Android数据库ORMlite框架翻译系列（第一章）

女爷i 2022-08-01 06:11 249阅读 0赞

##     ##

前言

个人感觉android上sqlite已经比较好用，但是如果需要在android上像J2EE那样开发的话那么sqlite还是显得比较复杂，这个时候你当然可以选择一些android平台上的ORM框架。ORM框架是做什么的，android平台上有哪些好用的ORM框架，这些问题你通通可以google得到你满意的结果，在此不做解释。本系列主要是翻译ORMlite文档。

为什么翻译ORMlite？简单点说就是因为个人觉得ORMlite是android平台上不错的ORM框架，官方也提供了很多相关介绍。但是几乎没有看到有中文文档。为了更多人可以学习到这个框架所以决定把官方的文档翻译成中文。个人英语水平非常有限，但是本人会尽力，如果文中有不妥的翻译之处敬请告之。文档中的比较杂的内容就不在文档中进行翻译，比如参见xxx连接，这些没有意义。主要翻译的技术文档而非专业英语，但基本会保持原文档的内容。

\-------------------------------------------------------------------------------------

1 获得开始

1.1 下载ORMlite jar

为了使用ORMLite，你需要下载相关的jar文件。ORMLite发布包是一个默认库，不过相关jar文件也可以通过网络从内部资源库里面获得。

通过JDBC连接SQL 数据库的用户需要下载ormlite-jdbc-4.41.jar和ormlite-core-4.41.jar两个文件。在android应用中使用，你需要下载ormlite-android-4.41.jar和ormlite-core-4.41.jar两个文件。在有ORMlite后台实现的JDBC中或者是Android中你都需要ormlite-core发布包。ORMLite没有任何外部依赖，即使可能有你想用的其他选用包。

1.2 配置class

下面是个class通过使用ORMlite 注解配置持久化到数据的例子。@DatabaseTable 注解配置Access类到数据库名为accounts的表。@DatabaseField注解映射Account中的每个字段到数据库中相同名字的字段。

一个字段需要配置成数据库中表的主键那么可以通过使用id=true 注解字段。并且，值得一提的是一个无参的构造器是必须的，这样的话通过查询可以返回一个对象。

![复制代码][copycode.gif]

@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;
    
    }
    
    }

![复制代码][copycode.gif]

1.3  配置  DAO

一个典型的java隔离数据库操作的模式是用数据访问对象类（Data Access Objects，即DAO）。每个DAO提供增、删、改等操作。这中功能专注于处理一个单一持久化的类。一种简单的创建DAO的方式是使用DaoManager类的静态方法createDao。例如，为上面定义的Account类创建一个DAO你可以这样做：

![复制代码][copycode.gif]

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

![复制代码][copycode.gif]

1.4  代码示例

这个示例使用本地Java H2数据库，创建一个在内存中运行的测试数据库。如果你想把示例代码跑起来那么你需要下载并且添加H2 jar文件到你的classpath中。注意：android用户需要看本手册android部分具体的文档。

代码执行下面几步：

①创建connection，这个connection可以操作数据库。

②为Account对象实例化一个DAO。

③accounts数据库表已经创建过。如果这个表已经创建好的话那么这几步就不必要了。

![复制代码][copycode.gif]

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

![复制代码][copycode.gif]

通过这些要点你应该能够开始使用ORMLite了。为了理解ORMlite更多有效的功能，继续学习下一章。

PS：翻译持续更新中。如果转载请说明出处。

[copycode.gif]: /images/20220731/5ea4e13092b74d53941b1065a33dadf8.png