Package org.odpi.openmetadata.accessservices.assetowner.client

Class ExternalReferenceManager

java.lang.Object

org.odpi.openmetadata.frameworkservices.ocf.metadatamanagement.client.ConnectedAssetClientBase

org.odpi.openmetadata.accessservices.assetowner.client.AssetOwnerBaseClient

org.odpi.openmetadata.accessservices.assetowner.client.ExternalReferenceManager

All Implemented Interfaces:

ExternalReferencesInterface, RelatedElementsManagementInterface, ConnectorFactoryInterface

public class ExternalReferenceManager
extends AssetOwnerBaseClient
implements ExternalReferencesInterface

ExternalReferenceManager is the java client for managing external references and their links to all types of governance definitions.

Field Summary

Fields inherited from class org.odpi.openmetadata.accessservices.assetowner.client.AssetOwnerBaseClient

defaultAssetType, nullRequestBody, restClient, serviceURLName, urlTemplatePrefix

Fields inherited from class org.odpi.openmetadata.frameworkservices.ocf.metadatamanagement.client.ConnectedAssetClientBase

auditLog, invalidParameterHandler, serverName, serverPlatformURLRoot

Constructor Summary

Constructors

Constructor	Description
ExternalReferenceManager(String serverName, String serverPlatformURLRoot)	Create a new client with no authentication embedded in the HTTP request.
ExternalReferenceManager(String serverName, String serverPlatformURLRoot, int maxPageSize, AuditLog auditLog)	Create a new client with no authentication embedded in the HTTP request.
ExternalReferenceManager(String serverName, String serverPlatformURLRoot, String userId, String password)	Create a new client that passes userId and password in each HTTP request.
ExternalReferenceManager(String serverName, String serverPlatformURLRoot, String userId, String password, int maxPageSize, AuditLog auditLog)	Create a new client that passes userId and password in each HTTP request.
ExternalReferenceManager(String serverName, String serverPlatformURLRoot, AssetOwnerRESTClient restClient, int maxPageSize)	Create a new client that uses the supplied rest client.

Method Summary

Modifier and Type	Method	Description
String	createExternalReference(String userId, String anchorGUID, ExternalReferenceProperties properties)	Create a definition of an external reference.
void	deleteExternalReference(String userId, String externalReferenceGUID)	Remove the definition of an external reference.
List<ExternalReferenceElement>	findExternalReferencesById(String userId, String resourceId, int startFrom, int pageSize)	Retrieve the list of external references for this resourceId.
List<RelatedElement>	getElementsForExternalReference(String userId, String externalReferenceGUID, int startFrom, int pageSize)	Return information about the elements linked to a externalReference.
ExternalReferenceElement	getExternalReferenceByGUID(String userId, String externalReferenceGUID)	Return information about a specific external reference.
List<ExternalReferenceElement>	getExternalReferencesByURL(String userId, String url, int startFrom, int pageSize)	Retrieve the list of external references for this URL.
void	linkExternalReferenceToElement(String userId, String attachedToGUID, String externalReferenceGUID, ExternalReferenceLinkProperties linkProperties)	Link an external reference to an object.
List<ExternalReferenceElement>	retrieveAttachedExternalReferences(String userId, String attachedToGUID, int startFrom, int pageSize)	Retrieve the list of external references attached to the supplied object.
void	unlinkExternalReferenceFromElement(String userId, String attachedToGUID, String externalReferenceGUID)	Remove the link between an external reference and an element.
void	updateExternalReference(String userId, String externalReferenceGUID, boolean isMergeUpdate, ExternalReferenceProperties properties)	Update the definition of an external reference.

Methods inherited from class org.odpi.openmetadata.accessservices.assetowner.client.AssetOwnerBaseClient

clearCatalogTemplate, clearMoreInformation, clearResource, clearStakeholder, getCatalogTemplateList, getDescriptiveElements, getMoreInformation, getResourceList, getStakeholderCommissionedElements, getStakeholders, getSupportedByResource, getSupportedByTemplate, removeReferenceable, setupCatalogTemplate, setupMoreInformation, setupResource, setupStakeholder, updateRelationship

Methods inherited from class org.odpi.openmetadata.frameworkservices.ocf.metadatamanagement.client.ConnectedAssetClientBase

getAnchorAssetFromGUID, getAssetForConnection, getAssetProperties, getAssetSummary, getConnectionByGUID, getConnectionByName, getConnectionForAsset, getConnectorByConnection, getConnectorByGUID, getConnectorByName, getConnectorForAsset, getConnectorForConnection, logAssetAuditMessage, saveConnection, saveConnection

Methods inherited from class java.lang.Object

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

Constructor Details

ExternalReferenceManager

public ExternalReferenceManager(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 services

Throws:

InvalidParameterException - bad input parameters

ExternalReferenceManager

public ExternalReferenceManager(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 services

userId - caller's userId embedded in all HTTP requests

password - caller's userId embedded in all HTTP requests

Throws:

InvalidParameterException - bad input parameters

ExternalReferenceManager

public ExternalReferenceManager(String serverName,
 String serverPlatformURLRoot,
 int maxPageSize,
 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 services

maxPageSize - pre-initialized parameter limit

auditLog - logging destination

Throws:

InvalidParameterException - bad input parameters

ExternalReferenceManager

public ExternalReferenceManager(String serverName,
 String serverPlatformURLRoot,
 String userId,
 String password,
 int maxPageSize,
 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 services

userId - caller's userId embedded in all HTTP requests

password - caller's userId embedded in all HTTP requests

maxPageSize - pre-initialized parameter limit

auditLog - logging destination

Throws:

InvalidParameterException - bad input parameters

ExternalReferenceManager

public ExternalReferenceManager(String serverName,
 String serverPlatformURLRoot,
 AssetOwnerRESTClient restClient,
 int maxPageSize)
                         throws InvalidParameterException

Create a new client that uses the supplied rest client. This is typically used when called from another OMAG Server.

Parameters:

serverName - name of the server to connect to

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

restClient - internal client for rest calls

maxPageSize - pre-initialized parameter limit

Throws:

InvalidParameterException - bad input parameters

Method Details

createExternalReference

public String createExternalReference(String userId,
 String anchorGUID,
 ExternalReferenceProperties properties)
                               throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Create a definition of an external reference.

Specified by:

createExternalReference in interface ExternalReferencesInterface

Parameters:

userId - calling user

anchorGUID - optional element to link the external reference to that will act as an anchor - that is, this external reference will be deleted when the element is deleted (once the external reference is linked to the anchor).

properties - properties for a external reference

Returns:

unique identifier of the external reference

Throws:

InvalidParameterException - qualifiedName or userId is null; qualifiedName is not unique

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem

updateExternalReference

public void updateExternalReference(String userId,
 String externalReferenceGUID,
 boolean isMergeUpdate,
 ExternalReferenceProperties properties)
                             throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Update the definition of an external reference.

Specified by:

updateExternalReference in interface ExternalReferencesInterface

Parameters:

userId - calling user

externalReferenceGUID - unique identifier of external reference

isMergeUpdate - are unspecified properties unchanged (true) or replaced with null?

properties - properties to change

Throws:

InvalidParameterException - guid, qualifiedName or userId is null; qualifiedName is not unique; guid is not known

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem

deleteExternalReference

public void deleteExternalReference(String userId,
 String externalReferenceGUID)
                             throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Remove the definition of an external reference.

Specified by:

deleteExternalReference in interface ExternalReferencesInterface

Parameters:

userId - calling user

externalReferenceGUID - unique identifier of external reference

Throws:

InvalidParameterException - guid or userId is null; guid is not known

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem

linkExternalReferenceToElement

public void linkExternalReferenceToElement(String userId,
 String attachedToGUID,
 String externalReferenceGUID,
 ExternalReferenceLinkProperties linkProperties)
                                    throws InvalidParameterException,
PropertyServerException,
UserNotAuthorizedException

Link an external reference to an object.

Specified by:

linkExternalReferenceToElement in interface ExternalReferencesInterface

Parameters:

userId - the name of the calling user.

attachedToGUID - object linked to external references.

externalReferenceGUID - unique identifier (guid) of the external reference details.

linkProperties - description for the reference from the perspective of the object that the reference is being attached to.

Throws:

InvalidParameterException - problem with the GUID or the external references are not correctly specified, or are null.

PropertyServerException - the server is not available.

UserNotAuthorizedException - the calling user is not authorized to issue the call.

unlinkExternalReferenceFromElement

public void unlinkExternalReferenceFromElement(String userId,
 String attachedToGUID,
 String externalReferenceGUID)
                                        throws InvalidParameterException,
PropertyServerException,
UserNotAuthorizedException

Remove the link between an external reference and an element. If the element is its anchor, the external reference is removed.

Specified by:

unlinkExternalReferenceFromElement in interface ExternalReferencesInterface

Parameters:

userId - the name of the calling user.

attachedToGUID - object linked to external references.

externalReferenceGUID - identifier of the external reference.

Throws:

InvalidParameterException - problem with the GUID or the external references are not correctly specified, or are null.

PropertyServerException - the server is not available.

UserNotAuthorizedException - the calling user is not authorized to issue the call.

getExternalReferenceByGUID

public ExternalReferenceElement getExternalReferenceByGUID(String userId,
 String externalReferenceGUID)
                                                    throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Return information about a specific external reference.

Specified by:

getExternalReferenceByGUID in interface ExternalReferencesInterface

Parameters:

userId - calling user

externalReferenceGUID - unique identifier for the external reference

Returns:

properties of the external reference

Throws:

InvalidParameterException - externalReferenceGUID or userId is null

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem

findExternalReferencesById

public List<ExternalReferenceElement> findExternalReferencesById(String userId,
 String resourceId,
 int startFrom,
 int pageSize)
                                                          throws InvalidParameterException,
PropertyServerException,
UserNotAuthorizedException

Retrieve the list of external references for this resourceId.

Specified by:

findExternalReferencesById in interface ExternalReferencesInterface

Parameters:

userId - the name of the calling user.

resourceId - unique reference id assigned by the resource owner (supports wildcards). This is the qualified name of the entity

startFrom - index of the list to start from (0 for start)

pageSize - maximum number of elements to return.

Returns:

links to addition information.

Throws:

InvalidParameterException - guid invalid or the external references are not correctly specified, or are null.

PropertyServerException - the server is not available.

UserNotAuthorizedException - the calling user is not authorized to issue the call.

getExternalReferencesByURL

public List<ExternalReferenceElement> getExternalReferencesByURL(String userId,
 String url,
 int startFrom,
 int pageSize)
                                                          throws InvalidParameterException,
PropertyServerException,
UserNotAuthorizedException

Retrieve the list of external references for this URL.

Specified by:

getExternalReferencesByURL in interface ExternalReferencesInterface

Parameters:

userId - the name of the calling user.

url - URL of the external resource.

startFrom - index of the list to start from (0 for start)

pageSize - maximum number of elements to return.

Returns:

links to addition information.

Throws:

InvalidParameterException - guid invalid or the external references are not correctly specified, or are null.

PropertyServerException - the server is not available.

UserNotAuthorizedException - the calling user is not authorized to issue the call.

retrieveAttachedExternalReferences

public List<ExternalReferenceElement> retrieveAttachedExternalReferences(String userId,
 String attachedToGUID,
 int startFrom,
 int pageSize)
                                                                  throws InvalidParameterException,
PropertyServerException,
UserNotAuthorizedException

Retrieve the list of external references attached to the supplied object.

Specified by:

retrieveAttachedExternalReferences in interface ExternalReferencesInterface

Parameters:

userId - the name of the calling user.

attachedToGUID - object linked to external reference.

startFrom - index of the list to start from (0 for start)

pageSize - maximum number of elements to return.

Returns:

links to addition information.

Throws:

InvalidParameterException - guid invalid or the external references are not correctly specified, or are null.

PropertyServerException - the server is not available.

UserNotAuthorizedException - the calling user is not authorized to issue the call.

getElementsForExternalReference

public List<RelatedElement> getElementsForExternalReference(String userId,
 String externalReferenceGUID,
 int startFrom,
 int pageSize)
                                                     throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Return information about the elements linked to a externalReference.

Specified by:

getElementsForExternalReference in interface ExternalReferencesInterface

Parameters:

userId - calling user

externalReferenceGUID - unique identifier for the externalReference

startFrom - paging start point

pageSize - maximum results that can be returned

Returns:

properties of the related elements

Throws:

InvalidParameterException - qualifiedName or userId is null

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem