org.odpi.openmetadata.accessservices.discoveryengine.client

Class DiscoveryAnnotationStoreClient

java.lang.Object

org.odpi.openmetadata.frameworks.discovery.DiscoveryAnnotationStore

org.odpi.openmetadata.accessservices.discoveryengine.client.DiscoveryAnnotationStoreClient

public class DiscoveryAnnotationStoreClient
extends DiscoveryAnnotationStore

DiscoveryAnnotationStoreClient provides a client-side implementation of the ODF DiscoveryAnnotationStore that is backed by calls to the Discovery Engine OMAS. An instance of this client is created for each discovery service instance that runs. This is why the REST client is passed in on the constructor (since creating a new RestTemplate object is very expensive).

Field Summary

Fields inherited from class org.odpi.openmetadata.frameworks.discovery.DiscoveryAnnotationStore

assetGUID, discoveryReportGUID, userId

Constructor Summary

Constructors

Constructor and Description
DiscoveryAnnotationStoreClient(String userId, String assetGUID, String discoveryReportGUID, DiscoveryEngineClient discoveryEngineClient) Constructor sets up the key parameters for accessing the annotations store.

Method Summary

Modifier and Type	Method and Description
String	addAnnotationToAnnotation(String anchorAnnotationGUID, Annotation annotation) Add a new annotation and link it to an existing annotation.
String	addAnnotationToDataField(String anchorDataFieldGUID, Annotation annotation) Add a new annotation and link it to an existing data field.
String	addAnnotationToDiscoveryReport(Annotation annotation) Add a new annotation to the annotation store as a top level annotation linked directly off of the report.
String	addDataFieldToDataField(String anchorDataFieldGUID, DataField dataField) Add a new data field and link it to an existing data field.
String	addDataFieldToDiscoveryReport(String annotationGUID, DataField dataField) Add a new data field to the Annotation store linked off of an annotation (typically SchemaAnalysisAnnotation).
void	deleteAnnotation(String annotationGUID) Remove an annotation from the annotation store.
void	deleteDataField(String dataFieldGUID) Remove a data field from the annotation store.
Annotation	getAnnotation(String annotationGUID) Return a specific annotation stored in the annotation store (previous or new).
DataField	getDataField(String dataFieldGUID) Return a specific data field stored in the annotation store (previous or new).
List<Annotation>	getExtendedAnnotations(String annotationGUID, int startingFrom, int maximumResults) Return any annotations attached to this annotation.
List<DataField>	getNestedDataFields(String anchorDataFieldGUID, int startingFrom, int maximumResults) Return any annotations attached to this annotation.
List<Annotation>	getNewAnnotationsForAsset(int startingFrom, int maximumResults) Return the current list of annotations for this discovery run.
List<Annotation>	getNewDataFieldsForAsset(int startingFrom, int maximumResults) Return the current list of data fields for this discovery run.
List<Annotation>	getPreviousAnnotationsForAsset(AnnotationStatus status, int startingFrom, int maximumResults) Return the list of annotations from previous runs of the discovery service that are set to a specific status.
List<Annotation>	getPreviousAnnotationsForAsset(int startingFrom, int maximumResults) Return the list of Annotations created for the asset by previous runs of the discovery service.
List<DataField>	getPreviousDataFieldsForAsset(int startingFrom, int maximumResults) Return the list of data fields from previous runs of the discovery service.
void	linkAnnotation(String anchorGUID, String annotationGUID) Link an existing annotation to another object.
void	unlinkAnnotation(String anchorGUID, String annotationGUID) Remove the relationship between an annotation and another object.
Annotation	updateAnnotation(Annotation annotation) Replace the current properties of an annotation.
DataField	updateDataField(DataField dataField) Replace the current properties of a data field.

Methods inherited from class java.lang.Object

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

Constructor Detail

DiscoveryAnnotationStoreClient

public DiscoveryAnnotationStoreClient(String userId,
                                      String assetGUID,
                                      String discoveryReportGUID,
                                      DiscoveryEngineClient discoveryEngineClient)

Constructor sets up the key parameters for accessing the annotations store.

Parameters:

userId - calling user

assetGUID - unique identifier of the asset that the annotations should be attached to

discoveryReportGUID - unique identifier of the discovery request that is used to identifier the discovery report.

discoveryEngineClient - client for calling REST APIs

Method Detail

getPreviousAnnotationsForAsset

public List<Annotation> getPreviousAnnotationsForAsset(int startingFrom,
                                                       int maximumResults)
                                                throws InvalidParameterException,
                                                       UserNotAuthorizedException,
                                                       PropertyServerException

Return the list of Annotations created for the asset by previous runs of the discovery service.

Specified by:

getPreviousAnnotationsForAsset in class DiscoveryAnnotationStore

Parameters:

startingFrom - starting position in the list.

maximumResults - maximum number of elements that can be returned

Returns:

list of annotation (or null if none are registered)

Throws:

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.

getPreviousAnnotationsForAsset

public List<Annotation> getPreviousAnnotationsForAsset(AnnotationStatus status,
                                                       int startingFrom,
                                                       int maximumResults)
                                                throws InvalidParameterException,
                                                       UserNotAuthorizedException,
                                                       PropertyServerException

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.

Specified by:

getPreviousAnnotationsForAsset in class DiscoveryAnnotationStore

Parameters:

status - status value to use on the query

startingFrom - starting position in the list.

maximumResults - maximum number of elements that can be returned

Returns:

list of annotation (or null if none are registered)

Throws:

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.

getNewAnnotationsForAsset

public List<Annotation> getNewAnnotationsForAsset(int startingFrom,
                                                  int maximumResults)
                                           throws InvalidParameterException,
                                                  UserNotAuthorizedException,
                                                  PropertyServerException

Return the current list of annotations for this discovery run.

Specified by:

getNewAnnotationsForAsset in class DiscoveryAnnotationStore

Parameters:

startingFrom - starting position in the list.

maximumResults - maximum number of elements that can be returned

Returns:

list of annotation (or null if none are registered)

Throws:

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.

getExtendedAnnotations

public List<Annotation> getExtendedAnnotations(String annotationGUID,
                                               int startingFrom,
                                               int maximumResults)
                                        throws InvalidParameterException,
                                               UserNotAuthorizedException,
                                               PropertyServerException

Return any annotations attached to this annotation.

Specified by:

getExtendedAnnotations in class DiscoveryAnnotationStore

Parameters:

annotationGUID - anchor annotation

startingFrom - starting position in the list

maximumResults - maximum number of annotations that can be returned.

Returns:

list of Annotation objects

Throws:

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 Annotation getAnnotation(String annotationGUID)
                         throws InvalidParameterException,
                                UserNotAuthorizedException,
                                PropertyServerException

Return a specific annotation stored in the annotation store (previous or new).

Specified by:

getAnnotation in class DiscoveryAnnotationStore

Parameters:

annotationGUID - unique identifier of the annotation

Returns:

annotation object

Throws:

InvalidParameterException - one of the parameters is invalid

UserNotAuthorizedException - the user id not authorized to issue this request

PropertyServerException - there was a problem retrieving the annotation from the annotation store.

addAnnotationToDiscoveryReport

public String addAnnotationToDiscoveryReport(Annotation annotation)
                                      throws InvalidParameterException,
                                             UserNotAuthorizedException,
                                             PropertyServerException

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

Specified by:

addAnnotationToDiscoveryReport in class DiscoveryAnnotationStore

Parameters:

annotation - annotation object

Returns:

unique identifier of new annotation

Throws:

InvalidParameterException - the annotation is invalid

UserNotAuthorizedException - the user id not authorized to issue this request

PropertyServerException - there was a problem adding the annotation to the annotation store.

addAnnotationToAnnotation

public String addAnnotationToAnnotation(String anchorAnnotationGUID,
                                        Annotation annotation)
                                 throws InvalidParameterException,
                                        UserNotAuthorizedException,
                                        PropertyServerException

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

Specified by:

addAnnotationToAnnotation in class DiscoveryAnnotationStore

Parameters:

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

annotation - annotation object

Returns:

unique identifier of new annotation

Throws:

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 void linkAnnotation(String anchorGUID,
                           String annotationGUID)
                    throws InvalidParameterException,
                           UserNotAuthorizedException,
                           PropertyServerException

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

Specified by:

linkAnnotation in class DiscoveryAnnotationStore

Parameters:

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

annotationGUID - unique identifier of the annotation

Throws:

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 void unlinkAnnotation(String anchorGUID,
                             String annotationGUID)
                      throws InvalidParameterException,
                             UserNotAuthorizedException,
                             PropertyServerException

Remove the relationship between an annotation and another object.

Specified by:

unlinkAnnotation in class DiscoveryAnnotationStore

Parameters:

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

annotationGUID - unique identifier of the annotation

Throws:

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 Annotation updateAnnotation(Annotation annotation)
                            throws InvalidParameterException,
                                   UserNotAuthorizedException,
                                   PropertyServerException

Replace the current properties of an annotation.

Specified by:

updateAnnotation in class DiscoveryAnnotationStore

Parameters:

annotation - new properties

Returns:

fully filled out annotation

Throws:

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 void deleteAnnotation(String annotationGUID)
                      throws InvalidParameterException,
                             UserNotAuthorizedException,
                             PropertyServerException

Remove an annotation from the annotation store.

Specified by:

deleteAnnotation in class DiscoveryAnnotationStore

Parameters:

annotationGUID - unique identifier of the annotation

Throws:

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.

getPreviousDataFieldsForAsset

public List<DataField> getPreviousDataFieldsForAsset(int startingFrom,
                                                     int maximumResults)
                                              throws InvalidParameterException,
                                                     UserNotAuthorizedException,
                                                     PropertyServerException

Return the list of data fields from previous runs of the discovery service.

Specified by:

getPreviousDataFieldsForAsset in class DiscoveryAnnotationStore

Parameters:

startingFrom - starting position in the list.

maximumResults - maximum number of elements that can be returned

Returns:

list of data fields (or null if none are registered)

Throws:

InvalidParameterException - one of the parameters is invalid

UserNotAuthorizedException - the user id not authorized to issue this request

PropertyServerException - there was a problem retrieving data fields from the annotation store.

getNewDataFieldsForAsset

public List<Annotation> getNewDataFieldsForAsset(int startingFrom,
                                                 int maximumResults)
                                          throws InvalidParameterException,
                                                 UserNotAuthorizedException,
                                                 PropertyServerException

Return the current list of data fields for this discovery run.

Specified by:

getNewDataFieldsForAsset in class DiscoveryAnnotationStore

Parameters:

startingFrom - starting position in the list.

maximumResults - maximum number of elements that can be returned

Returns:

list of data fields (or null if none are registered)

Throws:

InvalidParameterException - one of the parameters is invalid

UserNotAuthorizedException - the user id not authorized to issue this request

PropertyServerException - there was a problem retrieving data fields from the annotation store.

getNestedDataFields

public List<DataField> getNestedDataFields(String anchorDataFieldGUID,
                                           int startingFrom,
                                           int maximumResults)
                                    throws InvalidParameterException,
                                           UserNotAuthorizedException,
                                           PropertyServerException

Return any annotations attached to this annotation.

Specified by:

getNestedDataFields in class DiscoveryAnnotationStore

Parameters:

anchorDataFieldGUID - anchor data field identifier

startingFrom - starting position in the list

maximumResults - maximum number of annotations that can be returned.

Returns:

list of DataField objects

Throws:

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.

getDataField

public DataField getDataField(String dataFieldGUID)
                       throws InvalidParameterException,
                              UserNotAuthorizedException,
                              PropertyServerException

Return a specific data field stored in the annotation store (previous or new).

Specified by:

getDataField in class DiscoveryAnnotationStore

Parameters:

dataFieldGUID - unique identifier of the data field

Returns:

data field object

Throws:

InvalidParameterException - one of the parameters is invalid

UserNotAuthorizedException - the user id not authorized to issue this request

PropertyServerException - there was a problem retrieving the data field from the annotation store.

addDataFieldToDiscoveryReport

public String addDataFieldToDiscoveryReport(String annotationGUID,
                                            DataField dataField)
                                     throws InvalidParameterException,
                                            UserNotAuthorizedException,
                                            PropertyServerException

Add a new data field to the Annotation store linked off of an annotation (typically SchemaAnalysisAnnotation).

Specified by:

addDataFieldToDiscoveryReport in class DiscoveryAnnotationStore

Parameters:

annotationGUID - unique identifier of the annotation that the data field is to be linked to

dataField - dataField object

Returns:

unique identifier of new dataField

Throws:

InvalidParameterException - the dataField is invalid or the annotation GUID points to an annotation that can not be associated with a data field.

UserNotAuthorizedException - the user id not authorized to issue this request

PropertyServerException - there was a problem adding the data field to the Annotation store.

addDataFieldToDataField

public String addDataFieldToDataField(String anchorDataFieldGUID,
                                      DataField dataField)
                               throws InvalidParameterException,
                                      UserNotAuthorizedException,
                                      PropertyServerException

Add a new data field and link it to an existing data field.

Specified by:

addDataFieldToDataField in class DiscoveryAnnotationStore

Parameters:

anchorDataFieldGUID - unique identifier of the data field that this new one is to be attached to

dataField - data field object

Returns:

unique identifier of new data field

Throws:

InvalidParameterException - one of the parameters is invalid

UserNotAuthorizedException - the user id not authorized to issue this request

PropertyServerException - there was a problem saving data fields in the annotation store.

addAnnotationToDataField

public String addAnnotationToDataField(String anchorDataFieldGUID,
                                       Annotation annotation)
                                throws InvalidParameterException,
                                       UserNotAuthorizedException,
                                       PropertyServerException

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

Specified by:

addAnnotationToDataField in class DiscoveryAnnotationStore

Parameters:

anchorDataFieldGUID - unique identifier of the data field that this new one is to be attached to

annotation - data field object

Returns:

unique identifier of annotation

Throws:

InvalidParameterException - one of the parameters is invalid

UserNotAuthorizedException - the user id not authorized to issue this request

PropertyServerException - there was a problem saving data fields in the annotation store.

updateDataField

public DataField updateDataField(DataField dataField)
                          throws InvalidParameterException,
                                 UserNotAuthorizedException,
                                 PropertyServerException

Replace the current properties of a data field.

Specified by:

updateDataField in class DiscoveryAnnotationStore

Parameters:

dataField - new properties

Returns:

fully filled out data field

Throws:

InvalidParameterException - one of the parameters is invalid

UserNotAuthorizedException - the user id not authorized to issue this request

PropertyServerException - there was a problem updating the data field in the annotation store.

deleteDataField

public void deleteDataField(String dataFieldGUID)
                     throws InvalidParameterException,
                            UserNotAuthorizedException,
                            PropertyServerException

Remove a data field from the annotation store.

Specified by:

deleteDataField in class DiscoveryAnnotationStore

Parameters:

dataFieldGUID - unique identifier of the data field

Throws:

InvalidParameterException - one of the parameters is invalid

UserNotAuthorizedException - the user id not authorized to issue this request

PropertyServerException - there was a problem deleting the data field from the annotation store.