Package io.permazen.schema

Class ComplexSchemaField

java.lang.Object
io.permazen.util.AbstractXMLStreaming
io.permazen.schema.SchemaItem
io.permazen.schema.SchemaField
io.permazen.schema.ComplexSchemaField
All Implemented Interfaces:
Cloneable
Direct Known Subclasses:
CollectionSchemaField, MapSchemaField
public abstract class ComplexSchemaField extends SchemaField
A complex field in one version of a SchemaObjectType.

  • Constructor Details

    • ComplexSchemaField

      public ComplexSchemaField()

  • Method Details

    • getSubFields

      public abstract NavigableMap<String,SimpleSchemaField> getSubFields()
      Get the sub-fields of this field.
      Returns:
      list of sub-fields, which will be unmodifiable if this instance is locked down

    • visitSchemaItems

      public void visitSchemaItems(Consumer<? super SchemaItem> visitor)
      Visit all SchemaItem descendents of this instance with the given visitor.

      If this instance is also a SchemaItem, then also visit this instance.

      The traversal is depth first, pre-order.

      Parameters:
      visitor - visitor for schema items

    • clone

      public ComplexSchemaField clone()
      Deep-clone this instance.

      The returned instance will not be locked down even if this one is.

      Overrides:
      clone in class SchemaField

    • equals

      public boolean equals(Object obj)
      Overrides:
      equals in class SchemaItem

    • hashCode

      public int hashCode()
      Overrides:
      hashCode in class SchemaItem

    • getObjectType

      public SchemaObjectType getObjectType()
      Get the SchemaObjectType of which this field is a member.
      Returns:
      containing object type

    • setObjectType

      public final void setObjectType(SchemaObjectType objectType)
      Set the SchemaObjectType of which this field is a member.

      Note: this field is considered derived information, and will be set automatically when a referrring SchemaObjectType is locked down.

      Parameters:
      objectType - containing object type
      Throws:
      UnsupportedOperationException - if this instance is locked down

    • visitSchemaItems

      public final <T extends SchemaItem> void visitSchemaItems(Class<T> nodeType, Consumer<? super T> visitor)
      Visit this schema item and all of its descendents matching the given type with the given visitor.

      The traversal is depth first, post-order.

      Parameters:
      nodeType - node type to include
      visitor - visitor for schema items
      Throws:
      IllegalArgumentException - if either parameter is null

    • isLockedDown

      public final boolean isLockedDown(boolean includingStorageIds)
      Determine whether this instance is locked down.
      Parameters:
      includingStorageIds - false to test all but storage ID's, true to require storage ID's to be locked down as well
      Returns:
      true if instance is locked down, otherwise false

    • getSchemaId

      public final SchemaId getSchemaId()
      Generate a unique SchemaId corresponding to the type and encoding structure of this schema item.

      The SchemaId does not depend on the storage ID.

      This instance must be locked down except for storage ID's. Repeated invocations of this method will be very fast, just returning the cached previous result.

      Returns:
      schema ID
      Throws:
      IllegalStateException - if this instance is not locked down
      See Also:

    • getItemType

      public abstract ItemType getItemType()
      Get the ItemType corresponding to this instance.
      Returns:
      schema item type