Cloud Firestore V1 Client - Class ExistenceFilter (1.32.0)

Reference documentation and code samples for the Cloud Firestore V1 Client class ExistenceFilter.

A digest of all the documents that match a given target.

Generated from protobuf message google.firestore.v1.ExistenceFilter

Methods

__construct

Constructor.

Parameters
NameDescription
data array

Optional. Data for populating the Message object.

↳ target_id int

The target ID to which this filter applies.

↳ count int

The total count of documents that match target_id. If different from the count of documents in the client that match, the client must manually determine which documents no longer match the target.

↳ unchanged_names Google\Cloud\Firestore\V1\BloomFilter

A bloom filter that contains the UTF-8 byte encodings of the resource names of the documents that match target_id, in the form projects/{project_id}/databases/{database_id}/documents/{document_path} that have NOT changed since the query results indicated by the resume token or timestamp given in Target.resume_type. This bloom filter may be omitted at the server's discretion, such as if it is deemed that the client will not make use of it or if it is too computationally expensive to calculate or transmit. Clients must gracefully handle this field being absent by falling back to the logic used before this field existed; that is, re-add the target without a resume token to figure out which documents in the client's cache are out of sync.

getTargetId

The target ID to which this filter applies.

Returns
TypeDescription
int

setTargetId

The target ID to which this filter applies.

Parameter
NameDescription
var int
Returns
TypeDescription
$this

getCount

The total count of documents that match target_id.

If different from the count of documents in the client that match, the client must manually determine which documents no longer match the target.

Returns
TypeDescription
int

setCount

The total count of documents that match target_id.

If different from the count of documents in the client that match, the client must manually determine which documents no longer match the target.

Parameter
NameDescription
var int
Returns
TypeDescription
$this

getUnchangedNames

A bloom filter that contains the UTF-8 byte encodings of the resource names of the documents that match target_id, in the form projects/{project_id}/databases/{database_id}/documents/{document_path} that have NOT changed since the query results indicated by the resume token or timestamp given in Target.resume_type.

This bloom filter may be omitted at the server's discretion, such as if it is deemed that the client will not make use of it or if it is too computationally expensive to calculate or transmit. Clients must gracefully handle this field being absent by falling back to the logic used before this field existed; that is, re-add the target without a resume token to figure out which documents in the client's cache are out of sync.

Returns
TypeDescription
Google\Cloud\Firestore\V1\BloomFilter|null

hasUnchangedNames

clearUnchangedNames

setUnchangedNames

A bloom filter that contains the UTF-8 byte encodings of the resource names of the documents that match target_id, in the form projects/{project_id}/databases/{database_id}/documents/{document_path} that have NOT changed since the query results indicated by the resume token or timestamp given in Target.resume_type.

This bloom filter may be omitted at the server's discretion, such as if it is deemed that the client will not make use of it or if it is too computationally expensive to calculate or transmit. Clients must gracefully handle this field being absent by falling back to the logic used before this field existed; that is, re-add the target without a resume token to figure out which documents in the client's cache are out of sync.

Parameter
NameDescription
var Google\Cloud\Firestore\V1\BloomFilter
Returns
TypeDescription
$this