/** * @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 SLM Server DB: // * implement the Marketplace API // * 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_SUCCESS = 200, SLM_RECORD_CREATED = 201, SLM_MALFORMED_PAYLOAD = 400, 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; }; // Notes: // * The mListingFolderId is used as a key to this map. It could therefore be taken off the LLMarketplaceTuple objects themselves. // * The SLM DB however uses mListingId as its primary key and it shows in its API. In the viewer though, the mListingFolderId is what we use to grab an inventory record. typedef std::map marketplace_items_list_t; // Session cache of all Marketplace tuples // Notes: // * There's one and only one possible set of Marketplace dataset per agent and per session thus making it an LLSingleton // * Some of those records might correspond to folders that do not exist in the inventory anymore. We do not clear them out though. They just won't show up in the UI. class LLSLMGetMerchantResponder; class LLSLMGetListingsResponder; class LLSLMCreateListingsResponder; class LLSLMGetListingResponder; class LLSLMUpdateListingsResponder; class LLSLMAssociateListingsResponder; class LLSLMDeleteListingsResponder; class LLMarketplaceData : public LLSingleton { public: friend class LLSLMGetMerchantResponder; friend class LLSLMGetListingsResponder; friend class LLSLMCreateListingsResponder; friend class LLSLMGetListingResponder; friend class LLSLMUpdateListingsResponder; friend class LLSLMAssociateListingsResponder; friend class LLSLMDeleteListingsResponder; LLMarketplaceData(); virtual ~LLMarketplaceData(); // Public SLM API : Initialization and status typedef boost::signals2::signal status_updated_signal_t; void initializeSLM(const status_updated_signal_t::slot_type& cb); U32 getSLMStatus() const { return mMarketPlaceStatus; } void getSLMListings(); bool isEmpty() { return (mMarketplaceItems.size() == 0); } // High level create/delete/set Marketplace data: 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 clearListing(const LLUUID& folder_id); bool setVersionFolder(const LLUUID& folder_id, const LLUUID& version_id); bool associateListing(const LLUUID& folder_id, const LLUUID& source_folder_id, S32 listing_id); bool getListing(const LLUUID& folder_id); // Probe the Marketplace data set to identify folders bool isListed(const LLUUID& folder_id); // returns true if folder_id is a Listing folder bool isListedAndActive(const LLUUID& folder_id); // returns true if folder_id is an active (listed) Listing folder bool isVersionFolder(const LLUUID& folder_id); // returns true if folder_id is a Version folder bool isInActiveFolder(const LLUUID& obj_id); // returns true if the obj_id is buried in an active version folder LLUUID getActiveFolder(const LLUUID& obj_id); // returns the UUID of the active version folder obj_id is in bool isUpdating(const LLUUID& folder_id); // returns true if we're waiting from SLM incoming data for folder_id // Access Marketplace data set : each method returns a default value if the argument can't be found bool getActivationState(const LLUUID& folder_id); S32 getListingID(const LLUUID& folder_id); LLUUID getVersionFolder(const LLUUID& folder_id); std::string getListingURL(const LLUUID& folder_id); LLUUID getListingFolder(S32 listing_id); // Used to flag if stock count values for Marketplace have to be updated bool checkDirtyCount() { if (mDirtyCount) { mDirtyCount = false; return true; } else { return false; } } void setDirtyCount() { mDirtyCount = true; } void setUpdating(const LLUUID& folder_id, bool isUpdating); private: // Modify Marketplace data set : each method returns true if the function succeeds, false if error // Used internally only by SLM Responders when data are received from the SLM Server bool addListing(const LLUUID& folder_id, S32 listing_id, const LLUUID& version_id, bool is_listed); bool deleteListing(const LLUUID& folder_id, bool update_slm = true); bool setListingID(const LLUUID& folder_id, S32 listing_id); bool setVersionFolderID(const LLUUID& folder_id, const LLUUID& version_id); bool setActivationState(const LLUUID& folder_id, bool activate); bool setListingURL(const LLUUID& folder_id, const std::string& edit_url); // Private SLM API : package data and get/post/put requests to the SLM Server through the SLM API void setSLMStatus(U32 status); void createSLMListing(const LLUUID& folder_id); void getSLMListing(S32 listing_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); void deleteSLMListing(S32 listing_id); 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 need to be updated at the next check // Update data std::set mPendingUpdateSet; // The cache of SLM data (at last...) marketplace_items_list_t mMarketplaceItems; }; #endif // LL_LLMARKETPLACEFUNCTIONS_H