Package org.odpi.openmetadata.adapters.connectors.restclients.spring

Class SpringRESTClientConnector

java.lang.Object

org.odpi.openmetadata.frameworks.connectors.Connector

org.odpi.openmetadata.frameworks.connectors.ConnectorBase

org.odpi.openmetadata.adapters.connectors.restclients.RESTClientConnector

org.odpi.openmetadata.adapters.connectors.restclients.spring.SpringRESTClientConnector

All Implemented Interfaces:

RESTClientCalls, AuditLoggingComponent, SecureConnectorExtension, VirtualConnectorExtension

public class SpringRESTClientConnector
extends RESTClientConnector

SpringRESTClientConnector is responsible for issuing calls to the server's REST APIs using Spring. It is supported through a connector because there are often changes in this integration, and it saves maintenance work if all Egeria clients use this connector.

Nested Class Summary

Nested classes/interfaces inherited from class org.odpi.openmetadata.frameworks.connectors.ConnectorBase

ConnectorBase.ProtectedConnection

Field Summary

Fields inherited from class org.odpi.openmetadata.adapters.connectors.restclients.RESTClientConnector

auditLog

Fields inherited from class org.odpi.openmetadata.frameworks.connectors.ConnectorBase

connectedAssetProperties, connectionBean, connectionProperties, connectorInstanceId, embeddedConnectors, secretsStoreConnectorMap

Constructor Summary

Constructors

Constructor	Description
SpringRESTClientConnector()	This constructor is work in progress as part of the upgrade of Egeria to use security.

Method Summary

Modifier and Type	Method	Description
<T> T	callDeleteRESTCall(String methodName, Class<T> returnClass, String urlTemplate, Object requestBody, Object... params)	Issue a DELETE REST call that returns a response object.
<T> T	callDeleteRESTCall(String methodName, org.springframework.core.ParameterizedTypeReference<T> responseType, String urlTemplate, Object requestBody, Object... params)	Issue a DELETE REST call that returns a response object.
<T> T	callDeleteRESTCallNoParams(String methodName, Class<T> returnClass, String urlTemplate, Object requestBody)	Issue a DELETE REST call that returns a response object.
<T> T	callGetRESTCall(String methodName, Class<T> returnClass, String urlTemplate, Object... params)	Issue a GET REST call that returns a response object.
<T> T	callGetRESTCall(String methodName, org.springframework.core.ParameterizedTypeReference<T> responseType, String urlTemplate, Object... params)	Issue a GET REST call that returns a response object.
<T> T	callGetRESTCallNoParams(String methodName, Class<T> returnClass, String urlTemplate)	Issue a GET REST call that returns a response object.
<T> T	callPatchRESTCall(String methodName, Class<T> returnClass, String urlTemplate, Object requestBody, Object... params)	Issue a PATCH REST call that returns a response object.
<T> T	callPostRESTCall(String methodName, Class<T> returnClass, String urlTemplate, Object requestBody, Object... params)	Issue a POST REST call that returns a response object.
<T> T	callPostRESTCall(String methodName, org.springframework.core.ParameterizedTypeReference<T> responseType, String urlTemplate, Object requestBody, Object... params)	Issue a POST REST call that returns a response object.
<T> T	callPostRESTCallNoParams(String methodName, Class<T> returnClass, String urlTemplate, Object requestBody)	Issue a POST REST call that returns a response object.
<T> T	callPutRESTCall(String methodName, Class<T> returnClass, String urlTemplate, Object requestBody, Object... params)	Issue a PUT REST call that returns a response object.
<T> T	callPutRESTCall(String methodName, org.springframework.core.ParameterizedTypeReference<T> responseType, String urlTemplate, Object requestBody, Object... params)	Issue a PUT REST call that returns a response object.
<T> T	callPutRESTCallNoParams(String methodName, Class<T> returnClass, String urlTemplate, Object requestBody)	Issue a PUT REST call that returns a response object.
void	start()	Indicates that the connector is completely configured and can begin processing.

Methods inherited from class org.odpi.openmetadata.adapters.connectors.restclients.RESTClientConnector

getConnectorComponentDescription, setAuditLog

Methods inherited from class org.odpi.openmetadata.frameworks.connectors.ConnectorBase

combineConfigurationProperties, disconnect, disconnectConnectors, equals, getArrayConfigurationProperty, getAssetTypeName, getBooleanConfigurationProperty, getConnectedAssetProperties, getConnection, getConnectorInstanceId, getDateConfigurationProperty, getIntConfigurationProperty, getLongConfigurationProperty, getNetworkAddresses, getStringConfigurationProperty, getSuppliedPlaceholderProperties, hashCode, initialize, initializeConnectedAssetProperties, initializeEmbeddedConnectors, initializeSecretsStoreConnector, isActive, logExceptionRecord, logRecord, logRecord, throwMissingConfigurationProperty, throwMissingResource, throwNoAsset, throwWrongTypeOfAsset, throwWrongTypeOfResource, throwWrongTypeOfRootSchema, toString

Methods inherited from class org.odpi.openmetadata.frameworks.connectors.Connector

clearStatisticProperty, clearStatisticTimestamp, getConnectorStatistics, getStatisticCounter, getStatisticProperty, getStatisticTimestamp, incrementStatisticCounter, initializeStatisticCounter, setStatisticProperty, setStatisticTimestamp

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.odpi.openmetadata.frameworks.connectors.SecureConnectorExtension

initializeSecretsStoreConnector

Constructor Details

SpringRESTClientConnector

public SpringRESTClientConnector()
                          throws NoSuchAlgorithmException,
KeyManagementException

This constructor is work in progress as part of the upgrade of Egeria to use security.

Throws:

NoSuchAlgorithmException - new exception added as part of the security work - no description provided yet

KeyManagementException - new exception added as part of the security work - no description provided yet

Method Details

start

public void start()
           throws ConnectorCheckedException

Indicates that the connector is completely configured and can begin processing.

Overrides:

start in class ConnectorBase

Throws:

ConnectorCheckedException - there is a problem within the connector.

callGetRESTCallNoParams

public <T> T callGetRESTCallNoParams(String methodName,
 Class<T> returnClass,
 String urlTemplate)
                              throws RESTServerException

Issue a GET REST call that returns a response object.

Type Parameters:

T - type of the return object

Parameters:

methodName - name of the method being called.

returnClass - class of the response object.

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

Returns:

response object

Throws:

RESTServerException - something went wrong with the REST call stack.

callGetRESTCall

public <T> T callGetRESTCall(String methodName,
 Class<T> returnClass,
 String urlTemplate,
 Object... params)
                      throws RESTServerException

Issue a GET REST call that returns a response object.

Type Parameters:

T - type of the return object

Parameters:

methodName - name of the method being called.

returnClass - class of the response object.

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

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

Returns:

response object

Throws:

RESTServerException - something went wrong with the REST call stack.

callPostRESTCallNoParams

public <T> T callPostRESTCallNoParams(String methodName,
 Class<T> returnClass,
 String urlTemplate,
 Object requestBody)
                               throws RESTServerException

Issue a POST REST call that returns a response object. This is typically a create, update, or find with complex parameters.

Type Parameters:

T - type of the return object

Parameters:

methodName - name of the method being called.

returnClass - class of the response object.

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

requestBody - request body for the request.

Returns:

Object

Throws:

RESTServerException - something went wrong with the REST call stack.

callPostRESTCall

public <T> T callPostRESTCall(String methodName,
 Class<T> returnClass,
 String urlTemplate,
 Object requestBody,
 Object... params)
                       throws RESTServerException

Issue a POST REST call that returns a response object. This is typically a create, update, or find with complex parameters.

Type Parameters:

T - type of the return object

Parameters:

methodName - name of the method being called.

returnClass - class of the response object.

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

requestBody - request body for the request.

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

Returns:

Object

Throws:

RESTServerException - something went wrong with the REST call stack.

callPutRESTCall

public <T> T callPutRESTCall(String methodName,
 Class<T> returnClass,
 String urlTemplate,
 Object requestBody,
 Object... params)
                      throws RESTServerException

Issue a PUT REST call that returns a response object. This is typically an update.

Type Parameters:

T - type of the return object

Parameters:

methodName - name of the method being called.

returnClass - class of the response object.

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

requestBody - request body for the request.

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

Returns:

Object

Throws:

RESTServerException - something went wrong with the REST call stack.

callPutRESTCallNoParams

public <T> T callPutRESTCallNoParams(String methodName,
 Class<T> returnClass,
 String urlTemplate,
 Object requestBody)
                              throws RESTServerException

Issue a PUT REST call that returns a response object. This is typically an update.

Type Parameters:

T - type of the return object

Parameters:

methodName - name of the method being called.

returnClass - class of the response object.

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

requestBody - request body for the request.

Returns:

Object

Throws:

RESTServerException - something went wrong with the REST call stack.

callDeleteRESTCallNoParams

public <T> T callDeleteRESTCallNoParams(String methodName,
 Class<T> returnClass,
 String urlTemplate,
 Object requestBody)
                                 throws RESTServerException

Issue a DELETE REST call that returns a response object.

Type Parameters:

T - type of the return object

Parameters:

methodName - name of the method being called.

returnClass - class of the response object.

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

requestBody - request body for the request.

Returns:

Object

Throws:

RESTServerException - something went wrong with the REST call stack.

callDeleteRESTCall

public <T> T callDeleteRESTCall(String methodName,
 Class<T> returnClass,
 String urlTemplate,
 Object requestBody,
 Object... params)
                         throws RESTServerException

Issue a DELETE REST call that returns a response object.

Type Parameters:

T - type of the return object

Parameters:

methodName - name of the method being called.

returnClass - class of the response object.

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

requestBody - request body for the request.

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

Returns:

Object

Throws:

RESTServerException - something went wrong with the REST call stack.

callPatchRESTCall

public <T> T callPatchRESTCall(String methodName,
 Class<T> returnClass,
 String urlTemplate,
 Object requestBody,
 Object... params)
                        throws RESTServerException

Issue a PATCH REST call that returns a response object.

Type Parameters:

T - type of the return object

Parameters:

methodName - name of the method being called.

returnClass - class of the response object.

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

requestBody - request body for the request.

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

Returns:

Object

Throws:

RESTServerException - something went wrong with the REST call stack.

callPostRESTCall

public <T> T callPostRESTCall(String methodName,
 org.springframework.core.ParameterizedTypeReference<T> responseType,
 String urlTemplate,
 Object requestBody,
 Object... params)
                       throws RESTServerException

Issue a POST REST call that returns a response object. This is typically a create, update, or find with complex parameters.

Type Parameters:

T - type of the return object

Parameters:

methodName - name of the method being called.

responseType - class of the response for generic object.

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

requestBody - request body for the request.

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

Returns:

Object

Throws:

RESTServerException - something went wrong with the REST call stack.

callGetRESTCall

public <T> T callGetRESTCall(String methodName,
 org.springframework.core.ParameterizedTypeReference<T> responseType,
 String urlTemplate,
 Object... params)
                      throws RESTServerException

Issue a GET REST call that returns a response object.

Type Parameters:

T - type of the return object

Parameters:

methodName - name of the method being called.

responseType - class of the response for generic object.

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

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

Returns:

response object

Throws:

RESTServerException - something went wrong with the REST call stack.

callDeleteRESTCall

public <T> T callDeleteRESTCall(String methodName,
 org.springframework.core.ParameterizedTypeReference<T> responseType,
 String urlTemplate,
 Object requestBody,
 Object... params)
                         throws RESTServerException

Issue a DELETE REST call that returns a response object.

Type Parameters:

T - type of the return object

Parameters:

methodName - name of the method being called.

responseType - class of the response for generic object.

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

requestBody - request body for the request.

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

Returns:

Object

Throws:

RESTServerException - something went wrong with the REST call stack.

callPutRESTCall

public <T> T callPutRESTCall(String methodName,
 org.springframework.core.ParameterizedTypeReference<T> responseType,
 String urlTemplate,
 Object requestBody,
 Object... params)
                      throws RESTServerException

Issue a PUT REST call that returns a response object. This is typically an update.

Type Parameters:

T - type of the return object

Parameters:

methodName - name of the method being called.

responseType - class of the response for generic object.

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

requestBody - request body for the request.

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

Returns:

Object

Throws:

RESTServerException - something went wrong with the REST call stack.