From 38d6d37f2d982fa959e9e8a4a3f7e1ccfad7b5d4 Mon Sep 17 00:00:00 2001 From: Jacek Antonelli Date: Fri, 15 Aug 2008 23:44:46 -0500 Subject: Second Life viewer sources 1.13.2.12 --- linden/indra/llmessage/llservice.h | 186 +++++++++++++++++++++++++++++++++++++ 1 file changed, 186 insertions(+) create mode 100644 linden/indra/llmessage/llservice.h (limited to 'linden/indra/llmessage/llservice.h') diff --git a/linden/indra/llmessage/llservice.h b/linden/indra/llmessage/llservice.h new file mode 100644 index 0000000..3866dbc --- /dev/null +++ b/linden/indra/llmessage/llservice.h @@ -0,0 +1,186 @@ +/** + * @file llservice.h + * @author Phoenix + * @date 2004-11-21 + * @brief Declaration file for LLService and related classes. + * + * Copyright (c) 2004-2007, Linden Research, Inc. + * + * 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://secondlife.com/developers/opensource/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://secondlife.com/developers/opensource/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. + */ + +#ifndef LL_LLSERVICE_H +#define LL_LLSERVICE_H + +#include +#include +//#include +//#include + +//#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 LLService instances. + * + * Derive classes from this class which appropriately implement the + * operator() and destructor. + * @see LLService + */ +#if 0 +class LLServiceCreator +{ +public: + typedef boost::intrusive_ptr 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(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 + * activate() with the name of the service needed which + * will call the associated factory, and return a pointer to the + * known interface. + * NOTE: 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 creator_t; + //typedef boost::intrusive_ptr service_t; + typedef boost::shared_ptr 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 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 -- cgit v1.1