Core API (see EbeanServer and Ebean).

### Ebean

Provides the main API for fetching and persisting beans with eBean.

    {@code
    // EXAMPLE 1: Simple fetch
    //========================

    // 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 3: Create and save an Order
    //=====================================

    // get a Customer reference so we don't hit the database
    Customer custRef = Ebean.getReference(Customer.class, 7);

    // create a new Order object
    Order newOrder = new Order();
    newOrder.setStatus(Order.Status.NEW);
    newOrder.setCustomer(custRef);

    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
    //=================================

    // 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);
    }