Package com.yahoo.document

Class Field

    • Field Detail

      • fieldId

        protected int fieldId

    • Constructor Detail

      • Field

        @Deprecated
public Field​(String name,
             int id,
             DataType dataType,
             boolean isHeader)
        Deprecated.
        Creates a new field.
        Parameters:
        name - The name of the field
        dataType - The datatype of the field
        isHeader - Whether this is a "header" field or a "content" field (true = "header").

      • Field

        public Field​(String name)

      • Field

        @Deprecated
public Field​(String name,
             DataType dataType,
             boolean isHeader,
             DocumentType owner)
        Deprecated.
        Creates a new field.
        Parameters:
        name - The name of the field
        dataType - The datatype of the field
        isHeader - Whether this is a "header" field or a "content" field (true = "header").
        owner - the owning document (used to check for id collisions)

      • Field

        @Deprecated
public Field​(String name,
             DataType dataType,
             boolean isHeader)
        Deprecated.
        Creates a new field.
        Parameters:
        name - The name of the field
        dataType - The datatype of the field
        isHeader - Whether this is a "header" field or a "content" field (true = "header").

      • Field

        public Field​(String name,
             DataType dataType)
        Constructor for header fields
        Parameters:
        name - The name of the field
        dataType - The datatype of the field

      • Field

        public Field​(String name,
             Field field)
        Creates a field with a new name and the other properties (excluding the id and owner) copied from another field

    • Method Detail

      • calculateIdV7

        protected int calculateIdV7​(DocumentType owner)
        The field id must be unique within a document type, and also within a (unknown at this time) hierarchy of document types. In addition it should be as resilient to doctype content changes and inheritance hierarchy changes as possible. All of this is enforced for names, so id's should follow names. Therefore we hash on name.

      • setId

        public void setId​(int newId,
                  DocumentType owner)
        Sets the id of this field. Don't do this unless you know what you are doing
        Parameters:
        newId - the id - if this is less than 100 it will cause document to serialize using just one byte for this field id. 100-127 are reserved values
        owner - the owning document, this is checked for collisions and notified of the id change. It can not be null

      • getDataType

        public final DataType getDataType()
        Returns the datatype of the field

      • setDataType

        @Deprecated
public void setDataType​(DataType type)
        Deprecated.
        do not use
        Set the data type of the field. This will cause recalculation of fieldid for version 7+.
        Parameters:
        type - The new type of the field.

      • getId

        @Deprecated
public final int getId​(int version)
        Deprecated.
        Returns the numeric ID used to represent this field when serialized

      • getId

        public final int getId()

      • hasForcedId

        public final boolean hasForcedId()
        Returns:
        true if the field has a forced id

      • isHeader

        @Deprecated
public boolean isHeader()
        Deprecated.
        this has no longer any semantic meaning as this is no longer an aspect with a field

      • setHeader

        @Deprecated
public void setHeader​(boolean header)
        Deprecated.
        this has no longer any semantic meaning as this is no longer an aspect with a field

      • equals

        public boolean equals​(Object o)
        Two fields are equal if they have the same name and the same data type
        Overrides:
        equals in class com.yahoo.vespa.objects.FieldBase

      • hashCode

        public int hashCode()
        Overrides:
        hashCode in class com.yahoo.vespa.objects.FieldBase

      • toString

        public String toString()
        Overrides:
        toString in class com.yahoo.vespa.objects.FieldBase