BESServiceRegistry.h

// BESServiceRegistry.h
 
// This file is part of bes, A C++ back-end server implementation framework
// for the OPeNDAP Data Access Protocol.
 
// Copyright (c) 2004-2009 University Corporation for Atmospheric Research
// Author: Patrick West <pwest@ucar.edu> and Jose Garcia <jgarcia@ucar.edu>
//
// This library is free software; you can redistribute it and/or
// modify it under the terms of the GNU Lesser General Public
// License as published by the Free Software Foundation; either
// version 2.1 of the License, or (at your option) any later version.
// 
// This library is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
// Lesser General Public License for more details.
// 
// You should have received a copy of the GNU Lesser General Public
// License along with this library; if not, write to the Free Software
// Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
//
// You can contact University Corporation for Atmospheric Research at
// 3080 Center Green Drive, Boulder, CO 80301
 
// (c) COPYRIGHT University Corporation for Atmospheric Research 2004-2005
// Please read the full copyright statement in the file COPYRIGHT_UCAR.
//
// Authors:
//      pwest       Patrick West <pwest@ucar.edu>
//      jgarcia     Jose Garcia <jgarcia@ucar.edu>
 
#ifndef I_BESServiceRegistry_h
#define I_BESServiceRegistry_h 1
 
#include <string>
#include <map>
#include <list>
#include <mutex>
 
#include "BESObj.h"
 
class BESInfo ;

class BESServiceRegistry : public BESObj
{
private:
    typedef struct _service_cmd
    {
        std::string _description ;
        std::map<std::string,std::string> _formats ;
    } service_cmd ;
    static BESServiceRegistry *     d_instance ;
    mutable std::recursive_mutex d_cache_lock_mutex;
 
    static void initialize_instance();
    static void delete_instance();
 
    std::map<std::string,std::map<std::string,service_cmd> >_services ;
    std::map<std::string,std::map<std::string,std::string> >    _handles ;
 
public:
    BESServiceRegistry() ;
    virtual ~BESServiceRegistry() ;
 
    virtual void        add_service( const std::string &name ) ;
    virtual void        add_to_service( const std::string &service,
                        const std::string &cmd,
                        const std::string &cmd_descript,
                        const std::string &format ) ;
    virtual void        add_format( const std::string &service,
                        const std::string &cmd,
                        const std::string &format ) ;
 
    virtual void        remove_service( const std::string &name ) ;
 
    virtual bool        service_available( const std::string &name,
                           const std::string &cmd = "",
                           const std::string &format = "" ) ;
 
    virtual void        handles_service( const std::string &handler,
                         const std::string &service ) ;
    
    virtual bool        does_handle_service( const std::string &handler,
                             const std::string &service ) ;
    virtual void        services_handled( const std::string &handler,
                        std::list<std::string> &services ) ;
 
    virtual void        show_services( BESInfo &info ) ;
 
    virtual void        dump( std::ostream &strm ) const ;
 
    static BESServiceRegistry * TheRegistry() ;
};
 
#endif // I_BESServiceRegistry_h