/** * @file llservice.h * @author Phoenix * @date 2004-11-21 * @brief Declaration file for LLService and related classes. * * $LicenseInfo:firstyear=2004&license=viewergpl$ * * Copyright (c) 2004-2009, Linden Research, Inc. * * Second Life Viewer Source Code * The source code in this file ("Source Code") is provided by Linden Lab * to you under the terms of the GNU General Public License, version 2.0 * ("GPL"), unless you have obtained a separate licensing agreement * ("Other License"), formally executed by you and Linden Lab. Terms of * the GPL can be found in doc/GPL-license.txt in this distribution, or * online at http://secondlifegrid.net/programs/open_source/licensing/gplv2 * * There are special exceptions to the terms and conditions of the GPL as * it is applied to this Source Code. View the full text of the exception * in the file doc/FLOSS-exception.txt in this software distribution, or * online at * http://secondlifegrid.net/programs/open_source/licensing/flossexception * * By copying, modifying or distributing this software, you acknowledge * that you have read and understood your obligations described above, * and agree to abide by those obligations. * * ALL LINDEN LAB SOURCE CODE IS PROVIDED "AS IS." LINDEN LAB MAKES NO * WARRANTIES, EXPRESS, IMPLIED OR OTHERWISE, REGARDING ITS ACCURACY, * COMPLETENESS OR PERFORMANCE. * $/LicenseInfo$ */ #ifndef LL_LLSERVICE_H #define LL_LLSERVICE_H #include <string> #include <map> //#include <boost/intrusive_ptr.hpp> //#include <boost/shared_ptr.hpp> //#include "llframetimer.h" #include "lliopipe.h" #include "llchainio.h" #if 0 class LLServiceCreator; /** * intrusive pointer support */ namespace boost { void intrusive_ptr_add_ref(LLServiceCreator* p); void intrusive_ptr_release(LLServiceCreator* p); }; #endif /** * @class LLServiceCreator * @brief This class is an abstract base class for classes which create * new <code>LLService</code> instances. * * Derive classes from this class which appropriately implement the * <code>operator()</code> and destructor. * @see LLService */ #if 0 class LLServiceCreator { public: typedef boost::intrusive_ptr<LLService> service_t; virtual ~LLServiceCreator() {} virtual service_t activate() = 0; virtual void discard() = 0; protected: LLServiceCreator() : mReferenceCount(0) { } private: friend void boost::intrusive_ptr_add_ref(LLServiceCreator* p); friend void boost::intrusive_ptr_release(LLServiceCreator* p); U32 mReferenceCount; }; #endif #if 0 namespace boost { inline void intrusive_ptr_add_ref(LLServiceCreator* p) { ++p->mReferenceCount; } inline void intrusive_ptr_release(LLServiceCreator* p) { if(p && 0 == --p->mReferenceCount) { delete p; } } }; #endif /** * @class LLService * @brief This class is the base class for the service classes. * @see LLIOPipe * * The services map a string to a chain factory with a known interface * at the front of the chain. So, to activate a service, call * <code>activate()</code> with the name of the service needed which * will call the associated factory, and return a pointer to the * known interface. * <b>NOTE:</b> If you are implementing a service factory, it is * vitally important that the service pipe is at the front of the * chain. */ class LLService : public LLIOPipe { public: //typedef boost::intrusive_ptr<LLServiceCreator> creator_t; //typedef boost::intrusive_ptr<LLService> service_t; typedef boost::shared_ptr<LLChainIOFactory> creator_t; /** * @brief This method is used to register a protocol name with a * a functor that creates the service. * * THOROUGH_DESCRIPTION * @param aParameter A brief description of aParameter. * @return Returns true if a service was successfully registered. */ static bool registerCreator(const std::string& name, creator_t fn); /** * @brief This method connects to a service by name. * * @param name The name of the service to connect to. * @param chain The constructed chain including the service instance. * @param context Context for the activation. * @return An instance of the service for use or NULL on failure. */ static LLIOPipe* activate( const std::string& name, LLPumpIO::chain_t& chain, LLSD context); /** * @brief * * @param name The name of the service to discard. * @return true if service creator was found and discarded. */ static bool discard(const std::string& name); protected: // The creation factory static data. typedef std::map<std::string, creator_t> creators_t; static creators_t sCreatorFunctors; protected: // construction & destruction. since this class is an abstract // base class, it is up to Service implementations to actually // deal with construction and not a public method. How that // construction takes place will be handled by the service // creators. LLService(); virtual ~LLService(); protected: // This frame timer records how long this service has // existed. Useful for derived services to give themselves a // lifetime and expiration. // *NOTE: Phoenix - This functionaity has been moved to the // pump. 2005-12-13 //LLFrameTimer mTimer; // Since services are designed in an 'ask now, respond later' // idiom which probably crosses thread boundaries, almost all // services will need a handle to a response pipe. It will usually // be the job of the service author to derive a useful // implementation of response, and up to the service subscriber to // further derive that class to do something useful when the // response comes in. LLIOPipe::ptr_t mResponse; }; #endif // LL_LLSERVICE_H