Initialisation error

Author: rbygrave

docs/trouble-shooting.html

@@ -201,6 +201,29 @@ <h5>Typically stacktrace</h5>
 
 <p>&nbsp;</p>
 
+<h2 id="initialisation-error">Initialisation Error</h2>
+<p>
+  ERROR: Unsupported initialisation of @OneToMany or @ManyToMany on: <em>&lt;className&gt;</em>
+  fields: <em>&lt;field names&gt;</em>
+  Refer: https://ebean.io/docs/trouble-shooting#initialisation-error
+</p>
+<p>
+  This error is telling us that the ebean-agent is looking at some initialisation code for
+  one of the OneToMany, ManyToMany or DbArray collections and that it is initialising an
+  unsupported collection or in some way isn't supported.
+</p>
+<p>
+  The supported initialisation for OneToMany, ManyToMany, DbArray collections are:
+</p>
+<ul>
+  <li><b>List</b> - new ArrayList<>(), List.of(), Collections.emptyList()</li>
+  <li><b>Set</b> - new LinkedHashSet<>(), Set.of(), Collections.emptySet()</li>
+  <li><b>Map</b> - new LinkedHashMap<>(), Map.of(), Collections.emptyMap()</li>
+</ul>
+<h4>Actions</h4>
+<h5>1. Change the OneToMany, ManyToMany, DbArray fields to initialise to a supported collection type.</h5>
+
+
 <h2 id="datasource">DataSource user is null?</h2>
 
 <h4>Actions</h4>

search.json

@@ -143,6 +143,14 @@
   "keywords":"",
   "url":"/docs/query"
 }
+,{
+  "title":"",
+  "caption":"",
+  "category":"Read Replicas",
+  "priority":"0",
+  "keywords":"",
+  "url":"/docs/read-replicas"
+}
 ,{
   "title":"",
   "caption":"",
@@ -1175,6 +1183,22 @@
   "keywords":"",
   "url":"/docs/database/postgres#ebean-postgres"
 }
+,{
+  "title":"Postgres / Array type",
+  "caption":"",
+  "category":"Database platforms",
+  "priority":"3",
+  "keywords":"",
+  "url":"/docs/database/postgres/arraytype"
+}
+,{
+  "title":"Postgres / PostGIS",
+  "caption":"",
+  "category":"Database platforms",
+  "priority":"3",
+  "keywords":"",
+  "url":"/docs/database/postgres/postgis"
+}
 ,{
   "title":"Redis - L2 cache",
   "caption":"",
@@ -4095,6 +4119,78 @@
   "keywords":"",
   "url":"/docs/query/streaming#findStream"
 }
+,{
+  "title":"@Transaction(readOnly=true)",
+  "caption":"",
+  "category":"Read Replicas",
+  "priority":"3",
+  "keywords":"",
+  "url":"/docs/read-replicas#transactionReadOnly"
+}
+,{
+  "title":"Amazon AWS Aurora",
+  "caption":"",
+  "category":"Read Replicas",
+  "priority":"3",
+  "keywords":"",
+  "url":"/docs/read-replicas#aurora"
+}
+,{
+  "title":"DataSourceBuilder readOnlyUrl",
+  "caption":"",
+  "category":"Read Replicas",
+  "priority":"3",
+  "keywords":"",
+  "url":"/docs/read-replicas#readOnlyUrl"
+}
+,{
+  "title":"DatabaseBuilder readOnlyDataSource",
+  "caption":"",
+  "category":"Read Replicas",
+  "priority":"3",
+  "keywords":"",
+  "url":"/docs/read-replicas#readOnlyDataSource"
+}
+,{
+  "title":"Overview",
+  "caption":"",
+  "category":"Read Replicas",
+  "priority":"3",
+  "keywords":"",
+  "url":"/docs/read-replicas#overview"
+}
+,{
+  "title":"Query.usingMaster()",
+  "caption":"",
+  "category":"Read Replicas",
+  "priority":"3",
+  "keywords":"",
+  "url":"/docs/read-replicas#queryUseMaster"
+}
+,{
+  "title":"ReadOnly Database",
+  "caption":"",
+  "category":"Read Replicas",
+  "priority":"3",
+  "keywords":"",
+  "url":"/docs/read-replicas#readOnlyDatabase"
+}
+,{
+  "title":"Using the Master",
+  "caption":"",
+  "category":"Read Replicas",
+  "priority":"3",
+  "keywords":"",
+  "url":"/docs/read-replicas#usingMaster"
+}
+,{
+  "title":"Using the Read Replica",
+  "caption":"",
+  "category":"Read Replicas",
+  "priority":"3",
+  "keywords":"",
+  "url":"/docs/read-replicas#queryUseReadReplica"
+}
 ,{
   "title":"CI Testing",
   "caption":"",