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.
403 lines
12 KiB
403 lines
12 KiB
/*
|
|
Kopete Groupwise Protocol
|
|
client.h - The main interface for the Groupwise protocol
|
|
|
|
Copyright (c) 2004 SUSE Linux AG http://www.suse.com
|
|
|
|
Based on Iris, Copyright (C) 2003 Justin Karneges
|
|
|
|
Kopete (c) 2002-2004 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 Lesser General Public *
|
|
* License as published by the Free Software Foundation; either *
|
|
* version 2 of the License, or (at your option) any later version. *
|
|
* *
|
|
*************************************************************************
|
|
*/
|
|
|
|
#ifndef LIBGW_CLIENT_H
|
|
#define LIBGW_CLIENT_H
|
|
|
|
#include <tqstring.h>
|
|
|
|
#include "gwclientstream.h"
|
|
#include "gwerror.h"
|
|
#include "rtf2html.h"
|
|
#include "transfer.h"
|
|
|
|
class ChatroomManager;
|
|
class PrivacyManager;
|
|
class RequestFactory;
|
|
class UserDetailsManager;
|
|
class Task;
|
|
|
|
using namespace GroupWise;
|
|
|
|
class Client : public TQObject
|
|
{
|
|
Q_OBJECT
|
|
TQ_OBJECT
|
|
|
|
public:
|
|
|
|
/*************
|
|
EXTERNAL API
|
|
*************/
|
|
|
|
Client( TQObject *tqparent = 0, uint protocolVersion = 2 );
|
|
~Client();
|
|
void setOSName( const TQString &name );
|
|
void setClientName( const TQString &s );
|
|
void setClientVersion( const TQString &s );
|
|
void setUserDN( const TQString & userDN );
|
|
/**
|
|
* Start a connection to the server using the supplied @ref ClientStream.
|
|
* This is only a transport layer connection.
|
|
* Needed for protocol action P1.
|
|
* @param s initialised client stream to use for the connection.
|
|
* @param server the server to connect to - but this is also set on the connector used to construct the clientstream??
|
|
* @param auth needed for jabber protocol layer only?
|
|
*/
|
|
void connectToServer( ClientStream *s, const NovellDN &server, bool auth=true );
|
|
|
|
/**
|
|
* Login to the GroupWise server using the supplied credentials
|
|
* Protocol action P1, needed for all
|
|
* @param host - probably could obtain this back from the connector - used for outgoing tasks to determine destination
|
|
* @param user The user name to log in as.
|
|
fd * @param password
|
|
*/
|
|
void start( const TQString &host, const uint port, const TQString &userId, const TQString &pass );
|
|
|
|
/**
|
|
* Logout and disconnect
|
|
* Protocol action P4 void distribute(const TQDomElement &);
|
|
|
|
*/
|
|
void close();
|
|
|
|
/**
|
|
* Accessors needed for login
|
|
*/
|
|
TQString host();
|
|
int port();
|
|
|
|
/**
|
|
* Set the user's presence on the server
|
|
* Protocol action P2
|
|
* @param status status enum
|
|
* @param reason custom status name for away statuses
|
|
* @param autoReply auto reply message for use in this status
|
|
*/
|
|
void settqStatus( GroupWise::tqStatus status, const TQString & reason, const TQString & autoReply );
|
|
|
|
/**
|
|
* Send a message
|
|
* Protocol action P10
|
|
* @param message contains the text and the recipient.
|
|
*/
|
|
void sendMessage( const TQStringList & addresseeDNs, const OutgoingMessage & message );
|
|
|
|
/**
|
|
* Send a typing notification
|
|
* Protocol action P11
|
|
* @param conference The conference where the typing took place.
|
|
* @param typing True if the user is now typing, false otherwise.
|
|
*/
|
|
void sendTyping( const ConferenceGuid & conferenceGuid, bool typing );
|
|
|
|
/**
|
|
* Request details for one or more users, for example, if we receive a message from someone who isn't on our contact list
|
|
* @param userDNs A list of one or more user's DNs to fetch details for
|
|
*/
|
|
void requestDetails( const TQStringList & userDNs );
|
|
|
|
/**
|
|
* Request the status of a single user, for example, if they have messaged us and are not on our contact list
|
|
*/
|
|
void requesttqStatus( const TQString & userDN );
|
|
|
|
/**
|
|
* Add a contact to the contact list
|
|
* Protocol action P12
|
|
*/
|
|
|
|
/**
|
|
* Remove a contact from the contact list
|
|
* Protocol action P13
|
|
*/
|
|
|
|
/**
|
|
* Instantiate a conference on the server
|
|
* Protocol action P5
|
|
*/
|
|
void createConference( const int clientId );
|
|
/**
|
|
* Overloaded version of the above to create a conference with a supplied list of invitees
|
|
*/
|
|
void createConference( const int clientId, const TQStringList & participants );
|
|
|
|
/**
|
|
* Join a conference, accepting an invitation
|
|
* Protocol action P7
|
|
*/
|
|
void joinConference( const ConferenceGuid & guid );
|
|
|
|
/**
|
|
* Reject a conference invitation
|
|
* Protocol action P8
|
|
*/
|
|
void rejectInvitation( const ConferenceGuid & guid );
|
|
|
|
/**
|
|
* Leave a conference, notifying
|
|
* Protocol action P6
|
|
*/
|
|
void leaveConference( const ConferenceGuid & guid );
|
|
|
|
/**
|
|
* Send an invitation to join a conference
|
|
* Protocol action P9
|
|
*/
|
|
void sendInvitation( const ConferenceGuid & guid, const TQString & dn, const GroupWise::OutgoingMessage & message );
|
|
/*************
|
|
INTERNAL (FOR USE BY TASKS) METHODS
|
|
*************/
|
|
/**
|
|
* Send an outgoing request to the server
|
|
*/
|
|
void send( Request *request );
|
|
/**
|
|
* Print a debug statement
|
|
*/
|
|
void debug( const TQString &str );
|
|
|
|
/**
|
|
* The protocol version of the Client
|
|
*/
|
|
uint protocolVersion() const;
|
|
/**
|
|
* Generate a unique ID for Tasks.
|
|
*/
|
|
TQString genUniqueId();
|
|
|
|
/**
|
|
* The current user's user ID
|
|
*/
|
|
TQString userId();
|
|
|
|
/**
|
|
* The current user's DN
|
|
*/
|
|
TQString userDN();
|
|
/**
|
|
* The current user's password
|
|
*/
|
|
TQString password();
|
|
|
|
/**
|
|
* User agent details for this host
|
|
*/
|
|
TQString userAgent();
|
|
|
|
/**
|
|
* Host's IP address
|
|
*/
|
|
TQCString ipAddress();
|
|
|
|
/**
|
|
* Obtain the list of custom statuses stored on the server
|
|
*/
|
|
TQValueList<GroupWise::CustomtqStatus> customStatuses();
|
|
|
|
/**
|
|
* Get a reference to the RequestFactory for this Client.
|
|
* Used by Tasks to generate Requests with an ascending sequence of transaction IDs
|
|
* for this connection
|
|
*/
|
|
RequestFactory * requestFactory();
|
|
|
|
/**
|
|
* Get a reference to the ChatroomManager for this Client.
|
|
* This is constructed the first time this function is called. Used to manipulate chat rooms on the server.
|
|
*/
|
|
ChatroomManager * chatroomManager();
|
|
|
|
/**
|
|
* Get a reference to the UserDetailsManager for this Client.
|
|
* Used to track known user details and issue new details requests
|
|
*/
|
|
UserDetailsManager * userDetailsManager();
|
|
/**
|
|
* Get a reference to the PrivacyManager for this Client.
|
|
* Used to track and manipulate server side privacy settings
|
|
*/
|
|
PrivacyManager * privacyManager();
|
|
/**
|
|
* Access the root Task for this client, so tasks may be added to it.
|
|
*/
|
|
Task* rootTask();
|
|
|
|
signals:
|
|
/** CONNECTION EVENTS */
|
|
/**
|
|
* Notifies that the login process has succeeded.
|
|
*/
|
|
void loggedIn();
|
|
void loginFailed();
|
|
/**
|
|
* Notifies tasks and account so they can react properly
|
|
*/
|
|
void disconnected();
|
|
/**
|
|
* We were disconnected because we connected elsewhere
|
|
*/
|
|
void connectedElsewhere();
|
|
|
|
/** STATUS AND METADATA EVENTS */
|
|
/**
|
|
* We've just got the user's own details from the server.
|
|
*/
|
|
void accountDetailsReceived( const GroupWise::ContactDetails & );
|
|
/**
|
|
* We've just found out about a folder from the server.
|
|
*/
|
|
void folderReceived( const FolderItem & );
|
|
/**
|
|
* We've just found out about a folder from the server.
|
|
*/
|
|
void contactReceived( const ContactItem & );
|
|
/**
|
|
* We've just received a contact's metadata from the server.
|
|
*/
|
|
void contactUserDetailsReceived( const GroupWise::ContactDetails & );
|
|
/**
|
|
* A remote contact changed status
|
|
*/
|
|
void statusReceived( const TQString & contactId, TQ_UINT16 status, const TQString & statusText );
|
|
/**
|
|
* Our status changed on the server
|
|
*/
|
|
void ourStatusChanged( GroupWise::tqStatus status, const TQString & statusText, const TQString & autoReply );
|
|
|
|
/** CONFERENCE (MANAGEMENT) EVENTS */
|
|
/**
|
|
* Notify that we've just received a message. Sender may not be on our contact list
|
|
*/
|
|
void messageReceived( const ConferenceEvent & );
|
|
/**
|
|
* Notify that we've received an auto reply. This Event does not contain any rtf, unlike a normal message.
|
|
*/
|
|
void autoReplyReceived( const ConferenceEvent & );
|
|
/**
|
|
* A conference was successfully created on the server
|
|
*/
|
|
void conferenceCreated( const int clientId, const GroupWise::ConferenceGuid & guid );
|
|
/**
|
|
* A third party was invited to join a chat. They may not be on our contact list.
|
|
*/
|
|
void inviteNotifyReceived( const ConferenceEvent & );
|
|
/**
|
|
* We were invited to join a chat. The inviter may not be on our contact list
|
|
*/
|
|
void invitationReceived( const ConferenceEvent & );
|
|
/**
|
|
* Someone joined a chat. They may not be on our contact list if it is a group chat
|
|
* and they were invited to join the chat prior to our being invited to join and joining
|
|
*/
|
|
void conferenceJoinNotifyReceived( const ConferenceEvent & );
|
|
/**
|
|
* Someone left a conference. This may close a conference, see @ref conferenceClosed.
|
|
*/
|
|
void conferenceLeft( const ConferenceEvent & );
|
|
/**
|
|
* Someone declined an invitation to join a conference. This may close a conference, see @ref conferenceClosed.
|
|
*/
|
|
void invitationDeclined( const ConferenceEvent & );
|
|
/**
|
|
* A conference was closed by the server. This occurs if we are the only participant and there
|
|
* are no outstanding invitations.
|
|
*/
|
|
void conferenceClosed( const ConferenceEvent & );
|
|
/**
|
|
* We joined a conference.
|
|
*/
|
|
void conferenceJoined( const GroupWise::ConferenceGuid &, const TQStringList &, const TQStringList & );
|
|
/**
|
|
* We received an "is typing" event in a conference
|
|
*/
|
|
void contactTyping( const ConferenceEvent & );
|
|
/**
|
|
* We received an "is not typing event" in a conference
|
|
*/
|
|
void contactNotTyping( const ConferenceEvent & );
|
|
/**
|
|
* An attempt to create a conference failed.
|
|
*/
|
|
void conferenceCreationFailed( const int clientId, const int error );
|
|
/**
|
|
* We received a temporary contact related to a conference
|
|
*/
|
|
void tempContactReceived( const GroupWise::ContactDetails & );
|
|
/**
|
|
* We received a broadcast message
|
|
*/
|
|
void broadcastReceived( const ConferenceEvent & );
|
|
/**
|
|
* We received a system broadcast
|
|
*/
|
|
void systemBroadcastReceived ( const ConferenceEvent & );
|
|
/** CONTACT LIST MANAGEMENT EVENTS */
|
|
/** TBD! */
|
|
void messageSendingFailed();
|
|
protected:
|
|
/**
|
|
* Instantiate all the event handling tasks
|
|
*/
|
|
void initialiseEventTasks();
|
|
protected slots:
|
|
// INTERNAL, FOR USE BY TASKS' finished() SIGNALS //
|
|
void lt_loginFinished();
|
|
void sst_statusChanged();
|
|
void cct_conferenceCreated();
|
|
/**
|
|
* Transforms an RTF message into an HTML message and emits messageReceived()
|
|
*/
|
|
void ct_messageReceived( const ConferenceEvent & );
|
|
void jct_joinConfCompleted();
|
|
/**
|
|
* Receive a custom status during login and record it
|
|
*/
|
|
void lt_gotCustomtqStatus( const GroupWise::CustomtqStatus & );
|
|
/**
|
|
* Notify us of the keepalive period contained in the login response
|
|
*/
|
|
void lt_gotKeepalivePeriod( int );
|
|
|
|
/**
|
|
* Used by the client stream to notify errors to upper layers.
|
|
*/
|
|
void streamError( int error );
|
|
|
|
/**
|
|
* The client stream has data ready to read.
|
|
*/
|
|
void streamReadyRead();
|
|
|
|
/**
|
|
* sendout a 'ping' keepalive message so that the server does not disconnect us
|
|
*/
|
|
void sendKeepAlive();
|
|
void smt_messageSent();
|
|
|
|
private:
|
|
void distribute( Transfer *transfer );
|
|
class ClientPrivate;
|
|
ClientPrivate* d;
|
|
};
|
|
|
|
#endif
|