clay.h

/*
-----------------------------------------------------------------------------
This source file is part of "clay" library.
It is licensed under the terms of the MIT license.
For the latest info, see http://libclay.sourceforge.net

Copyright (c) 2010-2013 Lin Jia Jun (Joe Lam)

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.
-----------------------------------------------------------------------------
*/

#ifndef __CLAY_H_INCLUDED__
#define __CLAY_H_INCLUDED__

#define CLAY_SVC_FUNC(func) (clay::core::CLAY_SVC_CLASS_FUNC)(&func)

#include <map>
#include <string>

namespace clay
{

namespace core
{

class ClayServiceProvider;

typedef int (*CLAY_SVC_STATIC_FUNC)(void*);

typedef int (ClayServiceProvider::*CLAY_SVC_CLASS_FUNC)(void*);

typedef std::map<int, CLAY_SVC_CLASS_FUNC> ClayServiceIntMap;
typedef std::map<std::string, CLAY_SVC_CLASS_FUNC> ClayServiceStrMap;

typedef std::map<int, ClayServiceProvider*> ClayServiceProviderIntMap;
typedef std::map<std::string, ClayServiceProvider*> ClayServiceProviderStrMap;

class ClayServiceProvider
{
protected:

    int m_code;

    std::string m_name;

    ClayServiceIntMap m_svcintmap;

    ClayServiceStrMap m_svcstrmap;

    void ClearServices();

    int RegisterService(int iSvcCode, CLAY_SVC_CLASS_FUNC pSvcFunc);

    int RegisterService(const std::string& sSvcName, CLAY_SVC_CLASS_FUNC pSvcFunc);

    int UnregisterService(int iSvcCode);

    int UnregisterService(const std::string& sSvcName);

    int GetServiceCount();

    virtual void SetupServices();

    int GetVersion(void* pParam);

public:

    int GetCode();

    std::string GetName();

    bool ServiceExists(int iSvcCode);

    bool ServiceExists(const std::string& sSvcName);

    CLAY_SVC_CLASS_FUNC GetService(int iSvcCode);

    CLAY_SVC_CLASS_FUNC GetService(const std::string& sSvcName);

    virtual int DoService(int iSvcCode, void* pParam);

    virtual int DoService(const std::string& sSvcName, void* pParam);

    explicit ClayServiceProvider(int iCode);

    explicit ClayServiceProvider(const std::string& sName);

    ClayServiceProvider(int iCode, const std::string& sName);

    virtual ~ClayServiceProvider();

};

class ClayServiceAgent
{

private:

    ClayServiceProviderIntMap  m_spintmap;
    ClayServiceProviderStrMap  m_spstrmap;

    ClayServiceAgent* m_external;

public:

    ClayServiceAgent();
    ~ClayServiceAgent();

    int RegSp(ClayServiceProvider* pServiceProvider);

    int UnregSp(int iSpCode);

    int UnregSp(const std::string& sSpName);

    ClayServiceProvider* GetSp(int iSpCode);

    ClayServiceProvider* GetSp(const std::string& sSpName);

    int GetSpCount();

    int CallService(int iSpCode, int iSvcCode, void* pParam);

    int CallService(int iSpCode, const std::string& sSvcName, void* pParam);

    int CallService(const std::string& sSpName, int iSvcCode, void* pParam);

    int CallService(const std::string& sSpName, const std::string& sSvcName, void* pParam);

    bool SpExists(int iSpCode);

    bool SpExists(const std::string& sSpName);

    bool SvcExists(int iSpCode, int iSvcCode);

    bool SvcExists(int iSpCode, const std::string& sSvcName);

    bool SvcExists(const std::string& sSpName, int iSvcCode);

    bool SvcExists(const std::string& sSpName, const std::string& sSvcName);

    void Clear();

    void SetExternalAgent(ClayServiceAgent* pAgent);

    static ClayServiceAgent* GetAgent()
    {
        // Meyer's Singleton ...
        static ClayServiceAgent instance;

        ClayServiceAgent* pAgent = instance.m_external;

        if(pAgent != NULL) return pAgent;
        else return &instance;
    }


};


} // end of clay::core


namespace lib
{

std::string GetTimeStr();

void Log(const char* sMsg);

clay::core::ClayServiceAgent* GetAgent();

void SetAgent(void* pAgent);

int RegisterSp(clay::core::ClayServiceProvider* pServiceProvider);

int GetSpCount();

clay::core::ClayServiceProvider* GetProvider(int iSpCode);

clay::core::ClayServiceProvider* GetProvider(const std::string& sSpName);

bool ProviderExists(int iSpCode);

bool ProviderExists(const std::string& sSpName);

bool ServiceExists(int iSpCode, int iSvcCode);

bool ServiceExists(int iSpCode, const std::string& sSvcName);

bool ServiceExists(const std::string& sSpName, int iSvcCode);

bool ServiceExists(const std::string& sSpName, const std::string& sSvcName);

int CallService(int iSpCode, int iSvcCode, void* pParam = NULL);

int CallService(int iSpCode, const std::string& sSvcName, void* pParam = NULL);

int CallService(const std::string& sSpName, int iSvcCode, void* pParam = NULL);

int CallService(const std::string& sSpName, const std::string& sSvcName, void* pParam = NULL);

void Clear();

} // end of clay::lib

} // end of clay


#endif // __CLAY_H_INCLUDED__