Package org.gcube.informationsystem.resourceregistry.persistence.orientdb.types.properties

Class PropertySchemaManagement

java.lang.Object

org.gcube.informationsystem.resourceregistry.persistence.orientdb.base.ElementManagement<com.orientechnologies.orient.core.record.OElement,org.gcube.informationsystem.types.reference.properties.PropertySchema>

org.gcube.informationsystem.resourceregistry.persistence.orientdb.types.properties.PropertySchemaManagement

All Implemented Interfaces:

TypeDefinitionManagement

public class PropertySchemaManagement
extends ElementManagement<com.orientechnologies.orient.core.record.OElement,org.gcube.informationsystem.types.reference.properties.PropertySchema>
implements TypeDefinitionManagement

Author:

Luca Frosini (ISTI - CNR)

Field Summary

Fields

Modifier and Type	Field	Description
protected String	name	The name of the property type.

Fields inherited from class org.gcube.informationsystem.resourceregistry.persistence.orientdb.base.ElementManagement

accessType, affectedInstances, AT, cachedType, complete, DELETED, DOLLAR, dryRun, element, elementClass, entryPoint, ignoredFields, ignoreKeys, ignoreStartWithKeys, jsonNode, limit, maskMetadata, metadataPolicy, oClass, oDatabaseDocument, offset, operation, polymorphic, preservePassedMetadata, reload, sanityCheckDeferred, self, typeName, UNDERSCORE, updateMode, uuid, workingEnvironment

Constructor Summary

Constructors

Constructor	Description
PropertySchemaManagement()	Creates a new PropertySchemaManagement instance.
PropertySchemaManagement(TypeEnvironment typeEnvironment, com.orientechnologies.orient.core.db.document.ODatabaseDocument oDatabaseDocument)	Creates a new PropertySchemaManagement instance bound to the specified environment and database.

Method Summary

Modifier and Type	Method	Description
protected org.gcube.com.fasterxml.jackson.databind.JsonNode	createCompleteJsonNode()	Abstract method to create the complete JSON node representation of the element.
protected com.orientechnologies.orient.core.record.OElement	createElement()	Creates the backing database element for this property type definition.
Map<UUID,org.gcube.com.fasterxml.jackson.databind.JsonNode>	getAffectedInstances()	Returns the map of instances affected by operations on this element.
com.orientechnologies.orient.core.record.OElement	getElement()	Returns the OrientDB element instance, retrieving and caching it if not already present.
String	getName()	Returns the name of the Type definition.
protected org.gcube.informationsystem.resourceregistry.api.exceptions.AlreadyPresentException	getSpecificAlreadyPresentException(String message)	Converts a generic AlreadyPresentException into a subclass-specific AlreadyPresentException.
protected org.gcube.informationsystem.resourceregistry.api.exceptions.NotFoundException	getSpecificNotFoundException(org.gcube.informationsystem.resourceregistry.api.exceptions.NotFoundException e)	Converts a generic NotFoundException into a subclass-specific NotFoundException.
protected Environment	getWorkingEnvironment()	Returns the active database working environment.
protected com.orientechnologies.orient.core.record.OElement	reallyCreate()	Persists a new element in the database (subclass hook).
protected void	reallyDelete()	Deletes an existing element from the database (subclass hook).
String	reallyGetAll()	Retrieves all elements from the database and returns them as a JSON array string.
protected com.orientechnologies.orient.core.record.OElement	reallyUpdate()	Updates an existing element in the database (subclass hook).
com.orientechnologies.orient.core.record.OElement	retrieveElement()	Directly queries and retrieves the OrientDB element from the database.
void	sanityCheck()	Performs runtime validation of the schema constraints this service enforces from the definition rather than through OrientDB: the mandatory properties, and the min and max bounds of the numeric values a creation or an update wrote.
void	setName(String name)	Sets the name of the Type definition.

Methods inherited from class org.gcube.informationsystem.resourceregistry.persistence.orientdb.base.ElementManagement

addIgnoredFields, afterModification, all, applyPrivacyMask, applyPrivacyMask, checkERMatch, checkJsonNode, checkUUIDMatch, checkUUIDNotAlreadyInUse, cleanCachedSerialization, concludeTransaction, create, createOrUpdate, createOrUpdateElementWithResult, delete, exists, getAccessType, getAllProperties, getCachedType, getCurrentODatabaseDocumentFromThreadLocal, getIgnoredFields, getLimit, getMandatoryErrorMessage, getMandatoryErrorMessage, getMetadataPolicy, getOClass, getOffset, getPropertyForJson, getPropertyMap, getTypeName, getUpdateMode, getUUID, internalCreate, internalCreateOrUdate, internalDelete, internalUpdate, isBackendLinkFieldName, isDryRun, isMaskMetadata, isPolymorphic, isPreservePassedMetadata, isReload, isSanityCheckDeferred, read, recordModification, requireExplicitUUID, retrieveElementFromAnyContext, serializeAsAffectedInstance, serializeAsEndpointReference, serializeAsJsonNode, serializeSelfAsJsonNode, setAsEntryPoint, setDryRun, setElement, setElementType, setIgnoredFields, setJson, setJsonNode, setLimit, setMaskMetadata, setMetadataPolicy, setOClass, setODatabaseDocument, setOffset, setOperation, setPolymorphic, setPreservePassedMetadata, setProperty, setReload, setRequireExplicitUUID, setSanityCheckDeferred, setUpdateMode, setUUID, setWorkingEnvironment, typeSatified, update, updateProperties

Methods inherited from class java.lang.Object

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

Field Details

name

protected String name

The name of the property type.

Constructor Details

PropertySchemaManagement

public PropertySchemaManagement()

Creates a new PropertySchemaManagement instance.

PropertySchemaManagement

public PropertySchemaManagement(TypeEnvironment typeEnvironment,
 com.orientechnologies.orient.core.db.document.ODatabaseDocument oDatabaseDocument)
                         throws org.gcube.informationsystem.resourceregistry.api.exceptions.ResourceRegistryException

Creates a new PropertySchemaManagement instance bound to the specified environment and database.

Parameters:

typeEnvironment - the type environment

oDatabaseDocument - the database connection

Throws:

org.gcube.informationsystem.resourceregistry.api.exceptions.ResourceRegistryException - if initialization fails

Method Details

getAffectedInstances

public Map<UUID,org.gcube.com.fasterxml.jackson.databind.JsonNode> getAffectedInstances()

Description copied from class: ElementManagement

Returns the map of instances affected by operations on this element.

Overrides:

getAffectedInstances in class ElementManagement<com.orientechnologies.orient.core.record.OElement,org.gcube.informationsystem.types.reference.properties.PropertySchema>

Returns:

the map of affected instances

getWorkingEnvironment

protected Environment getWorkingEnvironment()
                                     throws org.gcube.informationsystem.resourceregistry.api.exceptions.ResourceRegistryException

Description copied from class: ElementManagement

Returns the active database working environment.

Specified by:

getWorkingEnvironment in class ElementManagement<com.orientechnologies.orient.core.record.OElement,org.gcube.informationsystem.types.reference.properties.PropertySchema>

Returns:

the working environment

Throws:

org.gcube.informationsystem.resourceregistry.api.exceptions.ResourceRegistryException - if the environment cannot be resolved

setName

public void setName(String name)

Description copied from interface: TypeDefinitionManagement

Sets the name of the Type definition.

Specified by:

setName in interface TypeDefinitionManagement

Parameters:

name - the name of the Type definition to set

getName

public String getName()

Description copied from interface: TypeDefinitionManagement

Returns the name of the Type definition.

Specified by:

getName in interface TypeDefinitionManagement

Returns:

the name of the Type definition

createCompleteJsonNode

protected org.gcube.com.fasterxml.jackson.databind.JsonNode createCompleteJsonNode()
                                                                            throws org.gcube.informationsystem.resourceregistry.api.exceptions.ResourceRegistryException

Description copied from class: ElementManagement

Abstract method to create the complete JSON node representation of the element.

Specified by:

createCompleteJsonNode in class ElementManagement<com.orientechnologies.orient.core.record.OElement,org.gcube.informationsystem.types.reference.properties.PropertySchema>

Returns:

the complete JSON node representing the element and its relationships

Throws:

org.gcube.informationsystem.resourceregistry.api.exceptions.ResourceRegistryException - on serialization or mapping error

reallyCreate

protected com.orientechnologies.orient.core.record.OElement reallyCreate()
                                                                  throws org.gcube.informationsystem.resourceregistry.api.exceptions.AlreadyPresentException,
org.gcube.informationsystem.resourceregistry.api.exceptions.ResourceRegistryException

Description copied from class: ElementManagement

Persists a new element in the database (subclass hook).

Specified by:

reallyCreate in class ElementManagement<com.orientechnologies.orient.core.record.OElement,org.gcube.informationsystem.types.reference.properties.PropertySchema>

Returns:

the persisted OrientDB vertex

Throws:

org.gcube.informationsystem.resourceregistry.api.exceptions.AlreadyPresentException - if the element already exists in the database

org.gcube.informationsystem.resourceregistry.api.exceptions.ResourceRegistryException - on any database error

reallyUpdate

protected com.orientechnologies.orient.core.record.OElement reallyUpdate()
                                                                  throws org.gcube.informationsystem.resourceregistry.api.exceptions.NotFoundException,
org.gcube.informationsystem.resourceregistry.api.exceptions.ResourceRegistryException

Description copied from class: ElementManagement

Updates an existing element in the database (subclass hook).

Specified by:

reallyUpdate in class ElementManagement<com.orientechnologies.orient.core.record.OElement,org.gcube.informationsystem.types.reference.properties.PropertySchema>

Returns:

the updated OrientDB vertex

Throws:

org.gcube.informationsystem.resourceregistry.api.exceptions.NotFoundException - if the element does not exist in the database

org.gcube.informationsystem.resourceregistry.api.exceptions.ResourceRegistryException - on any database error

reallyDelete

protected void reallyDelete()
                     throws org.gcube.informationsystem.resourceregistry.api.exceptions.NotFoundException,
org.gcube.informationsystem.resourceregistry.api.exceptions.ResourceRegistryException

Description copied from class: ElementManagement

Deletes an existing element from the database (subclass hook).

Specified by:

reallyDelete in class ElementManagement<com.orientechnologies.orient.core.record.OElement,org.gcube.informationsystem.types.reference.properties.PropertySchema>

Throws:

org.gcube.informationsystem.resourceregistry.api.exceptions.NotFoundException - if the element does not exist in the database

org.gcube.informationsystem.resourceregistry.api.exceptions.ResourceRegistryException - on any database error

getElement

public com.orientechnologies.orient.core.record.OElement getElement()
                                                             throws org.gcube.informationsystem.resourceregistry.api.exceptions.NotFoundException,
org.gcube.informationsystem.resourceregistry.api.exceptions.ResourceRegistryException

Description copied from class: ElementManagement

Returns the OrientDB element instance, retrieving and caching it if not already present.

Overrides:

getElement in class ElementManagement<com.orientechnologies.orient.core.record.OElement,org.gcube.informationsystem.types.reference.properties.PropertySchema>

Returns:

the OrientDB element instance

Throws:

org.gcube.informationsystem.resourceregistry.api.exceptions.NotFoundException - if the element does not exist

org.gcube.informationsystem.resourceregistry.api.exceptions.instances.AvailableInAnotherContextException - if the element belongs to another context

org.gcube.informationsystem.resourceregistry.api.exceptions.ResourceRegistryException - on database error

retrieveElement

public com.orientechnologies.orient.core.record.OElement retrieveElement()
                                                                  throws org.gcube.informationsystem.resourceregistry.api.exceptions.NotFoundException,
org.gcube.informationsystem.resourceregistry.api.exceptions.ResourceRegistryException

Description copied from class: ElementManagement

Directly queries and retrieves the OrientDB element from the database.

Overrides:

retrieveElement in class ElementManagement<com.orientechnologies.orient.core.record.OElement,org.gcube.informationsystem.types.reference.properties.PropertySchema>

Returns:

the loaded OrientDB element

Throws:

org.gcube.informationsystem.resourceregistry.api.exceptions.NotFoundException - if the element does not exist

org.gcube.informationsystem.resourceregistry.api.exceptions.ResourceRegistryException - on database error

createElement

protected com.orientechnologies.orient.core.record.OElement createElement()
                                                                   throws org.gcube.informationsystem.resourceregistry.api.exceptions.AlreadyPresentException,
org.gcube.informationsystem.resourceregistry.api.exceptions.ResourceRegistryException

Creates the backing database element for this property type definition.

Returns:

the created database element

Throws:

org.gcube.informationsystem.resourceregistry.api.exceptions.AlreadyPresentException - if the element is already present

org.gcube.informationsystem.resourceregistry.api.exceptions.ResourceRegistryException - if the database operation fails

reallyGetAll

public String reallyGetAll()
                    throws org.gcube.informationsystem.resourceregistry.api.exceptions.ResourceRegistryException

Description copied from class: ElementManagement

Retrieves all elements from the database and returns them as a JSON array string.

Specified by:

reallyGetAll in class ElementManagement<com.orientechnologies.orient.core.record.OElement,org.gcube.informationsystem.types.reference.properties.PropertySchema>

Returns:

JSON array string of all elements

Throws:

org.gcube.informationsystem.resourceregistry.api.exceptions.ResourceRegistryException - on database traversal or serialization error

getSpecificNotFoundException

protected org.gcube.informationsystem.resourceregistry.api.exceptions.NotFoundException getSpecificNotFoundException(org.gcube.informationsystem.resourceregistry.api.exceptions.NotFoundException e)

Description copied from class: ElementManagement

Converts a generic NotFoundException into a subclass-specific NotFoundException.

Specified by:

getSpecificNotFoundException in class ElementManagement<com.orientechnologies.orient.core.record.OElement,org.gcube.informationsystem.types.reference.properties.PropertySchema>

Parameters:

e - the generic exception

Returns:

the specific NotFoundException

getSpecificAlreadyPresentException

protected org.gcube.informationsystem.resourceregistry.api.exceptions.AlreadyPresentException getSpecificAlreadyPresentException(String message)

Description copied from class: ElementManagement

Converts a generic AlreadyPresentException into a subclass-specific AlreadyPresentException.

Specified by:

getSpecificAlreadyPresentException in class ElementManagement<com.orientechnologies.orient.core.record.OElement,org.gcube.informationsystem.types.reference.properties.PropertySchema>

Parameters:

message - the exception message

Returns:

the specific AlreadyPresentException

sanityCheck

public void sanityCheck()
                 throws org.gcube.informationsystem.resourceregistry.api.exceptions.types.SchemaViolationException,
org.gcube.informationsystem.resourceregistry.api.exceptions.ResourceRegistryException

Description copied from class: ElementManagement

Performs runtime validation of the schema constraints this service enforces from the definition rather than through OrientDB: the mandatory properties, and the min and max bounds of the numeric values a creation or an update wrote.

Overrides:

sanityCheck in class ElementManagement<com.orientechnologies.orient.core.record.OElement,org.gcube.informationsystem.types.reference.properties.PropertySchema>

Throws:

org.gcube.informationsystem.resourceregistry.api.exceptions.types.SchemaViolationException - if a schema constraint is violated

org.gcube.informationsystem.resourceregistry.api.exceptions.ResourceRegistryException - on database lookup failure