APIServer Class Reference

Handles queries from external clients for many kinds of returned xml structures according to CCP's API plus extensions for EVEmu. More...

#include "APIServer.h"

Inheritance diagram for APIServer:

Collaboration diagram for APIServer:

Classes
class	Lock

Public Member Functions
	APIServer ()
void	Run ()
void	Stop ()
void	CreateServices (const PyServiceMgr &services)
std::string &	url ()
std::tr1::shared_ptr < std::vector< char > >	GetXML (const APICommandCall *pAPICommandCall)
Public Member Functions inherited from Singleton< APIServer >
	Singleton ()
	Primary constructor. More...

Static Public Attributes
static const char *const	FallbackURL = "http://api.eveonline.com/"

Private Member Functions
void	RunInternal ()

Private Attributes
std::unique_ptr < boost::asio::detail::thread >	_ioThread
std::unique_ptr < boost::asio::io_context >	_io
std::unique_ptr < APIServerListener >	_listener
std::string	_url
std::string	_basePath
boost::asio::detail::mutex	_limboLock
bool	runonce
std::tr1::shared_ptr< std::string >	m_xmlString
std::map< std::string, APIServiceManager * >	m_APIServiceManagers

Additional Inherited Members
Static Public Member Functions inherited from Singleton< APIServer >
static APIServer &	get ()
Static Protected Attributes inherited from Singleton< APIServer >
static std::shared_ptr< APIServer >	mInstance

Detailed Description

Handles queries from external clients for many kinds of returned xml structures according to CCP's API plus extensions for EVEmu.

A very limited HTTP server that can efficiently deliver many different xml structured documents to clients Uses asio for efficient asynchronous network communication

Author

Aknor Jaden

Date

July 2011

Definition at line 44 of file APIServer.h.

Constructor & Destructor Documentation

APIServer::APIServer

(

)

Definition at line 41 of file APIServer.cpp.

References _url, runonce, and sConfig.

{
    runonce = false;
    std::stringstream urlBuilder;
    urlBuilder << "http://" << sConfig.net.apiServer << ":" << (sConfig.net.apiServerPort) << "/";
    _url = urlBuilder.str();
}

Member Function Documentation

void APIServer::CreateServices

(

const PyServiceMgr &

services

)

Definition at line 49 of file APIServer.cpp.

References m_APIServiceManagers, and runonce.

{
    if( !runonce )
    {
        m_APIServiceManagers.insert(std::make_pair("base", new APIServiceManager(services)));
        m_APIServiceManagers.insert(std::make_pair("account", new APIAccountManager(services)));
        m_APIServiceManagers.insert(std::make_pair("admin", new APIAdminManager(services)));
        m_APIServiceManagers.insert(std::make_pair("char", new APICharacterManager(services)));
        m_APIServiceManagers.insert(std::make_pair("corp", new APICorporationManager(services)));
        m_APIServiceManagers.insert(std::make_pair("eve", new APIEveSystemManager(services)));
        m_APIServiceManagers.insert(std::make_pair("map", new APIMapManager(services)));
        m_APIServiceManagers.insert(std::make_pair("object", new APIActiveObjectManager(services)));
        m_APIServiceManagers.insert(std::make_pair("server", new APIServerManager(services)));
    }

    runonce = true;
}

std::tr1::shared_ptr< std::vector< char > > APIServer::GetXML

(

const APICommandCall *

pAPICommandCall

)

Definition at line 67 of file APIServer.cpp.

References m_APIServiceManagers, m_xmlString, and sLog.

{
    //if( m_APIServiceManagers.find(pAPICommandCall->at(0).first) != m_APIServiceManagers.end() )
    if( pAPICommandCall->find( "service" ) == pAPICommandCall->end() )
    {
        sLog.Error( "APIserver::GetXML()", "Cannot find 'service' specifier in pAPICommandCall packet" );
        return std::tr1::shared_ptr<std::vector<char> >(new std::vector<char>() );
        //return std::tr1::shared_ptr<std::string>(new std::string(""));
    }

    if( m_APIServiceManagers.find(pAPICommandCall->find( "service" )->second) != m_APIServiceManagers.end() )
    {
        // Get reference to service manager object and call ProcessCall() with the pAPICommandCall packet
        //m_xmlString = m_APIServiceManagers.find("base")->second->ProcessCall(pAPICommandCall);
        m_xmlString = m_APIServiceManagers.find( pAPICommandCall->find( "service" )->second )->second->ProcessCall( pAPICommandCall );

        // Convert the std::string to the std::vector<char>:
        std::tr1::shared_ptr<std::vector<char> > ret = std::tr1::shared_ptr<std::vector<char> >(new std::vector<char>());
        unsigned long len = m_xmlString->length();
        for(size_t i=0; i<m_xmlString->length(); i++)
            ret->push_back(m_xmlString->at(i));

        return ret;
    }
    else
    {
        // Service call not found, so return NULL:
        return std::tr1::shared_ptr<std::vector<char> >(new std::vector<char>() );
        //return NULL;
        //m_xmlString = m_APIServiceManagers.find("base")->second->ProcessCall(pAPICommandCall);
    }
}

void APIServer::Run

(

)

Definition at line 105 of file APIServer.cpp.

References _ioThread, and RunInternal().

{
    _ioThread = std::unique_ptr<boost::asio::detail::thread>(new boost::asio::detail::thread(std::bind(&APIServer::RunInternal, this)));
}

Here is the call graph for this function:

void APIServer::RunInternal ( )

private

Definition at line 116 of file APIServer.cpp.

References _io, and _listener.

Referenced by Run().

{
    _io = std::unique_ptr<boost::asio::io_context>(new boost::asio::io_context());
    _listener = std::unique_ptr<APIServerListener>(new APIServerListener(*_io));
    _io->run();
}

Here is the caller graph for this function:

void APIServer::Stop

(

)

Definition at line 110 of file APIServer.cpp.

References _io, and _ioThread.

{
    _io->stop();
    _ioThread->join();
}

std::string & APIServer::url

(

)

Definition at line 100 of file APIServer.cpp.

References _url.

{
    return _url;
}

Member Data Documentation

std::string APIServer::_basePath

private

Definition at line 67 of file APIServer.h.

std::unique_ptr<boost::asio::io_context> APIServer::_io

private

Definition at line 64 of file APIServer.h.

Referenced by RunInternal(), and Stop().

std::unique_ptr<boost::asio::detail::thread> APIServer::_ioThread

private

Definition at line 63 of file APIServer.h.

Referenced by Run(), and Stop().

boost::asio::detail::mutex APIServer::_limboLock

private

Definition at line 68 of file APIServer.h.

std::unique_ptr<APIServerListener> APIServer::_listener

private

Definition at line 65 of file APIServer.h.

Referenced by RunInternal().

std::string APIServer::_url

private

Definition at line 66 of file APIServer.h.

Referenced by APIServer(), and url().

const char *const APIServer::FallbackURL = "http://api.eveonline.com/"

static

Definition at line 58 of file APIServer.h.

Referenced by APIServerConnection::RedirectLocation().

std::map<std::string, APIServiceManager *> APIServer::m_APIServiceManagers

private

Definition at line 73 of file APIServer.h.

Referenced by CreateServices(), and GetXML().

std::tr1::shared_ptr<std::string> APIServer::m_xmlString

private

Definition at line 71 of file APIServer.h.

Referenced by GetXML().

bool APIServer::runonce

private

Definition at line 69 of file APIServer.h.

Referenced by APIServer(), and CreateServices().

---

The documentation for this class was generated from the following files:

• /backups/local/src/eve/EvEmu_Crucible/src/eve-server/apiserver/APIServer.h
• /backups/local/src/eve/EvEmu_Crucible/src/eve-server/apiserver/APIServer.cpp