Return to ProviderManagerService.h CVS log

Up to [Pegasus] / pegasus / src / Pegasus / ProviderManager

BUG#: 2196
TITLE: Copyright update

DESCRIPTION: Update all .cpp and .h files for new license and
update the doc/license.txt file.  Note that there were also
a couple of files that had to be fixed because they had violated
the comments rules (ex. blank line at head of file or in the case of
xmlwriter.cpp a comment line //=========  which drove the strip
function nuts.  These were fixed.  This has been compiled and tested
on windows.

//%2004////////////////////////////////////////////////////////////////////////
//
// Copyright (c) 2000, 2001, 2002 BMC Software; Hewlett-Packard Development
// Company, L.P.; IBM Corp.; The Open Group; Tivoli Systems.
// Copyright (c) 2003 BMC Software; Hewlett-Packard Development Company, L.P.;
// IBM Corp.; EMC Corporation, The Open Group.
// Copyright (c) 2004 BMC Software; Hewlett-Packard Development Company, L.P.;
// IBM Corp.; EMC Corporation; VERITAS Software Corporation; The Open Group.
//
// Permission is hereby granted, free of charge, to any person obtaining a copy
// of this software and associated documentation files (the "Software"), to
// deal in the Software without restriction, including without limitation the
// rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
// sell copies of the Software, and to permit persons to whom the Software is
// furnished to do so, subject to the following conditions:
// 
// THE ABOVE COPYRIGHT NOTICE AND THIS PERMISSION NOTICE SHALL BE INCLUDED IN
// ALL COPIES OR SUBSTANTIAL PORTIONS OF THE SOFTWARE. THE SOFTWARE IS PROVIDED
// "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT
// LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
// PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
// ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
// WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
//
//==============================================================================
//
// Author: Chip Vincent (cvincent@us.ibm.com)
//
// Modified By:
//              Nag Boranna, Hewlett-Packard Company(nagaraja_boranna@hp.com)
//              Yi Zhou, Hewlett-Packard Company(yi_zhou@hp.com)
//              Jenny Yu, Hewlett-Packard Company (jenny_yu@hp.com)
//              Nitin Upasani, Hewlett-Packard Company (Nitin_Upasani@hp.com)
//              Carol Ann Krug Graves, Hewlett-Packard Company
//                (carolann_graves@hp.com)
//              Mike Day, IBM (mdday@us.ibm.com)
//              Amit K Arora (amita@in.ibm.com) for PEP-101
//
//%/////////////////////////////////////////////////////////////////////////////

#ifndef Pegasus_ProviderManagerService_h
#define Pegasus_ProviderManagerService_h

#include <Pegasus/Common/Config.h>
#include <Pegasus/Common/MessageQueueService.h>
#include <Pegasus/Common/CIMObjectPath.h>
#include <Pegasus/Common/Pair.h>
#include <Pegasus/Common/Triad.h>
#include <Pegasus/Common/Thread.h>
#include <Pegasus/Common/AutoPtr.h>

#include <Pegasus/ProviderManager/SafeQueue.h>
#include <Pegasus/Server/Linkage.h>
#include <Pegasus/ProviderManager/OperationResponseHandler.h>
#include <Pegasus/Common/HashTable.h>
#include <Pegasus/ProviderManager/Provider.h>
#include <Pegasus/Common/Constants.h>
PEGASUS_NAMESPACE_BEGIN


typedef HashTable<String, 
		  EnableIndicationsResponseHandler *,
		  EqualFunc<String>, 
		  HashFunc<String> > IndicationResponseTable;

class ProviderRegistrationManager;

class PEGASUS_SERVER_LINKAGE ProviderManagerService : public MessageQueueService
{
public:
    ProviderManagerService(ProviderRegistrationManager * providerRegistrationManager);
    virtual ~ProviderManagerService(void);
    static ProviderManager *getProviderManager(void);
    
    
protected:
    virtual Boolean messageOK(const Message * message);
    virtual void handleEnqueue(void);
    virtual void handleEnqueue(Message * message);

    virtual void _handle_async_request(AsyncRequest * request);

protected:
    virtual Triad<String, String, String> 
      _lookupConsumerProvider(const String & destinationPath);
 
    virtual Triad<String, String, String>
        _lookupProviderForClass(const CIMObjectPath & objectPath);

    virtual Triad<String, String, String> _lookupMethodProviderForClass(
	const CIMObjectPath & objectPath,
	const CIMName & methodName);

    virtual void _lookupProviderForAssocClass(
        const CIMNamespaceName& nameSpace,
        const CIMName& assocClassName,
        Array<String>& Locations,
        Array<String>& providerNames,
        Array<String>& interfaceNames);

protected:
    //static PEGASUS_THREAD_RETURN PEGASUS_THREAD_CDECL handleServiceOperation(void * arg) throw();

    //void handleStartService();
    //void handleStopService();
    //void handlePauseService();
    //void handleResumeService();

    static PEGASUS_THREAD_RETURN PEGASUS_THREAD_CDECL handleCimOperation(void * arg) throw();

    //void handleGetClassRequest(const Message * message) throw();
    //void handleEnumerateClassesRequest(const Message * message) throw();
    //void handleEnumerateClassNamesRequest(const Message * message) throw();
    //void handleCreateClassRequest(const Message * message) throw();
    //void handleModifyClassRequest(const Message * message) throw();
    //void handleDeleteClassRequest(const Message * message) throw();

    void handleGetInstanceRequest(AsyncOpNode *op, const Message *message) throw();
    void handleEnumerateInstancesRequest(AsyncOpNode *op, const Message *message) throw();
    void handleEnumerateInstanceNamesRequest(AsyncOpNode *op, const Message *message) throw();
    void handleCreateInstanceRequest(AsyncOpNode *op, const Message *message) throw();
    void handleModifyInstanceRequest(AsyncOpNode *op, const Message *message) throw();
    void handleDeleteInstanceRequest(AsyncOpNode *op, const Message *message) throw();

    void handleExecuteQueryRequest(AsyncOpNode *op, const Message *message) throw();

    void handleAssociatorsRequest(AsyncOpNode *op, const Message *message) throw();
    void handleAssociatorNamesRequest(AsyncOpNode *op, const Message *message) throw();
    void handleReferencesRequest(AsyncOpNode *op, const Message *message) throw();
    void handleReferenceNamesRequest(AsyncOpNode *op, const Message *message) throw();

    void handleGetPropertyRequest(AsyncOpNode *op, const Message *message) throw();
    void handleSetPropertyRequest(AsyncOpNode *op, const Message *message) throw();

    void handleInvokeMethodRequest(AsyncOpNode *op, const Message *message) throw();

    void handleCreateSubscriptionRequest(AsyncOpNode *op, const Message *message) throw();
    void handleModifySubscriptionRequest(AsyncOpNode *op, const Message *message) throw();
    void handleDeleteSubscriptionRequest(AsyncOpNode *op, const Message *message) throw();
    void handleEnableIndicationsRequest(AsyncOpNode *op, const Message *message) throw();
    void handleDisableIndicationsRequest(AsyncOpNode *op, const Message *message) throw();

    void handleDisableModuleRequest(AsyncOpNode *op, const Message *message) throw();
    void handleEnableModuleRequest(AsyncOpNode *op, const Message *message) throw();
    void handleStopAllProvidersRequest(AsyncOpNode *op, const Message *message) throw();
    void handleExportIndicationRequest(AsyncOpNode *op, 
					const Message *message) throw();
    

    /**
        Inserts an entry into the enabled indication providers table.

        @param   provider              the provider instance
        @param   handler               pointer to the indication response handler
    */

      void _insertEntry(
	 const Provider & provider,
	 const EnableIndicationsResponseHandler *handler);

    /**
        Generates a String key from by combining the provider and provider
	module names.

        @param   provider              the provider instance

	@return  the generated key
     */


      void _removeEntry(const String & key);
      
      

      String _generateKey (
	 const Provider & provider);

    /**
        Generates a String key by combining the provider name and provider
	file name.

        @param   providerName       the name of the provider 
        @param   providerFileName   the provider file name 

	@return  the generated key
    */
    String _generateKey (const String & providerName,
			 const String & providerFileName);

      
protected:

    SafeQueue<AsyncOpNode *> _incomingQueue;
    //SafeQueue<Message *> _outgoingQueue;

    AutoPtr<ProviderRegistrationManager> _providerRegistrationManager;
    /** Table holding indication response handlers, one for each provider
	that has indications enabled.
    */
    
    IndicationResponseTable _responseTable;
    
};


PEGASUS_NAMESPACE_END

#endif