org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore

Class OMRSDynamicTypeMetadataCollectionBase

java.lang.Object

org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.OMRSMetadataCollection

org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.OMRSMetadataCollectionBase

org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.OMRSDynamicTypeMetadataCollectionBase

public class OMRSDynamicTypeMetadataCollectionBase
extends OMRSMetadataCollectionBase

OMRSDynamicTypeMetadataCollectionBase provides a base class for an open metadata repository that has a dynamic type system. It begins with no types defined and builds up the knowledge of the types as they are added through the API

Field Summary

Fields inherited from class org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.OMRSMetadataCollection

metadataCollectionId, metadataCollectionName, parentConnector, repositoryHelper, repositoryName, repositoryValidator, securityVerifier

Constructor Summary

Constructors

Constructor and Description
OMRSDynamicTypeMetadataCollectionBase(OMRSRepositoryConnector parentConnector, String repositoryName, OMRSRepositoryHelper repositoryHelper, OMRSRepositoryValidator repositoryValidator, String metadataCollectionId) Constructor ensures the metadata collection is linked to its connector and knows its metadata collection Id.

Method Summary

Modifier and Type	Method and Description
void	addAttributeTypeDef(String userId, AttributeTypeDef newAttributeTypeDef) Create a definition of a new AttributeTypeDef.
void	addTypeDef(String userId, TypeDef newTypeDef) Create a definition of a new TypeDef.
void	deleteAttributeTypeDef(String userId, String obsoleteTypeDefGUID, String obsoleteTypeDefName) Delete an AttributeTypeDef.
void	deleteTypeDef(String userId, String obsoleteTypeDefGUID, String obsoleteTypeDefName) Delete the TypeDef.
AttributeTypeDef	reIdentifyAttributeTypeDef(String userId, String originalAttributeTypeDefGUID, String originalAttributeTypeDefName, String newAttributeTypeDefGUID, String newAttributeTypeDefName) Change the guid or name of an existing TypeDef to a new value.
TypeDef	reIdentifyTypeDef(String userId, String originalTypeDefGUID, String originalTypeDefName, String newTypeDefGUID, String newTypeDefName) Change the guid or name of an existing TypeDef to a new value.
TypeDef	updateTypeDef(String userId, TypeDefPatch typeDefPatch) Update one or more properties of the TypeDef.
boolean	verifyAttributeTypeDef(String userId, AttributeTypeDef attributeTypeDef) Verify that a definition of an AttributeTypeDef is either new - or matches the definition already stored.
boolean	verifyTypeDef(String userId, TypeDef typeDef) Verify that a definition of a TypeDef is either new - or matches the definition already stored.

Methods inherited from class org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.OMRSMetadataCollectionBase

addEntity, addEntityParameterValidation, addEntityParameterValidation, addEntityProxy, addEntityProxyParameterValidation, addExternalEntity, addExternalEntityParameterValidation, addExternalRelationship, addExternalRelationshipParameterValidation, addRelationship, addRelationshipParameterValidation, addRelationshipParameterValidation, addTypeDefGallery, attributeTypeDefCategoryParameterValidation, attributeTypeDefParameterValidation, classifyEntity, classifyEntityParameterValidation, classifyEntityParameterValidation, declassifyEntity, declassifyEntityParameterValidation, deleteEntity, deleteEntityReferenceCopy, deleteRelationship, deleteRelationshipReferenceCopy, filterAttributeTypeDefsByCategory, filterAttributeTypeDefsByGUID, filterAttributeTypeDefsByName, filterTypeDefsByCategory, filterTypeDefsByGUID, filterTypeDefsByName, filterTypeDefsByProperty, filterTypeDefsBySearchCriteria, filterTypesByExternalID, filterTypesByWildCardName, findAttributeTypeDefsByCategory, findEntitiesByClassification, findEntitiesByClassificationParameterValidation, findEntitiesByProperty, findEntitiesByPropertyParameterValidation, findEntitiesByPropertyValue, findEntitiesByPropertyValueParameterValidation, findRelationshipsByProperty, findRelationshipsByPropertyParameterValidation, findRelationshipsByPropertyValue, findRelationshipsByPropertyValueParameterValidation, findTypeDefsByCategory, findTypeDefsByProperty, findTypesByExternalID, findTypesByName, getAllTypes, getAttributeTypeDefByGUID, getAttributeTypeDefByName, getEntityDetail, getEntityDetail, getEntityNeighborhood, getEntityNeighborhoodParameterValidation, getEntityProxy, getEntitySummary, getInstanceParameterValidation, getInstanceParameterValidation, getLinkingEntities, getLinkingEntitiesParameterValidation, getMetadataCollectionId, getRelatedEntities, getRelatedEntitiesParameterValidation, getRelationship, getRelationship, getRelationshipsForEntity, getRelationshipsForEntityParameterValidation, getTypeDefByGUID, getTypeDefByName, getTypeDefForInstance, isEntityKnown, isRelationshipKnown, manageAttributeTypeDefParameterValidation, manageInstanceParameterValidation, manageInstanceParameterValidation, manageInstanceParameterValidation, manageReferenceInstanceParameterValidation, manageTypeDefParameterValidation, newAttributeTypeDefParameterValidation, newTypeDefParameterValidation, purgeEntity, purgeEntityReferenceCopy, purgeEntityReferenceCopy, purgeRelationship, purgeRelationshipReferenceCopy, purgeRelationshipReferenceCopy, referenceInstanceParameterValidation, refreshEntityReferenceCopy, refreshRelationshipReferenceCopy, reHomeEntity, reHomeInstanceParameterValidation, reHomeRelationship, reIdentifyEntity, reIdentifyInstanceParameterValidation, reIdentifyRelationship, removeInstanceParameterValidation, reportEntityNotKnown, reportEntityProxyOnly, reportRelationshipNotKnown, reportTypeDefAlreadyDefined, reportTypeDefConflict, reportTypeDefInUse, reportTypeDefNotSupported, reportUnknownTypeGUID, reportUnknownTypeName, reportUnsupportedAsOfTimeFunction, reportUnsupportedOptionalFunction, restoreEntity, restoreRelationship, reTypeEntity, reTypeInstanceParameterValidation, reTypeRelationship, saveEntityReferenceCopy, saveRelationshipReferenceCopy, searchForTypeDefs, securityVerifyTypeDefList, typeDefCategoryParameterValidation, typeDefExternalIDParameterValidation, typeDefParameterValidation, typeDefPropertyParameterValidation, typeDefSearchParameterValidation, typeGUIDParameterValidation, typeNameParameterValidation, undoEntityUpdate, undoRelationshipUpdate, updateEntityClassification, updateEntityClassificationParameterValidation, updateEntityProperties, updateEntityStatus, updateInstancePropertiesPropertyValidation, updateInstanceStatusParameterValidation, updateRelationshipProperties, updateRelationshipStatus, updateTypeDefParameterValidation

Methods inherited from class org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.OMRSMetadataCollection

basicRequestValidation, getMetadataCollectionId, reHomeEntity, reHomeRelationship, saveInstanceReferenceCopies, setSecurityVerifier, validateRepositoryConnector

Methods inherited from class java.lang.Object

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

Constructor Detail

OMRSDynamicTypeMetadataCollectionBase

public OMRSDynamicTypeMetadataCollectionBase(OMRSRepositoryConnector parentConnector,
                                             String repositoryName,
                                             OMRSRepositoryHelper repositoryHelper,
                                             OMRSRepositoryValidator repositoryValidator,
                                             String metadataCollectionId)

Constructor ensures the metadata collection is linked to its connector and knows its metadata collection Id.

Parameters:

parentConnector - connector that this metadata collection supports. The connector has the information to call the metadata repository.

repositoryName - name of this repository.

repositoryHelper - helper class for building types and instances

repositoryValidator - validator class for checking open metadata repository objects and parameters.

metadataCollectionId - unique identifier of the metadata collection Id.

Method Detail

addTypeDef

public void addTypeDef(String userId,
                       TypeDef newTypeDef)
                throws InvalidParameterException,
                       RepositoryErrorException,
                       TypeDefKnownException,
                       TypeDefConflictException,
                       InvalidTypeDefException,
                       UserNotAuthorizedException

Create a definition of a new TypeDef.

Overrides:

addTypeDef in class OMRSMetadataCollectionBase

Parameters:

userId - unique identifier for requesting user.

newTypeDef - TypeDef structure describing the new TypeDef.

Throws:

InvalidParameterException - the new TypeDef is null.

RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.

TypeDefKnownException - the TypeDef is already stored in the repository.

TypeDefConflictException - the new TypeDef conflicts with an existing TypeDef.

InvalidTypeDefException - the new TypeDef has invalid contents.

UserNotAuthorizedException - the userId is not permitted to perform this operation.

addAttributeTypeDef

public void addAttributeTypeDef(String userId,
                                AttributeTypeDef newAttributeTypeDef)
                         throws InvalidParameterException,
                                RepositoryErrorException,
                                TypeDefKnownException,
                                TypeDefConflictException,
                                InvalidTypeDefException,
                                UserNotAuthorizedException

Create a definition of a new AttributeTypeDef.

Overrides:

addAttributeTypeDef in class OMRSMetadataCollectionBase

Parameters:

userId - unique identifier for requesting user.

newAttributeTypeDef - TypeDef structure describing the new TypeDef.

Throws:

InvalidParameterException - the new TypeDef is null.

RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.

TypeDefKnownException - the TypeDef is already stored in the repository.

TypeDefConflictException - the new TypeDef conflicts with an existing TypeDef.

InvalidTypeDefException - the new TypeDef has invalid contents.

UserNotAuthorizedException - the userId is not permitted to perform this operation.

verifyTypeDef

public boolean verifyTypeDef(String userId,
                             TypeDef typeDef)
                      throws InvalidParameterException,
                             RepositoryErrorException,
                             TypeDefConflictException,
                             InvalidTypeDefException,
                             UserNotAuthorizedException

Verify that a definition of a TypeDef is either new - or matches the definition already stored.

Overrides:

verifyTypeDef in class OMRSMetadataCollectionBase

Parameters:

userId - unique identifier for requesting user.

typeDef - TypeDef structure describing the TypeDef to test.

Returns:

boolean - true means the TypeDef matches the local definition - false means the TypeDef is not known.

Throws:

InvalidParameterException - the TypeDef is null.

RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.

TypeDefConflictException - the new TypeDef conflicts with an existing TypeDef.

InvalidTypeDefException - the new TypeDef has invalid contents.

UserNotAuthorizedException - the userId is not permitted to perform this operation.

verifyAttributeTypeDef

public boolean verifyAttributeTypeDef(String userId,
                                      AttributeTypeDef attributeTypeDef)
                               throws InvalidParameterException,
                                      RepositoryErrorException,
                                      TypeDefConflictException,
                                      InvalidTypeDefException,
                                      UserNotAuthorizedException

Verify that a definition of an AttributeTypeDef is either new - or matches the definition already stored.

Overrides:

verifyAttributeTypeDef in class OMRSMetadataCollectionBase

Parameters:

userId - unique identifier for requesting user.

attributeTypeDef - TypeDef structure describing the TypeDef to test.

Returns:

boolean - true means the TypeDef matches the local definition - false means the TypeDef is not known.

Throws:

InvalidParameterException - the TypeDef is null.

RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.

TypeDefConflictException - the new TypeDef conflicts with an existing TypeDef.

InvalidTypeDefException - the new TypeDef has invalid contents.

UserNotAuthorizedException - the userId is not permitted to perform this operation.

updateTypeDef

public TypeDef updateTypeDef(String userId,
                             TypeDefPatch typeDefPatch)
                      throws InvalidParameterException,
                             RepositoryErrorException,
                             TypeDefNotKnownException,
                             PatchErrorException,
                             UserNotAuthorizedException

Update one or more properties of the TypeDef. The TypeDefPatch controls what types of updates are safe to make to the TypeDef.

Overrides:

updateTypeDef in class OMRSMetadataCollectionBase

Parameters:

userId - unique identifier for requesting user.

typeDefPatch - TypeDef patch describing change to TypeDef.

Returns:

updated TypeDef

Throws:

InvalidParameterException - the TypeDefPatch is null.

RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.

TypeDefNotKnownException - the requested TypeDef is not found in the metadata collection.

PatchErrorException - the TypeDef can not be updated because the supplied patch is incompatible with the stored TypeDef.

UserNotAuthorizedException - the userId is not permitted to perform this operation.

deleteTypeDef

public void deleteTypeDef(String userId,
                          String obsoleteTypeDefGUID,
                          String obsoleteTypeDefName)
                   throws InvalidParameterException,
                          RepositoryErrorException,
                          TypeDefNotKnownException,
                          TypeDefInUseException,
                          UserNotAuthorizedException

Delete the TypeDef. This is only possible if the TypeDef has never been used to create instances or any instances of this TypeDef have been purged from the metadata collection.

Overrides:

deleteTypeDef in class OMRSMetadataCollectionBase

Parameters:

userId - unique identifier for requesting user.

obsoleteTypeDefGUID - String unique identifier for the TypeDef.

obsoleteTypeDefName - String unique name for the TypeDef.

Throws:

InvalidParameterException - the one of TypeDef identifiers is null.

RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.

TypeDefNotKnownException - the requested TypeDef is not found in the metadata collection.

TypeDefInUseException - the TypeDef can not be deleted because there are instances of this type in the the metadata collection. These instances need to be purged before the TypeDef can be deleted.

UserNotAuthorizedException - the userId is not permitted to perform this operation.

deleteAttributeTypeDef

public void deleteAttributeTypeDef(String userId,
                                   String obsoleteTypeDefGUID,
                                   String obsoleteTypeDefName)
                            throws InvalidParameterException,
                                   RepositoryErrorException,
                                   TypeDefNotKnownException,
                                   TypeDefInUseException,
                                   UserNotAuthorizedException

Delete an AttributeTypeDef. This is only possible if the AttributeTypeDef has never been used to create instances or any instances of this AttributeTypeDef have been purged from the metadata collection.

Overrides:

deleteAttributeTypeDef in class OMRSMetadataCollectionBase

Parameters:

userId - unique identifier for requesting user.

obsoleteTypeDefGUID - String unique identifier for the AttributeTypeDef.

obsoleteTypeDefName - String unique name for the AttributeTypeDef.

Throws:

InvalidParameterException - the one of AttributeTypeDef identifiers is null.

RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.

TypeDefNotKnownException - the requested AttributeTypeDef is not found in the metadata collection.

TypeDefInUseException - the AttributeTypeDef can not be deleted because there are instances of this type in the the metadata collection. These instances need to be purged before the AttributeTypeDef can be deleted.

UserNotAuthorizedException - the userId is not permitted to perform this operation.

reIdentifyTypeDef

public TypeDef reIdentifyTypeDef(String userId,
                                 String originalTypeDefGUID,
                                 String originalTypeDefName,
                                 String newTypeDefGUID,
                                 String newTypeDefName)
                          throws InvalidParameterException,
                                 RepositoryErrorException,
                                 TypeDefNotKnownException,
                                 UserNotAuthorizedException

Change the guid or name of an existing TypeDef to a new value. This is used if two different TypeDefs are discovered to have the same guid. This is extremely unlikely but not impossible so the open metadata protocol has provision for this.

Overrides:

reIdentifyTypeDef in class OMRSMetadataCollectionBase

Parameters:

userId - unique identifier for requesting user.

originalTypeDefGUID - the original guid of the TypeDef.

originalTypeDefName - the original name of the TypeDef.

newTypeDefGUID - the new identifier for the TypeDef.

newTypeDefName - new name for this TypeDef.

Returns:

typeDef - new values for this TypeDef, including the new guid/name.

Throws:

InvalidParameterException - one of the parameters is invalid or null.

RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.

TypeDefNotKnownException - the TypeDef identified by the original guid/name is not found in the metadata collection.

UserNotAuthorizedException - the userId is not permitted to perform this operation.

reIdentifyAttributeTypeDef

public AttributeTypeDef reIdentifyAttributeTypeDef(String userId,
                                                   String originalAttributeTypeDefGUID,
                                                   String originalAttributeTypeDefName,
                                                   String newAttributeTypeDefGUID,
                                                   String newAttributeTypeDefName)
                                            throws InvalidParameterException,
                                                   RepositoryErrorException,
                                                   TypeDefNotKnownException,
                                                   UserNotAuthorizedException

Change the guid or name of an existing TypeDef to a new value. This is used if two different TypeDefs are discovered to have the same guid. This is extremely unlikely but not impossible so the open metadata protocol has provision for this.

Overrides:

reIdentifyAttributeTypeDef in class OMRSMetadataCollectionBase

Parameters:

userId - unique identifier for requesting user.

originalAttributeTypeDefGUID - the original guid of the AttributeTypeDef.

originalAttributeTypeDefName - the original name of the AttributeTypeDef.

newAttributeTypeDefGUID - the new identifier for the AttributeTypeDef.

newAttributeTypeDefName - new name for this AttributeTypeDef.

Returns:

attributeTypeDef - new values for this AttributeTypeDef, including the new guid/name.

Throws:

InvalidParameterException - one of the parameters is invalid or null.

RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.

TypeDefNotKnownException - the AttributeTypeDef identified by the original guid/name is not found in the metadata collection.

UserNotAuthorizedException - the userId is not permitted to perform this operation.