org.opennebula.client
Class Client

java.lang.Object
  org.opennebula.client.Client

public class Client
extends java.lang.Object

This class represents the connection with the core and handles the xml-rpc calls.

Constructor Summary

Client()
Creates a new xml-rpc client with default options: the auth.

Client(java.lang.String secret, java.lang.String endpoint)
Creates a new xml-rpc client with specified options.

Method Summary

OneResponse

call(java.lang.String action, java.lang.Object... args) Performs an XML-RPC call.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Client

public Client()
       throws ClientConfigurationException

Creates a new xml-rpc client with default options: the auth. file will be assumed to be at $ONE_AUTH, and the endpoint will be set to $ONE_XMLRPC.
It is the equivalent of Client(null, null).

Throws:

ClientConfigurationException - if the default configuration options are invalid.

Client

public Client(java.lang.String secret,
              java.lang.String endpoint)
       throws ClientConfigurationException

Creates a new xml-rpc client with specified options.

Parameters:

secret - A string containing the ONE user:password tuple. Can be null

endpoint - Where the rpc server is listening, must be something like "http://localhost:2633/RPC2". Can be null

Throws:

ClientConfigurationException - if the configuration options are invalid

Method Detail

call

public OneResponse call(java.lang.String action,
                        java.lang.Object... args)

Performs an XML-RPC call.

Parameters:

action - ONE action

args - ONE arguments

Returns:

The server's xml-rpc response encapsulated