org.odpi.openmetadata.accessservices.dataengine.client

Class DataEngineRESTClient

java.lang.Object

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

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

org.odpi.openmetadata.commonservices.ocf.metadatamanagement.client.OCFRESTClient

org.odpi.openmetadata.accessservices.dataengine.client.DataEngineRESTClient

All Implemented Interfaces:

DataEngineClient

Direct Known Subclasses:

DataEngineRESTConfigurationClient

public class DataEngineRESTClient
extends OCFRESTClient
implements DataEngineClient

The Data Engine Open Metadata Access Service (OMAS) provides an interface for data engine tools to create processes with ports, schemas and relationships. See interface definition for more explanation.

Field Summary

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

auditLog, exceptionHandler, serverName, serverPlatformURLRoot

Constructor Summary

Constructors

Constructor and Description
DataEngineRESTClient(String serverName, String serverPlatformRootURL) Create a new client without authentication.
DataEngineRESTClient(String serverName, String serverPlatformRootURL, String userId, String password) Create a new client that passes userId and password in each HTTP request.

Method Summary

Modifier and Type	Method and Description
void	addLineageMappings(String userId, List<LineageMapping> lineageMappings) Add lineage mapping relationships between schema types
String	addProcessHierarchy(String userId, ProcessHierarchy processHierarchy) Add a ProcessHierarchy relationship to a process
String	createExternalDataEngine(String userId, SoftwareServerCapability softwareServerCapability) Create or update the software server capability entity
String	createOrUpdatePortAlias(String userId, PortAlias portAlias, String processQualifiedName) Create or update the port alias entity with a PortDelegation relationship.
String	createOrUpdatePortImplementation(String userId, PortImplementation portImplementation, String processQualifiedName) Create or update the port implementation entity,with the corresponding schema type and port schema relationship.
List<String>	createOrUpdateProcesses(String userId, List<Process> processes) Create or update the processes, with all the ports, schema types and corresponding relationships including process hierarchy relationships.
String	createOrUpdateSchemaType(String userId, SchemaType schemaType) Create or update the schema type entity, with the corresponding schema attributes and relationships
void	deleteExternalDataEngine(String userId, String qualifiedName, String guid) Delete the external data engine
void	deletePortAlias(String userId, String qualifiedName, String guid) Delete the port alias
void	deletePortImplementation(String userId, String qualifiedName, String guid) Delete the port implementation
void	deleteProcesses(String userId, List<String> qualifiedNames, List<String> guids) Delete a list of processes
void	deleteSchemaType(String userId, String qualifiedName, String guid) Delete the schema type
DeleteSemantic	getDeleteSemantic()
String	getExternalSourceName() Returns the name of the source system using data engine client
void	setDeleteSemantic(DeleteSemantic deleteSemantic)
void	setExternalSourceName(String externalSourceName) Sets external source system name using the data engine client

Methods inherited from class org.odpi.openmetadata.commonservices.ocf.metadatamanagement.client.OCFRESTClient

callAssetGetRESTCall, callAssetsGetRESTCall, callAssetsPostRESTCall, callConnectionGetRESTCall, callSchemaTypeGetRESTCall, callTagGetRESTCall, callTagListGetRESTCall, callTagListPostRESTCall

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

callConnectorTypeGetRESTCall, callCountGetRESTCall, callGUIDGetRESTCall, callGUIDListGetRESTCall, callGUIDListPostRESTCall, callGUIDPostRESTCall, callNameListGetRESTCall, callStringMapGetRESTCall, callVoidGetRESTCall, callVoidPostRESTCall

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

callDeleteRESTCall, callDeleteRESTCall, callGetRESTCall, callGetRESTCall, callGetRESTCallNoParams, callPostRESTCall, callPostRESTCall, callPostRESTCallNoParams, callPutRESTCall, callPutRESTCall

Methods inherited from class java.lang.Object

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

Constructor Detail

DataEngineRESTClient

public DataEngineRESTClient(String serverName,
                            String serverPlatformRootURL)
                     throws InvalidParameterException

Create a new client without authentication.

Parameters:

serverName - name of the server to connect to

serverPlatformRootURL - the network address of the server running the OMAS REST servers

Throws:

InvalidParameterException - null URL or server name

DataEngineRESTClient

public DataEngineRESTClient(String serverName,
                            String serverPlatformRootURL,
                            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:

serverName - name of the server to connect to

serverPlatformRootURL - the network address of the server running the OMAS REST servers

userId - caller's userId embedded in all HTTP requests

password - caller's userId embedded in all HTTP requests

Throws:

InvalidParameterException - null URL or server name

Method Detail

getExternalSourceName

public String getExternalSourceName()

Description copied from interface: DataEngineClient

Returns the name of the source system using data engine client

Specified by:

getExternalSourceName in interface DataEngineClient

Returns:

Source system name

setExternalSourceName

public void setExternalSourceName(String externalSourceName)

Description copied from interface: DataEngineClient

Sets external source system name using the data engine client

Specified by:

setExternalSourceName in interface DataEngineClient

Parameters:

externalSourceName - Source system name

getDeleteSemantic

public DeleteSemantic getDeleteSemantic()

setDeleteSemantic

public void setDeleteSemantic(DeleteSemantic deleteSemantic)

createOrUpdateProcesses

public List<String> createOrUpdateProcesses(String userId,
                                            List<Process> processes)
                                     throws InvalidParameterException,
                                            PropertyServerException

Create or update the processes, with all the ports, schema types and corresponding relationships including process hierarchy relationships.

Specified by:

createOrUpdateProcesses in interface DataEngineClient

Parameters:

userId - the name of the calling user

processes - list of processes

Returns:

unique identifier of the process in the repository

Throws:

InvalidParameterException - the bean properties are invalid

PropertyServerException - problem accessing the property server

deleteProcesses

public void deleteProcesses(String userId,
                            List<String> qualifiedNames,
                            List<String> guids)
                     throws InvalidParameterException,
                            PropertyServerException

Description copied from interface: DataEngineClient

Delete a list of processes

Specified by:

deleteProcesses in interface DataEngineClient

Parameters:

userId - the name of the calling user

qualifiedNames - the qualified names of the processes to be deleted

guids - the unique identifiers of the processes to be deleted

Throws:

InvalidParameterException - the bean properties are invalid

PropertyServerException - problem accessing the property server

createExternalDataEngine

public String createExternalDataEngine(String userId,
                                       SoftwareServerCapability softwareServerCapability)
                                throws InvalidParameterException,
                                       UserNotAuthorizedException,
                                       PropertyServerException

Create or update the software server capability entity

Specified by:

createExternalDataEngine in interface DataEngineClient

Parameters:

userId - the name of the calling user

softwareServerCapability - the software server capability bean

Returns:

unique identifier of the server in the repository

Throws:

InvalidParameterException - the bean properties are invalid

UserNotAuthorizedException - user not authorized to issue this request

PropertyServerException - problem accessing the property server

deleteExternalDataEngine

public void deleteExternalDataEngine(String userId,
                                     String qualifiedName,
                                     String guid)
                              throws InvalidParameterException,
                                     PropertyServerException

Description copied from interface: DataEngineClient

Delete the external data engine

Specified by:

deleteExternalDataEngine in interface DataEngineClient

Parameters:

userId - the name of the calling user

qualifiedName - the qualified name of the external data engine

guid - the unique identifier of the external data engine

Throws:

InvalidParameterException - the bean properties are invalid

PropertyServerException - problem accessing the property server

createOrUpdateSchemaType

public String createOrUpdateSchemaType(String userId,
                                       SchemaType schemaType)
                                throws InvalidParameterException,
                                       PropertyServerException,
                                       UserNotAuthorizedException

Create or update the schema type entity, with the corresponding schema attributes and relationships

Specified by:

createOrUpdateSchemaType in interface DataEngineClient

Parameters:

userId - the name of the calling user

schemaType - the schema type bean

Returns:

unique identifier of the schema type in the repository

Throws:

InvalidParameterException - the bean properties are invalid

PropertyServerException - problem accessing the property server

UserNotAuthorizedException - user not authorized to issue this request

deleteSchemaType

public void deleteSchemaType(String userId,
                             String qualifiedName,
                             String guid)
                      throws InvalidParameterException,
                             PropertyServerException

Description copied from interface: DataEngineClient

Delete the schema type

Specified by:

deleteSchemaType in interface DataEngineClient

Parameters:

userId - the name of the calling user

qualifiedName - the qualified name of schema type

guid - the unique identifier of the external data engine

Throws:

InvalidParameterException - the bean properties are invalid

PropertyServerException - problem accessing the property server

createOrUpdatePortImplementation

public String createOrUpdatePortImplementation(String userId,
                                               PortImplementation portImplementation,
                                               String processQualifiedName)
                                        throws InvalidParameterException,
                                               UserNotAuthorizedException,
                                               PropertyServerException

Create or update the port implementation entity,with the corresponding schema type and port schema relationship. It attaches the port implementation to the provided process

Specified by:

createOrUpdatePortImplementation in interface DataEngineClient

Parameters:

userId - the name of the calling user

portImplementation - the port implementation bean

processQualifiedName - the process qualified name

Returns:

unique identifier of the port implementation in the repository

Throws:

InvalidParameterException - the bean properties are invalid

UserNotAuthorizedException - user not authorized to issue this request

PropertyServerException - problem accessing the property server

deletePortImplementation

public void deletePortImplementation(String userId,
                                     String qualifiedName,
                                     String guid)
                              throws InvalidParameterException,
                                     PropertyServerException

Description copied from interface: DataEngineClient

Delete the port implementation

Specified by:

deletePortImplementation in interface DataEngineClient

Parameters:

userId - the name of the calling user

qualifiedName - the qualified name of port

guid - the unique identifier of the external data engine

Throws:

InvalidParameterException - the bean properties are invalid

PropertyServerException - problem accessing the property server

createOrUpdatePortAlias

public String createOrUpdatePortAlias(String userId,
                                      PortAlias portAlias,
                                      String processQualifiedName)
                               throws InvalidParameterException,
                                      UserNotAuthorizedException,
                                      PropertyServerException

Create or update the port alias entity with a PortDelegation relationship. It attaches the port alias to the provided process

Specified by:

createOrUpdatePortAlias in interface DataEngineClient

Parameters:

userId - the name of the calling user

portAlias - the port alias bean

processQualifiedName - the process qualified name

Returns:

unique identifier of the port alias in the repository

Throws:

InvalidParameterException - the bean properties are invalid

UserNotAuthorizedException - user not authorized to issue this request

PropertyServerException - problem accessing the property server

deletePortAlias

public void deletePortAlias(String userId,
                            String qualifiedName,
                            String guid)
                     throws InvalidParameterException,
                            PropertyServerException

Description copied from interface: DataEngineClient

Delete the port alias

Specified by:

deletePortAlias in interface DataEngineClient

Parameters:

userId - the name of the calling user

qualifiedName - the qualified name of port

guid - the unique identifier of the external data engine

Throws:

InvalidParameterException - the bean properties are invalid

PropertyServerException - problem accessing the property server

addProcessHierarchy

public String addProcessHierarchy(String userId,
                                  ProcessHierarchy processHierarchy)
                           throws InvalidParameterException,
                                  UserNotAuthorizedException,
                                  PropertyServerException

Add a ProcessHierarchy relationship to a process

Specified by:

addProcessHierarchy in interface DataEngineClient

Parameters:

userId - the name of the calling user

processHierarchy - the process hierarchy bean

Returns:

the unique identifier (guid) of the child of the process hierarchy that was updated

Throws:

InvalidParameterException - the bean properties are invalid

UserNotAuthorizedException - user not authorized to issue this request

PropertyServerException - problem accessing the property server

addLineageMappings

public void addLineageMappings(String userId,
                               List<LineageMapping> lineageMappings)
                        throws InvalidParameterException,
                               UserNotAuthorizedException,
                               PropertyServerException

Add lineage mapping relationships between schema types

Specified by:

addLineageMappings in interface DataEngineClient

Parameters:

userId - the name of the calling user

lineageMappings - list of lineage mappings

Throws:

InvalidParameterException - the bean properties are invalid

UserNotAuthorizedException - user not authorized to issue this request

PropertyServerException - problem accessing the property server