com.hp.ucmdb.api

Class UcmdbServiceFactory

java.lang.Object

com.hp.ucmdb.api.UcmdbServiceFactory

public class UcmdbServiceFactory
extends Object

Entry point for UCMDB API services.
To obtain a reference to the UCMDB:
1) Get a reference to UcmdbServiceProvider by calling one of the getServiceProvider methods.
2) Call one of the UcmdbServiceProvider connect methods.

Example:

 final String HOST_NAME = "localhost";
 final int PORT = 8080;
 UcmdbServiceProvider provider = UcmdbServiceFactory.getServiceProvider(HOST_NAME, PORT);
 final String USERNAME = "integration_user";
 final String PASSWORD = "integration_password";
 Credentials credentials = provider.createCredentials(USERNAME, PASSWORD),
 ClientContext clientContext = provider.createClientContext("Example");
 UcmdbService ucmdbService = provider.connect(credentials, clientContext);
 

See Also:

UcmdbServiceProvider

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	UcmdbServiceFactory.AllHostAcceptedVerifier Disables host name verfication (used in case of NAT networks)
static interface	UcmdbServiceFactory.ConnectionProperties Internal implementation.
static class	UcmdbServiceFactory.DefaultTruststoreManger The X509TrustManager implementation.
static interface	UcmdbServiceFactory.HttpBootstrap Internal implementation.
static interface	UcmdbServiceFactory.HttpUcmdbServiceProviderFactory Internal implementation.

Method Summary

Modifier and Type	Method and Description
static String	getClientVersion()
static UcmdbServiceProvider	getServiceProvider(String host, int port) Returns an instance of a UCMDB service provider from the specified host and port.
static UcmdbServiceProvider	getServiceProvider(String protocol, String host, int port)
static UcmdbServiceProvider	getServiceProvider(String protocol, String host, int port, String rootContext) Returns an instance of a UCMDB service provider from the specified host port using the specified protocol.
static void	initSSL() Initializes the secure socket layer.

Methods inherited from class java.lang.Object

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

Method Detail

getClientVersion

public static String getClientVersion()

getServiceProvider

public static UcmdbServiceProvider getServiceProvider(String host,
                                                      int port)
                                               throws MalformedURLException,
                                                      IncompatibleVersionException

Returns an instance of a UCMDB service provider from the specified host and port. The connection is made using HTTP.

Parameters:

host - name of the web server host.

port - port the web server listens on. Generally 80 or 8080.

Returns:

an instance of the service provider.

Throws:

MalformedURLException - if the host name results in an invalid URL.

IncompatibleVersionException - if the version of the client is unsupported by the version running on the server.

getServiceProvider

public static UcmdbServiceProvider getServiceProvider(String protocol,
                                                      String host,
                                                      int port,
                                                      String rootContext)
                                               throws MalformedURLException,
                                                      IncompatibleVersionException

Returns an instance of a UCMDB service provider from the specified host port using the specified protocol.

Parameters:

protocol - either "http" or "https".

host - name of the web server host.

port - port the web server listens on. Generally 80 or 8080 for http, 443 for https.

Returns:

an instance of the service provider.

Throws:

MalformedURLException - if the host name results in an invalid URL.

IncompatibleVersionException - if the version of the client is unsupported by the version running on the server.

getServiceProvider

public static UcmdbServiceProvider getServiceProvider(String protocol,
                                                      String host,
                                                      int port)
                                               throws MalformedURLException,
                                                      IncompatibleVersionException

Throws:

MalformedURLException

IncompatibleVersionException

initSSL

public static void initSSL()

Initializes the secure socket layer.