Added in API level 31

Builder

open class Builder<BuilderType : GenericDocument.Builder<GenericDocument.Builder<*>>!>
kotlin.Any
   ↳ android.app.appsearch.GenericDocument.Builder

The builder class for GenericDocument.

Summary

Public constructors
Builder(namespace: String, id: String, schemaType: String)

Creates a new GenericDocument.Builder.

Creates a new GenericDocument.Builder from the given GenericDocument.

Public methods
open GenericDocument

Builds the GenericDocument object.

open BuilderType
setCreationTimestampMillis(creationTimestampMillis: Long)

Sets the creation timestamp of the GenericDocument, in milliseconds.

open BuilderType
setPropertyBoolean(name: String, vararg values: Boolean)

Sets one or multiple boolean values for a property, replacing its previous values.

open BuilderType
setPropertyBytes(name: String, vararg values: ByteArray!)

Sets one or multiple byte[] for a property, replacing its previous values.

open BuilderType
setPropertyDocument(name: String, vararg values: GenericDocument!)

Sets one or multiple GenericDocument values for a property, replacing its previous values.

open BuilderType
setPropertyDouble(name: String, vararg values: Double)

Sets one or multiple double values for a property, replacing its previous values.

open BuilderType
setPropertyLong(name: String, vararg values: Long)

Sets one or multiple long values for a property, replacing its previous values.

open BuilderType
setPropertyString(name: String, vararg values: String!)

Sets one or multiple String values for a property, replacing its previous values.

open BuilderType
setScore(score: Int)

Sets the score of the GenericDocument.

open BuilderType
setTtlMillis(ttlMillis: Long)

Sets the TTL (time-to-live) of the GenericDocument, in milliseconds.

Public constructors

Builder

Added in API level 31
Builder(
    namespace: String,
    id: String,
    schemaType: String)

Creates a new GenericDocument.Builder.

Document IDs are unique within a namespace.

The number of namespaces per app should be kept small for efficiency reasons.

Parameters
namespace String: the namespace to set for the GenericDocument. This value cannot be null.
id String: the unique identifier for the GenericDocument in its namespace. This value cannot be null.
schemaType String: the AppSearchSchema type of the GenericDocument. The provided schemaType must be defined using AppSearchSession#setSchema prior to inserting a document of this schemaType into the AppSearch index using AppSearchSession#put. Otherwise, the document will be rejected by AppSearchSession#put with result code android.app.appsearch.AppSearchResult#RESULT_NOT_FOUND. This value cannot be null.

Builder

Added in API level 31
Builder(document: GenericDocument)

Creates a new GenericDocument.Builder from the given GenericDocument.

The GenericDocument is deep copied, i.e. changes to the new GenericDocument returned by this function will NOT affect the original GenericDocument.

Parameters
document GenericDocument: This value cannot be null.

Public methods

build

Added in API level 31
open fun build(): GenericDocument

Builds the GenericDocument object.

Return
GenericDocument This value cannot be null.

setCreationTimestampMillis

Added in API level 31
open fun setCreationTimestampMillis(creationTimestampMillis: Long): BuilderType

Sets the creation timestamp of the GenericDocument, in milliseconds.

This should be set using a value obtained from the System#currentTimeMillis time base.

If this method is not called, this will be set to the time the object is built.

Parameters
creationTimestampMillis Long: a creation timestamp in milliseconds. Value is a non-negative timestamp measured as the number of milliseconds since 1970-01-01T00:00:00Z.
Return
BuilderType This value cannot be null.

setPropertyBoolean

Added in API level 31
open fun setPropertyBoolean(
    name: String,
    vararg values: Boolean
): BuilderType

Sets one or multiple boolean values for a property, replacing its previous values.

Parameters
name String: the name associated with the values. Must match the name for this property as given in AppSearchSchema.PropertyConfig#getName. This value cannot be null.
values Boolean: the boolean values of the property. This value cannot be null.
Return
BuilderType This value cannot be null.
Exceptions
java.lang.IllegalArgumentException if the name is empty or null.

setPropertyBytes

Added in API level 31
open fun setPropertyBytes(
    name: String,
    vararg values: ByteArray!
): BuilderType

Sets one or multiple byte[] for a property, replacing its previous values.

Parameters
name String: the name associated with the values. Must match the name for this property as given in AppSearchSchema.PropertyConfig#getName. This value cannot be null.
values ByteArray!: the byte[] of the property. This value cannot be null.
Return
BuilderType This value cannot be null.
Exceptions
java.lang.IllegalArgumentException if no values are provided, or if a passed in byte[] is null, or if name is empty.

setPropertyDocument

Added in API level 31
open fun setPropertyDocument(
    name: String,
    vararg values: GenericDocument!
): BuilderType

Sets one or multiple GenericDocument values for a property, replacing its previous values.

Parameters
name String: the name associated with the values. Must match the name for this property as given in AppSearchSchema.PropertyConfig#getName. This value cannot be null.
values GenericDocument!: the GenericDocument values of the property. This value cannot be null.
Return
BuilderType This value cannot be null.
Exceptions
java.lang.IllegalArgumentException if no values are provided, or if a passed in GenericDocument is null, or if name is empty.

setPropertyDouble

Added in API level 31
open fun setPropertyDouble(
    name: String,
    vararg values: Double
): BuilderType

Sets one or multiple double values for a property, replacing its previous values.

Parameters
name String: the name associated with the values. Must match the name for this property as given in AppSearchSchema.PropertyConfig#getName. This value cannot be null.
values Double: the double values of the property. This value cannot be null.
Return
BuilderType This value cannot be null.
Exceptions
java.lang.IllegalArgumentException if the name is empty or null.

setPropertyLong

Added in API level 31
open fun setPropertyLong(
    name: String,
    vararg values: Long
): BuilderType

Sets one or multiple long values for a property, replacing its previous values.

Parameters
name String: the name associated with the values. Must match the name for this property as given in AppSearchSchema.PropertyConfig#getName. This value cannot be null.
values Long: the long values of the property. This value cannot be null.
Return
BuilderType This value cannot be null.
Exceptions
java.lang.IllegalArgumentException if the name is empty or null.

setPropertyString

Added in API level 31
open fun setPropertyString(
    name: String,
    vararg values: String!
): BuilderType

Sets one or multiple String values for a property, replacing its previous values.

Parameters
name String: the name associated with the values. Must match the name for this property as given in AppSearchSchema.PropertyConfig#getName. This value cannot be null.
values String!: the String values of the property. This value cannot be null.
Return
BuilderType This value cannot be null.
Exceptions
java.lang.IllegalArgumentException if no values are provided, or if a passed in String is null or "".

setScore

Added in API level 31
open fun setScore(score: Int): BuilderType

Sets the score of the GenericDocument.

The score is a query-independent measure of the document's quality, relative to other GenericDocument objects of the same AppSearchSchema type.

Results may be sorted by score using android.app.appsearch.SearchSpec.Builder#setRankingStrategy. Documents with higher scores are considered better than documents with lower scores.

Any non-negative integer can be used a score. By default, scores are set to 0.

Parameters
score Int: any non-negative int representing the document's score. Value is between 0 and Integer.MAX_VALUE inclusive
Return
BuilderType This value cannot be null.
Exceptions
java.lang.IllegalArgumentException if the score is negative.

setTtlMillis

Added in API level 31
open fun setTtlMillis(ttlMillis: Long): BuilderType

Sets the TTL (time-to-live) of the GenericDocument, in milliseconds.

The TTL is measured against getCreationTimestampMillis. At the timestamp of creationTimestampMillis + ttlMillis, measured in the java.lang.System#currentTimeMillis time base, the document will be auto-deleted.

The default value is 0, which means the document is permanent and won't be auto-deleted until the app is uninstalled or android.app.appsearch.AppSearchSession#remove is called.

Parameters
ttlMillis Long: a non-negative duration in milliseconds.
Return
BuilderType This value cannot be null.
Exceptions
java.lang.IllegalArgumentException if ttlMillis is negative.