Changelog
3.6.0 (2022-10-04)
Features
- Count queries (not available for use yet) (#1033) (8b60612)
- Make count queries publicly available for use (#1042) (1c8d242)
Documentation
Dependencies
- Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.0.4 (#1053) (9b4c26e)
- Update dependency org.graalvm.buildtools:junit-platform-native to v0.9.14 (#1045) (04b3861)
- Update dependency org.graalvm.buildtools:native-maven-plugin to v0.9.14 (#1046) (6631a58)
- Update dependency org.junit.vintage:junit-vintage-engine to v5.9.1 (#1039) (84423f4)
3.5.0 (2022-09-16)
Features
Dependencies
- Update actions/setup-java action to v3 (#1031) (1aae546)
- Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.0.2 (#1032) (9b68360)
- Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.0.3 (#1034) (5acd8e4)
3.4.2 (2022-08-24)
Dependencies
3.4.1 (2022-08-19)
Bug Fixes
3.4.0 (2022-08-03)
Features
Bug Fixes
Dependencies
- update dependency com.google.cloud:google-cloud-shared-dependencies to v3 (#1000) (a3c4ec5)
- update dependency org.graalvm.buildtools:junit-platform-native to v0.9.12 (#972) (8cf33b0)
- update dependency org.graalvm.buildtools:junit-platform-native to v0.9.13 (#988) (f8d9496)
- update dependency org.graalvm.buildtools:native-maven-plugin to v0.9.13 (#989) (4c768e3)
- update dependency org.junit.vintage:junit-vintage-engine to v5.9.0 (#997) (d4dd4d8)
3.3.0 (2022-07-01)
Features
Bug Fixes
Performance Improvements
Dependencies
- update beam.version to v2.40.0 (#978) (44276f8)
- update dependency com.google.cloud:google-cloud-shared-dependencies to v2.13.0 (#974) (6def73d)
- update dependency org.graalvm.buildtools:native-maven-plugin to v0.9.12 (#973) (bfb4ec9)
3.2.0 (2022-05-23)
Features
Documentation
Dependencies
3.1.0 (2022-04-21)
Features
Dependencies
- update dependency com.google.cloud:google-cloud-shared-dependencies to v2.10.0 (#945) (5b2e318)
- update dependency com.google.cloud:native-image-support to v0.13.1 (#944) (b3b474f)
3.0.21 (2022-03-30)
Bug Fixes
- change REST binding for ListDocuments to support root collection (#900) (aabd4ac)
- java: move test native image configs to test/resources (#929) (9ed6c5e)
Dependencies
- update dependency com.google.cloud:google-cloud-shared-dependencies to v2.9.0 (#932) (abebae7)
- update dependency com.google.cloud:native-image-support to v0.12.11 (#931) (0e1e3c5)
3.0.20 (2022-03-24)
Dependencies
- update dependency org.graalvm.buildtools:junit-platform-native to v0.9.11 (#923) (43f24b1)
- update dependency org.graalvm.buildtools:native-maven-plugin to v0.9.11 (#924) (70b0d00)
3.0.19 (2022-03-14)
Bug Fixes
Dependencies
3.0.18 (2022-03-10)
Dependencies
3.0.17 (2022-03-09)
Dependencies
3.0.16 (2022-03-08)
Dependencies
3.0.15 (2022-03-02)
Documentation
Dependencies
- update dependency com.google.cloud:google-cloud-shared-dependencies to v2.8.0 (#895) (bf1951d)
- update dependency com.google.cloud:native-image-support to v0.12.6 (#898) (73606e5)
3.0.14 (2022-03-01)
Bug Fixes
- fix groupID for artifacts (#890) (bb46bcb)
- java: add reflection configuration for native image tests (#878) (1938113)
Dependencies
- update actions/setup-java action to v3 (#888) (07130f9)
- update dependency com.google.cloud:native-image-support to v0.12.5 (#889) (5f4ffcb)
- update dependency org.graalvm.buildtools:junit-platform-native to v0.9.10 (#880) (a3a9684)
3.0.13 (2022-02-22)
Bug Fixes
Documentation
Dependencies
- update dependency com.google.cloud:native-image-support to v0.12.4 (#882) (b2aeb1a)
- update dependency org.graalvm.buildtools:native-maven-plugin to v0.9.10 (#881) (036f7f8)
3.0.12 (2022-02-04)
Dependencies
- update dependency com.google.cloud:google-cloud-shared-dependencies to v2.7.0 (#860) (bf48381)
- update dependency org.apache.commons:commons-lang3 to v3.12.0 (#846) (efc73bd)
3.0.11 (2022-01-27)
Bug Fixes
3.0.10 (2022-01-07)
Bug Fixes
Dependencies
3.0.9 (2021-12-03)
Dependencies
3.0.8 (2021-11-16)
Bug Fixes
Dependencies
3.0.7 (2021-10-27)
Bug Fixes
- java: java 17 dependency arguments (#802) (ec07294)
- set timeouts for BatchGetDocuments/RunQuery (#799) (6cd2a45)
3.0.6 (2021-10-19)
Dependencies
3.0.5 (2021-09-22)
Dependencies
3.0.4 (2021-09-14)
Dependencies
3.0.3 (2021-08-31)
Dependencies
- update dependency com.google.cloud:google-cloud-shared-dependencies to v2.2.0 (#753) (6744bfa)
- update google-cloud-conformance-tests to 0.2.0 (#752) (135bc6b)
3.0.2 (2021-08-23)
Dependencies
3.0.1 (2021-08-11)
Dependencies
3.0.0 (2021-08-09)
⚠ BREAKING CHANGES
- update Java compile to 1.8 (#710)
- update gapic generator to 2.0.0, java 8 features (#719)
Features
- update Java compile to 1.8 (#710)
- gapic-generator-java v1.0.13, mtls support (#712) (a27dd9c)
- update gapic generator to 2.0.0, java 8 features (#719) (0d5b378)
Dependencies
2.6.2 (2021-07-29)
Bug Fixes
- Add shopt -s nullglob to dependencies script (8f4b199)
- Ensures bundles are encoded as UTF8 bytes. (#695) (0946a17)
- lower batch size on BulkWriter retry (#688) (146b21d)
- Update dependencies.sh to not break on mac (#694) (8f4b199)
Documentation
2.6.1 (2021-06-30)
Dependencies
2.6.0 (2021-06-29)
Features
Bug Fixes
2.5.1 (2021-06-22)
Bug Fixes
Dependencies
- update dependency com.google.cloud:google-cloud-conformance-tests to v0.1.1 (#650) (b93ca8a)
- update dependency com.google.cloud:google-cloud-shared-dependencies to v1.3.0 (#660) (0f13fd0)
2.5.0 (2021-06-01)
Features
- add
gcf-owl-bot[bot]toignoreAuthors(#641) (6f40f0f) - add recursiveDelete() to Firestore (#622) (#649) (9ff2f41)
Dependencies
2.4.0 (2021-05-17)
Features
Bug Fixes
Dependencies
2.3.0 (2021-04-23)
Features
Dependencies
2.2.7 (2021-04-20)
Bug Fixes
Dependencies
2.2.6 (2021-04-13)
Bug Fixes
Dependencies
2.2.5 (2021-03-11)
Dependencies
2.2.4 (2021-02-25)
Dependencies
2.2.3 (2021-02-19)
Dependencies
2.2.2 (2021-02-19)
Bug Fixes
- block close() on the termination of all RPC channels (#512) (67bd06a)
- samples: close firestore instance in test (#476) (fb1cb17)
2.2.1 (2021-02-02)
Bug Fixes
2.2.0 (2021-01-20)
Features
- Add bundle proto building (#271) (994835c)
- add bundle.proto from googleapis/googleapis (#407) (37da386)
- add CollectionGroup#getPartitions(long) (#478) (bab064e)
- add implicit ordering for startAt(DocumentReference) calls (#417) (aae6dc9)
- add max/min throttling options to BulkWriterOptions (#400) (27a9397)
- add success and error callbacks to BulkWriter (#483) (3c05037)
- Implementation of Firestore Bundle Builder (#293) (fd5ef90)
- Release bundles (#466) (3af065e)
Bug Fixes
- add @BetaApi, make BulkWriter public, and refactor Executor (#497) (27ff9f6)
- build: sample checkstyle violations (#457) (777ecab)
- bulkWriter: writing to the same doc doesn't create a new batch (#394) (259ece8)
- empty commit to trigger release-please (fcef0d3)
- make BulkWriterOptions public (#502) (6ea05be)
- retry Query streams (#426) (3513cd3)
- retry transactions that fail with expired transaction IDs (#447) (5905438)
- verify partition count before invoking GetPartition RPC (#418) (2054ae9)
Documentation
Dependencies
- remove explicit version for jackson (#479) (e2aecfe)
- update dependency com.google.cloud:google-cloud-conformance-tests to v0.0.12 (#367) (2bdd846)
- update dependency com.google.cloud:google-cloud-conformance-tests to v0.0.13 (#411) (e6157b5)
- update dependency com.google.cloud:google-cloud-shared-dependencies to v0.10.0 (#383) (cb39ee8)
- update dependency com.google.cloud:google-cloud-shared-dependencies to v0.10.2 (#403) (991dd81)
- update dependency com.google.cloud:google-cloud-shared-dependencies to v0.12.1 (#425) (b897ffa)
- update dependency com.google.cloud:google-cloud-shared-dependencies to v0.13.0 (#430) (0f8f218)
- update dependency com.google.cloud:google-cloud-shared-dependencies to v0.14.1 (#446) (e241f8e)
- update dependency com.google.cloud:google-cloud-shared-dependencies to v0.15.0 (#460) (b82fc35)
- update dependency com.google.cloud:google-cloud-shared-dependencies to v0.16.0 (#481) (ae98824)
- update dependency com.google.cloud:google-cloud-shared-dependencies to v0.16.1 (4ace93c)
- update dependency com.google.cloud:google-cloud-shared-dependencies to v0.17.0 (#487) (e11e472)
- update dependency com.google.cloud:google-cloud-shared-dependencies to v0.18.0 (#495) (f78720a)
- update jackson dependencies to v2.11.3 (#396) (2e176e2)
2.1.0 (2020-09-10)
Features
- add method to set emulator host programmatically (#319) (#336) (97037f4), closes #210 #190
- add opencensus tracing support (#360) (edaa539)
- add support for != and NOT_IN queries (#350) (68aff5b)
- generate protos to add NOT_EQUAL, NOT_IN, IS_NOT_NAN, IS_NOT_NULL query operators (#343) (3fb1b63)
Bug Fixes
- samples: re-add maven exec config for Quickstart sample (#347) (4c2329b)
- add support to deserialize to custom Lists and Maps (#337) (dc897e0)
Dependencies
2.0.0 (2020-08-14)
New Features
Query Partition API
New API and backend RPC which allows for fetching a set of cursor keys for a
Collection Group Query. Accessible via the new CollectionGroup#getPartitions(long,ApiStreamObserver) method.
Read-Only Transaction Options
TransactionOptions
has been refactored to provide the ability to configure options for read-only
transactions along with the existing configuration for read-write transactions.
This new ability is provided via the new TransactionOptions.createReadOnlyOptionsBuilder()
type safe builder.
Along with the new type safe builder for read-only options, there is a new type
safe builder for read-write options as well accessible via TransactionOptions.createReadWriteOptionsBuilder(). Each of the existing TransactionOptions.create(...)
methods for configuring read-write options has been deprecated in favor of the new builder.
EmulatorCredentials
com.google.cloud.firestore.FirestoreOptions.Builder.FakeCredentials has been
made static and renamed to com.google.cloud.firestore.FirestoreOptions.EmulatorCredentials
allowing instantiation outside FirestoreOptions.Builder.
When connecting to the Cloud Firestore Emulator via FirestoreOptions rather than
the environment variable FIRESTORE_EMULATOR_HOST, a custom credential implementation
must be specified to allow various admin operations in the emulator. Previously
this required users to create their own implementation due to it not being
possible to construct a FakeCredential. As part of this change, EmulatorCredentials
is static and therefore able to be constructed from any location.
Breaking Changes
New Firestore Admin Client API Artifact
The Cloud Firestore Admin Client has been migrated to its own maven artifact com.google.cloud:google-cloud-firestore-admin
rather than being bundled in com.google.cloud:google-cloud-firestore. All
packages and classes have retained their existing names.
The new artifact is included in the com.google.cloud:google-cloud-firestore-bom,
com.google.cloud:google-cloud-bom and com.google.cloud:libraries-bom
artifacts and is accessible by adding the new dependency to your pom.xml file:
<dependency>
<groupId>com.google.cloud</groupId>
<artifactId>google-cloud-firestore-admin</artifactId>
</dependency>
Removal of v1beta1
Cloud Firestore has been GA for some time now, and the google-cloud-firestore
code base has been using the protos and generated classes for the v1 api since
that time. As such, we will no longer be publishing artifacts for the deprecated
v1beta1 protos. All functionality from v1beta1 is present in v1, and all users
should update any code to use v1.
Removal of support for java.util.Date in Snapshots
It is no longer possible to configure the ability for java.util.Date to be
returned from DocumentSnapshot.get(FieldPath) or DocumentSnapshot.getData()
for properties which are stored as Timestamps in Cloud Firestore.
The default behavior has been to return com.google.cloud.Timestamp by default
for some time, and is now the only option. Any code that is dependent on the old
behavior must be updated to use Timestamps instead of Date.
Laundry List of Pull Requests
⚠ BREAKING CHANGES
- add support for the Query Partition API (#202)
Firestore#collectionGroup(...)has a new return typeCollectionGroupwhich requires any code that previously used the method be re-compiled to pick up the new signature.CollectionGroupextendsQueryand as such does not require your code to be updated, only the compiled class files.
- move FirestoreAdminClient and associated classes to new artifact google-cloud-firestore-admin (#311)
- remove deprecated v1beta1 protos and grpc client (#305)
- remove deprecated FirestoreOptions#setTimestampsInSnapshotsEnabled (#308)
- remove deprecated getCollections() methods (#307)
- various renames due to generator changes
Features
- add support for read-only transactions in TransactionOptions (#320) (c25dca3)
- add support for the Query Partition API (#202) (3996548)
Bug Fixes
Dependencies
- update dependency com.google.cloud:google-cloud-shared-dependencies to v0.8.5 (#322) (1b21350)
- update dependency com.google.cloud:google-cloud-shared-dependencies to v0.8.6 (#324) (b945fdb)
- update jackson dependencies to v2.11.2 (#314) (15d68cd)
Miscellaneous Chores
- enable gapicv2 (#188) (92224bc)
- move FirestoreAdminClient and associated classes to new artifact google-cloud-firestore-admin (#311) (03ef755)
- remove deprecated FirestoreOptions#setTimestampsInSnapshotsEnabled (#308) (7255a42)
- remove deprecated getCollections() methods (#307) (bb4ddf1)
- remove deprecated v1beta1 protos and grpc client (#305) (96adacb)
- add BulkWriter (#323) (e7054df)
- make BulkWriter package private (#330) (ef0869a)
1.35.2 (2020-07-16)
Bug Fixes
- add Internal#autoId() (#292) (b91c57c)
- add support for deleting nested fields that contain periods (#295) (84f602e)
- use test credentials when connecting to the Emulator from the Firebase Admin SDK (#296) (a0a6e80)
Dependencies
1.35.1 (2020-07-01)
Dependencies
- update dependency com.google.cloud:google-cloud-shared-dependencies to v0.8.2 (#280) (9296f7a)
- update jackson dependencies to v2.11.1 (#272) (1065704)
- adopt flatten plugin and google-cloud-shared-dependencies (#261) (78b2ebf)
1.35.0 (2020-06-17)
Features
- ability to serialize Query to Proto (#241) (bae22e0)
- add support for fieldmask to document reference (#245) (4a846b1)
Dependencies
- update core dependencies (#254) (9b275ca)
- update dependency com.google.api:api-common to v1.9.2 (#238) (c47d327)
- update dependency io.grpc:grpc-bom to v1.30.0 (#244) (b5749d4)
1.34.0 (2020-05-29)
Features
Bug Fixes
- add RateLimiter (#230) (47d4a11)
- catch null Firestore in system tests (#215) (2a4a7b5)
- Fields used in whereIn should be equality filters (#216) (4a62633)
- replace usages of transform proto with update_transform (#213) (46a3c51)
- support array of references for IN queries (#211) (b376003)
Dependencies
- update core dependencies to v1.93.5 (#229) (b078213)
- update dependency com.google.api:api-common to v1.9.1 (#228) (7e4568d)
- update dependency com.google.api.grpc:proto-google-common-protos to v1.18.0 (#204) (1e05de4)
- update dependency com.google.cloud:google-cloud-conformance-tests to v0.0.10 (#197) (69372af)
- update dependency com.google.guava:guava-bom to v29 (#180) (3c204b4)
- update dependency io.grpc:grpc-bom to v1.29.0 (#206) (5d8c50f)
- update dependency org.threeten:threetenbp to v1.4.4 (#194) (c867bd5)
- update jackson dependencies to v2.11.0 (#195) (5066812)
- update protobuf.version to v3.12.0 (#220) (2c0b35d)
- update protobuf.version to v3.12.2 (#226) (2eeea19)
Documentation
1.33.0 (2020-04-08)
Features
- add new Firestore.runAsyncTransaction (#103) (b28b660)
- NOTICE This change will require any users of the library that implement
com.google.cloud.firestore.Firestoreto have to implement the new runAsyncTransaction methods, and is a binary incompatible change in Java 7. Those users who only usecom.google.cloud.firestore.Firestorethrough the instance returned fromFirestoreOptions.getDefaultInstance().getService()will not have to recompile their code.
- NOTICE This change will require any users of the library that implement
- add Query.limitToLast() (#151) (c104615)
- base transaction retries on error codes (#129) (00b6eb3), closes googleapis/nodejs-firestore#953
- use SecureRandom instead of Random to reduce the chance of auto-id collisions (#156) (0088ee7)
Bug Fixes
- add missing @InternalExtensionOnly annotation to com.google.cloud.firestore.Firestore (#141) (d3458cb)
- add support for updating an individual field with pojo in all update method (#136) (7d6c2c1)
- mark v1beta1 as deprecated (#154) (495f7f9)
Dependencies
- update core dependencies (#127) (7995db0)
- update core dependencies (#167) (11f16fd)
- update core dependencies to v1.55.0 (#158) (f3a20d3)
- update core dependencies to v1.93.3 (#132) (50394e1)
- update core dependencies to v1.93.4 (#168) (2118232)
- update dependency com.google.api:api-common to v1.9.0 (#153) (8ca0ea8)
- update dependency com.google.cloud:google-cloud-conformance-tests to v0.0.8 (#123) (0bbf4b0)
- update dependency com.google.cloud:google-cloud-conformance-tests to v0.0.9 (#152) (d41c41f)
- update dependency com.google.cloud.samples:shared-configuration to v1.0.13 (#148) (6bd8e7f)
- update dependency org.threeten:threetenbp to v1.4.2 (#142) (41b2a9a)
- update dependency org.threeten:threetenbp to v1.4.3 (#165) (d8bfa80)
1.32.5 (2020-03-05)
Bug Fixes
Dependencies
- update core dependencies (#120) (293ba55)
- update core dependencies to v1.93.1 (#124) (6ce14ce)
- update dependency com.google.cloud:google-cloud-conformance-tests to v0.0.6 (#118) (7dad920)
- update dependency io.grpc:grpc-bom to v1.27.2 (#116) (83ef310)
- update jackson dependencies to v2.10.3 (#122) (85a3ced)
1.32.4 (2020-02-18)
Bug Fixes
- add cause to transaction errors on transaction commit (#108) (00b3c6f)
- remove error_prone_annotations exclusion rules from poms (#97) (0f9b474)
Dependencies
- update core dependencies to v1.92.5 (#101) (e767078)
- update dependency io.grpc:grpc-bom to v1.27.1 (#106) (46a7c48)
- update opencensus.version to v0.25.0 (#105) (fcdbab3)
- update protobuf.version to v3.11.4 (#109) (4f498b4)
Documentation
1.32.3 (2020-02-03)
Dependencies
- update core dependencies (#89) (7593432)
- update dependency com.google.auth:google-auth-library-credentials to v0.20.0 (#86) (f32bd9b)
- update dependency com.google.cloud:google-cloud-conformance-tests to v0.0.5 (#90) (f701446)
- update protobuf.version to v3.11.3 (#94) (6155816)
1.32.2 (2020-01-14)
Dependencies
- update core dependencies (#63) (4c1fb09)
- update dependency com.fasterxml.jackson.core:jackson-core to v2.10.2 (#69) (5e296b8)
- update dependency com.fasterxml.jackson.core:jackson-databind to v2.10.2 (#70) (2f3a14b)
- update dependency com.google.cloud:google-cloud-conformance-tests to v0.0.4 (#82) (6050055)
- update dependency com.google.guava:guava-bom to v28.2-android (#76) (c1dcb9f), closes #33
- update dependency com.google.truth:truth to v1.0.1 (#81) (5d16063)
- update dependency org.threeten:threetenbp to v1.4.1 (#78) (0db7256)
1.32.1 (2020-01-02)
Bug Fixes
- add google-cloud-firestore to bom (#65) (b273a58)
- set google-cloud-conformance-tests to test scope (#44) (03983c3)
Dependencies
- update dependencies (#51) (ce4c37b), closes #49 #50
- update dependency com.google.auth:google-auth-library-credentials to v0.19.0 (#48) (d68b457)
- update dependency com.google.cloud:google-cloud-conformance-tests to v0.0.3 (#55) (6e6644f)
- update dependency junit:junit to v4.13 (#62) (7f80e44)