Merge "Document ChangeJson#lazyLoad and ChangeData#lazyLoad"
diff --git a/java/com/google/gerrit/server/change/ChangeJson.java b/java/com/google/gerrit/server/change/ChangeJson.java
index 3d350b0..406033d 100644
--- a/java/com/google/gerrit/server/change/ChangeJson.java
+++ b/java/com/google/gerrit/server/change/ChangeJson.java
@@ -331,6 +331,10 @@
this.options = Sets.immutableEnumSet(options);
}
+ /**
+ * See {@link ChangeData#lazyLoad}. If lazyLoad is set, converting data from index-backed {@link
+ * ChangeData} will fail with an exception.
+ */
public ChangeJson lazyLoad(boolean load) {
lazyLoad = load;
return this;
diff --git a/java/com/google/gerrit/server/query/change/ChangeData.java b/java/com/google/gerrit/server/query/change/ChangeData.java
index fccb14a..c877544 100644
--- a/java/com/google/gerrit/server/query/change/ChangeData.java
+++ b/java/com/google/gerrit/server/query/change/ChangeData.java
@@ -451,6 +451,13 @@
this.notes = notes;
}
+ /**
+ * If false, omit fields that require database/repo IO.
+ *
+ * <p>This is used to enforce that the dashboard is rendered from the index only. If {@code
+ * lazyLoad} is on, the {@code ChangeData} object will load from the database ("lazily") when a
+ * field accessor is called.
+ */
public ChangeData setLazyLoad(boolean load) {
lazyLoad = load;
return this;
