org.odpi.openmetadata.accessservices.discoveryengine.server

Class DiscoveryEngineServices

java.lang.Object

org.odpi.openmetadata.accessservices.discoveryengine.server.DiscoveryEngineServices

public class DiscoveryEngineServices
extends Object

The DiscoveryEngineServices provides the server-side implementation of the services used by the discovery engine as it is managing requests to execute open discovery services in the discovery server. These services align with the interface definitions from the Open Discovery Framework (ODF).

Constructor Summary

Constructors

Constructor and Description
DiscoveryEngineServices() Default constructor

Method Summary

Modifier and Type	Method and Description
AnnotationResponse	addAnnotationToAnnotation(String serverName, String userId, String anchorAnnotationGUID, Annotation requestBody) Add a new annotation and link it to an existing annotation.
GUIDResponse	addAnnotationToDiscoveryReport(String serverName, String userId, String discoveryReportGUID, Annotation requestBody) Add a new annotation to the annotation store as a top level annotation linked directly off of the report.
DiscoveryAnalysisReportResponse	createDiscoveryAnalysisReport(String serverName, String userId, String assetGUID, DiscoveryAnalysisReportRequestBody requestBody) Create a new discovery analysis report and chain it to its asset, discovery engine and discovery service.
VoidResponse	deleteAnnotation(String serverName, String userId, String annotationGUID, NullRequestBody requestBody) Remove an annotation from the annotation store.
AnnotationResponse	getAnnotation(String serverName, String userId, String annotationGUID) Retrieve a single annotation by unique identifier.
AnnotationListResponse	getAnnotationsForAssetByStatus(String serverName, String userId, String assetGUID, int startingFrom, int maximumResults, StatusRequestBody requestBody) Return the list of annotations from previous runs of the discovery service that are set to a specific status.
DiscoveryAnalysisReportResponse	getDiscoveryAnalysisReport(String serverName, String userId, String discoveryReportGUID) Request the discovery report for a discovery request that has completed.
AnnotationListResponse	getDiscoveryReportAnnotations(String serverName, String userId, String discoveryReportGUID, int startingFrom, int maximumResults) Return the annotations linked directly to the report.
AnnotationListResponse	getExtendedAnnotations(String serverName, String userId, String annotationGUID, int startingFrom, int maximumResults) Return any annotations attached to this annotation.
VoidResponse	linkAnnotation(String serverName, String userId, String anchorGUID, String annotationGUID, NullRequestBody requestBody) Link an existing annotation to another object.
VoidResponse	unlinkAnnotation(String serverName, String userId, String anchorGUID, String annotationGUID, NullRequestBody requestBody) Remove the relationship between an annotation and another object.
AnnotationResponse	updateAnnotation(String serverName, String userId, String annotationGUID, Annotation requestBody) Replace the current properties of an annotation.
DiscoveryAnalysisReportResponse	updateDiscoveryAnalysisReport(String serverName, String userId, String discoveryReportGUID, DiscoveryAnalysisReport requestBody) Update the properties of the discovery analysis report.

Methods inherited from class java.lang.Object

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

Constructor Detail

DiscoveryEngineServices

public DiscoveryEngineServices()

Default constructor

Method Detail

createDiscoveryAnalysisReport

public DiscoveryAnalysisReportResponse createDiscoveryAnalysisReport(String serverName,
                                                                     String userId,
                                                                     String assetGUID,
                                                                     DiscoveryAnalysisReportRequestBody requestBody)

Create a new discovery analysis report and chain it to its asset, discovery engine and discovery service.

Parameters:

serverName - name of server instance to route request to

userId - calling user

assetGUID - unique identifier of the asset being analysed

requestBody - all of the other parameters

Returns:

The new discovery report or InvalidParameterException one of the parameters is invalid or UserNotAuthorizedException the user is not authorized to access the asset and/or report or PropertyServerException there was a problem in the store whether the asset/report properties are kept.

updateDiscoveryAnalysisReport

public DiscoveryAnalysisReportResponse updateDiscoveryAnalysisReport(String serverName,
                                                                     String userId,
                                                                     String discoveryReportGUID,
                                                                     DiscoveryAnalysisReport requestBody)

Update the properties of the discovery analysis report.

Parameters:

serverName - name of server instance to route request to

userId - calling user

discoveryReportGUID - unique identifier of the report to update

requestBody - updated report - this will replace what was previous stored

Returns:

the new values stored in the repository or InvalidParameterException one of the parameters is null or invalid. UserNotAuthorizedException user not authorized to issue this request. PropertyServerException there was a problem that occurred within the property server.

getDiscoveryAnalysisReport

public DiscoveryAnalysisReportResponse getDiscoveryAnalysisReport(String serverName,
                                                                  String userId,
                                                                  String discoveryReportGUID)

Request the discovery report for a discovery request that has completed.

Parameters:

serverName - name of server instance to route request to

userId - identifier of calling user

discoveryReportGUID - identifier of the discovery request.

Returns:

discovery report or InvalidParameterException one of the parameters is null or invalid. UserNotAuthorizedException user not authorized to issue this request. PropertyServerException there was a problem that occurred within the property server.

getAnnotationsForAssetByStatus

public AnnotationListResponse getAnnotationsForAssetByStatus(String serverName,
                                                             String userId,
                                                             String assetGUID,
                                                             int startingFrom,
                                                             int maximumResults,
                                                             StatusRequestBody requestBody)

Return the list of annotations from previous runs of the discovery service that are set to a specific status. If status is null then annotations that have been reviewed, approved and/or actioned are returned from discovery reports that are not waiting or in progress.

Parameters:

serverName - name of server instance to route request to

userId - calling user

assetGUID - unique identifier of the asset

startingFrom - starting position in the list.

maximumResults - maximum number of elements that can be returned

requestBody - status value to use on the query

Returns:

list of annotation (or null if none are registered) or InvalidParameterException one of the parameters is invalid UserNotAuthorizedException the user id not authorized to issue this request PropertyServerException there was a problem retrieving annotations from the annotation store.

getDiscoveryReportAnnotations

public AnnotationListResponse getDiscoveryReportAnnotations(String serverName,
                                                            String userId,
                                                            String discoveryReportGUID,
                                                            int startingFrom,
                                                            int maximumResults)

Return the annotations linked directly to the report.

Parameters:

serverName - name of server instance to route request to

userId - identifier of calling user

discoveryReportGUID - identifier of the discovery request.

startingFrom - initial position in the stored list.

maximumResults - maximum number of definitions to return on this call.

Returns:

list of annotations or InvalidParameterException one of the parameters is null or invalid. UserNotAuthorizedException user not authorized to issue this request. PropertyServerException there was a problem that occurred within the property server.

getExtendedAnnotations

public AnnotationListResponse getExtendedAnnotations(String serverName,
                                                     String userId,
                                                     String annotationGUID,
                                                     int startingFrom,
                                                     int maximumResults)

Return any annotations attached to this annotation.

Parameters:

serverName - name of server instance to route request to

userId - identifier of calling user

annotationGUID - anchor annotation

startingFrom - starting position in the list

maximumResults - maximum number of annotations that can be returned.

Returns:

list of Annotation objects or InvalidParameterException one of the parameters is null or invalid. UserNotAuthorizedException user not authorized to issue this request. PropertyServerException there was a problem that occurred within the property server.

getAnnotation

public AnnotationResponse getAnnotation(String serverName,
                                        String userId,
                                        String annotationGUID)

Retrieve a single annotation by unique identifier. This call is typically used to retrieve the latest values for an annotation.

Parameters:

serverName - name of server instance to route request to

userId - identifier of calling user

annotationGUID - unique identifier of the annotation

Returns:

Annotation object or InvalidParameterException one of the parameters is null or invalid. UserNotAuthorizedException user not authorized to issue this request. PropertyServerException there was a problem that occurred within the property server.

addAnnotationToDiscoveryReport

public GUIDResponse addAnnotationToDiscoveryReport(String serverName,
                                                   String userId,
                                                   String discoveryReportGUID,
                                                   Annotation requestBody)

Add a new annotation to the annotation store as a top level annotation linked directly off of the report.

Parameters:

serverName - name of server instance to route request to

userId - identifier of calling user

discoveryReportGUID - unique identifier of the discovery analysis report

requestBody - annotation object

Returns:

unique identifier of new annotation or InvalidParameterException the annotation is invalid UserNotAuthorizedException the user id not authorized to issue this request PropertyServerException there was a problem retrieving adding the annotation to the annotation store.

addAnnotationToAnnotation

public AnnotationResponse addAnnotationToAnnotation(String serverName,
                                                    String userId,
                                                    String anchorAnnotationGUID,
                                                    Annotation requestBody)

Add a new annotation and link it to an existing annotation.

Parameters:

serverName - name of server instance to route request to

userId - identifier of calling user

anchorAnnotationGUID - unique identifier of the annotation that this new one os to be attached to

requestBody - annotation object

Returns:

fully filled out annotation or InvalidParameterException one of the parameters is invalid UserNotAuthorizedException the user id not authorized to issue this request PropertyServerException there was a problem saving annotations in the annotation store.

linkAnnotation

public VoidResponse linkAnnotation(String serverName,
                                   String userId,
                                   String anchorGUID,
                                   String annotationGUID,
                                   NullRequestBody requestBody)

Link an existing annotation to another object. The anchor object must be a Referenceable.

Parameters:

serverName - name of server instance to route request to

userId - identifier of calling user

anchorGUID - unique identifier that the annotation is to be linked to

annotationGUID - unique identifier of the annotation

requestBody - null request body to satisfy POST semantics

Returns:

void or InvalidParameterException one of the parameters is invalid UserNotAuthorizedException the user id not authorized to issue this request PropertyServerException there was a problem updating annotations in the annotation store.

unlinkAnnotation

public VoidResponse unlinkAnnotation(String serverName,
                                     String userId,
                                     String anchorGUID,
                                     String annotationGUID,
                                     NullRequestBody requestBody)

Remove the relationship between an annotation and another object.

Parameters:

serverName - name of server instance to route request to

userId - identifier of calling user

anchorGUID - unique identifier that the annotation is to be unlinked from

annotationGUID - unique identifier of the annotation

requestBody - null request body to satisfy POST semantics

Returns:

void or InvalidParameterException one of the parameters is invalid UserNotAuthorizedException the user id not authorized to issue this request PropertyServerException there was a problem updating annotations in the annotation store.

updateAnnotation

public AnnotationResponse updateAnnotation(String serverName,
                                           String userId,
                                           String annotationGUID,
                                           Annotation requestBody)

Replace the current properties of an annotation.

Parameters:

serverName - name of server instance to route request to

userId - identifier of calling user

annotationGUID - identifier of the annotation to change

requestBody - new properties

Returns:

fully filled out annotation or InvalidParameterException one of the parameters is invalid UserNotAuthorizedException the user id not authorized to issue this request PropertyServerException there was a problem updating the annotation in the annotation store.

deleteAnnotation

public VoidResponse deleteAnnotation(String serverName,
                                     String userId,
                                     String annotationGUID,
                                     NullRequestBody requestBody)

Remove an annotation from the annotation store.

Parameters:

serverName - name of server instance to route request to

userId - identifier of calling user

annotationGUID - unique identifier of the annotation

requestBody - null request body to satisfy POST semantics

Returns:

void or InvalidParameterException one of the parameters is invalid UserNotAuthorizedException the user id not authorized to issue this request PropertyServerException there was a problem deleting the annotation from the annotation store.