Android ORMLiteフレームの入門用法

7851 ワード

転載は出典を明記してください.http://blog.csdn.net/lmj623565791/article/details/39121377
皆さんはAndroidプロジェクトの中で多かれ少なかれデータベースを使っています.私達の開発効率を高めるためには、もちろんデータベースORMの枠組みが必要です.特にいくつかのデータベース操作が頻繁なapです.このブログではORMLiteの簡単な使い方を詳しく紹介します.
ORMLiteの入門法を紹介します.
1、ORMLite Jarをダウンロードする
まずORMLite公式サイトでjarパッケージをダウンロードします。に行って、Androidに対して:ormlite-android-4.48 jarとormlite-coree-48.48 jarです.
ps:訪問できない友達は、記事の最後にjar、ソースコード、docとこのブログの例を一緒に包装して皆さんにダウンロードします.
2、ビーン類を配置する
jarがあったら、直接新しいプロジェクトを作ります.zhy_ormlite、jarをlibsにコピーします.
そして新しいカバンを作ります.comp.zy.zhy_ormlite.beanは専門的にプロジェクトの中のBeanを保管することに用いて、まず一つのUser.javaを新たに建設します.
package com.zhy.zhy_ormlite.bean;

import com.j256.ormlite.field.DatabaseField;
import com.j256.ormlite.table.DatabaseTable;

@DatabaseTable(tableName = "tb_user")
public class User
{
	@DatabaseField(generatedId = true)
	private int id;
	@DatabaseField(columnName = "name")
	private String name;
	@DatabaseField(columnName = "desc")
	private String desc;

	public User()
	{
	}

	public User(String name, String desc)
	{
		this.name = name;
		this.desc = desc;
	}

	public int getId()
	{
		return id;
	}

	public void setId(int id)
	{
		this.id = id;
	}

	public String getName()
	{
		return name;
	}

	public void setName(String name)
	{
		this.name = name;
	}

	public String getDesc()
	{
		return desc;
	}

	public void setDesc(String desc)
	{
		this.desc = desc;
	}

}
まずUser類に@DatabaseTableを追加し、これはデータベースの一枚の表であり、tb_と表記します.user
そしてそれぞれの属性に@DatabaseFieldを追加します.columnNameの値はこのフィールドのデータ中の列名です.
@DatabaseField(generatodIId=true)は、generatedはidがプライマリキーであり、自動的に生成されることを表しています.
3、DAO類の作成
元のデータベース操作はSQLiteOpenHelperを継承する必要があります.ここではOrmLiteSqlite OpenHelperを継承します.コードを見てください.
package com.zhy.zhy_ormlite.db;

import java.sql.SQLException;

import android.content.Context;
import android.database.sqlite.SQLiteDatabase;

import com.j256.ormlite.android.apptools.OrmLiteSqliteOpenHelper;
import com.j256.ormlite.dao.Dao;
import com.j256.ormlite.support.ConnectionSource;
import com.j256.ormlite.table.TableUtils;
import com.zhy.zhy_ormlite.bean.User;

public class DatabaseHelper extends OrmLiteSqliteOpenHelper
{

	private static final String TABLE_NAME = "sqlite-test.db";
	/**
	 * userDao ,       
	 */
	private Dao<User, Integer> userDao;

	private DatabaseHelper(Context context)
	{
		super(context, TABLE_NAME, null, 2);
	}

	@Override
	public void onCreate(SQLiteDatabase database,
			ConnectionSource connectionSource)
	{
		try
		{
			TableUtils.createTable(connectionSource, User.class);
		} catch (SQLException e)
		{
			e.printStackTrace();
		}
	}

	@Override
	public void onUpgrade(SQLiteDatabase database,
			ConnectionSource connectionSource, int oldVersion, int newVersion)
	{
		try
		{
			TableUtils.dropTable(connectionSource, User.class, true);
			onCreate(database, connectionSource);
		} catch (SQLException e)
		{
			e.printStackTrace();
		}
	}

	private static DatabaseHelper instance;

	/**
	 *      Helper
	 * 
	 * @param context
	 * @return
	 */
	public static synchronized DatabaseHelper getHelper(Context context)
	{
		if (instance == null)
		{
			synchronized (DatabaseHelper.class)
			{
				if (instance == null)
					instance = new DatabaseHelper(context);
			}
		}

		return instance;
	}

	/**
	 *   userDao
	 * 
	 * @return
	 * @throws SQLException
	 */
	public Dao<User, Integer> getUserDao() throws SQLException
	{
		if (userDao == null)
		{
			userDao = getDao(User.class);
		}
		return userDao;
	}

	/**
	 *     
	 */
	@Override
	public void close()
	{
		super.close();
		userDao = null;
	}

}
ここではOrmLiteSqlite OpenHelperを継承します.実はSQLiteOpenHelperを間接的に継承しました.
2つの方法を実装する必要があります.
1、onCreate(SQLiteDatabase database、Connection Source connection Source)
表を作成して、私達は直接ormliteから提供されたTable.create Tableを使用します.作成を行います
2、onUpgrade(SQLiteDatabase database、Connection Source connection Source、int oldVersion、int newVersion)
表を更新して、ormliteで提供したTable Utils.dropTableを使用します.削除操作を行います
削除が完了したら、忘れずに、作成操作:onCreate(database、connectionance Source);
その後、単一の例を使用して、私たちのhelpのインスタンスを取得するために、getHelperを作成する方法を発表する.
最後に多くの時計があるかもしれません.どの表も普通は単独でDaoを書いて操作に使います.ここでは簡単のために抜粋していません.直接helperに書いています.
例えばUserDaoの取得:
/**
	 *   userDao
	 * 
	 * @return
	 * @throws SQLException
	 */
	public Dao<User, Integer> getUserDao() throws SQLException
	{
		if (userDao == null)
		{
			userDao = getDao(User.class);
		}
		return userDao;
	}
そして、取得したDaoを通じてUserの一般的な動作を行うことができます.
4、テスト
最後はテストです.直接テストクラスを作ってテストします.
package com.zhy.zhy_ormlite.test;

import java.sql.SQLException;
import java.util.List;

import com.zhy.zhy_ormlite.bean.User;
import com.zhy.zhy_ormlite.db.DatabaseHelper;

import android.test.AndroidTestCase;
import android.util.Log;

public class OrmLiteDbTest extends AndroidTestCase
{

	public void testAddUser()
	{

		User u1 = new User("zhy", "2B  ");
		DatabaseHelper helper = DatabaseHelper.getHelper(getContext());
		try
		{
			helper.getUserDao().create(u1);
			u1 = new User("zhy2", "2B  ");
			helper.getUserDao().create(u1);
			u1 = new User("zhy3", "2B  ");
			helper.getUserDao().create(u1);
			u1 = new User("zhy4", "2B  ");
			helper.getUserDao().create(u1);
			u1 = new User("zhy5", "2B  ");
			helper.getUserDao().create(u1);
			u1 = new User("zhy6", "2B  ");
			helper.getUserDao().create(u1);
			
			testList();
			
			
		} catch (SQLException e)
		{
			e.printStackTrace();
		}
	}

	public void testDeleteUser()
	{
		DatabaseHelper helper = DatabaseHelper.getHelper(getContext());
		try
		{
			helper.getUserDao().deleteById(2);
		} catch (SQLException e)
		{
			e.printStackTrace();
		}
	}

	public void testUpdateUser()
	{
		DatabaseHelper helper = DatabaseHelper.getHelper(getContext());
		try
		{
			User u1 = new User("zhy-android", "2B  ");
			u1.setId(3);
			helper.getUserDao().update(u1);
			
		} catch (SQLException e)
		{
			e.printStackTrace();
		}
	}

	public void testList()
	{
		DatabaseHelper helper = DatabaseHelper.getHelper(getContext());
		try
		{
			User u1 = new User("zhy-android", "2B  ");
			u1.setId(2);
			List<User> users = helper.getUserDao().queryForAll();
			Log.e("TAG", users.toString());
		} catch (SQLException e)
		{
			e.printStackTrace();
		}
	}

}
簡単にCURDをテストしました.Android TestCaseを使って環境を覚えてください.
使うにはとても便利ですが、Userのデータベース操作など、単独で抽出したものをUserDaoとしてお勧めします.以下の通りです.
package com.zhy.zhy_ormlite.db;

import java.sql.SQLException;

import android.content.Context;

import com.zhy.zhy_ormlite.bean.User;

public class UserDao
{
	private Context context;

	public UserDao(Context context)
	{
		this.context = context;
	}

	public void add(User user)
	{
		try
		{
			DatabaseHelper.getHelper(context).getUserDao().create(user);
		} catch (SQLException e)
		{
		}
	}//......

}
注:ORMLiteはまたいくつかの基本クラスORMLiteBaseActivity、ORMLiteBaserviceなどを提供しています.データベースの操作に便利です.ここでは考慮しないでください.プロジェクトの中で自分もBaseActvityなどを継承しなければならない可能性が高いです.
以上、ORMLiteフレームワークの使い方を簡単に紹介しましたが、Android快速開発シリーズORMLiteフレームの使用はその使い方を深く紹介します.
ソースをクリックしてダウンロード