Class ExistenceFilter (3.21.0)

public final class ExistenceFilter extends GeneratedMessageV3 implements ExistenceFilterOrBuilder

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

Protobuf type google.firestore.v1.ExistenceFilter

Static Fields

COUNT_FIELD_NUMBER

public static final int COUNT_FIELD_NUMBER
Field Value
Type Description
int

TARGET_ID_FIELD_NUMBER

public static final int TARGET_ID_FIELD_NUMBER
Field Value
Type Description
int

UNCHANGED_NAMES_FIELD_NUMBER

public static final int UNCHANGED_NAMES_FIELD_NUMBER
Field Value
Type Description
int

Static Methods

getDefaultInstance()

public static ExistenceFilter getDefaultInstance()
Returns
Type Description
ExistenceFilter

getDescriptor()

public static final Descriptors.Descriptor getDescriptor()
Returns
Type Description
Descriptor

newBuilder()

public static ExistenceFilter.Builder newBuilder()
Returns
Type Description
ExistenceFilter.Builder

newBuilder(ExistenceFilter prototype)

public static ExistenceFilter.Builder newBuilder(ExistenceFilter prototype)
Parameter
Name Description
prototype ExistenceFilter
Returns
Type Description
ExistenceFilter.Builder

parseDelimitedFrom(InputStream input)

public static ExistenceFilter parseDelimitedFrom(InputStream input)
Parameter
Name Description
input InputStream
Returns
Type Description
ExistenceFilter
Exceptions
Type Description
IOException

parseDelimitedFrom(InputStream input, ExtensionRegistryLite extensionRegistry)

public static ExistenceFilter parseDelimitedFrom(InputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
Name Description
input InputStream
extensionRegistry ExtensionRegistryLite
Returns
Type Description
ExistenceFilter
Exceptions
Type Description
IOException

parseFrom(byte[] data)

public static ExistenceFilter parseFrom(byte[] data)
Parameter
Name Description
data byte[]
Returns
Type Description
ExistenceFilter
Exceptions
Type Description
InvalidProtocolBufferException

parseFrom(byte[] data, ExtensionRegistryLite extensionRegistry)

public static ExistenceFilter parseFrom(byte[] data, ExtensionRegistryLite extensionRegistry)
Parameters
Name Description
data byte[]
extensionRegistry ExtensionRegistryLite
Returns
Type Description
ExistenceFilter
Exceptions
Type Description
InvalidProtocolBufferException

parseFrom(ByteString data)

public static ExistenceFilter parseFrom(ByteString data)
Parameter
Name Description
data ByteString
Returns
Type Description
ExistenceFilter
Exceptions
Type Description
InvalidProtocolBufferException

parseFrom(ByteString data, ExtensionRegistryLite extensionRegistry)

public static ExistenceFilter parseFrom(ByteString data, ExtensionRegistryLite extensionRegistry)
Parameters
Name Description
data ByteString
extensionRegistry ExtensionRegistryLite
Returns
Type Description
ExistenceFilter
Exceptions
Type Description
InvalidProtocolBufferException

parseFrom(CodedInputStream input)

public static ExistenceFilter parseFrom(CodedInputStream input)
Parameter
Name Description
input CodedInputStream
Returns
Type Description
ExistenceFilter
Exceptions
Type Description
IOException

parseFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)

public static ExistenceFilter parseFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
Name Description
input CodedInputStream
extensionRegistry ExtensionRegistryLite
Returns
Type Description
ExistenceFilter
Exceptions
Type Description
IOException

parseFrom(InputStream input)

public static ExistenceFilter parseFrom(InputStream input)
Parameter
Name Description
input InputStream
Returns
Type Description
ExistenceFilter
Exceptions
Type Description
IOException

parseFrom(InputStream input, ExtensionRegistryLite extensionRegistry)

public static ExistenceFilter parseFrom(InputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
Name Description
input InputStream
extensionRegistry ExtensionRegistryLite
Returns
Type Description
ExistenceFilter
Exceptions
Type Description
IOException

parseFrom(ByteBuffer data)

public static ExistenceFilter parseFrom(ByteBuffer data)
Parameter
Name Description
data ByteBuffer
Returns
Type Description
ExistenceFilter
Exceptions
Type Description
InvalidProtocolBufferException

parseFrom(ByteBuffer data, ExtensionRegistryLite extensionRegistry)

public static ExistenceFilter parseFrom(ByteBuffer data, ExtensionRegistryLite extensionRegistry)
Parameters
Name Description
data ByteBuffer
extensionRegistry ExtensionRegistryLite
Returns
Type Description
ExistenceFilter
Exceptions
Type Description
InvalidProtocolBufferException

parser()

public static Parser<ExistenceFilter> parser()
Returns
Type Description
Parser<ExistenceFilter>

Methods

equals(Object obj)

public boolean equals(Object obj)
Parameter
Name Description
obj Object
Returns
Type Description
boolean
Overrides

getCount()

public int 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.

The client can use the unchanged_names bloom filter to assist with this determination by testing ALL the document names against the filter; if the document name is NOT in the filter, it means the document no longer matches the target.

int32 count = 2;

Returns
Type Description
int

The count.

getDefaultInstanceForType()

public ExistenceFilter getDefaultInstanceForType()
Returns
Type Description
ExistenceFilter

getParserForType()

public Parser<ExistenceFilter> getParserForType()
Returns
Type Description
Parser<ExistenceFilter>
Overrides

getSerializedSize()

public int getSerializedSize()
Returns
Type Description
int
Overrides

getTargetId()

public int getTargetId()

The target ID to which this filter applies.

int32 target_id = 1;

Returns
Type Description
int

The targetId.

getUnchangedNames()

public BloomFilter getUnchangedNames()

A bloom filter that, despite its name, contains the UTF-8 byte encodings of the resource names of ALL the documents that match target_id, in the form projects/{project_id}/databases/{database_id}/documents/{document_path}.

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.

.google.firestore.v1.BloomFilter unchanged_names = 3;

Returns
Type Description
BloomFilter

The unchangedNames.

getUnchangedNamesOrBuilder()

public BloomFilterOrBuilder getUnchangedNamesOrBuilder()

A bloom filter that, despite its name, contains the UTF-8 byte encodings of the resource names of ALL the documents that match target_id, in the form projects/{project_id}/databases/{database_id}/documents/{document_path}.

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.

.google.firestore.v1.BloomFilter unchanged_names = 3;

Returns
Type Description
BloomFilterOrBuilder

hasUnchangedNames()

public boolean hasUnchangedNames()

A bloom filter that, despite its name, contains the UTF-8 byte encodings of the resource names of ALL the documents that match target_id, in the form projects/{project_id}/databases/{database_id}/documents/{document_path}.

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.

.google.firestore.v1.BloomFilter unchanged_names = 3;

Returns
Type Description
boolean

Whether the unchangedNames field is set.

hashCode()

public int hashCode()
Returns
Type Description
int
Overrides

internalGetFieldAccessorTable()

protected GeneratedMessageV3.FieldAccessorTable internalGetFieldAccessorTable()
Returns
Type Description
FieldAccessorTable
Overrides

isInitialized()

public final boolean isInitialized()
Returns
Type Description
boolean
Overrides

newBuilderForType()

public ExistenceFilter.Builder newBuilderForType()
Returns
Type Description
ExistenceFilter.Builder

newBuilderForType(GeneratedMessageV3.BuilderParent parent)

protected ExistenceFilter.Builder newBuilderForType(GeneratedMessageV3.BuilderParent parent)
Parameter
Name Description
parent BuilderParent
Returns
Type Description
ExistenceFilter.Builder
Overrides

newInstance(GeneratedMessageV3.UnusedPrivateParameter unused)

protected Object newInstance(GeneratedMessageV3.UnusedPrivateParameter unused)
Parameter
Name Description
unused UnusedPrivateParameter
Returns
Type Description
Object
Overrides

toBuilder()

public ExistenceFilter.Builder toBuilder()
Returns
Type Description
ExistenceFilter.Builder

writeTo(CodedOutputStream output)

public void writeTo(CodedOutputStream output)
Parameter
Name Description
output CodedOutputStream
Overrides
Exceptions
Type Description
IOException