Provides the main API for fetching and persisting beans with eBean.
-
- // EXAMPLE 1: Simple fetch
- //========================
+{@code
+// EXAMPLE 1: Simple fetch
+//========================
- // fetch order 10
- Order order = Ebean.find(Order.class, 10);
+// fetch order 10
+Order order = Ebean.find(Order.class, 10);
- // EXAMPLE 2: Fetch an Object with associations
- //=============================================
-
- // fetch Customer 7 including their billing and shipping addresses
- Customer customer =
- Ebean.find(Customer.class)
- .setId(7)
- .fetch("billingAddress")
- .fetch("shippingAddress")
- .findUnique();
-
- Address billAddr = customer.getBillingAddress();
- Address shipAddr = customer.getShippingAddress();
+// EXAMPLE 2: Fetch an Object with associations
+//=============================================
+
+// fetch Customer 7 including their billing and shipping addresses
+Customer customer =
+ Ebean.find(Customer.class)
+ .setId(7)
+ .fetch("billingAddress")
+ .fetch("shippingAddress")
+ .findUnique();
+
+Address billAddr = customer.getBillingAddress();
+Address shipAddr = customer.getShippingAddress();
- // EXAMPLE 3: Create and save an Order
- //=====================================
-
- // get a Customer reference so we don't hit the database
- Customer custRef = Ebean.getReference(Customer.class, 7);
+// EXAMPLE 3: Create and save an Order
+//=====================================
- // create a new Order object
- Order newOrder = new Order();
- newOrder.setStatus(Order.Status.NEW);
- newOrder.setCustomer(custRef);
-
- ArrayList orderLines = new ArrayList();
- newOrder.setLines(orderLines);
- ...
+// get a Customer reference so we don't hit the database
+Customer custRef = Ebean.getReference(Customer.class, 7);
- // add a line to the order
- Product prodRef = Ebean.getReference(Product.class, 41);
- OrderLine line = new OrderLine();
- line.setProduct(prodRef);
- line.setQuantity(10);
- orderLines.add(line);
- ...
+// create a new Order object
+Order newOrder = new Order();
+newOrder.setStatus(Order.Status.NEW);
+newOrder.setCustomer(custRef);
- // save the order and its lines in a single transaction
- // NB: assumes CascadeType.PERSIST is set on the order lines association
- Ebean.save(newOrder);
+ArrayList orderLines = new ArrayList();
+newOrder.setLines(orderLines);
+...
+
+// add a line to the order
+Product prodRef = Ebean.getReference(Product.class, 41);
+OrderLine line = new OrderLine();
+line.setProduct(prodRef);
+line.setQuantity(10);
+orderLines.add(line);
+...
+
+// save the order and its lines in a single transaction
+// NB: assumes CascadeType.PERSIST is set on the order lines association
+Ebean.save(newOrder);
- // EXAMPLE 4: Use another database
- //=================================
+// EXAMPLE 4: Use another database
+//=================================
- // Get access to the Human Resources EbeanServer/Database
- EbeanServer hrServer = Ebean.getServer("HR");
-
-
- // fetch contact 3 from the HR database
- Contact contact = hrServer.find(Contact.class, 3);
-
- contact.setStatus(Contact.Status.INACTIVE);
- ...
-
- // save the contact back to the HR database
- hrServer.save(contact);
-
-
+// Get access to the Human Resources EbeanServer/Database
+EbeanServer hrServer = Ebean.getServer("HR");
+
+
+// fetch contact 3 from the HR database
+Contact contact = hrServer.find(Contact.class, 3);
+
+contact.setStatus(Contact.Status.INACTIVE);
+...
+
+// save the contact back to the HR database
+hrServer.save(contact);
+}