diff options
Diffstat (limited to 'kopete/protocols/groupwise/gwaccount.h')
| -rw-r--r-- | kopete/protocols/groupwise/gwaccount.h | 360 |
1 files changed, 360 insertions, 0 deletions
diff --git a/kopete/protocols/groupwise/gwaccount.h b/kopete/protocols/groupwise/gwaccount.h new file mode 100644 index 00000000..2e8f8348 --- /dev/null +++ b/kopete/protocols/groupwise/gwaccount.h @@ -0,0 +1,360 @@ +/* + gwaccount.h - Kopete GroupWise Protocol + + Copyright (c) 2004 SUSE Linux AG http://www.suse.com + + Based on Testbed + Copyright (c) 2003 by Will Stephenson <will@stevello.free-online.co.uk> + + Kopete (c) 2002-2003 by the Kopete developers <kopete-devel@kde.org> + + ************************************************************************* + * * + * This library 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 GW_ACCOUNT_H +#define GW_ACCOUNT_H + +#include <kaction.h> + +#include <kopetechatsessionmanager.h> + +#include "gwerror.h" + +#include <managedconnectionaccount.h> + +class KActionMenu; + +namespace Kopete { + class Contact; + class Group; + class MetaContact; +} + +class GroupWiseContact; +class GroupWiseChatSession; +class GroupWiseProtocol; +class KNetworkConnector; +namespace QCA { + class TLS; +} +class QCATLSHandler; +class ClientStream; +class Client; +class GWContactList; + +using namespace GroupWise; + +/** + * This represents an account on a Novell GroupWise Messenger Server + */ +class GroupWiseAccount : public Kopete::ManagedConnectionAccount +{ + Q_OBJECT +public: + GroupWiseAccount( GroupWiseProtocol *parent, const QString& accountID, const char *name = 0 ); + ~GroupWiseAccount(); + + /** + * Construct the context menu used for the status bar icon + */ + virtual KActionMenu* actionMenu(); + + // DEBUG ONLY + void dumpManagers(); + // DEBUG ONLY + /** + * Creates a protocol specific Kopete::Contact subclass and adds it to the supplied + * Kopete::MetaContact + */ + virtual bool createContact(const QString& contactId, Kopete::MetaContact* parentContact); + /** + * Delete a contact on the server + */ + void deleteContact( GroupWiseContact * contact ); + /** + * Called when Kopete is set globally away + */ + virtual void setAway(bool away, const QString& reason); + /** + * Utility access to the port given by the user + */ + int port() const; + /** + * Utility access to the server given by the user + */ + const QString server() const; + /** + * Utility access to our protocol + */ + GroupWiseProtocol * protocol() const; + /** + * Utility access to the @ref Client which is the main interface exposed by libgroupwise. + * Most protocol actions are carried out using the client's member functions but the possibility exists + * to start Tasks directly on the client and respond directly to their signals. + */ + Client * client() const; + /** + * Utility to create or access a message manager instance for a given GUID and set of contacts + */ + GroupWiseChatSession * chatSession( Kopete::ContactPtrList others, const ConferenceGuid & guid, Kopete::Contact::CanCreateFlags canCreate ); + /** + * Look up a contact given a DN + * Returns 0 if none found + */ + GroupWiseContact * contactForDN( const QString & dn ); + /** + * Create a conference (start a chat) on the server + */ + void createConference( const int clientId, const QStringList& invitees ); + + /** + * Send a message + */ + void sendMessage( const ConferenceGuid & guid, const Kopete::Message & message ); + + /** + * Invite someone to join a conference + */ + void sendInvitation( const ConferenceGuid & guid, const QString & dn, const QString & message ); + + /** + * Check a contact's blocking status + * Only works when connected - otherwise always returns false + */ + bool isContactBlocked( const QString & m_dn ); + /** + * Set up a temporary contact (not on our contact list but is messaging us or involved in a conversation that we have been invited to. + */ + GroupWiseContact * createTemporaryContact( const QString & dn ); + + /** + * Check whether sync is not currently needed + */ + bool dontSync(); + + void syncContact( GroupWiseContact * contact ); + +public slots: + + void slotTestRTFize(); + + /* Connects to the server. */ + void performConnectWithPassword ( const QString &password ); + + /* Disconnects from the server. */ + virtual void disconnect(); + virtual void disconnect( Kopete::Account::DisconnectReason reason ); + + /** Set the online status for the account. Reimplemented from Kopete::Account */ + void setOnlineStatus( const Kopete::OnlineStatus& status , const QString &reason = QString::null); +signals: + void conferenceCreated( const int mmId, const GroupWise::ConferenceGuid & guid ); + void conferenceCreationFailed( const int mmId, const int statusCode ); + void contactTyping( const ConferenceEvent & ); + void contactNotTyping( const ConferenceEvent & ); + void privacyChanged( const QString & dn, bool allowed ); + + +protected slots: + void slotMessageSendingFailed(); + /** + * Set an auto reply message for use when the account is away + * TODO: Extend Kopete::AwayAction so you can set multiple ones there. + */ + void slotSetAutoReply(); + /** + * Manage the user's privacy settings + */ + void slotPrivacy(); + + /** + * Show a dialog to join a chatroom without first adding it to the contact list + */ + void slotJoinChatRoom(); + + /** + * Slot informing GroupWise when a group is renamed + */ + void slotKopeteGroupRenamed( Kopete::Group * ); + /** + * Slot informing GroupWise when a group is removed + */ + void slotKopeteGroupRemoved( Kopete::Group * ); + + // SERVER SIDE CONTACT LIST PROCESSING + /** + * Called when we receive a FOLDER from the server side contact list + * Adds to the Kopete contact list if not already present. + */ + void receiveFolder( const FolderItem & folder ); + /** + * Called when we receive a CONTACT from the server side contact list + * Adds to a folder in the Kopete contact list. + */ + void receiveContact( const ContactItem & ); + /** + * Called when we receive a CONTACT'S METADATA (including initial status) from the server side contact list, + * or in response to an explicity query. This is necessary to handle some events from the server. + * These events are queued in the account until the data arrives and then we handle the event. + */ + void receiveContactUserDetails( const GroupWise::ContactDetails & ); + /** + * Called after we create a contact on the server + */ + void receiveContactCreated(); + /** + * Handles the response to deleting a contact on the server + */ + void receiveContactDeleted( const ContactItem & instance ); + + // SLOTS HANDLING PROTOCOL EVENTS + /** + * Received a message from the server. + * Find the conversation that this message belongs to, and display it there. + * @param event contains event type, sender, content, flags. Type is used to handle autoreplies, normal messages, and [system] broadcasts. + */ + void handleIncomingMessage( const ConferenceEvent & ); + /** + * A contact changed status + */ + void receiveStatus( const QString &, Q_UINT16, const QString & ); + /** + * Our status changed on the server + */ + void changeOurStatus( GroupWise::Status, const QString &, const QString & ); + /** + * Called when we've been disconnected for logging in as this user somewhere else + */ + void slotConnectedElsewhere(); + /** + * Called when we've logged in successfully + */ + void slotLoggedIn(); + /** + * Called when a login attempt failed + */ + void slotLoginFailed(); + /** + * We joined a conference having accepted an invitation, create a message manager + */ + void receiveConferenceJoin( const GroupWise::ConferenceGuid & guid, const QStringList & participants, const QStringList & invitees ); + /** + * Someone joined a conference, add them to the appropriate message manager + */ + void receiveConferenceJoinNotify( const ConferenceEvent & ); + /** + * Someone left a conference, remove them from the message manager + */ + void receiveConferenceLeft( const ConferenceEvent & ); + /** + * The user was invited to join a conference + */ + void receiveInvitation( const ConferenceEvent & ); + /** + * Notification that a third party was invited to join conference + */ + void receiveInviteNotify( const ConferenceEvent & ); + /** + * Notification that a third party declined an invitation + */ + void receiveInviteDeclined( const ConferenceEvent & ); + /** + * A conference was closed by the server because everyone has left or declined invitations + * Prevents any further messages to this conference + */ +// void closeConference(); + // SLOTS HANDLING NETWORK EVENTS + /** + * Update the local user's metadata + */ + void receiveAccountDetails( const GroupWise::ContactDetails & details ); + /** + * The TLS handshake has happened, check the result + */ + void slotTLSHandshaken(); + /** The connection is ready for a login */ + void slotTLSReady( int secLayerCode ); + /** + * Called when the clientstream is connected, debug only + */ + void slotCSConnected(); + /** + * Performs necessary actions when the client stream has been disconnected + */ + void slotCSDisconnected(); + void slotCSError( int error ); + void slotCSWarning( int warning ); + + // HOUSEKEEPING + /** + * We listen for the destroyed() signal and leave any conferences we + * might have been in, and remove it from our map. + */ + void slotLeavingConference( GroupWiseChatSession * ); + + /** Debug slots */ + void slotConnError(); + void slotConnConnected(); +protected: + /** + * Sends a status message to the server - called by the status specific slotGoAway etc + */ + //void setStatus( GroupWise::Status status, const QString & reason = QString::null ); + + int handleTLSWarning (int warning, QString server, QString accountId); + + GroupWiseChatSession * findChatSessionByGuid( const GroupWise::ConferenceGuid & guid ); + /** + * reconcile any changes to the contact list which happened offline + */ + void reconcileOfflineChanges(); + /** + * Memory management + */ + void cleanup(); +private: + // action menu and its actions + KActionMenu * m_actionMenu; + KAction * m_actionAutoReply; + KAction * m_actionManagePrivacy; + KAction * m_actionJoinChatRoom; + // Network code + KNetworkConnector * m_connector; + QCA::TLS * m_QCATLS; + QCATLSHandler * m_tlsHandler; + ClientStream * m_clientStream; + // Client, entry point of libgroupwise + Client * m_client; + + QString m_initialReason; + QValueList<GroupWiseChatSession*> m_chatSessions; + bool m_dontSync; + GWContactList * m_serverListModel; +}; + +/** + * @internal + * An action that selects an OnlineStatus and provides a status message, but not using Kopete::Away, because the status message relates only to this status. + */ +/*class OnlineStatusMessageAction : public KAction +{ + Q_OBJECT + public: + OnlineStatusMessageAction ( const Kopete::OnlineStatus& status, const QString &text, const QString &message, const QIconSet &pix, QObject *parent=0, const char *name=0); + signals: + void activated( const Kopete::OnlineStatus& status, const QString & ); + private slots: + void slotActivated(); + private: + Kopete::OnlineStatus m_status; + QString m_message; +}; +*/ +#endif |