ORMLite文档 - 开始

下面的信息能够帮助你开始使用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);

当我们配置好我们的数据库对象，我们可以使用它们来持久化Account对象到数据库中并且可以从数据库中根据对象的ID来查询它。

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

到这里，你应该可以开始使用ORMLite了。要理解更多ORMLite提供的功能，继续下面的章节吧。参看 如何使用小节。

更多代码和安卓项目的例子可以看代码样例小节。