/** * @file llmarketplacefunctions.h * @brief Miscellaneous marketplace-related functions and classes * class definition * * $LicenseInfo:firstyear=2001&license=viewerlgpl$ * Second Life Viewer Source Code * Copyright (C) 2011, Linden Research, Inc. * * 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; * version 2.1 of the License only. * * 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, write to the Free Software * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA * * Linden Research, Inc., 945 Battery Street, San Francisco, CA 94111 USA * $/LicenseInfo$ */ #ifndef LL_LLMARKETPLACEFUNCTIONS_H #define LL_LLMARKETPLACEFUNCTIONS_H #include #include #include #include "llsingleton.h" #include "llstring.h" LLSD getMarketplaceStringSubstitutions(); namespace MarketplaceErrorCodes { enum eCode { IMPORT_DONE = 200, IMPORT_PROCESSING = 202, IMPORT_REDIRECT = 302, IMPORT_BAD_REQUEST = 400, IMPORT_AUTHENTICATION_ERROR = 401, IMPORT_FORBIDDEN = 403, IMPORT_NOT_FOUND = 404, IMPORT_DONE_WITH_ERRORS = 409, IMPORT_JOB_FAILED = 410, IMPORT_JOB_TIMEOUT = 499, IMPORT_SERVER_SITE_DOWN = 500, IMPORT_SERVER_API_DISABLED = 503, }; } namespace MarketplaceStatusCodes { enum sCode { MARKET_PLACE_NOT_INITIALIZED = 0, MARKET_PLACE_INITIALIZING = 1, MARKET_PLACE_CONNECTION_FAILURE = 2, MARKET_PLACE_MERCHANT = 3, MARKET_PLACE_NOT_MERCHANT = 4, }; } class LLMarketplaceInventoryImporter : public LLSingleton { public: static void update(); LLMarketplaceInventoryImporter(); typedef boost::signals2::signal status_changed_signal_t; typedef boost::signals2::signal status_report_signal_t; boost::signals2::connection setInitializationErrorCallback(const status_report_signal_t::slot_type& cb); boost::signals2::connection setStatusChangedCallback(const status_changed_signal_t::slot_type& cb); boost::signals2::connection setStatusReportCallback(const status_report_signal_t::slot_type& cb); void initialize(); bool triggerImport(); bool isImportInProgress() const { return mImportInProgress; } bool isInitialized() const { return mInitialized; } U32 getMarketPlaceStatus() const { return mMarketPlaceStatus; } protected: void reinitializeAndTriggerImport(); void updateImport(); private: bool mAutoTriggerImport; bool mImportInProgress; bool mInitialized; U32 mMarketPlaceStatus; status_report_signal_t * mErrorInitSignal; status_changed_signal_t * mStatusChangedSignal; status_report_signal_t * mStatusReportSignal; }; // Classes handling the data coming from and going to the Marketplace DB: // * implement the Marketplace API (TBD) // * cache the current Marketplace data (tuples) // * provide methods to get Marketplace data on any inventory item // * set Marketplace data // * signal Marketplace updates to inventory namespace SLMErrorCodes { enum eCode { SLM_DONE = 200, SLM_NOT_FOUND = 404, }; } class LLMarketplaceData; class LLInventoryObserver; // A Marketplace item is known by its tuple class LLMarketplaceTuple { public: friend class LLMarketplaceData; LLMarketplaceTuple(); LLMarketplaceTuple(const LLUUID& folder_id); LLMarketplaceTuple(const LLUUID& folder_id, S32 listing_id, const LLUUID& version_id, bool is_listed = false); private: // Representation of a marketplace item in the Marketplace DB (well, what we know of it...) LLUUID mListingFolderId; S32 mListingId; LLUUID mVersionFolderId; bool mIsActive; std::string mEditURL; }; // Note: The listing folder UUID is used as a key to this map. It could therefore be taken off the LLMarketplaceTuple objects themselves typedef std::map marketplace_items_list_t; // Session cache of Marketplace tuples // Note: There's one and only one possible set of Marketplace dataset per agent and per session class LLMarketplaceData : public LLSingleton { public: LLMarketplaceData(); virtual ~LLMarketplaceData(); // SLM Public typedef boost::signals2::signal status_updated_signal_t; U32 getSLMStatus() const { return mMarketPlaceStatus; } void setSLMStatus(U32 status); void initializeSLM(const status_updated_signal_t::slot_type& cb); void getSLMListings(); //void getSLMListing(); void createSLMListing(const LLUUID& folder_id); void updateSLMListing(const LLUUID& folder_id, S32 listing_id, const LLUUID& version_id, bool is_listed); void associateSLMListing(const LLUUID& folder_id, S32 listing_id, const LLUUID& version_id); bool isEmpty() { return (mMarketplaceItems.size() == 0); } // Probe the Marketplace data set to identify folders bool isListed(const LLUUID& folder_id); // returns true if folder_id is a Listing folder bool isVersionFolder(const LLUUID& folder_id); // returns true if folder_id is a Version folder // Create/Delete Marketplace data set : each method returns true if the function succeeds, false if error bool createListing(const LLUUID& folder_id); bool activateListing(const LLUUID& folder_id, bool activate); bool setVersionFolder(const LLUUID& folder_id, const LLUUID& version_id); bool addListing(const LLUUID& folder_id, S32 listing_id, const LLUUID& version_id, bool is_listed); bool associateListing(const LLUUID& folder_id, S32 listing_id); bool deleteListing(const LLUUID& folder_id); // Access Marketplace data set : each method returns a default value if the folder_id can't be found bool getActivationState(const LLUUID& folder_id); S32 getListingID(const LLUUID& folder_id); LLUUID getVersionFolderID(const LLUUID& folder_id); std::string getListingURL(const LLUUID& folder_id); LLUUID getListingFolder(S32 listing_id); // Modify Marketplace data set : each method returns true if the function succeeds, false if error bool setListingID(const LLUUID& folder_id, S32 listing_id); bool setVersionFolderID(const LLUUID& folder_id, const LLUUID& version_id); bool setActivation(const LLUUID& folder_id, bool activate); bool setEditURL(const LLUUID& folder_id, const std::string& edit_url); // Used to flag if count values for Marketplace are likely to have to be updated bool checkDirtyCount() { if (mDirtyCount) { mDirtyCount = false; return true; } else { return false; } } void setDirtyCount() { mDirtyCount = true; } private: // SLM Private std::string getSLMConnectURL(const std::string& route); // Handling Marketplace connection and inventory connection U32 mMarketPlaceStatus; status_updated_signal_t * mStatusUpdatedSignal; LLInventoryObserver* mInventoryObserver; bool mDirtyCount; // If true, stock count value will be updating at the next check // The cache of SLM data (at last...) marketplace_items_list_t mMarketplaceItems; }; #endif // LL_LLMARKETPLACEFUNCTIONS_H