---

schmidt-sebastian · pongad · commit 7d3849bf8f7e · 2018-04-26T11:32:37.000-07:00
yaml --- r: 9333 b: refs/heads/master c: 412cf0d h: refs/heads/master i: 9331: f4c8d77
diff --git a/[refs] b/[refs]
@@ -1,5 +1,5 @@
 ---
-refs/heads/master: c001e14a6119affebd94dcbcc715509392d2c527
+refs/heads/master: 412cf0df77c4ea55e4e85a545f622ff4f14db0b4
 refs/heads/travis: 47e4fee4fd5af9b2a8ce46f23c72ec95f9b195b2
 refs/heads/gh-pages: 1e525ea89a8c2133b947a8f1e3306079d006152d
 refs/tags/0.0.9: 22f1839238f66c39e67ed4dfdcd273b1ae2e8444
diff --git a/trunk/google-cloud-firestore/src/main/java/com/google/cloud/firestore/CollectionReference.java b/trunk/google-cloud-firestore/src/main/java/com/google/cloud/firestore/CollectionReference.java
@@ -26,9 +26,13 @@
 
 /**
  * A CollectionReference can be used for adding documents, getting document references, and querying
- * for documents (using the methods inherited from Query)
+ * for documents (using the methods inherited from Query).
+ *
+ * <p><b>Subclassing Note</b>: Firestore classes are not meant to be subclassed except for use in
+ * test mocks. Subclassing is not supported in production code and new SDK releases may break code
+ * that does so.
  */
-public final class CollectionReference extends Query {
+public class CollectionReference extends Query {
 
   /**
    * Creates a CollectionReference from a complete collection path.
diff --git a/trunk/google-cloud-firestore/src/main/java/com/google/cloud/firestore/DocumentReference.java b/trunk/google-cloud-firestore/src/main/java/com/google/cloud/firestore/DocumentReference.java
@@ -36,8 +36,12 @@
  * write, read, or listen to the location. There may or may not exist a document at the referenced
  * location. A DocumentReference can also be used to create a CollectionReference to a
  * subcollection.
+ *
+ * <p><b>Subclassing Note</b>: Firestore classes are not meant to be subclassed except for use in
+ * test mocks. Subclassing is not supported in production code and new SDK releases may break code
+ * that does so.
  */
-public final class DocumentReference {
+public class DocumentReference {
 
   private final ResourcePath path;
   private final FirestoreImpl firestore;
diff --git a/trunk/google-cloud-firestore/src/main/java/com/google/cloud/firestore/DocumentSnapshot.java b/trunk/google-cloud-firestore/src/main/java/com/google/cloud/firestore/DocumentSnapshot.java
@@ -41,6 +41,10 @@
  * <p>If the DocumentSnapshot points to a non-existing document, getData() and its corresponding
  * methods will return null. You can always explicitly check for a document's existence by calling
  * {@link #exists()}.
+ *
+ * <p><b>Subclassing Note</b>: Firestore classes are not meant to be subclassed except for use in
+ * test mocks. Subclassing is not supported in production code and new SDK releases may break code
+ * that does so.
  */
 public class DocumentSnapshot {
 
diff --git a/trunk/google-cloud-firestore/src/main/java/com/google/cloud/firestore/QueryDocumentSnapshot.java b/trunk/google-cloud-firestore/src/main/java/com/google/cloud/firestore/QueryDocumentSnapshot.java
@@ -32,8 +32,12 @@
  * <p>QueryDocumentSnapshot offers the same API surface as {@link DocumentSnapshot}. Since query
  * results contain only existing documents, the {@link #exists()} method will always return true and
  * {@code getData()} will never be null.
+ *
+ * <p><b>Subclassing Note</b>: Firestore classes are not meant to be subclassed except for use in
+ * test mocks. Subclassing is not supported in production code and new SDK releases may break code
+ * that does so.
  */
-public final class QueryDocumentSnapshot extends DocumentSnapshot {
+public class QueryDocumentSnapshot extends DocumentSnapshot {
   private QueryDocumentSnapshot(
       FirestoreImpl firestore,
       DocumentReference docRef,
