Document.DocumentProperty

abstract fun indexNestedProperties(): Boolean

Configures whether all fields in the nested document should be indexed.

If false, the nested document's properties are not indexed regardless of its own schema, unless indexableNestedPropertiesList is used to index a subset of properties from the nested document.

IllegalArgumentException will be thrown during setSchema if set to true and defining a non-empty list for indexableNestedPropertiesList

abstract fun indexableNestedPropertiesList(): Array<String!>!

The list of properties in the nested document to index. The property will be indexed according to its indexing configurations in the document's schema definition.

indexNestedProperties is required to be false if this list is non-empty. IllegalArgumentException will be thrown during setSchema if this condition is not met.

abstract fun inheritIndexableNestedPropertiesFromSuperclass(): Boolean

Configures whether to inherit the indexable nested properties list from the Document's superclass type definition. When set to true, the indexable property paths will be a union of the paths specified in indexableNestedPropertiesList and any path specified in the document class's superclass or inherited interfaces. Effectively, this is a no-op if none of the document superclasses specify a path for this document property.

Ex. Consider the following Document classes:

class Person {
  = {"streetName", "zipcode"})
  Address livesAt;
}

class Artist extends Person {
  
    indexableNestedPropertiesList = {"country"},
    inheritIndexableNestedPropertiesFromSuperclass = true
  )
  Address livesAt;
}

By setting 'inheritIndexableNestedPropertiesFromSuperclass = true', Artist.livesAt inherits the indexable nested properties defined by its parent class's livesAt field (Person.livesAt) and indexes all three fields: {streetName, zipCode, country}

abstract fun name(): String!

The name of this property. This string is used to query against this property.

If not specified, the name of the field in the code will be used instead.

abstract fun required(): Boolean

Configures whether this property must be specified for the document to be valid.

This attribute does not apply to properties of a repeated type (e.g. a list).

Please make sure you understand the consequences of required fields on schema migration before setting this attribute to true.