org.odpi.openmetadata.accessservices.dataengine.client

Class DataEngineImpl

java.lang.Object

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

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

org.odpi.openmetadata.accessservices.dataengine.client.DataEngineImpl

All Implemented Interfaces:

DataEngineClient

public class DataEngineImpl
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.FFDCRESTClient

clientConnector, serverPlatformURLRoot

Constructor Summary

Constructors

Constructor and Description
DataEngineImpl(String serverName, String serverPlatformRootURL) Create a new client without authentication.
DataEngineImpl(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
void	addPortsToProcess(String userId, List<String> portGUIDs, String processGUID) Add ports and process ports relationship to an existing port
String	createPortAlias(String userId, PortAlias portAlias) Create the Port Alias entity with a PortDelegation relationship
String	createPortAlias(String userId, String qualifiedName, String displayName, PortType portType, String delegatesTo) Create the Port Alias entity with a PortDelegation relationship
String	createPortImplementation(String userId, PortImplementation portImplementation) Create the port implementation entity, with the corresponding schema type and port schema relationship
String	createPortImplementation(String userId, String qualifiedName, String displayName, PortType portType, SchemaType schemaType) Create the port implementation entity, with the corresponding schema type and port schema relationship
String	createProcess(String userId, Process process) Creates the process, with all the ports, schema types and corresponding relationships
String	createProcess(String userId, String qualifiedName, String processName, String description, String latestChange, List<String> zoneMembership, String displayName, String formula, String owner, OwnerType ownerType, List<PortImplementation> portImplementations, List<PortAlias> portAliases, List<LineageMapping> lineageMappings) Creates the process, with all the ports, schema types and corresponding relationships
List<String>	createProcesses(String userId, List<Process> processes) Creates the process, with all the ports, schema types and corresponding relationships
String	createSchemaType(String userId, SchemaType schemaType) Create the schema type entity, with the corresponding schema attributes and relationships
String	createSchemaType(String userId, String qualifiedName, String displayName, String author, String encodingStandard, String usage, String versionNumber, List<Attribute> attributeList) Create the schema type entity, with the corresponding schema attributes and relationships
String	createSoftwareServerCapability(String userId, SoftwareServerCapability softwareServerCapability) Create the software server capability entity
String	createSoftwareServerCapability(String userId, String qualifiedName, String name, String description, String type, String version, String patchLevel, String source) Create the software server capability entity

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

callCountGetRESTCall, callGetRESTCall, callGetRESTCallNoParams, callGUIDGetRESTCall, callGUIDListGetRESTCall, callGUIDListPostRESTCall, callGUIDPostRESTCall, callPostRESTCall, callPostRESTCallNoParams, callVoidPostRESTCall

Methods inherited from class java.lang.Object

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

Constructor Detail

DataEngineImpl

public DataEngineImpl(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

DataEngineImpl

public DataEngineImpl(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

createProcess

public String createProcess(String userId,
                            String qualifiedName,
                            String processName,
                            String description,
                            String latestChange,
                            List<String> zoneMembership,
                            String displayName,
                            String formula,
                            String owner,
                            OwnerType ownerType,
                            List<PortImplementation> portImplementations,
                            List<PortAlias> portAliases,
                            List<LineageMapping> lineageMappings)
                     throws PropertyServerException,
                            InvalidParameterException,
                            UserNotAuthorizedException

Description copied from interface: DataEngineClient

Creates the process, with all the ports, schema types and corresponding relationships

Specified by:

createProcess in interface DataEngineClient

Parameters:

userId - the name of the calling user

qualifiedName - the qualifiedName name of the process

processName - the name of the process

description - the description of the process

latestChange - the description for the latest change done for the process

zoneMembership - the list of zones of the process

displayName - the display name of the process

formula - the formula for the process

owner - the name of the owner for this process

ownerType - the type of the owner for this process

portImplementations - the list of port implementations

portAliases - the list of port aliases

lineageMappings - the list of lineage mappings

Returns:

unique identifier of the process in the repository

Throws:

PropertyServerException - problem accessing the property server

InvalidParameterException - the bean properties are invalid

UserNotAuthorizedException - user not authorized to issue this request

InvalidParameterException

createProcess

public String createProcess(String userId,
                            Process process)
                     throws InvalidParameterException,
                            PropertyServerException,
                            UserNotAuthorizedException

Description copied from interface: DataEngineClient

Creates the process, with all the ports, schema types and corresponding relationships

Specified by:

createProcess in interface DataEngineClient

Parameters:

userId - the name of the calling user

process - the process bean

Returns:

unique identifier of the process in the repository

Throws:

InvalidParameterException - the bean properties are invalid

PropertyServerException - problem accessing the property server

UserNotAuthorizedException - user not authorized to issue this request

InvalidParameterException

createProcesses

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

Description copied from interface: DataEngineClient

Creates the process, with all the ports, schema types and corresponding relationships

Specified by:

createProcesses 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

UserNotAuthorizedException - user not authorized to issue this request

InvalidParameterException

createSoftwareServerCapability

public String createSoftwareServerCapability(String userId,
                                             String qualifiedName,
                                             String name,
                                             String description,
                                             String type,
                                             String version,
                                             String patchLevel,
                                             String source)
                                      throws InvalidParameterException,
                                             UserNotAuthorizedException,
                                             PropertyServerException

Description copied from interface: DataEngineClient

Create the software server capability entity

Specified by:

createSoftwareServerCapability in interface DataEngineClient

Parameters:

userId - the name of the calling user

qualifiedName - the qualifiedName name of the server

name - the name of the server

description - the description of the server

type - the type of the server

version - the version of the server

patchLevel - the patch level of the server

source - the source of the server

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

createSoftwareServerCapability

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

Description copied from interface: DataEngineClient

Create the software server capability entity

Specified by:

createSoftwareServerCapability 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

createSchemaType

public String createSchemaType(String userId,
                               String qualifiedName,
                               String displayName,
                               String author,
                               String encodingStandard,
                               String usage,
                               String versionNumber,
                               List<Attribute> attributeList)
                        throws InvalidParameterException,
                               PropertyServerException,
                               UserNotAuthorizedException

Description copied from interface: DataEngineClient

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

Specified by:

createSchemaType in interface DataEngineClient

Parameters:

userId - the name of the calling user

qualifiedName - the qualifiedName name of the schema type

displayName - the display name of the schema type

author - the author of the schema type

encodingStandard - the encoding for the schema type

usage - the usage for the schema type

versionNumber - the version number for the schema type

attributeList - the list of attributes for the schema type

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

createSchemaType

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

Description copied from interface: DataEngineClient

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

Specified by:

createSchemaType 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

createPortImplementation

public String createPortImplementation(String userId,
                                       String qualifiedName,
                                       String displayName,
                                       PortType portType,
                                       SchemaType schemaType)
                                throws InvalidParameterException,
                                       UserNotAuthorizedException,
                                       PropertyServerException

Description copied from interface: DataEngineClient

Create the port implementation entity, with the corresponding schema type and port schema relationship

Specified by:

createPortImplementation in interface DataEngineClient

Parameters:

userId - the name of the calling user

qualifiedName - the qualifiedName name of the port

displayName - the display name of the port

portType - the type of the port

schemaType - the schema type attached to the port implementation

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

createPortImplementation

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

Description copied from interface: DataEngineClient

Create the port implementation entity, with the corresponding schema type and port schema relationship

Specified by:

createPortImplementation in interface DataEngineClient

Parameters:

userId - the name of the calling user

portImplementation - the port implementation bean

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

createPortAlias

public String createPortAlias(String userId,
                              String qualifiedName,
                              String displayName,
                              PortType portType,
                              String delegatesTo)
                       throws InvalidParameterException,
                              UserNotAuthorizedException,
                              PropertyServerException

Description copied from interface: DataEngineClient

Create the Port Alias entity with a PortDelegation relationship

Specified by:

createPortAlias in interface DataEngineClient

Parameters:

userId - the name of the calling user

qualifiedName - the qualifiedName name of the port

displayName - the display name of the port

portType - the type of the port

delegatesTo - the qualified name of the delegated port

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

createPortAlias

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

Description copied from interface: DataEngineClient

Create the Port Alias entity with a PortDelegation relationship

Specified by:

createPortAlias in interface DataEngineClient

Parameters:

userId - the name of the calling user

portAlias - the port alias bean

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

addLineageMappings

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

Description copied from interface: DataEngineClient

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

addPortsToProcess

public void addPortsToProcess(String userId,
                              List<String> portGUIDs,
                              String processGUID)
                       throws InvalidParameterException,
                              UserNotAuthorizedException,
                              PropertyServerException

Description copied from interface: DataEngineClient

Add ports and process ports relationship to an existing port

Specified by:

addPortsToProcess in interface DataEngineClient

Parameters:

userId - the name of the calling user

portGUIDs - the list of port GUIDs

processGUID - the process GUYID

Throws:

InvalidParameterException - the bean properties are invalid

UserNotAuthorizedException - user not authorized to issue this request

PropertyServerException - problem accessing the property server