/* -------------------------------------------------------------------------- */ /* Copyright 2002-2015, OpenNebula Project, OpenNebula Systems */ /* */ /* Licensed under the Apache License, Version 2.0 (the "License"); you may */ /* not use this file except in compliance with the License. You may obtain */ /* a copy of the License at */ /* */ /* http://www.apache.org/licenses/LICENSE-2.0 */ /* */ /* Unless required by applicable law or agreed to in writing, software */ /* distributed under the License is distributed on an "AS IS" BASIS, */ /* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. */ /* See the License for the specific language governing permissions and */ /* limitations under the License. */ /* -------------------------------------------------------------------------- */ #ifndef ONE_CLIENT_H_ #define ONE_CLIENT_H_ #include #include #include #include #include #include "NebulaLog.h" using namespace std; // ============================================================================= // Doc: // http://xmlrpc-c.sourceforge.net/doc/#clientexamplepp // http://xmlrpc-c.sourceforge.net/doc/libxmlrpc_client++.html#simple_client // ============================================================================= /** * This class represents the connection with the core and handles the * xml-rpc calls. */ class Client : public xmlrpc_c::clientSimple { public: /** * Singleton accessor */ static Client * client() { return _client; }; /** * Singleton initializer */ static Client * initialize(const string& secret, const string& endpoint, size_t message_size) { if ( _client == 0 ) { _client = new Client(secret, endpoint, message_size); } return _client; }; const string& get_oneauth() const { return one_auth; }; const string& get_endpoint() const { return one_endpoint; }; size_t get_message_size() const { return xmlrpc_limit_get(XMLRPC_XML_SIZE_LIMIT_ID); }; /** * Reads ONE_AUTH from environment or its default location at * $HOME/.one/one_auth */ static int read_oneauth(string &secret, string& error); private: /** * Creates a new xml-rpc client with specified options. * * @param secret A string containing the ONE user:password tuple. * If not set, the auth. file will be assumed to be at $ONE_AUTH * @param endpoint Where the rpc server is listening, must be something * like "http://localhost:2633/RPC2". If not set, the endpoint will be set * to $ONE_XMLRPC. * @param message_size for XML elements in the client library (in bytes) * @throws Exception if the authorization options are invalid */ Client(const string& secret, const string& endpoint, size_t message_size); string one_auth; string one_endpoint; static Client * _client; }; #endif /*ONECLIENT_H_*/