下面的信息能够帮助你开始使用ORMLite。安卓用户在读过这篇文章后需要看看安卓相关的页面。参看和安卓一起使用小节。

1.1下载 ORMLite Jar

下载 ORMLite Jar。

1.2配置一个类

配置一个类来持久化。

1.3配置一个数据访问对象（DAO）

配置一个数据访问对象（DAO）。

1.4代码样例

一些如何工作的例子。

1.1下载 ORMLite Jar

开始使用ORMLite，你需要下载这些jar文件。 ORMLite发布页面 是默认的仓库但是这些jar文件也能从 central maven repository 和 Sourceforge获得。

使用JDBC连接访问SQL数据库的用户需要下载 ormlite-jdbc-4.48.jar 和ormlite-core-4.48.jar 文件。如果要在安卓软件中使用，你则需要下载 ormlite-android-4.48.jar 和 ormlite-core-4.48.jar 文件。不管是JDBC还是安卓环境它们都需要ormlite-core，因为它使ORMLite的后端实现。尽管有一些 可选的 包你可能想使用，ORMLite不需要任何外部依赖。参看外部依赖小节。这些代码需要在Java 5或之后的版本下工作。

1.2配置一个类

以下是一个样例类，它被配置能够使用ORMLite标注持久化到数据库中。 @DatabaseTable 标注设置Account类能够持久化到数据库的accounts表中。@DatabaseField标注将Account的属性映射到数据库的同名列上。

name属性使用id = true标注参数被设置成数据库表的主键。另外，注意需要一个无参数构造器这样对象才能被查询返回。更多相关信息（如JPA标注和其他配置类的方法）参看教程后面的类设置信息。参看设置你的类小节。

@DatabaseTable(tableName = "accounts")
public class Account {

    @DatabaseField(id = true)
    private String name;
    @DatabaseField
    private String password;

    public Account() {
        // ORMLite需要一个无参数构造器 
    }
    public Account(String name, String password) {
        this.name = name;
        this.password = password;
    }
    public String getName() {
        return name;
    }
    public void setName(String name) {
        this.name = name;
    }
    public String getPassword() {
        return password;
    }
    public void setPassword(String password) {
        this.password = password;
    }
}

1.3配置一个数据访问对象（DAO）

在典型的Java模式里数据库操被封装到数据访问对象（DAO）。中每一个DAO提供create, delete, update等功能和持久化一个类的操作。一个简单地方法建立一个DAO是使用DaoManager 类中的createDao静态方法。例如，对上面定义的Account类创建一个DAO你需要这么做：

Dao<Account, String> accountDao =
  DaoManager.createDao(connectionSource, Account.class);
Dao<Order, Integer> orderDao =
  DaoManager.createDao(connectionSource, Order.class);

更多关于设置DAO的信息在后面的手册中可以找到。参看设置DAO小节。

1.4代码样例

这个样例使用Java原生H2数据库来创造一个内存中存储的test数据库。你需要下载和添加H2 jar文件到你的classpath中如何你想运行这个例子。参看H2主页。注意： 安卓用户应该看手册后面的安卓相关文档。参看和安卓一起使用小节。这里也有一些完整的例子以供参考。参看Example Code小节。

代码按照下面的步骤执行。

• 首先它创造一个连接源来建立和数据库的连接。

• 然后实例化一个Account对象的DAO。

• accounts 数据库表接着被生成。如果数据库表已经存在那么这个步骤就不需要了。

  public class AccountApp {

  public static void main(String[] args) throws Exception {
  // this uses h2 by default but change to match your database
  String databaseUrl = "jdbc:h2:mem:account";
  // create a connection source to our database
  ConnectionSource connectionSource =
      new JdbcConnectionSource(databaseUrl);
  
  // instantiate the dao
  Dao<Account, String> accountDao =
      DaoManager.createDao(connectionSource, Account.class);
  
  // if you need to create the 'accounts' table make this call
  TableUtils.createTable(connectionSource, Account.class);</code></pre></li>

        // create an instance of Account
        Account account = new Account();
        account.setName("Jim Coakley");

        // persist the account object to the database
        accountDao.create(account);

        // retrieve the account from the database by its id field (name)
        Account account2 = accountDao.queryForId("Jim Coakley");
        System.out.println("Account: " + account2.getName());

        // close the connection source
        connectionSource.close();
    }
}