* Ebean has built in support for "AutoTune". This is a mechanism where a query
@@ -82,7 +77,6 @@ import java.util.Set;
* to a remote client or where there is some requirement for "Read Consistency"
* guarantees.
*
- *
*
Query Language
*
* Partial Objects
@@ -101,7 +95,6 @@ import java.util.Set;
* concurrency checking will occur but only include the fetched properties.
* Refer to "ALL Properties/Columns" mode of Optimistic Concurrency checking.
*
* Find orders fetching its id, shipDate and status properties. Note that the id
* property is always fetched even if it is not included in the list of fetch
* properties.
*
- *
*
{@code
* find order (shipDate, status)
* }
- *
*
* Find orders with a named bind variable (that will need to be bound via
* {@link Query#setParameter(String, Object)}).
*
- *
*
{@code
* find order
* where customer.name like :custLike
* }
- *
*
* Find orders and also fetch the customer with a named bind parameter. This
* will fetch and populate both the order and customer objects.
*
- *
*
{@code
* find order
* fetch customer
* where customer.id = :custId
* }
- *
*
* Find orders and also fetch the customer, customer shippingAddress, order
* details and related product. Note that customer and product objects will be
@@ -215,7 +197,6 @@ import java.util.Set;
* objects (associated with each order detail) will have their id, sku and name
* populated.
*
* When you get a Query object from a named query, the query statement has
@@ -269,9 +249,8 @@ import java.util.Set;
* to make it as easy as possible to use your own SQL to populate entity beans.
* Refer to {@link RawSql} .
*
- *
- * @param
- * the type of Entity bean this query will fetch.
+ *
+ * @param the type of Entity bean this query will fetch.
*/
public interface Query {
@@ -289,7 +268,7 @@ public interface Query {
* Perform an 'As of' query using history tables to return the object graph
* as of a time in the past.
*
- * To perform this query the DB must have underlying history tables.
+ * To perform this query the DB must have underlying history tables.
*
*
* @param asOf the date time in the past at which you want to view the data
@@ -399,7 +378,6 @@ public interface Query {
* You use {@link #fetch(String, String)} to specify specific properties to fetch
* on other non-root level paths of the object graph.
*
- *
*
{@code
*
* List customers =
@@ -412,8 +390,7 @@ public interface Query {
*
* }
*
- * @param fetchProperties
- * the properties to fetch for this bean (* = all properties).
+ * @param fetchProperties the properties to fetch for this bean (* = all properties).
*/
Query select(String fetchProperties);
@@ -428,7 +405,6 @@ public interface Query {
* only those properties are fetched and populated resulting in a
* "Partial Object" - a bean that only has some of its properties populated.
*
- *
*
{@code
*
* // query orders...
@@ -437,17 +413,15 @@ public interface Query {
* // fetch the customer...
* // ... getting the customers name and phone number
* .fetch("customer", "name, phoneNumber")
- *
+ *
* // ... also fetch the customers billing address (* = all properties)
* .fetch("customer.billingAddress", "*")
* .findList();
* }
- *
*
* If columns is null or "*" then all columns/properties for that path are
* fetched.
*
- *
*
{@code
*
* // fetch customers (their id, name and status)
@@ -458,19 +432,16 @@ public interface Query {
* .findList();
*
* }
- *
- * @param path
- * the path of an associated (1-1,1-M,M-1,M-M) bean.
- * @param fetchProperties
- * properties of the associated bean that you want to include in the
- * fetch (* means all properties, null also means all properties).
+ *
+ * @param path the path of an associated (1-1,1-M,M-1,M-M) bean.
+ * @param fetchProperties properties of the associated bean that you want to include in the
+ * fetch (* means all properties, null also means all properties).
*/
Query fetch(String path, String fetchProperties);
/**
* Additionally specify a FetchConfig to use a separate query or lazy loading
* to load this path.
- *
*
{@code
*
* // fetch customers (their id, name and status)
@@ -500,16 +471,13 @@ public interface Query {
*
* }
*
- * @param path
- * the property of an associated (1-1,1-M,M-1,M-M) bean.
+ * @param path the property of an associated (1-1,1-M,M-1,M-M) bean.
*/
Query fetch(String path);
/**
* Additionally specify a JoinConfig to specify a "query join" and or define
* the lazy loading query.
- *
- *
*
{@code
*
* // fetch customers (their id, name and status)
@@ -536,7 +504,7 @@ public interface Query {
*
* This query will execute against the EbeanServer that was used to create it.
*
- *
+ *
* @see EbeanServer#findIds(Query, Transaction)
*/
List