2 * This file is part of TpSession
4 * Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies).
5 * Contact Kate Alhola kate.alhola(a)nokia.com
7 * This library is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU Lesser General Public
9 * License as published by the Free Software Foundation; either
10 * version 2.1 of the License, or (at your option) any later version.
12 * This library is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * Lesser General Public License for more details.
17 * You should have received a copy of the GNU Lesser General Public
18 * License along with this library; if not, write to the Free Software
19 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
21 #include "tpsession.h"
30 * \headerfile <tpsession.h>
32 * Top level class, counterpart of Account Manager. TpSession connects to account manager and requests accounts from it. TpSession creates TpSessionAccount for all accounts .
33 * As top level class TpSession provides simålified interface to send and receive messages via any account. TpSession provides signal when it has accounts ready.
34 * If you require some specific account in constructor, you will receive signal only when this account is ready. If you use constructor without any parameters, you will get one
35 * signal for every account. If synchronous is true, constructor is executed as synchronous and it does return after transactions to set up accounts are done.
38 * \fn void TpSession::accountReady(TpSessionAccount *);
40 * Emitted when the account becomes ready
42 * \param TpSessionAccount pointer to account become ready
45 * \fn void TpSession::amReady(TpSession *);
47 * Emitted when the account Manager becomes ready
49 * \param TpSession pointer to TpSession class
52 * \fn void TpSession::messageReceived(const Tp::ReceivedMessage &,TpSessionAccount *);
54 * Emitted when any of Account Managers recived message
56 * \param Tp::ReceivedMessage Message received
57 * \param TpSessionAccount pointer to account received message
62 * Construct a new TpSession object.
64 * \param cmname Name of the default connection manager. Can be empty or omnitted, then there is no default connection manager
65 * \param synchronous if false, asynchronous behavior, function returns immediately and accountReady signals are emitted when accounts are ready
66 * if True, synchronous behavior and function returns when accounts are ready
68 TpSession::TpSession(QString cmname,bool synchronous)
71 Tp::enableDebug(false);
72 Tp::enableWarnings(false);
74 mAM = Tp::AccountManager::create();
76 connect(mAM->becomeReady(),
77 SIGNAL(finished(Tp::PendingOperation *)),
78 SLOT(onAMReady(Tp::PendingOperation *)));
80 SIGNAL(accountCreated(const QString &)),
81 SLOT(onAccountCreated(const QString &)));
84 if(synchronous) loop.exec(); // Loop locally untill accounts are initialized
88 TpSession* TpSession::instancePtr=NULL;
90 * Returns pointer to TpSession singleton. If there is not yet TpSession Object, creates it with "Ring" connection manager as default
92 * \param synchronous if false, asynchronous behavior, function returns immediately and accountReady signals are emitted when accounts are ready
93 * if True, synchronous behavior and function returns when accounts are ready
95 TpSession* TpSession::instance(bool synchronous)
97 if(instancePtr==NULL) instancePtr=new TpSession("ring",synchronous);
101 void TpSession::onAMReady(Tp::PendingOperation *op)
103 qDebug() << "TpSession::onAMReady";
104 TpSessionAccount *tpacc;
106 foreach (const QString &path, mAM->allAccountPaths()) {
107 accounts+=tpacc=new TpSessionAccount(mAM, path);
108 connect(tpacc,SIGNAL(accountReady(TpSessionAccount*)),
109 SLOT(onAccountReady(TpSessionAccount *)));
114 void TpSession::onReady(Tp::PendingOperation *)
118 void TpSession::onAccountCreated(const QString &path)
121 accounts+=new TpSessionAccount(mAM, path);
124 void TpSession::onAccountReady(TpSessionAccount *tpacc)
126 qDebug() << "TpSession::onAccountReady:Account " << tpacc->acc->cmName() << "is Ready";
127 connect(tpacc,SIGNAL(messageReceived(const Tp::ReceivedMessage &,TpSessionAccount *)),
128 SLOT(onMessageReceived(const Tp::ReceivedMessage &,TpSessionAccount *)));
129 if(!reqCm.isEmpty() && tpacc->acc->cmName()==reqCm) {
133 emit accountReady(tpacc);
134 if(!reqMsg.isEmpty()) tpacc->sendMessageToAddress(reqAddress,reqMsg);
139 void TpSession::onMessageReceived(const Tp::ReceivedMessage &msg,TpSessionAccount *acc)
141 qDebug() << "TestProg::onMessageReceived " << msg.text() << "from " << msg.sender()->id();
142 emit messageReceived(msg,acc);
146 * Send message using specified connection manager to address
148 * \param connectionMgr Name of the connection manager
149 * \param address Valid address for this connection manager type. Asexample telephone number to Ring, GoogleTalk address for Gabble
150 * \param message Message body
152 void TpSession::sendMessageToAddress(QString connectionMgr,QString address,QString message)
154 TpSessionAccount *tpsa=getAccount(connectionMgr);
155 if(tpsa) tpsa->sendMessageToAddress(address,message);
158 * Returns pointer to TpSessionAccout object with specified connection manager or protocol, returns NULL if no match found
160 * \param cm Name of the connection manager, if left empty matches every entry
161 * \param protocol Name of the protocol manager, if left empty matches every entry
163 TpSessionAccount* TpSession::getAccount(const QString cm,QString protocol)
165 qDebug() << "TpSession::getAccount" << cm << " " << protocol;
166 foreach (TpSessionAccount *tpacc, accounts) {
167 if((!cm.isEmpty() && tpacc->acc->cmName()==cm) || (!protocol.isEmpty() && tpacc->acc->protocol()==protocol)) {
168 qDebug() << "TpSession::getAccount found" << tpacc->acc->cmName() << " " << tpacc->acc->protocol();
175 void TpSession::createObserver()
178 qDebug() << __PRETTY_FUNCTION__ ;
180 registrar = Tp::ClientRegistrar::create();
182 Tp::ChannelClassList channelFilters;
183 QMap<QString, QDBusVariant> textFilter, mediaFilter;
184 // Registering Text channel observer
185 textFilter.insert(QLatin1String(TELEPATHY_INTERFACE_CHANNEL ".ChannelType"),
186 QDBusVariant(TELEPATHY_INTERFACE_CHANNEL_TYPE_TEXT));
187 textFilter.insert(QLatin1String(TELEPATHY_INTERFACE_CHANNEL ".TargetHandleType"),
188 QDBusVariant(Tp::HandleTypeContact));
189 channelFilters.append(textFilter);
191 // Registering Media channel observer
192 mediaFilter.insert(QLatin1String(TELEPATHY_INTERFACE_CHANNEL ".ChannelType"),
193 QDBusVariant(TELEPATHY_INTERFACE_CHANNEL_TYPE_STREAMED_MEDIA));
194 mediaFilter.insert(QLatin1String(TELEPATHY_INTERFACE_CHANNEL ".TargetHandleType"),
195 QDBusVariant(Tp::HandleTypeContact));
196 channelFilters.append(mediaFilter);
198 TpSessionObserver* observer = new TpSessionObserver( channelFilters, this );
199 bool registered = registrar->registerClient(
200 Tp::AbstractClientPtr::dynamicCast(Tp::SharedPtr<TpSessionObserver>(observer)),
201 "TpSessionChannelObserver");
203 qDebug() << "TpSession::createObserver" << (registered ? "started" : "failed");
208 void TpSession::createChannelListener(const QString &channelType,
209 const Tp::MethodInvocationContextPtr<> &context,
210 const Tp::AccountPtr &account,
211 const Tp::ChannelPtr &channel)
213 qDebug() << "TpSession::createChannelListener";
215 QString channelObjectPath = channel->objectPath();
218 if ( channels.contains( channelObjectPath ) &&
219 !channelType.isEmpty() &&
220 !channelObjectPath.isEmpty() ) {
221 qDebug() << "TELEPATHY_ERROR_INVALID_ARGUMENT";
224 qDebug() << "creating listener for: " << channelObjectPath << " type " << channelType;
226 ChannelListener* listener = 0;
227 if( channelType == TELEPATHY_INTERFACE_CHANNEL_TYPE_TEXT ) {
228 listener = new TextChannelListener(account, channel, context);
229 } else if ( channelType == TELEPATHY_INTERFACE_CHANNEL_TYPE_STREAMED_MEDIA ) {
230 listener = new StreamChannelListener(account, channel, context);
234 connect(listener, SIGNAL(channelClosed(ChannelListener *)),
235 this, SLOT(channelClosed(ChannelListener *)));
236 Channels.append( channelObjectPath );