Package org.odpi.openmetadata.commonservices.generichandlers

Class OpenMetadataAPIGenericBuilder

java.lang.Object
org.odpi.openmetadata.commonservices.generichandlers.OpenMetadataAPIGenericBuilder
Direct Known Subclasses:
EmbeddedConnectionBuilder, MetadataElementBuilder, ReferenceableBuilder
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 Details

  • Constructor Details

    • OpenMetadataAPIGenericBuilder

      public 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, 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 ype (if any)
      existingClassifications - classifications that are currently stored
      repositoryHelper - helper methods
      serviceName - name of this OMAS
      serverName - name of local server

    • OpenMetadataAPIGenericBuilder

      protected OpenMetadataAPIGenericBuilder(String typeGUID, String typeName, Map<String,Object> extendedProperties, Date effectiveFrom, Date effectiveTo, 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 subtype (if any)
      effectiveFrom - date to make the element active in the governance program (null for now)
      effectiveTo - date to remove the element from the governance program (null = until deleted)
      existingClassifications - classifications that are currently stored
      repositoryHelper - helper methods
      serviceName - name of this OMAS
      serverName - name of local server

  • Method Details

    • 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

    • getClassification

      public Classification getClassification(String classificationName)
      Return a proposed classification for this element
      Returns:
      classification object ready for the repository

    • getInitialGovernanceZones

      public List<String> getInitialGovernanceZones()
      Retrieve the initial zones.
      Returns:
      list of null

    • setGovernanceZones

      protected void setGovernanceZones(String userId, List<String> zoneMembership, String methodName) throws InvalidParameterException
      Set up the ZoneMembership classification for this entity. This method overrides any previously defined ZoneMembership classification for this entity.
      Parameters:
      userId - calling user
      zoneMembership - list of zone names for the zones this asset is a member of
      methodName - calling method
      Throws:
      InvalidParameterException - AssetZones is not supported in the local repository, or any repository connected by an open metadata repository cohort

    • isClassificationSet

      public boolean isClassificationSet(String classificationName)
      Return whether a particular classification has been set up by the caller.
      Parameters:
      classificationName - name of the classification to test for
      Returns:
      boolean

    • setTemplateClassifications

      public void setTemplateClassifications(String userId, String externalSourceGUID, String externalSourceName, List<Classification> templateClassifications, Map<String,String> placeholderProperties, String methodName) throws InvalidParameterException
      Set up the list of classifications from a template entity.
      Parameters:
      userId - calling user
      externalSourceGUID - guid of the software capability entity that represented the external source - null for local
      externalSourceName - name of the software capability entity that represented the external source
      templateClassifications - list of classifications from the template
      placeholderProperties - map of placeholder names to placeholder values to substitute into the template properties
      methodName - calling method
      Throws:
      InvalidParameterException - the type of one of the classifications is not supported

    • setTemplateSubstitute

      public void setTemplateSubstitute(String userId, String methodName) throws PropertyServerException
      Set up the "TemplateSubstitute" classification for this entity. This is used when a new entity is being created, and it is known to be created as a template substitute.
      Parameters:
      userId - calling user
      methodName - calling method
      Throws:
      PropertyServerException - a null anchors GUID has been supplied

    • setAnchors

      public void setAnchors(String userId, OpenMetadataAPIAnchorHandler.AnchorIdentifiers anchorIdentifiers, String methodName) throws PropertyServerException
      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.
      Parameters:
      userId - calling user
      anchorIdentifiers - values for anchors classification
      methodName - calling method
      Throws:
      PropertyServerException - a null anchors GUID has been supplied

    • setAnchors

      public void setAnchors(String userId, String anchorGUID, String anchorTypeName, String anchorDomainName, String anchorScopeGUID, List<String> zoneMembership, String methodName) throws PropertyServerException
      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.
      Parameters:
      userId - calling user
      anchorGUID - unique identifier of the anchor entity that this entity is linked to directly or indirectly
      anchorTypeName - unique name of the anchor entity's type
      anchorDomainName - unique name of the anchor entity's domain
      anchorScopeGUID - unique identifier of the anchor's scope
      zoneMembership - zone membership from the anchor
      methodName - calling method
      Throws:
      PropertyServerException - a null anchors GUID has been supplied

    • setEffectivityDates

      public void setEffectivityDates(Date effectiveFrom, Date effectiveTo)
      Set up the effective dates for the entity. This determines
      Parameters:
      effectiveFrom - date that the element is effective from
      effectiveTo - date that the element is effective to

    • 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

    • 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

    • getInstanceProperties

      public InstanceProperties getInstanceProperties(Map<String,InstancePropertyValue> propertyMap, Date effectiveFrom, Date effectiveTo) throws InvalidParameterException
      Return the properties based on the parameters supplied. This is typically used for relationship and classification properties.
      Parameters:
      propertyMap - map of property names to values
      effectiveFrom - date to make the element active in the governance program (null for now)
      effectiveTo - date to remove the element from the governance program (null = until deleted)
      Returns:
      repository services properties
      Throws:
      InvalidParameterException - problem mapping properties

    • updateInstanceProperties

      protected InstanceProperties updateInstanceProperties(InstanceProperties properties, Map<String,InstancePropertyValue> propertyMap) throws InvalidParameterException
      Add the supplied properties to the supplied instance properties object.
      Parameters:
      properties - current accumulated properties
      propertyMap - map of property names to values
      Returns:
      repository services properties
      Throws:
      InvalidParameterException - problem mapping properties

    • setEffectivityDates

      protected InstanceProperties setEffectivityDates(InstanceProperties properties)
      Set the supplied effectivity dates into the instance properties.
      Parameters:
      properties - current accumulated properties
      Returns:
      augmented instance properties

    • getEntityClassifications

      public List<Classification> getEntityClassifications()
      Return a list of entity classifications that can be stored in the metadata repository.
      Returns:
      list of entity classification objects