Package org.odpi.openmetadata.frameworkservices.oif.client.rest

Class OpenIntegrationRESTClient

java.lang.Object

org.odpi.openmetadata.commonservices.ffdc.rest.FFDCRESTClientBase

org.odpi.openmetadata.commonservices.ffdc.rest.FFDCRESTClient

org.odpi.openmetadata.frameworkservices.oif.client.rest.OpenIntegrationRESTClient

public class OpenIntegrationRESTClient
extends org.odpi.openmetadata.commonservices.ffdc.rest.FFDCRESTClient

OpenIntegrationRESTClient is responsible for issuing calls to the OMAS REST APIs.

Constructor Summary

Constructors

Constructor	Description
OpenIntegrationRESTClient(String serverName, String serverPlatformURLRoot)	Constructor for no authentication.
OpenIntegrationRESTClient(String serverName, String serverPlatformURLRoot, String userId, String password)	Constructor for simple userId and password authentication.
OpenIntegrationRESTClient(String serverName, String serverPlatformURLRoot, String userId, String password, org.odpi.openmetadata.frameworks.auditlog.AuditLog auditLog)	Constructor for simple userId and password authentication with audit log.
OpenIntegrationRESTClient(String serverName, String serverPlatformURLRoot, org.odpi.openmetadata.frameworks.auditlog.AuditLog auditLog)	Constructor for no authentication with audit log.

Method Summary

Modifier and Type	Method	Description
org.odpi.openmetadata.frameworkservices.oif.rest.CatalogTargetResponse	callCatalogTargetGetRESTCall(String methodName, String urlTemplate, Object... params)	Issue a GET REST call that returns a CatalogTargetResponse object.
org.odpi.openmetadata.frameworkservices.oif.rest.CatalogTargetsResponse	callCatalogTargetsGetRESTCall(String methodName, String urlTemplate, Object... params)	Issue a GET REST call that returns a CatalogTargetsResponse object.
org.odpi.openmetadata.frameworkservices.oif.rest.IntegrationConnectorElementResponse	callIntegrationConnectorGetRESTCall(String methodName, String urlTemplate, Object... params)	Issue a GET REST call that returns a IntegrationConnectorElementResponse object.
org.odpi.openmetadata.frameworkservices.oif.rest.IntegrationConnectorElementsResponse	callIntegrationConnectorsGetRESTCall(String methodName, String urlTemplate, Object... params)	Issue a GET REST call that returns a IntegrationConnectorElementsResponse object.
org.odpi.openmetadata.frameworkservices.oif.rest.IntegrationGroupElementResponse	callIntegrationGroupGetRESTCall(String methodName, String urlTemplate, Object... params)	Issue a GET REST call that returns a IntegrationGroupElementResponse object.
org.odpi.openmetadata.frameworkservices.oif.rest.IntegrationGroupElementsResponse	callIntegrationGroupsGetRESTCall(String methodName, String urlTemplate, Object... params)	Issue a GET REST call that returns a IntegrationGroupElementsResponse object.
org.odpi.openmetadata.frameworkservices.oif.rest.IntegrationReportResponse	callIntegrationReportGetRESTCall(String methodName, String urlTemplate, Object... params)	Issue a GET REST call that returns a IntegrationReportResponse object.
org.odpi.openmetadata.frameworkservices.oif.rest.IntegrationReportsResponse	callIntegrationReportsGetRESTCall(String methodName, String urlTemplate, Object... params)	Issue a GET REST call that returns a IntegrationReportsResponse object.
org.odpi.openmetadata.frameworkservices.oif.rest.RegisteredIntegrationConnectorResponse	callRegisteredIntegrationConnectorGetRESTCall(String methodName, String urlTemplate, Object... params)	Issue a GET REST call that returns a RegisteredIntegrationConnectorResponse object.
org.odpi.openmetadata.frameworkservices.oif.rest.RegisteredIntegrationConnectorsResponse	callRegisteredIntegrationConnectorsGetRESTCall(String methodName, String urlTemplate, Object... params)	Issue a GET REST call that returns a RegisteredIntegrationConnectorsResponse object.

Methods inherited from class org.odpi.openmetadata.commonservices.ffdc.rest.FFDCRESTClient

callBooleanGetRESTCall, callCountGetRESTCall, callGUIDGetRESTCall, callGUIDListGetRESTCall, callGUIDListPostRESTCall, callGUIDPostRESTCall, callNameListGetRESTCall, callOCFConnectorReportGetRESTCall, callStringMapGetRESTCall, callVoidGetRESTCall, callVoidPostRESTCall

Methods inherited from class org.odpi.openmetadata.commonservices.ffdc.rest.FFDCRESTClientBase

callPostRESTCallNoParams

Methods inherited from class java.lang.Object

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

Constructor Details

OpenIntegrationRESTClient

public OpenIntegrationRESTClient(String serverName,
 String serverPlatformURLRoot,
 org.odpi.openmetadata.frameworks.auditlog.AuditLog auditLog)
                          throws org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException

Constructor for no authentication with audit log.

Parameters:

serverName - name of the OMAG Server to call

serverPlatformURLRoot - URL root of the server manager where the OMAG Server is running.

auditLog - destination for log messages.

Throws:

org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException - there is a problem creating the client-side components to issue any REST APIs.

OpenIntegrationRESTClient

public OpenIntegrationRESTClient(String serverName,
 String serverPlatformURLRoot)
                          throws org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException

Constructor for no authentication.

Parameters:

serverName - name of the OMAG Server to call

serverPlatformURLRoot - URL root of the server manager where the OMAG Server is running.

Throws:

org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException - there is a problem creating the client-side components to issue any REST APIs.

OpenIntegrationRESTClient

public OpenIntegrationRESTClient(String serverName,
 String serverPlatformURLRoot,
 String userId,
 String password,
 org.odpi.openmetadata.frameworks.auditlog.AuditLog auditLog)
                          throws org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException

Constructor for simple userId and password authentication with audit log.

Parameters:

serverName - name of the OMAG Server to call

serverPlatformURLRoot - URL root of the server manager where the OMAG Server is running.

userId - user id for the HTTP request

password - password for the HTTP request

auditLog - destination for log messages.

Throws:

org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException - there is a problem creating the client-side components to issue any REST APIs.

OpenIntegrationRESTClient

public OpenIntegrationRESTClient(String serverName,
 String serverPlatformURLRoot,
 String userId,
 String password)
                          throws org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException

Constructor for simple userId and password authentication.

Parameters:

serverName - name of the OMAG Server to call

serverPlatformURLRoot - URL root of the server manager where the OMAG Server is running.

userId - user id for the HTTP request

password - password for the HTTP request

Throws:

org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException - there is a problem creating the client-side components to issue any REST APIs.

Method Details

callIntegrationReportGetRESTCall

public org.odpi.openmetadata.frameworkservices.oif.rest.IntegrationReportResponse callIntegrationReportGetRESTCall(String methodName,
 String urlTemplate,
 Object... params)
                                                                                                            throws org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException,
org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException,
org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException

Issue a GET REST call that returns a IntegrationReportResponse object.

Parameters:

methodName - name of the method being called.

urlTemplate - template of the URL for the REST API with place-holders for the parameters.

params - a list of parameters that are slotted into the url template.

Returns:

response object

Throws:

org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException - one of the parameters is invalid.

org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException - the user is not authorized to make this request.

org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException - the repository is not available or not working properly.

callIntegrationReportsGetRESTCall

public org.odpi.openmetadata.frameworkservices.oif.rest.IntegrationReportsResponse callIntegrationReportsGetRESTCall(String methodName,
 String urlTemplate,
 Object... params)
                                                                                                              throws org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException,
org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException,
org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException

Issue a GET REST call that returns a IntegrationReportsResponse object.

Parameters:

methodName - name of the method being called.

urlTemplate - template of the URL for the REST API with place-holders for the parameters.

params - a list of parameters that are slotted into the url template.

Returns:

response object

Throws:

org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException - one of the parameters is invalid.

org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException - the user is not authorized to make this request.

org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException - the repository is not available or not working properly.

callIntegrationGroupGetRESTCall

public org.odpi.openmetadata.frameworkservices.oif.rest.IntegrationGroupElementResponse callIntegrationGroupGetRESTCall(String methodName,
 String urlTemplate,
 Object... params)
                                                                                                                 throws org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException,
org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException,
org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException

Issue a GET REST call that returns a IntegrationGroupElementResponse object.

Parameters:

methodName - name of the method being called

urlTemplate - template of the URL for the REST API with place-holders for the parameters

params - a list of parameters that are slotted into the url template

Returns:

response object

Throws:

org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException - one of the parameters is invalid.

org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException - the user is not authorized to make this request.

org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException - the repository is not available or not working properly.

callIntegrationGroupsGetRESTCall

public org.odpi.openmetadata.frameworkservices.oif.rest.IntegrationGroupElementsResponse callIntegrationGroupsGetRESTCall(String methodName,
 String urlTemplate,
 Object... params)
                                                                                                                   throws org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException,
org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException,
org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException

Issue a GET REST call that returns a IntegrationGroupElementsResponse object.

Parameters:

methodName - name of the method being called.

urlTemplate - template of the URL for the REST API with place-holders for the parameters.

params - a list of parameters that are slotted into the url template.

Returns:

response object

Throws:

org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException - one of the parameters is invalid.

org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException - the user is not authorized to make this request.

org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException - the repository is not available or not working properly.

callIntegrationConnectorGetRESTCall

public org.odpi.openmetadata.frameworkservices.oif.rest.IntegrationConnectorElementResponse callIntegrationConnectorGetRESTCall(String methodName,
 String urlTemplate,
 Object... params)
                                                                                                                         throws org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException,
org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException,
org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException

Issue a GET REST call that returns a IntegrationConnectorElementResponse object.

Parameters:

methodName - name of the method being called.

urlTemplate - template of the URL for the REST API with place-holders for the parameters.

params - a list of parameters that are slotted into the url template.

Returns:

response object

Throws:

org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException - one of the parameters is invalid.

org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException - the user is not authorized to make this request.

org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException - the repository is not available or not working properly.

callIntegrationConnectorsGetRESTCall

public org.odpi.openmetadata.frameworkservices.oif.rest.IntegrationConnectorElementsResponse callIntegrationConnectorsGetRESTCall(String methodName,
 String urlTemplate,
 Object... params)
                                                                                                                           throws org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException,
org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException,
org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException

Issue a GET REST call that returns a IntegrationConnectorElementsResponse object.

Parameters:

methodName - name of the method being called.

urlTemplate - template of the URL for the REST API with place-holders for the parameters.

params - a list of parameters that are slotted into the url template.

Returns:

response object

Throws:

org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException - one of the parameters is invalid.

org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException - the user is not authorized to make this request.

org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException - the repository is not available or not working properly.

callRegisteredIntegrationConnectorGetRESTCall

public org.odpi.openmetadata.frameworkservices.oif.rest.RegisteredIntegrationConnectorResponse callRegisteredIntegrationConnectorGetRESTCall(String methodName,
 String urlTemplate,
 Object... params)
                                                                                                                                      throws org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException,
org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException,
org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException

Issue a GET REST call that returns a RegisteredIntegrationConnectorResponse object.

Parameters:

methodName - name of the method being called.

urlTemplate - template of the URL for the REST API with place-holders for the parameters.

params - a list of parameters that are slotted into the url template.

Returns:

response object

Throws:

org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException - one of the parameters is invalid.

org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException - the user is not authorized to make this request.

org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException - the repository is not available or not working properly.

callRegisteredIntegrationConnectorsGetRESTCall

public org.odpi.openmetadata.frameworkservices.oif.rest.RegisteredIntegrationConnectorsResponse callRegisteredIntegrationConnectorsGetRESTCall(String methodName,
 String urlTemplate,
 Object... params)
                                                                                                                                        throws org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException,
org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException,
org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException

Issue a GET REST call that returns a RegisteredIntegrationConnectorsResponse object.

Parameters:

methodName - name of the method being called.

urlTemplate - template of the URL for the REST API with place-holders for the parameters.

params - a list of parameters that are slotted into the url template.

Returns:

response object

Throws:

org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException - one of the parameters is invalid.

org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException - the user is not authorized to make this request.

org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException - the repository is not available or not working properly.

callCatalogTargetGetRESTCall

public org.odpi.openmetadata.frameworkservices.oif.rest.CatalogTargetResponse callCatalogTargetGetRESTCall(String methodName,
 String urlTemplate,
 Object... params)
                                                                                                    throws org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException,
org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException,
org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException

Issue a GET REST call that returns a CatalogTargetResponse object.

Parameters:

methodName - name of the method being called.

urlTemplate - template of the URL for the REST API with place-holders for the parameters.

params - a list of parameters that are slotted into the url template.

Returns:

response object

Throws:

org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException - one of the parameters is invalid.

org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException - the user is not authorized to make this request.

org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException - the repository is not available or not working properly.

callCatalogTargetsGetRESTCall

public org.odpi.openmetadata.frameworkservices.oif.rest.CatalogTargetsResponse callCatalogTargetsGetRESTCall(String methodName,
 String urlTemplate,
 Object... params)
                                                                                                      throws org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException,
org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException,
org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException

Issue a GET REST call that returns a CatalogTargetsResponse object.

Parameters:

methodName - name of the method being called.

urlTemplate - template of the URL for the REST API with place-holders for the parameters.

params - a list of parameters that are slotted into the url template.

Returns:

response object

Throws:

org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException - one of the parameters is invalid.

org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException - the user is not authorized to make this request.

org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException - the repository is not available or not working properly.