ActiveAndroid是采用活动记录(Active Record)架构模式设计的适用于Android平台的轻量级ORM架构。
项目主页:https://github.com/pardom/ActiveAndroid
1.配置与初始化
首先在AndroidManifest.xml
文件中配置数据库名称和数据库版本号。
<manifest ...>
<application android:name="com.activeandroid.app.Application" ...>
...
<meta-data android:name="AA_DB_NAME" android:value="数据库名字.db" />
<meta-data android:name="AA_DB_VERSION" android:value="数据库版本号" />
</application>
</manifest>
-
AA_DB_NAME:数据库名
-
AA_DB_VERSION:数据库版本号,默认是1。
接着,在AndroidManifest.xml
文件中指定application元素的name为 com.activeandroid.app.Application,如果需要自定义Application,需要让你的Application对象继 承自com.activeandroid.app.Application而不是android.app.Application。如果你需要继承其他库 的Application,则需要在Application中初始化和处理ActiveAndroid。
public class MyApplication extends SomeLibraryApplication {
@Override
public void onCreate() {
super.onCreate();
ActiveAndroid.initialize(this);
}
@Override
public void onTerminate() {
super.onTerminate();
ActiveAndroid.dispose();
}
}
2.创建Model
创建数据库模型非常简单,创建的模型必须继承Model类,这样你的类名就是你的表名。如果不想使用类名做表名,则可以使用@Table定义表名。@Column用于定义列名。Model类使用无参的构造函数,如果定义自己的构造函数必须定义一个无参的构造函数。
@Table(name = "Categories")
public class Category extends Model {
@Column(name = "Name")
public String name;
}
@Table(name = "Items")
public class Item extends Model {
@Column(name = "remote_id", unique = true, onUniqueConflict = Column.ConflictAction.REPLACE)
public int remoteId;
@Column(name = "Name")
public String name;
@Column(name = "Category")
public Category category;
public Item(){
super();
}
public Item(String name, Category category){
super();
this.name = name;
this.category = category;
}
}
3.增删改查
3.1 插入
3.1.1 单条插入
保存一条记录,只需要创建一个模型的实例,并为每个字段指定值,然后调用save()方法。
Category restaurants = new Category();
restaurants.name = "Restaurants";
restaurants.save();
3.1.2批量插入
ActiveAndroid.beginTransaction();
try {
for (int i = 0; i < 100; i++) {
Item item = new Item();
item.name = "Example " + i;
item.save();
}
ActiveAndroid.setTransactionSuccessful();
}
finally {
ActiveAndroid.endTransaction();
}
3.2 更新
new Update(Person.class).set("age=?," + "name=?", age, name).execute();
3.3 删除
调用delete()方法就可以删除一条记录,下面的例子中,通过id加载一个Item对象,并且删除他。
Item item = Item.load(Item.class, 1);
item.delete();
也可以通过静态方法删除
Item.delete(Item.class, 1);
也可以创建调用Delete对象删除
new Delete().from(Item.class).where("Id = ?", 1).execute();
3.4 查询
查询一条
public static Item getRandom(Category category) {
return new Select()
.from(Item.class)
.where("Category = ?", category.getId())
.orderBy("RANDOM()")
.executeSingle();
}
查询所有
public static List<Item> getAll(Category category) {
return new Select()
.from(Item.class)
.where("Category = ?", category.getId())
.orderBy("Name ASC")
.execute();
}
4. 使用内容提供者
使用ActiveAndroid的ContentProvider,必须复写默认的标识列如下所示(默认标识列是ID)。
@Table(name = "Items", id = BaseColumns._ID)
public class Item extends Model {...}
接着就可以使用
ContentProvider
mySpinner.setAdapter(new SimpleCursorAdapter(getActivity(),
android.R.layout.simple_expandable_list_item_1,
null,
new String[] { "MyProperty" },
new int[] { android.R.id.text1 },
0));
getActivity().getSupportLoaderManager().initLoader(0, null, new LoaderCallbacks<Cursor>() {
@Override
public Loader<Cursor> onCreateLoader(int arg0, Bundle cursor) {
return new CursorLoader(getActivity(),
ContentProvider.createUri(MyEntityClass.class, null),
null, null, null, null
);
}
@Override
public void onLoadFinished(Loader<Cursor> arg0, Cursor cursor) {
((SimpleCursorAdapter)mySpinner.getAdapter()).swapCursor(cursor);
}
@Override
public void onLoaderReset(Loader<Cursor> arg0) {
((SimpleCursorAdapter)mySpinner.getAdapter()).swapCursor(null);
}
});
最后别忘了在
AndroidManifest.xml
中注册
provider
<application ...>
<provider android:authorities="com.example" android:exported="false" android:name="com.activeandroid.content.ContentProvider" />
...
</application>