org.odpi.openmetadata.accessservices.assetmanager.client

Class DataAssetExchangeClient

java.lang.Object

org.odpi.openmetadata.accessservices.assetmanager.client.ExchangeClientBase

org.odpi.openmetadata.accessservices.assetmanager.client.SchemaExchangeClientBase

org.odpi.openmetadata.accessservices.assetmanager.client.DataAssetExchangeClient

All Implemented Interfaces:

DataAssetExchangeInterface, SchemaExchangeInterface

public class DataAssetExchangeClient
extends SchemaExchangeClientBase
implements DataAssetExchangeInterface

DataAssetExchangeClient is the client for managing Data Assets, Schemas and Connections.

Constructor Summary

Constructors

Constructor and Description
DataAssetExchangeClient(String serverName, String serverPlatformURLRoot) Create a new client with no authentication embedded in the HTTP request.
DataAssetExchangeClient(String serverName, String serverPlatformURLRoot, AssetManagerRESTClient restClient, int maxPageSize, AuditLog auditLog) Create a new client that is going to be used in an OMAG Server.
DataAssetExchangeClient(String serverName, String serverPlatformURLRoot, AuditLog auditLog) Create a new client with no authentication embedded in the HTTP request.
DataAssetExchangeClient(String serverName, String serverPlatformURLRoot, String userId, String password) Create a new client that passes userId and password in each HTTP request.
DataAssetExchangeClient(String serverName, String serverPlatformURLRoot, String userId, String password, AuditLog auditLog) Create a new client that passes userId and password in each HTTP request.

Method Summary

Modifier and Type	Method and Description
void	clearAssetAsReferenceData(String userId, String assetManagerGUID, String assetManagerName, String assetGUID, String assetExternalIdentifier) Remove the reference data designation from the asset.
String	createAsset(String userId, String assetManagerGUID, String assetManagerName, boolean assetManagerIsHome, String assetExternalIdentifier, String assetExternalIdentifierName, String assetExternalIdentifierUsage, String assetExternalIdentifierSource, KeyPattern assetExternalIdentifierKeyPattern, Map<String,String> mappingProperties, AssetProperties assetProperties) Create a new metadata element to represent the root of an asset.
String	createAssetFromTemplate(String userId, String assetManagerGUID, String assetManagerName, String templateGUID, String assetExternalIdentifier, String assetExternalIdentifierName, String assetExternalIdentifierUsage, String assetExternalIdentifierSource, KeyPattern assetExternalIdentifierKeyPattern, Map<String,String> mappingProperties, TemplateProperties templateProperties) Create a new metadata element to represent an asset using an existing metadata element as a template.
List<AssetElement>	findAssets(String userId, String assetManagerGUID, String assetManagerName, String searchString, int startFrom, int pageSize) Retrieve the list of asset metadata elements that contain the search string.
AssetElement	getAssetByGUID(String userId, String assetManagerGUID, String assetManagerName, String openMetadataGUID) Retrieve the asset metadata element with the supplied unique identifier.
List<AssetElement>	getAssetsByName(String userId, String assetManagerGUID, String assetManagerName, String name, int startFrom, int pageSize) Retrieve the list of asset metadata elements with a matching qualified or display name.
List<AssetElement>	getAssetsForAssetManager(String userId, String assetManagerGUID, String assetManagerName, int startFrom, int pageSize) Retrieve the list of assets created on behalf of the named asset manager.
void	publishAsset(String userId, String assetManagerGUID, String assetManagerName, String assetGUID) Update the zones for the asset so that it becomes visible to consumers.
void	removeAsset(String userId, String assetManagerGUID, String assetManagerName, String assetGUID, String assetExternalIdentifier) Remove the metadata element representing an asset.
void	setAssetAsReferenceData(String userId, String assetManagerGUID, String assetManagerName, String assetGUID, String assetExternalIdentifier) Classify the asset to indicate that it can be used as reference data.
void	updateAsset(String userId, String assetManagerGUID, String assetManagerName, String assetGUID, String assetExternalIdentifier, boolean isMergeUpdate, AssetProperties assetProperties) Update the metadata element representing an asset.
void	withdrawAsset(String userId, String assetManagerGUID, String assetManagerName, String assetGUID) Update the zones for the asset so that it is no longer visible to consumers.

Methods inherited from class org.odpi.openmetadata.accessservices.assetmanager.client.SchemaExchangeClientBase

clearColumnAsPrimaryKey, clearForeignKeyRelationship, clearSchemaElementAsCalculatedValue, clearSchemaTypeParent, createSchemaAttribute, createSchemaAttributeFromTemplate, createSchemaType, createSchemaTypeFromTemplate, findSchemaAttributes, findSchemaType, getAttributesForSchemaType, getSchemaAttributeByGUID, getSchemaAttributesByName, getSchemaTypeByGUID, getSchemaTypeByName, getSchemaTypeForElement, getSchemaTypeParent, removeSchemaAttribute, removeSchemaType, setSchemaElementAsCalculatedValue, setupColumnAsPrimaryKey, setupForeignKeyRelationship, setupSchemaTypeParent, updateForeignKeyRelationship, updateSchemaAttribute, updateSchemaType

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.odpi.openmetadata.accessservices.assetmanager.api.SchemaExchangeInterface

clearColumnAsPrimaryKey, clearForeignKeyRelationship, clearSchemaElementAsCalculatedValue, clearSchemaTypeParent, createSchemaAttribute, createSchemaAttributeFromTemplate, createSchemaType, createSchemaTypeFromTemplate, findSchemaAttributes, findSchemaType, getAttributesForSchemaType, getSchemaAttributeByGUID, getSchemaAttributesByName, getSchemaTypeByGUID, getSchemaTypeByName, getSchemaTypeForElement, getSchemaTypeParent, removeSchemaAttribute, removeSchemaType, setSchemaElementAsCalculatedValue, setupColumnAsPrimaryKey, setupForeignKeyRelationship, setupSchemaTypeParent, updateForeignKeyRelationship, updateSchemaAttribute, updateSchemaType

Constructor Detail

DataAssetExchangeClient

public DataAssetExchangeClient(String serverName,
                               String serverPlatformURLRoot,
                               AuditLog auditLog)
                        throws InvalidParameterException

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

Parameters:

serverName - name of the server to connect to

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

auditLog - logging destination

Throws:

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

DataAssetExchangeClient

public DataAssetExchangeClient(String serverName,
                               String serverPlatformURLRoot)
                        throws InvalidParameterException

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

Parameters:

serverName - name of the server to connect to

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

Throws:

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

DataAssetExchangeClient

public DataAssetExchangeClient(String serverName,
                               String serverPlatformURLRoot,
                               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:

serverName - name of the server to connect to

serverPlatformURLRoot - 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

auditLog - logging destination

Throws:

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

DataAssetExchangeClient

public DataAssetExchangeClient(String serverName,
                               String serverPlatformURLRoot,
                               AssetManagerRESTClient restClient,
                               int maxPageSize,
                               AuditLog auditLog)
                        throws InvalidParameterException

Create a new client that is going to be used in an OMAG Server.

Parameters:

serverName - name of the server to connect to

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

restClient - client that issues the REST API calls

maxPageSize - maximum number of results supported by this server

auditLog - logging destination

Throws:

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

DataAssetExchangeClient

public DataAssetExchangeClient(String serverName,
                               String serverPlatformURLRoot,
                               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

serverPlatformURLRoot - 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 - there is a problem creating the client-side components to issue any REST API calls.

Method Detail

createAsset

public String createAsset(String userId,
                          String assetManagerGUID,
                          String assetManagerName,
                          boolean assetManagerIsHome,
                          String assetExternalIdentifier,
                          String assetExternalIdentifierName,
                          String assetExternalIdentifierUsage,
                          String assetExternalIdentifierSource,
                          KeyPattern assetExternalIdentifierKeyPattern,
                          Map<String,String> mappingProperties,
                          AssetProperties assetProperties)
                   throws InvalidParameterException,
                          UserNotAuthorizedException,
                          PropertyServerException

Create a new metadata element to represent the root of an asset.

Specified by:

createAsset in interface DataAssetExchangeInterface

Parameters:

userId - calling user

assetManagerGUID - unique identifier of software server capability representing the caller

assetManagerName - unique name of software server capability representing the caller

assetManagerIsHome - ensure that only the asset manager can update this asset

assetExternalIdentifier - unique identifier of the asset in the external asset manager

assetExternalIdentifierName - name of property for the external identifier in the external asset manager

assetExternalIdentifierUsage - optional usage description for the external identifier when calling the external asset manager

assetExternalIdentifierSource - component that issuing this request.

assetExternalIdentifierKeyPattern - pattern for the external identifier within the external asset manager (default is LOCAL_KEY)

mappingProperties - additional properties to help with the mapping of the elements in the external asset manager and open metadata

assetProperties - properties to store

Returns:

unique identifier of the new metadata element

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)

createAssetFromTemplate

public String createAssetFromTemplate(String userId,
                                      String assetManagerGUID,
                                      String assetManagerName,
                                      String templateGUID,
                                      String assetExternalIdentifier,
                                      String assetExternalIdentifierName,
                                      String assetExternalIdentifierUsage,
                                      String assetExternalIdentifierSource,
                                      KeyPattern assetExternalIdentifierKeyPattern,
                                      Map<String,String> mappingProperties,
                                      TemplateProperties templateProperties)
                               throws InvalidParameterException,
                                      UserNotAuthorizedException,
                                      PropertyServerException

Create a new metadata element to represent an asset using an existing metadata element as a template. The template defines additional classifications and relationships that should be added to the new asset.

Specified by:

createAssetFromTemplate in interface DataAssetExchangeInterface

Parameters:

userId - calling user

assetManagerGUID - unique identifier of software server capability representing the caller

assetManagerName - unique name of software server capability representing the caller

assetExternalIdentifier - unique identifier of the asset in the external asset manager

assetExternalIdentifierName - name of property for the external identifier in the external asset manager

assetExternalIdentifierUsage - optional usage description for the external identifier when calling the external asset manager

assetExternalIdentifierSource - component that issuing this request.

assetExternalIdentifierKeyPattern - pattern for the external identifier within the external asset manager (default is LOCAL_KEY)

mappingProperties - additional properties to help with the mapping of the elements in the external asset manager and open metadata

templateGUID - unique identifier of the metadata element to copy

templateProperties - properties that override the template

Returns:

unique identifier of the new metadata element

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)

updateAsset

public void updateAsset(String userId,
                        String assetManagerGUID,
                        String assetManagerName,
                        String assetGUID,
                        String assetExternalIdentifier,
                        boolean isMergeUpdate,
                        AssetProperties assetProperties)
                 throws InvalidParameterException,
                        UserNotAuthorizedException,
                        PropertyServerException

Update the metadata element representing an asset.

Specified by:

updateAsset in interface DataAssetExchangeInterface

Parameters:

userId - calling user

assetManagerGUID - unique identifier of software server capability representing the caller

assetManagerName - unique name of software server capability representing the caller

assetGUID - unique identifier of the metadata element to update

assetExternalIdentifier - unique identifier of the asset in the external asset manager

isMergeUpdate - should the new properties be merged with existing properties (true) or completely replace them (false)?

assetProperties - new properties for this element

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)

publishAsset

public void publishAsset(String userId,
                         String assetManagerGUID,
                         String assetManagerName,
                         String assetGUID)
                  throws InvalidParameterException,
                         UserNotAuthorizedException,
                         PropertyServerException

Update the zones for the asset so that it becomes visible to consumers. (The zones are set to the list of zones in the publishedZones option configured for each instance of the Asset Manager OMAS).

Specified by:

publishAsset in interface DataAssetExchangeInterface

Parameters:

userId - calling user

assetManagerGUID - unique identifier of software server capability representing the caller

assetManagerName - unique name of software server capability representing the caller

assetGUID - unique identifier of the metadata element to publish

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)

withdrawAsset

public void withdrawAsset(String userId,
                          String assetManagerGUID,
                          String assetManagerName,
                          String assetGUID)
                   throws InvalidParameterException,
                          UserNotAuthorizedException,
                          PropertyServerException

Update the zones for the asset so that it is no longer visible to consumers. (The zones are set to the list of zones in the defaultZones option configured for each instance of the Asset Manager OMAS. This is the setting when the database is first created).

Specified by:

withdrawAsset in interface DataAssetExchangeInterface

Parameters:

userId - calling user

assetManagerGUID - unique identifier of software server capability representing the caller

assetManagerName - unique name of software server capability representing the caller

assetGUID - unique identifier of the metadata element to withdraw

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)

removeAsset

public void removeAsset(String userId,
                        String assetManagerGUID,
                        String assetManagerName,
                        String assetGUID,
                        String assetExternalIdentifier)
                 throws InvalidParameterException,
                        UserNotAuthorizedException,
                        PropertyServerException

Remove the metadata element representing an asset. This will delete the asset and all anchored elements such as schema and comments.

Specified by:

removeAsset in interface DataAssetExchangeInterface

Parameters:

userId - calling user

assetManagerGUID - unique identifier of software server capability representing the caller

assetManagerName - unique name of software server capability representing the caller

assetGUID - unique identifier of the metadata element to remove

assetExternalIdentifier - unique identifier of the asset in the external asset manager

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)

setAssetAsReferenceData

public void setAssetAsReferenceData(String userId,
                                    String assetManagerGUID,
                                    String assetManagerName,
                                    String assetGUID,
                                    String assetExternalIdentifier)
                             throws InvalidParameterException,
                                    UserNotAuthorizedException,
                                    PropertyServerException

Classify the asset to indicate that it can be used as reference data.

Specified by:

setAssetAsReferenceData in interface DataAssetExchangeInterface

Parameters:

userId - calling user

assetManagerGUID - unique identifier of software server capability representing the caller

assetManagerName - unique name of software server capability representing the caller

assetGUID - unique identifier of the metadata element to update

assetExternalIdentifier - unique identifier of the asset in the external asset manager

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)

clearAssetAsReferenceData

public void clearAssetAsReferenceData(String userId,
                                      String assetManagerGUID,
                                      String assetManagerName,
                                      String assetGUID,
                                      String assetExternalIdentifier)
                               throws InvalidParameterException,
                                      UserNotAuthorizedException,
                                      PropertyServerException

Remove the reference data designation from the asset.

Specified by:

clearAssetAsReferenceData in interface DataAssetExchangeInterface

Parameters:

userId - calling user

assetManagerGUID - unique identifier of software server capability representing the caller

assetManagerName - unique name of software server capability representing the caller

assetGUID - unique identifier of the metadata element to update

assetExternalIdentifier - unique identifier of the asset in the external asset manager

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)

findAssets

public List<AssetElement> findAssets(String userId,
                                     String assetManagerGUID,
                                     String assetManagerName,
                                     String searchString,
                                     int startFrom,
                                     int pageSize)
                              throws InvalidParameterException,
                                     UserNotAuthorizedException,
                                     PropertyServerException

Retrieve the list of asset metadata elements that contain the search string. The search string is treated as a regular expression.

Specified by:

findAssets in interface DataAssetExchangeInterface

Parameters:

userId - calling user

assetManagerGUID - unique identifier of software server capability representing the caller

assetManagerName - unique name of software server capability representing the caller

searchString - string to find in the properties

startFrom - paging start point

pageSize - maximum results that can be returned

Returns:

list of matching metadata elements

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)

getAssetsByName

public List<AssetElement> getAssetsByName(String userId,
                                          String assetManagerGUID,
                                          String assetManagerName,
                                          String name,
                                          int startFrom,
                                          int pageSize)
                                   throws InvalidParameterException,
                                          UserNotAuthorizedException,
                                          PropertyServerException

Retrieve the list of asset metadata elements with a matching qualified or display name. There are no wildcards supported on this request.

Specified by:

getAssetsByName in interface DataAssetExchangeInterface

Parameters:

userId - calling user

assetManagerGUID - unique identifier of software server capability representing the caller

assetManagerName - unique name of software server capability representing the caller

name - name to search for

startFrom - paging start point

pageSize - maximum results that can be returned

Returns:

list of matching metadata elements

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)

getAssetsForAssetManager

public List<AssetElement> getAssetsForAssetManager(String userId,
                                                   String assetManagerGUID,
                                                   String assetManagerName,
                                                   int startFrom,
                                                   int pageSize)
                                            throws InvalidParameterException,
                                                   UserNotAuthorizedException,
                                                   PropertyServerException

Retrieve the list of assets created on behalf of the named asset manager.

Specified by:

getAssetsForAssetManager in interface DataAssetExchangeInterface

Parameters:

userId - calling user

assetManagerGUID - unique identifier of software server capability representing the caller

assetManagerName - unique name of software server capability representing the caller

startFrom - paging start point

pageSize - maximum results that can be returned

Returns:

list of matching metadata elements

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)

getAssetByGUID

public AssetElement getAssetByGUID(String userId,
                                   String assetManagerGUID,
                                   String assetManagerName,
                                   String openMetadataGUID)
                            throws InvalidParameterException,
                                   UserNotAuthorizedException,
                                   PropertyServerException

Retrieve the asset metadata element with the supplied unique identifier.

Specified by:

getAssetByGUID in interface DataAssetExchangeInterface

Parameters:

userId - calling user

assetManagerGUID - unique identifier of software server capability representing the caller

assetManagerName - unique name of software server capability representing the caller

openMetadataGUID - unique identifier of the requested metadata element

Returns:

matching metadata element

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)