00001 /******************************************************************************* 00002 * Copyright (C) 2001-2004 Vintela, Inc. All rights reserved. 00003 * 00004 * Redistribution and use in source and binary forms, with or without 00005 * modification, are permitted provided that the following conditions are met: 00006 * 00007 * - Redistributions of source code must retain the above copyright notice, 00008 * this list of conditions and the following disclaimer. 00009 * 00010 * - Redistributions in binary form must reproduce the above copyright notice, 00011 * this list of conditions and the following disclaimer in the documentation 00012 * and/or other materials provided with the distribution. 00013 * 00014 * - Neither the name of Vintela, Inc. nor the names of its 00015 * contributors may be used to endorse or promote products derived from this 00016 * software without specific prior written permission. 00017 * 00018 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS ``AS IS'' 00019 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 00020 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 00021 * ARE DISCLAIMED. IN NO EVENT SHALL Vintela, Inc. OR THE CONTRIBUTORS 00022 * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 00023 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 00024 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 00025 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 00026 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 00027 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 00028 * POSSIBILITY OF SUCH DAMAGE. 00029 *******************************************************************************/ 00030 00036 #ifndef OW_SERVICEIFC_HPP_INCLUDE_GUARD_ 00037 #define OW_SERVICEIFC_HPP_INCLUDE_GUARD_ 00038 #include "OW_config.h" 00039 #include "OW_ServiceEnvironmentIFC.hpp" 00040 #include "OW_SharedLibraryReference.hpp" 00041 #include "OW_IntrusiveReference.hpp" 00042 #include "OW_IntrusiveCountableBase.hpp" 00043 00044 // The classes and functions defined in this file are not meant for general 00045 // use, they are internal implementation details. They may change at any time. 00046 00047 namespace OW_NAMESPACE 00048 { 00049 00050 // This class is a base interface for any services for Openwbem. 00051 class OW_COMMON_API ServiceIFC : public IntrusiveCountableBase 00052 { 00053 public: 00054 virtual ~ServiceIFC(); 00061 virtual String getName() const; 00062 00069 virtual StringArray getDependencies() const; 00070 00081 virtual StringArray getDependentServices() const; 00082 00091 virtual void init(const ServiceEnvironmentIFCRef& env) = 0; 00097 virtual void initialized(); 00098 00106 virtual void start(); 00107 00112 virtual void started(); 00113 00120 virtual void shuttingDown(); 00121 00127 virtual void shutdown() = 0; 00128 }; 00129 00130 } // end namespace OW_NAMESPACE 00131 00132 #if !defined(OW_STATIC_SERVICES) 00133 #define OW_SERVICE_FACTORY(derived, serviceName) \ 00134 extern "C" OW_EXPORT OW_NAMESPACE::ServiceIFC* \ 00135 createService() \ 00136 { \ 00137 return new derived; \ 00138 } \ 00139 extern "C" OW_EXPORT const char* \ 00140 getOWVersion() \ 00141 { \ 00142 return OW_VERSION; \ 00143 } 00144 #else 00145 #define OW_SERVICE_FACTORY(derived, serviceName) \ 00146 extern "C" OW_NAMESPACE::ServiceIFC* \ 00147 createService_##serviceName() \ 00148 { \ 00149 return new derived; \ 00150 } 00151 #endif /* !defined(OW_STATIC_SERVICES) */ 00152 00153 #endif /* OW_SERVICEIFC_HPP_INCLUDE_GUARD_ */