Package org.odpi.openmetadata.serveroperations.client

Class ServerOperationsClient

java.lang.Object

org.odpi.openmetadata.serveroperations.client.ServerOperationsClient

public class ServerOperationsClient
extends Object

ServerOperationsClient is the client for issuing queries about an OMAG Server

Field Summary

Fields

Modifier and Type	Field	Description
protected AuditLog	auditLog

Constructor Summary

Constructors

Constructor	Description
ServerOperationsClient(String platformName, String platformRootURL)	Create a new client with no authentication embedded in the HTTP request.
ServerOperationsClient(String platformName, String platformRootURL, String userId, String password)	Create a new client that passes userId and password in each HTTP request.
ServerOperationsClient(String platformName, String platformRootURL, String userId, String password, AuditLog auditLog)	Create a new client that passes userId and password in each HTTP request.
ServerOperationsClient(String platformName, String platformRootURL, AuditLog auditLog)	Create a new client with no authentication embedded in the HTTP request.

Method Summary

Modifier and Type	Method	Description
void	addOpenMetadataArchive(String userId, String serverName, Connection connection)	Add a new open metadata archive to running repository.
void	addOpenMetadataArchiveContent(String userId, String serverName, OpenMetadataArchive openMetadataArchive)	Add a new open metadata archive to running repository.
void	addOpenMetadataArchiveFile(String userId, String serverName, String fileName)	Add a new open metadata archive to running repository.
OMAGServerConfig	getActiveConfiguration(String userId, String serverName)	Return the configuration used for the current active instance of the server.
ServerServicesStatus	getActiveServerStatus(String userId, String serverName)	Return the status of a running server (use platform services to find out if the server is running).
List<String>	getActiveServices(String userId, String serverName)	Retrieve a list of the active services on a server
ServerStatus	getServerStatus(String userId, String serverName)	Retrieve the server status

Methods inherited from class java.lang.Object

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

Field Details

auditLog

protected AuditLog auditLog

Constructor Details

ServerOperationsClient

public ServerOperationsClient(String platformName,
 String platformRootURL,
 AuditLog auditLog)
                       throws InvalidParameterException

Create a new client with no authentication embedded in the HTTP request.

Parameters:

platformName - name of the platform to connect to

platformRootURL - the network address of the server running the OMAG Platform

auditLog - logging destination

Throws:

InvalidParameterException - there is a problem creating the client-side components to issue any REST API calls.

ServerOperationsClient

public ServerOperationsClient(String platformName,
 String platformRootURL)
                       throws InvalidParameterException

Create a new client with no authentication embedded in the HTTP request.

Parameters:

platformName - name of the platform to connect to

platformRootURL - the network address of the server running the OMAS REST services

Throws:

InvalidParameterException - there is a problem creating the client-side components to issue any REST API calls.

ServerOperationsClient

public ServerOperationsClient(String platformName,
 String platformRootURL,
 String userId,
 String password,
 AuditLog auditLog)
                       throws InvalidParameterException

Create a new client that passes userId and password in each HTTP request. This is the userId/password of the calling server. The end user's userId is sent on each request.

Parameters:

platformName - name of the platform to connect to

platformRootURL - the network address of the platform

userId - caller's userId embedded in all HTTP requests

password - caller's userId embedded in all HTTP requests

auditLog - logging destination

Throws:

InvalidParameterException - there is a problem creating the client-side components to issue any REST API calls.

ServerOperationsClient

public ServerOperationsClient(String platformName,
 String platformRootURL,
 String userId,
 String password)
                       throws InvalidParameterException

Create a new client that passes userId and password in each HTTP request. This is the userId/password of the calling server. The end user's userId is sent on each request.

Parameters:

platformName - name of the server to connect to

platformRootURL - the network address of the platform

userId - caller's userId embedded in all HTTP requests

password - caller's userId embedded in all HTTP requests

Throws:

InvalidParameterException - there is a problem creating the client-side components to issue any REST API calls.

Method Details

getServerStatus

public ServerStatus getServerStatus(String userId,
 String serverName)
                             throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Retrieve the server status

Parameters:

userId - calling user

serverName - the name of the server

Returns:

The server status

Throws:

InvalidParameterException - one of the parameters is invalid

UserNotAuthorizedException - the user is not authorized to issue this request

PropertyServerException - there is a problem reported in the open metadata server(s)

getActiveConfiguration

public OMAGServerConfig getActiveConfiguration(String userId,
 String serverName)
                                        throws UserNotAuthorizedException,
InvalidParameterException,
PropertyServerException

Return the configuration used for the current active instance of the server. Null is returned if the server instance is not running.

Parameters:

userId - calling user

serverName - server to start

Returns:

configuration properties used to initialize the server or null if not running

Throws:

UserNotAuthorizedException - the supplied userId is not authorized to issue this command.

InvalidParameterException - invalid parameter.

PropertyServerException - unusual state in the platform.

getActiveServerStatus

public ServerServicesStatus getActiveServerStatus(String userId,
 String serverName)
                                           throws UserNotAuthorizedException,
InvalidParameterException,
PropertyServerException

Return the status of a running server (use platform services to find out if the server is running).

Parameters:

userId - calling user

serverName - server to start

Returns:

status of the server

Throws:

UserNotAuthorizedException - the supplied userId is not authorized to issue this command.

InvalidParameterException - invalid parameter.

PropertyServerException - unusual state in the platform.

getActiveServices

public List<String> getActiveServices(String userId,
 String serverName)
                               throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Retrieve a list of the active services on a server

Parameters:

userId - calling user

serverName - name of the server

Returns:

List of service names

Throws:

InvalidParameterException - one of the parameters is invalid

UserNotAuthorizedException - the user is not authorized to issue this request

PropertyServerException - there is a problem reported in the open metadata server(s)

addOpenMetadataArchiveFile

public void addOpenMetadataArchiveFile(String userId,
 String serverName,
 String fileName)
                                throws UserNotAuthorizedException,
InvalidParameterException,
PropertyServerException

Add a new open metadata archive to running repository.

Parameters:

userId - calling user

serverName - server to start

fileName - name of the open metadata archive file.

Throws:

UserNotAuthorizedException - the supplied userId is not authorized to issue this command.

InvalidParameterException - invalid parameter.

PropertyServerException - unusual state in the platform.

addOpenMetadataArchive

public void addOpenMetadataArchive(String userId,
 String serverName,
 Connection connection)
                            throws UserNotAuthorizedException,
InvalidParameterException,
PropertyServerException

Add a new open metadata archive to running repository.

Parameters:

userId - calling user

serverName - server to start

connection - connection for the open metadata archive.

Throws:

UserNotAuthorizedException - the supplied userId is not authorized to issue this command.

InvalidParameterException - invalid parameter.

PropertyServerException - unusual state in the platform.

addOpenMetadataArchiveContent

public void addOpenMetadataArchiveContent(String userId,
 String serverName,
 OpenMetadataArchive openMetadataArchive)
                                   throws UserNotAuthorizedException,
InvalidParameterException,
PropertyServerException

Add a new open metadata archive to running repository.

Parameters:

userId - calling user

serverName - server to start

openMetadataArchive - openMetadataArchive for the open metadata archive.

Throws:

UserNotAuthorizedException - the supplied userId is not authorized to issue this command.

InvalidParameterException - invalid parameter.

PropertyServerException - unusual state in the platform.