You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
tdenetwork/kopete/protocols/jabber/jabberaccount.h

311 lines
9.2 KiB

/***************************************************************************
jabberaccount.h - core Jabber account class
-------------------
begin : Sat Mar 8 2003
copyright : (C) 2003 by Till Gerken <till@tantalo.net>
Based on JabberProtocol by Daniel Stone <dstone@kde.org>
and Till Gerken <till@tantalo.net>.
copyright : (C) 2006 by Olivier Goffart <ogoffart at kde.org>
Kopete (C) 2001-2003 Kopete developers <kopete-devel@kde.org>.
***************************************************************************/
/***************************************************************************
* *
* This program is free software; you can redistribute it and/or modify *
* it under the terms of the GNU General Public License as published by *
* the Free Software Foundation; either version 2 of the License, or *
* (at your option) any later version. *
* *
***************************************************************************/
#ifndef JABBERACCOUNT_H
#define JABBERACCOUNT_H
#ifdef HAVE_CONFIG_H
#include <config.h>
#endif
// we need these for type reasons
#include <kopetepasswordedaccount.h>
#include <kopeteonlinestatus.h>
#include <im.h>
#include "jabberclient.h"
class TQString;
class TQStringList;
class KActionMenu;
class JabberResourcePool;
class JabberContact;
class JabberContactPool;
class JabberProtocol;
class JabberTransport;
class JabberBookmarks;
namespace Kopete { class MetaContact; }
#ifdef SUPPORT_JINGLE
//class JingleSessionManager;
//class JingleSession;
class VoiceCaller;
#endif
/* @author Daniel Stone, Till Gerken */
class JabberAccount : public Kopete::PasswordedAccount
{
Q_OBJECT
public:
JabberAccount (JabberProtocol * parent, const TQString & accountID, const char *name = 0L);
~JabberAccount ();
/* Returns the action menu for this account. */
virtual KActionMenu *actionMenu ();
/* Return the resource of the client */
const TQString resource () const;
const TQString server () const;
const int port () const;
JabberResourcePool *resourcePool ();
JabberContactPool *contactPool ();
/* to get the protocol from the account */
JabberProtocol *protocol () const
{
return m_protocol;
}
JabberClient *client () const
{
return m_jabberClient;
}
#ifdef SUPPORT_JINGLE
VoiceCaller *voiceCaller() const
{
return m_voiceCaller;
}
// JingleSessionManager *sessionManager() const
// {
// return m_jingleSessionManager;
// }
#endif
// change the default S5B server port
void setS5BServerPort ( int port );
/* Tells the user to connect first before they can do whatever it is
* that they want to do. */
void errorConnectFirst ();
/* Tells the user that the connection was lost while we waited for
* an answer of him. */
void errorConnectionLost ();
/*
* Handle TLS warnings. Displays a dialog and returns the user's choice.
* Parameters: Warning code from QCA::TLS
* Automatically resumes the stream if wanted.
*/
/**
* Handle a TLS warning. Displays a dialog and returns if the
* stream can be continued or not.
* @param client JabberClient instance
* @param warning Warning code from QCA::TLS
* @return True if stream can be resumed.
*/
static bool handleTLSWarning ( JabberClient *client, int warning );
/*
* Handle stream errors. Displays a dialog and returns.
*/
static void handleStreamError (int streamError, int streamCondition, int connectorCode, const TQString &server, Kopete::Account::DisconnectReason &errorClass);
const TQMap<TQString, JabberTransport *> &transports()
{ return m_transports; }
/**
* called when the account is removed in the config ui
*/
virtual bool removeAccount();
public slots:
/* Connects to the server. */
void connectWithPassword ( const TQString &password );
/* Disconnects from the server. */
void disconnect ();
/* Disconnect with a reason */
void disconnect ( Kopete::Account::DisconnectReason reason );
/* Disconnect with a reason, and status */
void disconnect( Kopete::Account::DisconnectReason reason, XMPP::Status &status );
/* Reimplemented from Kopete::Account */
void setOnlineStatus( const Kopete::OnlineStatus& status , const TQString &reason = TQString());
void addTransport( JabberTransport *tr , const TQString &jid);
void removeTransport( const TQString &jid );
protected:
/**
* Create a new contact in the specified metacontact
*
* You shouldn't ever call this method yourself, For adding contacts see @ref addContact()
*
* This method is called by @ref Kopete::Account::addContact() in this method, you should
* simply create the new custom @ref Kopete::Contact in the given metacontact. You should
* NOT add the contact to the server here as this method gets only called when synchronizing
* the contact list on disk with the one in memory. As such, all created contacts from this
* method should have the "dirty" flag set.
*
* This method should simply be used to intantiate the new contact, everything else
* (updating the GUI, parenting to meta contact, etc.) is being taken care of.
*
* @param contactId The unique ID for this protocol
* @param parentContact The metacontact to add this contact to
*/
virtual bool createContact (const TQString & contactID, Kopete::MetaContact * parentContact);
private:
JabberProtocol *m_protocol;
// backend for this account
JabberClient *m_jabberClient;
JabberResourcePool *m_resourcePool;
JabberContactPool *m_contactPool;
#ifdef SUPPORT_JINGLE
VoiceCaller *m_voiceCaller;
//JingleSessionManager *m_jingleSessionManager;
#endif
JabberBookmarks *m_bookmarks;
/* Set up our actions for the status menu. */
void initActions ();
void cleanup ();
/* Initial presence to set after connecting. */
XMPP::Status m_initialPresence;
/**
* Sets our own presence. Updates our resource in the
* resource pool and sends a presence packet to the server.
*/
void setPresence ( const XMPP::Status &status );
/**
* Returns if a connection attempt is currently in progress.
*/
bool isConnecting ();
TQMap<TQString, JabberTransport *>m_transports;
/* used in removeAccount() */
bool m_removing;
/* keep track if we told the user we were not able to bind the
jabber transfer port, to avoid popup insanity */
bool m_notifiedUserCannotBindTransferPort;
private slots:
/* Connects to the server. */
void slotConnect ();
/* Disconnects from the server. */
void slotDisconnect ();
// handle a TLS warning
void slotHandleTLSWarning ( int validityResult );
// handle client errors
void slotClientError ( JabberClient::ErrorCode errorCode );
// we are connected to the server
void slotConnected ();
/* Called from Psi: tells us when we've been disconnected from the server. */
void slotCSDisconnected ();
/* Called from Psi: alerts us to a protocol error. */
void slotCSError (int);
/* Called from Psi: roster request finished */
void slotRosterRequestFinished ( bool success );
/* Called from Psi: incoming file transfer */
void slotIncomingFileTransfer ();
/* Called from Psi: debug messages from the backend. */
void slotClientDebugMessage (const TQString &msg);
/* Sends a raw message to the server (use with caution) */
void slotSendRaw ();
/* Slots for handling group chats. */
void slotJoinNewChat ();
void slotGroupChatJoined ( const XMPP::Jid &jid );
void slotGroupChatLeft ( const XMPP::Jid &jid );
void slotGroupChatPresence ( const XMPP::Jid &jid, const XMPP::Status &status );
void slotGroupChatError ( const XMPP::Jid &jid, int error, const TQString &reason );
/* Incoming subscription request. */
void slotSubscription ( const XMPP::Jid &jid, const TQString &type );
/* the dialog that asked to add the contact was closed (that dialog is shown in slotSubscription) */
void slotContactAddedNotifyDialogClosed(const TQString& contactid);
/**
* A new item appeared in our roster, synch it with the
* contact list.
* (or the contact has been updated
*/
void slotContactUpdated ( const XMPP::RosterItem & );
/**
* An item has been deleted from our roster,
* delete it from our contact pool.
*/
void slotContactDeleted ( const XMPP::RosterItem & );
/* Someone on our contact list had (another) resource come online. */
void slotResourceAvailable ( const XMPP::Jid &, const XMPP::Resource & );
/* Someone on our contact list had (another) resource go offline. */
void slotResourceUnavailable ( const XMPP::Jid &, const XMPP::Resource & );
/* Displays a new message. */
void slotReceivedMessage ( const XMPP::Message & );
/* Gets the user's vCard from the server for editing. */
void slotEditVCard ();
/* Get the services list from the server for management. */
void slotGetServices ();
/* Update the myself information if the global identity changes. */
void slotGlobalIdentityChanged( const TQString &key, const TQVariant &value );
/* we received a voice invitation */
void slotIncomingVoiceCall(const Jid&);
/* the unregister task finished */
void slotUnregisterFinished();
//void slotIncomingJingleSession(const TQString &sessionType, JingleSession *session);
};
#endif