org.odpi.openmetadata.commonservices.generichandlers

Class OpenMetadataAPIGenericBuilder

java.lang.Object

org.odpi.openmetadata.commonservices.generichandlers.OpenMetadataAPIGenericBuilder

Direct Known Subclasses:

AnnotationBuilder, AnnotationReviewBuilder, EmbeddedConnectionBuilder, InformalTagBuilder, LikeBuilder, RatingBuilder, ReferenceableBuilder, SearchKeywordBuilder

public class OpenMetadataAPIGenericBuilder
extends Object

OpenMetadataAPIGenericBuilder provides the common functions for building new entities, relationships and classifications. Subtypes push details of their classifications to this supertype. They manage their instance properties.

Field Summary

Fields

Modifier and Type	Field and Description
protected RepositoryErrorHandler	errorHandler
protected List<Classification>	existingClassifications
protected Map<String,Object>	extendedProperties
protected InstanceStatus	instanceStatus
protected Map<String,Classification>	newClassifications
protected InstanceProperties	properties
protected OMRSRepositoryHelper	repositoryHelper
protected String	serverName
protected String	serviceName
protected String	typeGUID
protected String	typeName

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	OpenMetadataAPIGenericBuilder(String typeGUID, String typeName, Map<String,Object> extendedProperties, InstanceStatus instanceStatus, List<Classification> existingClassifications, OMRSRepositoryHelper repositoryHelper, String serviceName, String serverName) Constructor for type specific creates.
protected	OpenMetadataAPIGenericBuilder(String typeGUID, String typeName, OMRSRepositoryHelper repositoryHelper, String serviceName, String serverName) Constructor for working with classifications.

Method Summary

Modifier and Type	Method and Description
InstanceProperties	getEntityClassificationProperties(String elementClassificationName, String methodName) Retrieve the requested classification and convert it to the OMRS format.
List<Classification>	getEntityClassifications(String userId, String methodName) Return a list of entity classifications that can be stored in the metadata repository.
InstanceAuditHeader	getExistingEntityClassificationHeader(String elementClassificationName, String methodName) Retrieve the requested classification and convert it to the OMRS format.
InstanceProperties	getInstanceProperties(String methodName) Return the supplied bean properties in an InstanceProperties object.
InstanceStatus	getInstanceStatus() Return the status that this entity should be created with.
String	getTypeGUID() Return the bean's type id
String	getTypeName() Return the bean's type name
void	setAnchors(String userId, String anchorGUID, String methodName) Set up the Anchors classification for this entity.
void	setClassification(Classification newClassification) Add a classification to the entity.
void	setLatestChange(String userId, int latestChangeTargetOrdinal, int latestChangeActionOrdinal, String classificationName, String attachmentGUID, String attachmentTypeName, String relationshipTypeName, String actionDescription, String methodName) Set up the LatestChange classification for an anchor entity.
void	setTemplateClassifications(String userId, String externalSourceGUID, String externalSourceName, List<Classification> templateClassifications, String methodName) Set up the list of classifications from a template entity.

Methods inherited from class java.lang.Object

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

Field Detail

errorHandler

protected RepositoryErrorHandler errorHandler

repositoryHelper

protected OMRSRepositoryHelper repositoryHelper

serviceName

protected String serviceName

serverName

protected String serverName

extendedProperties

protected Map<String,Object> extendedProperties

typeGUID

protected String typeGUID

typeName

protected String typeName

instanceStatus

protected InstanceStatus instanceStatus

existingClassifications

protected List<Classification> existingClassifications

newClassifications

protected Map<String,Classification> newClassifications

properties

protected InstanceProperties properties

Constructor Detail

OpenMetadataAPIGenericBuilder

protected OpenMetadataAPIGenericBuilder(String typeGUID,
                                        String typeName,
                                        OMRSRepositoryHelper repositoryHelper,
                                        String serviceName,
                                        String serverName)

Constructor for working with classifications.

Parameters:

typeGUID - type GUID to use for the entity

typeName - type name to use for the entity

repositoryHelper - helper methods

serviceName - name of this OMAS

serverName - name of local server

OpenMetadataAPIGenericBuilder

protected OpenMetadataAPIGenericBuilder(String typeGUID,
                                        String typeName,
                                        Map<String,Object> extendedProperties,
                                        InstanceStatus instanceStatus,
                                        List<Classification> existingClassifications,
                                        OMRSRepositoryHelper repositoryHelper,
                                        String serviceName,
                                        String serverName)

Constructor for type specific creates.

Parameters:

typeGUID - type GUID to use for the entity

typeName - type name to use for the entity

extendedProperties - properties for the sub type (if any)

instanceStatus - status to use on the request

existingClassifications - classifications that are currently stored

repositoryHelper - helper methods

serviceName - name of this OMAS

serverName - name of local server

Method Detail

setClassification

public void setClassification(Classification newClassification)

Add a classification to the entity. This overrides any existing value for this classification.

Parameters:

newClassification - classification object ready for the repository

setTemplateClassifications

public void setTemplateClassifications(String userId,
                                       String externalSourceGUID,
                                       String externalSourceName,
                                       List<Classification> templateClassifications,
                                       String methodName)
                                throws InvalidParameterException

Set up the list of classifications from a template entity.

Parameters:

userId - calling user

externalSourceGUID - guid of the software server capability entity that represented the external source - null for local

externalSourceName - name of the software server capability entity that represented the external source

templateClassifications - list of classifications from the template

methodName - calling method

Throws:

InvalidParameterException - the type of one of the classifications is not supported

setAnchors

public void setAnchors(String userId,
                       String anchorGUID,
                       String methodName)
                throws InvalidParameterException

Set up the Anchors classification for this entity. This is used when a new entity is being created and it is known to be connected to a specific anchor. This method overrides an previously defined Anchors classification for this entity.

Parameters:

userId - calling user

anchorGUID - unique identifier of the anchor entity that this entity is linked to directly or indirectly

methodName - calling method

Throws:

InvalidParameterException - anchors is not supported in the local repository, or any repository connected by an open metadata repository cohort

setLatestChange

public void setLatestChange(String userId,
                            int latestChangeTargetOrdinal,
                            int latestChangeActionOrdinal,
                            String classificationName,
                            String attachmentGUID,
                            String attachmentTypeName,
                            String relationshipTypeName,
                            String actionDescription,
                            String methodName)
                     throws InvalidParameterException

Set up the LatestChange classification for an anchor entity. This is typically used on the create of the anchor and other direct update actions on it. Other updates are made to it through the generic handler as attachments are added and changed.

Parameters:

userId - calling user

latestChangeTargetOrdinal - ordinal for the LatestChangeTarget enum value

latestChangeActionOrdinal - ordinal for the LatestChangeAction enum value

classificationName - name of a changed classification

attachmentGUID - unique identifier of an entity attached to the anchor

attachmentTypeName - type name of the attached entity

relationshipTypeName - relationship used to attach the entity

actionDescription - human readable description of the change

methodName - calling method

Throws:

InvalidParameterException - this classification is not supported

getTypeName

public String getTypeName()

Return the bean's type name

Returns:

string name

getTypeGUID

public String getTypeGUID()

Return the bean's type id

Returns:

string id

getInstanceStatus

public InstanceStatus getInstanceStatus()

Return the status that this entity should be created with.

Returns:

instance status enum

getInstanceProperties

public InstanceProperties getInstanceProperties(String methodName)
                                         throws InvalidParameterException

Return the supplied bean properties in an InstanceProperties object.

Parameters:

methodName - name of the calling method

Returns:

InstanceProperties object

Throws:

InvalidParameterException - there is a problem with the properties

getEntityClassifications

public List<Classification> getEntityClassifications(String userId,
                                                     String methodName)
                                              throws InvalidParameterException

Return a list of entity classifications that can be stored in the metadata repository.

Parameters:

userId - calling user

methodName - calling method

Returns:

list of entity classification objects

Throws:

InvalidParameterException - the properties of the classification are flawed

getExistingEntityClassificationHeader

public InstanceAuditHeader getExistingEntityClassificationHeader(String elementClassificationName,
                                                                 String methodName)
                                                          throws InvalidParameterException

Retrieve the requested classification and convert it to the OMRS format.

Parameters:

elementClassificationName - name of the classification to retrieve/convert

methodName - calling method

Returns:

null if the classification is not found for an OMRS Classification bean for the named classification

Throws:

InvalidParameterException - the classification name parameter is null

getEntityClassificationProperties

public InstanceProperties getEntityClassificationProperties(String elementClassificationName,
                                                            String methodName)
                                                     throws InvalidParameterException

Retrieve the requested classification and convert it to the OMRS format.

Parameters:

elementClassificationName - name of the classification to retrieve/convert

methodName - calling method

Returns:

null or the appropriate properties

Throws:

InvalidParameterException - the classification name parameter is null