Major Rewrite of the New Cache Based Services.

- Defined a generalised Group/Msg retrieval interface (RsTokenService), which is defined in rsidentity.h
	- Defined MetaData for both Groups and Messages (not finalised yet).
	- Implemented a general Data Backend for Local Testing of interface - inside p3gxsservice.cc
	- Modified services to use this temporary backend.
	- Added Wire and ForumV2 services.

Still lots to do:
	- work out request options.
	- finalise metadata.
	- group permissions.
	- identities



git-svn-id: http://svn.code.sf.net/p/retroshare/code/branches/v0.5-new_cache_system@5219 b45a01b8-16f6-495d-af2f-9b41ad6348cc

libretroshare/src/services/p3wire.h

@@ -0,0 +1,125 @@
+/*
+ * libretroshare/src/services: p3wire.h
+ *
+ * Wire interface for RetroShare.
+ *
+ * Copyright 2012-2012 by Robert Fernie.
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Library General Public
+ * License Version 2 as published by the Free Software Foundation.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ * Library General Public License for more details.
+ *
+ * You should have received a copy of the GNU Library General Public
+ * License along with this library; if not, write to the Free Software
+ * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
+ * USA.
+ *
+ * Please report all bugs and problems to "retroshare@lunamutt.com".
+ *
+ */
+
+#ifndef P3_WIRE_SERVICE_HEADER
+#define P3_WIRE_SERVICE_HEADER
+
+#include "services/p3gxsservice.h"
+
+#include "retroshare/rswire.h"
+
+#include <map>
+#include <string>
+
+/* 
+ * Wire Service
+ *
+ */
+class WireDataProxy: public GxsDataProxy
+{
+        public:
+
+        bool getGroup(const std::string &id, RsWireGroup &group);
+        bool getPulse(const std::string &id, RsWirePulse &pulse);
+
+        bool addGroup(const RsWireGroup &group);
+        bool addPulse(const RsWirePulse &pulse);
+
+        /* These Functions must be overloaded to complete the service */
+virtual bool convertGroupToMetaData(void *groupData, RsGroupMetaData &meta);
+virtual bool convertMsgToMetaData(void *msgData, RsMsgMetaData &meta);
+};
+
+
+class p3Wire: public p3GxsDataService, public RsWire
+{
+	public:
+
+	p3Wire(uint16_t type);
+
+virtual int	tick();
+
+	public:
+
+
+virtual bool updated();
+
+       /* Data Requests */
+virtual bool requestGroupInfo(     uint32_t &token, uint32_t ansType, const RsTokReqOptions &opts, const std::list<std::string> &groupIds);
+virtual bool requestMsgInfo(       uint32_t &token, uint32_t ansType, const RsTokReqOptions &opts, const std::list<std::string> &groupIds);
+virtual bool requestMsgRelatedInfo(uint32_t &token, uint32_t ansType, const RsTokReqOptions &opts, const std::list<std::string> &msgIds);
+
+        /* Generic Lists */
+virtual bool getGroupList(         const uint32_t &token, std::list<std::string> &groupIds);
+virtual bool getMsgList(           const uint32_t &token, std::list<std::string> &msgIds);
+
+        /* Generic Summary */
+virtual bool getGroupSummary(      const uint32_t &token, std::list<RsGroupMetaData> &groupInfo);
+virtual bool getMsgSummary(        const uint32_t &token, std::list<RsMsgMetaData> &msgInfo);
+
+        /* Actual Data -> specific to Interface */
+        /* Specific Service Data */
+virtual bool getGroupData(const uint32_t &token, RsWireGroup &group);
+virtual bool getMsgData(const uint32_t &token, RsWirePulse &page);
+
+        /* Poll */
+virtual uint32_t requestStatus(const uint32_t token);
+
+        /* Cancel Request */
+virtual bool cancelRequest(const uint32_t &token);
+
+        //////////////////////////////////////////////////////////////////////////////
+        /* Functions from Forums -> need to be implemented generically */
+virtual bool groupsChanged(std::list<std::string> &groupIds);
+
+        // Get Message Status - is retrived via MessageSummary.
+virtual bool setMessageStatus(const std::string &msgId, const uint32_t status, const uint32_t statusMask);
+
+        // 
+virtual bool groupSubscribe(const std::string &groupId, bool subscribe);
+
+virtual bool groupRestoreKeys(const std::string &groupId);
+virtual bool groupShareKeys(const std::string &groupId, std::list<std::string>& peers);
+
+
+virtual bool createGroup(RsWireGroup &group);
+virtual bool createPulse(RsWirePulse &pulse);
+
+
+	private:
+
+std::string genRandomId();
+
+	WireDataProxy *mWireProxy;
+
+	RsMutex mWireMtx;
+
+	/***** below here is locked *****/
+
+	bool mUpdated;
+
+};
+
+#endif