前言
此文档翻译于第一次学习 ORMLite 框架，如果发现当中有什么不对的地方，请指正。若翻译与原文档出现任何的不相符，请以原文档为准。原则上建议学习原英文文档。
----------------------------------------------------------------------------------------------
一、入门
1.1 下载 ORMLite Jar
为了开始使用 ORMLite，您需要下载的 jar 文件。ORMLite 发布包是一个默认库，不过相关的 jar文件也可以从 Maven 仓库和 Sourceforge 获取。
通过 JDBC 连接 SQL 数据库的用户需要下载 ormlite-jdbc-4.48.jar 和 ormlite-core-4.48.jar 两个文件。对于在安卓应用中的使用来说，你需要下载 ormlite-android-4.48.jar 和 ormlite-core-4.48.jar 两个文件。在有 ORMlite 后台实现的 JDBC中 或者是 Android 中你都需要 ormlite-core 发布包。ORMLite 没有任何外部依赖，即使可能有你想用的其他选用包。请参阅外部依赖项。代码适用于 Java 5 或更高版本。
1.2 配置一个 POJO
下面是个 POJO 通过使用ORMlite 注解配置持久化到数据的例子。@DatabaseTable 注解配置 Access 类到数据库名为 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 needs a no-arg constructor
}
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 未每一个需要持久化的 POJO 提供了增、删、改等类型的功能。建立一个 DAO 的简单方法是使用 DaoManager 类上的 createDao 静态方法。例如，为上面的 Accout 类创建一个 DAO 你可以这样做:
Dao<Account, String> accountDao =
DaoManager.createDao(connectionSource, Account.class);
Dao<Order, Integer> orderDao =
DaoManager.createDao(connectionSource, Order.class);
更多有关如何设置 DAOs 的信息是可用后来在手册。请参阅一节DAOs 设置了。
1.4 代码示例
此示例使用本机 Java H2 数据库创建内存中测试数据库。如果你需要运行下面的示例代码，你需要下载 H2 的 jar 文件添加到您的 ClassPath。注：Android 用户请参阅 Android的示例代码。
该代码按照下面的步骤执行。
- 创建一个 connection source，用来连接数据库。
- 为 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);
//Once we have configured our database objects, we can use them to persist an Account to the database and query for it from the database by its 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 更多有效的功能，继续学习下一章。