在OSChina上看到这款开源轻量级的ORM框架,看了下例子,感觉非常小巧轻量简单。
public class Main { public static void main(String[] args) { new DB("corporation").open("com.mysql.jdbc.Driver", "jdbc:mysql://localhost/test", "root", "p@ssw0rd"); new DB("university").open("oracle.jdbc.driver.OracleDriver", "jdbc:oracle:thin:@localhost:1521:xe", "activejdbc", "activejdbc"); Employee.deleteAll(); Student.deleteAll(); Employee.createIt("first_name", "John", "last_name", "Doe"); Employee.createIt("first_name", "Jane", "last_name", "Smith"); Student.createIt("first_name", "Mike", "last_name", "Myers"); Student.createIt("first_name", "Steven", "last_name", "Spielberg"); System.out.println("*** Employees ***"); Employee.findAll().dump(); System.out.println("*** Students ***"); Student.findAll().dump(); new DB("corporation").close(); new DB("university").close(); } }
ActiveJDBC 是一个快速和轻量级的 Java 的 ORM 小型框架,语法简单易于理解,同时支持多数据库链接。ActiveJDBC 的文档(javadoc)非常完善。基于以下原则设计:
有关ActiveJDBC的特性的官方说明在这里:http://code.google.com/p/activejdbc/wiki/Features
项目发布在Google Code网站上,地址是:http://activejdbc.googlecode.com 可以使用SVN 将项目Check out下来。
ActiveJDBC 项目是使用Maven进行构建和管理JAR包的,具体怎样使用Maven来进行构建,它的网站上写得很详细,Maven本身也很简单。这里我只是记录下我的操作步骤,使用手动构建的。
在MyEclipse里新建一个WEB工程(JAVA工程也可以), 然后,引入所需要的JAR包
这些JAR包可以到http://ipsolutionsdev.com/snapshots/ 这里下载,最新的JAR包在页面最下面。上面这些JAR包缺一不可,我首先引入的是activejdbc包,然后根据ClassNotFoundException挨个导入的。
接着可以看下ActiveJDBC文档的Getting Started页,写得非常简洁,可以让你很快上手。
建表语句是:
create database test;
use test;
create table (
id int(32) default not null auto_increment primary key,
first_name varchar(65),
last_name varchar(65)
);
AJ的表名与Model名是有命名约定的,比如Model名为Employee,对应表名为employees。
内容如下:
package cn.ijser.pojo;
import activejdbc.Model;
public class Employee extends Model {
}
没有Getters和Setters? 没错,不需要,而且ActiveJDBC也不推荐。它是利用了JAVA的反射机制来进行识别的,不仅不必写Getters和Setters,连同fields也不必写,只要你事先建立好表,AJ会自动为你建立映射。而且也不必配置表名与POJO间的对应关系,因为AJ遵循“约定>配置”的原则,可以省掉配置文件,非常方便简单。
Instrumentation是对已经编译好的POJO们进行一下处理,添加了父类的静态方法,这样才可以像下面这样使用:
List<Person> retirees = Person.where("age >= ?", 65);
否则,AJ不会知道将要操作的表或数据库,因为静态方法是属于类而不是对象的。这样虽然稍微麻烦点,但是好处也是挺不错的,它不必像其它ORM框架一样,需要使用第三个类来进行管理,比如JPA使用的PersistentManager和Hibernate 使用的Session。
尽管AJ需要增加一步额外的构建过程,但它使API的设计更加直观和简洁。
还有一点要说明的是,Instrumentation的创建也是很快的,而且只需要在程序编译的时候进行创建即可。官方文档中说50-60个models只需要5-7s,一般的小型程序(10个以内models的程序)只需要1-2秒即可完成。
官方文档只主要介绍了使用Maven,Ant,和StandAlone三种方式,我使用的是另外一种,JAVA程序实现的。只需要创建一个工具类,然后在编译之后,运行之前调用一下这个类的make方法即可。
package cn.ijser.utils;
import activejdbc.instrumentation.Instrumentation;
public class MakeInstrumentationUtil {
public static void make() {
try {
Instrumentation instrumentation = new Instrumentation();
instrumentation.setOutputDirectory(ClassLoader
.getSystemResource(“”).getPath());
instrumentation.instrument();
} catch (Exception e) {
e.printStackTrace();
}
}
}
package cn.ijser.test;
import activejdbc.Base;
import cn.ijser.pojo.Employee;
import cn.ijser.utils.MakeInstrumentationUtil;
public class Test {
public static void main(String[] args) {
MakeInstrumentationUtil.make(); # 这里创建Instrumentation
Base.open(“com.mysql.jdbc.Driver”, “jdbc:mysql://localhost/activejdbc”,
“root”, “sa”);
Employee e = new Employee();
e.set(“first_name”, “John”);
e.set(“last_name”, “ijse”);
e.save();
}
}
AJ的具体使用方法,可以查看AJ的文档,上面这个测试代码只是向数据库的employees表中写入了一条记录。
=========
PS:
比较惭愧的是,自己没有学会使用Maven来进行构建和学习ActiveJDBC,继续学习Maven…
感谢曹江华Arden的热心解答。