/******************************************************************************* * libretroshare/src/services: p3photoservice.h * * * * libretroshare: retroshare core library * * * * Copyright 2008-2012 Robert Fernie,Chris Evi-Parker * * * * This program 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 3 of the * * License, or (at your option) any later version. * * * * This program 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 Lesser General Public License for more details. * * * * You should have received a copy of the GNU Lesser General Public License * * along with this program. If not, see . * * * *******************************************************************************/ #ifndef P3PHOTOSERVICEV2_H #define P3PHOTOSERVICEV2_H #include "gxs/rsgenexchange.h" #include "retroshare/rsphoto.h" class p3PhotoService : public RsPhoto, public RsGenExchange { public: p3PhotoService(RsGeneralDataService* gds, RsNetworkExchangeService* nes, RsGixs* gixs); virtual RsServiceInfo getServiceInfo(); static uint32_t photoAuthenPolicy(); public: /*! * @return true if a change has occured */ bool updated(); /*! * */ void service_tick(); protected: void notifyChanges(std::vector& changes); public: /** Requests **/ void groupsChanged(std::list& grpIds); void msgsChanged(GxsMsgIdResult& msgs); RsTokenService* getTokenService(); bool getGroupList(const uint32_t &token, std::list &groupIds); bool getMsgList(const uint32_t &token, GxsMsgIdResult& msgIds); /* Generic Summary */ bool getGroupSummary(const uint32_t &token, std::list &groupInfo); bool getMsgSummary(const uint32_t &token, MsgMetaResult &msgInfo); /* Specific Service Data */ bool getAlbum(const uint32_t &token, std::vector &albums); bool getPhoto(const uint32_t &token, PhotoResult &photos); bool getPhotoComment(const uint32_t &token, PhotoCommentResult &comments); bool getPhotoRelatedComment(const uint32_t &token, PhotoRelatedCommentResult &comments); public: /** Modifications **/ /*! * submits album, which returns a token that needs * to be acknowledge to get album grp id * @param token token to redeem for acknowledgement * @param album album to be submitted */ bool submitAlbumDetails(uint32_t& token, RsPhotoAlbum &album); /*! * submits photo, which returns a token that needs * to be acknowledge to get photo msg-grp id pair * @param token token to redeem for acknowledgement * @param photo photo to be submitted */ bool submitPhoto(uint32_t& token, RsPhotoPhoto &photo); /*! * submits photo comment, which returns a token that needs * to be acknowledged to get photo msg-grp id pair * The mParentId needs to be set to an existing msg for which * commenting is enabled * @param token token to redeem for acknowledgement * @param comment comment to be submitted */ bool submitComment(uint32_t& token, RsPhotoComment &photo); /*! * subscribes to group, and returns token which can be used * to be acknowledged to get group Id * @param token token to redeem for acknowledgement * @param grpId the id of the group to subscribe to */ bool subscribeToAlbum(uint32_t& token, const RsGxsGroupId& grpId, bool subscribe); /*! * This allows the client service to acknowledge that their msgs has * been created/modified and retrieve the create/modified msg ids * @param token the token related to modification/create request * @param msgIds map of grpid->msgIds of message created/modified * @return true if token exists false otherwise */ bool acknowledgeMsg(const uint32_t& token, std::pair& msgId); /*! * This allows the client service to acknowledge that their grps has * been created/modified and retrieve the create/modified grp ids * @param token the token related to modification/create request * @param msgIds vector of ids of groups created/modified * @return true if token exists false otherwise */ bool acknowledgeGrp(const uint32_t& token, RsGxsGroupId& grpId); private: std::vector mGroupChange; std::vector mMsgChange; RsMutex mPhotoMutex; }; #endif // P3PHOTOSERVICEV2_H