Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features.

BUG:215923


git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdenetwork@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da

1 files changed, 156 insertions, 0 deletions

diff --git a/kopete/protocols/oscar/liboscar/ssimodifytask.h b/kopete/protocols/oscar/liboscar/ssimodifytask.h
new file mode 100644
index 00000000..2c32dda3
--- /dev/null
+++ b/kopete/protocols/oscar/liboscar/ssimodifytask.h
@@ -0,0 +1,156 @@
+/*
+	Kopete Oscar Protocol
+	ssimodifytask.h - Handles all the ssi modification stuff
+
+	Copyright (c) 2004 by Kopete Developers <kopete-devel@kde.org>
+
+	Based on code 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 SSIMODIFYTASK_H
+#define SSIMODIFYTASK_H
+
+#include "task.h"
+#include "oscartypes.h"
+#include "ssimanager.h"
+
+
+class Buffer;
+
+/**
+This class takes care of any SSI list modifications that need to be made. This includes:
+@li adds
+@li edits
+@li removes
+@li group changes
+@li alias changes
+@li authorization changes
+etc.
+
+This task implements the following SNACs from the SSI family (0x0013):
+@li 0x0008
+@li 0x0009
+@li 0x000A
+@li 0x000E
+@li 0x0011
+@li 0x0012
+
+@author Matt Rogers
+*/
+class SSIModifyTask : public Task
+{
+public:
+    SSIModifyTask( Task* parent, bool staticTask = false );
+    ~SSIModifyTask();
+
+	virtual void onGo();
+	virtual bool take( Transfer* transfer );
+
+	/* Contact properties */
+	enum OperationType { NoType = 0x00, Add = 0x10, Remove = 0x20, Rename = 0x40, Change = 0x80 };
+	enum OperationSubject { NoSubject = 0x000, Contact = 0x100, Group = 0x200, Visibility = 0x400, Invisibility = 0x800 };
+	
+	//! Set up the stuff needed to add a contact.
+	//! @return true if we can send the packet
+	bool addContact( const QString& contact, const QString& group, bool requiresAuth = false );
+	
+	//! Set up the stuff needed to remove a contact.
+	//! @return true if we can send the packet
+	bool removeContact( const QString& contact );
+	
+	//! Set up the stuff needed to change groups
+	//! @return true if we can send the packet
+	bool changeGroup( const QString& contact, const QString& newGroup );
+	
+	/* Group properties */
+	
+	//! Add a new group to the SSI list
+	//! @return true if we can send the packet
+	bool addGroup( const QString& groupName );
+	
+	//! Remove a group from the SSI list
+	//! @return true if we can send the packet
+	bool removeGroup( const QString& groupName );
+	
+	//! Rename a group on the SSI list
+	//! @return true if we can send the packet
+	bool renameGroup( const QString& oldName, const QString& newName );
+	
+	//! Add an item to the SSI list
+	//! Should be used for other items we don't have explicit functions for
+	//! like icon hashs, privacy settings, non-icq contacts, etc.
+	bool addItem( const SSI& item );
+	
+	//! Remove an item from the SSI list
+	//! Should be used for other items we don't have explicit functions for
+	//! like icon hashs, privacy settings, non-icq contacts, etc.
+	bool removeItem( const SSI& item );
+	
+	//! Modify an item on the SSI list
+	//! Should be used for other items we don't have explicit functions for
+	//! like icon hashs, privacy settings, non-icq contacts, etc.
+	bool modifyItem( const SSI& oldItem, const SSI& newItem );
+	
+protected:
+	virtual bool forMe( const Transfer* transfer ) const;
+
+private:
+	//! Handle the acknowledgement from the server
+	void handleSSIAck();
+	
+	//! Construct and send the packet to send to the server
+	void sendSSIUpdate();
+	
+	//! Helper function to change the group on the server
+	void changeGroupOnServer();
+	
+	//! Update the SSI Manager with the new data
+	void updateSSIManager();
+	
+	//! Helper function to free id on error
+	void freeIdOnError();
+		
+	//! Send the SSI edit start packet
+	void sendEditStart();
+	
+	//! Send the SSI edit end packet
+	void sendEditEnd();
+	
+	void addItemToBuffer( Oscar::SSI item, Buffer* buffer );
+	Oscar::SSI getItemFromBuffer( Buffer* buffer ) const;
+	
+	//! Handle server request to add item
+	void handleSSIAdd();
+	
+	//! Handle server request to update item
+	void handleSSIUpdate();
+	
+	//! Handle server request to remove item
+	void handleSSIRemove();
+
+private:
+	SSI m_oldItem;
+	SSI m_newItem;
+	SSI m_groupItem;
+	OperationType m_opType;
+	OperationSubject m_opSubject;
+	WORD m_id;
+	SSIManager* m_ssiManager;
+	bool m_static;
+	
+};
+
+#endif
+
+//kate: tab-width 4; indent-mode csands