XUtils===XUtils3框架的基本使用方法(二)

转载自:http://blog.csdn.net/a1002450926/article/details/50364196

上一篇文章，主要介绍了XUtil3的注解模块，网络模块，图片加载模块，今天给大家带来数据库模块的讲解，现在主流的ORM框架很多，比如OrmLite,GreenDao,Active Android,Realm等等，这些框架每个都有自己的优点和缺点，大家完全可以根据自己项目的实际需求进行选择，下面开始进入今天的数据库模块的介绍。

今天主要给大家带来以下几个模块:
如何创建删除一张表
如何对表进行增删查改操作
如何创建数据库和删除数据库
如何建立一表对一表，多表对一表，多表对多表的外键操作。
相信对ORM框架有过了解的人，大概都知道只要创建一个JavaBean对象，在类的上面和属性的上面添加注释标签，这样就能生成一个表。下面带大家看一下XUtils3的实体bean的写法:

@Table(name="person")
publicclassPersonTable{
@Column(name="id",isId=true,autoGen=true)
privateintid;
//姓名
@Column(name="name")
privateStringname;

//年龄
@Column(name="age")
privateintage;

//性别
@Column(name="sex")
privateStringsex;

//工资
@Column(name="salary")
privateStringsalary;

publicintgetId(){
returnid;
}

publicvoidsetId(intid){
this.id=id;
}

publicStringgetName(){
returnname;
}

publicvoidsetName(Stringname){
this.name=name;
}


publicStringgetSex(){
returnsex;
}

publicvoidsetSex(Stringsex){
this.sex=sex;
}

publicintgetAge(){
returnage;
}

publicvoidsetAge(intage){
this.age=age;
}


publicStringgetSalary(){
returnsalary;
}

publicvoidsetSalary(Stringsalary){
this.salary=salary;
}

@Override
publicStringtoString(){
return"PersonTable[id="+id+",name="+name+",age="+age
+",sex="+sex+",salary="+salary+"]";
}
}

通过上方的实体bean,我们需要知道一个表对应的实体bean需要注意以下几点:
1.在类名上面加入@Table标签，标签里面的属性name的值就是以后生成的数据库的表的名字
2.实体bean里面的属性需要加上@Column标签，这样这个标签的name属性的值会对应数据库里面的表的字段。
3.实体bean里面的普通属性，如果没有加上@Column标签就不会在生成表的时候在表里面加入字段。
4.实体bean中必须有一个主键，如果没有主键，表以后不会创建成功，@Column(name=”id”,isId=true,autoGen=true)这个属性name的值代表的是表的主键的标识，isId这个属性代表的是该属性是不是表的主键，autoGen代表的是主键是否是自增长，如果不写autoGen这个属性，默认是自增长的属性。

既然知道怎么写实体bean了，下面看看如何在程序中创建一个数据库和如何生成表的吧。

publicclassXUtil{
staticDbManager.DaoConfigdaoConfig;
publicstaticDaoConfiggetDaoConfig(){
Filefile=newFile(Environment.getExternalStorageDirectory().getPath());
if(daoConfig==null){
daoConfig=newDbManager.DaoConfig()
.setDbName("shiyan.db")
.setDbDir(file)
.setDbVersion(1)
.setAllowTransaction(true)
.setDbUpgradeListener(newDbUpgradeListener(){
@Override
publicvoidonUpgrade(DbManagerdb,intoldVersion,intnewVersion){

}
});
}
returndaoConfig;
}
}

通过XUti.getDaoConfig()方法，我们能够获取到一个DaoConfig对象。通过getDaoConfig()方法，我们可以知道这个方法主要可以做以下事情:
1.setDbName 设置数据库的名称
2.setDbDir 设置数据库存放的路径
3.setDbVersion 设置数据库的版本
4.setAllowTransaction(true) 设置允许开启事务
5.setDbUpgradeListener 设置一个版本升级的监听方法
那么具体我们什么时候创建的表呢？如果我们单纯的调用XUti.getDaoConfig()方法是不能够创建PersonTable这个实体对应的person这张表的，那么如何创建表呢？
只需要一下几步:
1.DaoConfig daoConfig=XUtil.getDaoConfig();
2.DbManager db = x.getDb(daoConfig);
这里我要告诉大家的是，数据库里面表的创建的时间，只有在你对数据库里面的操作涉及到这张表的操作时，会先判断当前的表是否存在，如果不存在，才会创建一张表，如果存在，才会进行相应的CRUD操作，但是只要我们想进行一张表的CRUD操作，我们必须先执行上面的2步，通俗点说就是必须拿到一个Dbmanger这个对象，我为什么这么说呢？那么咱们就先看一下DbManger的庐山真面目吧。
DbManager部分源码如下:

publicinterfaceDbManagerextendsCloseable{

DaoConfiggetDaoConfig();

SQLiteDatabasegetDatabase();

/**
*保存实体类或实体类的List到数据库,
*如果该类型的id是自动生成的,则保存完后会给id赋值.
*
*@paramentity
*@return
*@throwsDbException
*/
booleansaveBindingId(Objectentity)throwsDbException;

/**
*保存或更新实体类或实体类的List到数据库,根据id对应的数据是否存在.
*
*@paramentity
*@throwsDbException
*/
voidsaveOrUpdate(Objectentity)throwsDbException;

/**
*保存实体类或实体类的List到数据库
*
*@paramentity
*@throwsDbException
*/
voidsave(Objectentity)throwsDbException;

/**
*保存或更新实体类或实体类的List到数据库,根据id和其他唯一索引判断数据是否存在.
*
*@paramentity
*@throwsDbException
*/
voidreplace(Objectentity)throwsDbException;

/////////////delete
voiddeleteById(Class<?>entityType,ObjectidValue)throwsDbException;

voiddelete(Objectentity)throwsDbException;

voiddelete(Class<?>entityType)throwsDbException;

voiddelete(Class<?>entityType,WhereBuilderwhereBuilder)throwsDbException;

/////////////update
voidupdate(Objectentity,String...updateColumnNames)throwsDbException;

voidupdate(Objectentity,WhereBuilderwhereBuilder,String...updateColumnNames)throwsDbException;

/////////////find
<T>TfindById(Class<T>entityType,ObjectidValue)throwsDbException;

<T>TfindFirst(Class<T>entityType)throwsDbException;

<T>List<T>findAll(Class<T>entityType)throwsDbException;

<T>Selector<T>selector(Class<T>entityType)throwsDbException;

DbModelfindDbModelFirst(SqlInfosqlInfo)throwsDbException;

List<DbModel>findDbModelAll(SqlInfosqlInfo)throwsDbException;

/////////////table

/**
*删除表
*
*@paramentityType
*@throwsDbException
*/
voiddropTable(Class<?>entityType)throwsDbException;

/**
*添加一列,
*新的entityType中必须定义了这个列的属性.
*
*@paramentityType
*@paramcolumn
*@throwsDbException
*/
voidaddColumn(Class<?>entityType,Stringcolumn)throwsDbException;

/////////////db

/**
*删除库
*
*@throwsDbException
*/
voiddropDb()throwsDbException;

/**
*关闭数据库,
*xUtils对同一个库的链接是单实例的,一般不需要关闭它.
*
*@throwsIOException
*/
voidclose()throwsIOException;

/////////////custom
voidexecNonQuery(SqlInfosqlInfo)throwsDbException;

voidexecNonQuery(Stringsql)throwsDbException;

CursorexecQuery(SqlInfosqlInfo)throwsDbException;

CursorexecQuery(Stringsql)throwsDbException;
}

通过DbManager这个类我们知道主要它做了以下几件事情:
1.getDaoConfig 获取数据库的配置信息
2.getDatabase 获取数据库实例
3.saveBindingId saveOrUpdate save 插入数据的3个方法(保存数据)
4.replace 只有存在唯一索引时才有用 慎重
5.delete操作的4种方法(删除数据)
6.update操作的2种方法(修改数据)
7.find操作6种方法(查询数据)
8.dropTable 删除表
9.addColumn 添加一列
10.dropDb 删除数据库

插入操作

<spanstyle="font-size:18px;">privatevoidinsert(){
try{
PersonTableperson=newPersonTable();
person.setName("小丽");
person.setAge(19);
person.setSex("woman");
person.setSalary(4000);
db.save(person);
//db.saveOrUpdate(person);
//db.saveBindingId(person);
}catch(DbExceptione){
e.printStackTrace();
}
}</span>

结果如下:

3种插入操作所需要的参数都是一个实体bean。save和saveOrUpdate的区别就是当一个实体里面的主键一样时如果使用saveOrUpdate会将当前主键对应的这条数据进行替换，而如果你使用了save就会报错。
saveBindingId主要是存进去的数据如果当前表有主键回合主键进行绑定关联。
当你执行完这个方法后，你会看到数据库里面person表里面多了一条数据.

查询操作

当前数据库中的表的效果如下:

1.findById的使用
该方法主要是通过主键的值来进行查找表里面的数据
需求:查找上方person表里面id为3的数据

privatevoidquery(){
try{
PersonTableperson=db.findById(PersonTable.class,"2");
Log.e("person",person.toString());
}catch(DbExceptione){
e.printStackTrace();
}
}

结果如下:

2.findFirst的使用
该方法主要是返回当前表里面的第一条数据
需求:查找上方person表里面的第一条数据

privatevoidquery(){
try{
PersonTableperson=db.findFirst(PersonTable.class);
Log.e("person",person.toString());
}catch(DbExceptione){
e.printStackTrace();
}
}

3.findAll的使用
该方法主要是返回当前表里面的所有数据
需求:查找person表里面的所有数据

privatevoidquery(){
try{
List<PersonTable>persons=db.findAll(PersonTable.class);
Log.e("persons",persons.toString());
}catch(DbExceptione){
e.printStackTrace();
}
}

4.selector的使用
该方法主要是用来进行一些特定条件的查找
需求:查找person表里面age大于30并且性别为man的数据

privatevoidquery(){
try{
List<PersonTable>persons=db.selector(PersonTable.class).where("age",">",30).and("sex","=","man").findAll();
for(PersonTableperson:persons){
Log.e("person",person.toString());
}
}catch(DbExceptione){
e.printStackTrace();
}
}

5.findDbModelFirst的使用
说起这个方法，该方法返回一个DbModel对象，那么该对象是什么呢？
DbModel源码如下:

publicfinalclassDbModel{

/**
*key:columnName
*value:valueStr
*/
privateHashMap<String,String>dataMap=newHashMap<String,String>();

publicStringgetString(StringcolumnName){
returndataMap.get(columnName);
}

publicintgetInt(StringcolumnName){
returnInteger.valueOf(dataMap.get(columnName));
}

publicbooleangetBoolean(StringcolumnName){
Stringvalue=dataMap.get(columnName);
if(value!=null){
returnvalue.length()==1?"1".equals(value):Boolean.valueOf(value);
}
returnfalse;
}

publicdoublegetDouble(StringcolumnName){
returnDouble.valueOf(dataMap.get(columnName));
}

publicfloatgetFloat(StringcolumnName){
returnFloat.valueOf(dataMap.get(columnName));
}

publiclonggetLong(StringcolumnName){
returnLong.valueOf(dataMap.get(columnName));
}

publicDategetDate(StringcolumnName){
longdate=Long.valueOf(dataMap.get(columnName));
returnnewDate(date);
}

publicjava.sql.DategetSqlDate(StringcolumnName){
longdate=Long.valueOf(dataMap.get(columnName));
returnnewjava.sql.Date(date);
}

publicvoidadd(StringcolumnName,StringvalueStr){
dataMap.put(columnName,valueStr);
}

/**
*@returnkey:columnName
*/
publicHashMap<String,String>getDataMap(){
returndataMap;
}

/**
*@paramcolumnName
*@return
*/
publicbooleanisEmpty(StringcolumnName){
returnTextUtils.isEmpty(dataMap.get(columnName));
}
}

通过源码，我们分析发现DbModel本质就是一个key为当前表的字段，value为当前某条记录的值的一个HashMap.
需求:查找person表中第一条数据的那个人的年龄age是多少。

privatevoidquery(){
try{
DbModelmodel=db.findDbModelFirst(newSqlInfo("select*fromperson"));
Log.e("age",model.getString("age"));
}catch(DbExceptione){
e.printStackTrace();
}
}

注意上面的sqlInfo对象的创建的构造参数只需要传入一个sql语句即可。

6.findDbModelAll的用法
该方法的用途就是返回满足sqlInfo信息的所有数据的字段的一个集合。
需求：查找person表中年龄age大于25里面的所有人的姓名

privatevoidquery(){
try{
List<DbModel>persons=db.findDbModelAll(newSqlInfo("select*frompersonwhereage>25"));
for(DbModelperson:persons){
Log.e("name",person.getString("name"));
}
}catch(DbExceptione){
e.printStackTrace();
}
}

基本把查询的6种方式都说了一遍，当然上面的6种需求不一定完全用上面的查询方法可以查出结果，我这么查询的目的主要是带领大家熟悉一下XUtils3的6种查询方法是如何使用的，会了上面的6种方法，我相信你的查询不会有太大问题，至于复杂的查询无非就是sql语句的基本功力了，大家赶紧动手操练一下吧。

修改操作

当前数据库中的表的效果如下:

修改一共有2种方法:
第一种：
需求：我们把上面的id为1的这条记录的age修改为25岁

privatevoidupdate(){
try{
PersonTableperson=db.findById(PersonTable.class,1);
person.setAge(25);
db.update(person,"age");
}catch(Exceptione){
e.printStackTrace();
}
}

通过方法，我们知道首先要通过DBManager通过查找的方法先找到id为1的这个实体bean，如果你对里面的哪个字段需要修改，只需要重新set这个属性的值，然后调用DBManager.update方法，第一个参数是需要修改的实体，第二个参数是对应的属性。

第二种:
需求:将person表中性别为man的工资salary都变成6000。

privatevoidupdate(){
try{
List<PersonTable>persons=db.findAll(PersonTable.class);
for(PersonTableperson:persons){
person.setSalary(6000);
db.update(person,WhereBuilder.b("sex","=","man"),"salary");
}
}catch(Exceptione){
e.printStackTrace();
}
}

修改数据一共就2种方法，基本都是需要一个实体bean对象去进行操作的，上面的第二种方法无非就是在修改数据时，多了一个限制条件，这样修改数据显得灵活一些。
上面第二种update的方法的参数简单介绍一下：
第一个参数:实体bean对象
第二个参数:一个WhereBuilder对象，主要是通过静态b方法去构造一个where条件语句
第三个参数:需要修改的字段名，如果你的需求是修改了2个或者更多个字段，只需要在后面加上相应的参数即可，例如第二种方法我不止修改salary还需要修改age统一为40岁，参考如下；

privatevoidupdate(){
try{
List<PersonTable>persons=db.findAll(PersonTable.class);
for(PersonTableperson:persons){
person.setSalary(6000);
person.setAge(40);
db.update(person,WhereBuilder.b("sex","=","man"),"salary","age");
}
}catch(Exceptione){
e.printStackTrace();
}
}

删除操作

当前数据库中的person表的效果如下:

1.deleteById的用法
该方法主要是根据表的主键进行单条记录的删除
需求:删除上方person表中id为5的记录

privatevoiddelete(){
try{
db.deleteById(PersonTable.class,5);
}catch(DbExceptione){
e.printStackTrace();
}
}

结果如下:

2.delete(Object entity)的用法
该方法主要是根据实体bean进行对表里面的一条或多条数据进行删除
需求：删除name为骆驼这条信息的记录

privatevoiddelete(){
try{
PersonTableperson=db.selector(PersonTable.class).where("name","=","骆驼").findFirst();
db.delete(person);
}catch(DbExceptione){
e.printStackTrace();
}
}

3.delete(Class<?> entityType)
该方法主要是用来删除表格里面的所有数据，但是注意：表还会存在，只是表里面数据没有了

privatevoiddelete(){
try{
db.delete(PersonTable.class);
}catch(DbExceptione){
e.printStackTrace();
}
}

4.delete(Class<?> entityType, WhereBuilder whereBuilder)
该方法主要是根据where语句的条件进行删除操作
需求:将person表总sex为woman并且salary为5000的信息删除

privatevoiddelete(){
try{
db.delete(PersonTable.class,WhereBuilder.b("sex","=","woman").and("salary","=","5000"));
}catch(DbExceptione){
e.printStackTrace();
}
}

5.dropTable(Class<?> entityType)

该方法是用来删除表

privatevoiddelete(){
try{
db.dropTable(PersonTable.class);
}catch(DbExceptione){
e.printStackTrace();
}
}

6.dropDb()
该方法是用来删除数据库

db.dropDb();

其他方法

1.addColumn(Class<> entityType, String column)
需求：在上方表中加入一个country字段
PersonTable的实体代码如下:

@Table(name="person")
publicclassPersonTable{
@Column(name="id",isId=true,autoGen=true)
privateintid;
//姓名
@Column(name="name")
privateStringname;

//年龄
@Column(name="age")
privateintage;

//性别
@Column(name="sex")
privateStringsex;

//工资
@Column(name="salary")
privateintsalary;

//国家
@Column(name="country",property="中国")
privateStringcountry;

publicintgetId(){
returnid;
}

publicvoidsetId(intid){
this.id=id;
}

publicStringgetName(){
returnname;
}

publicvoidsetName(Stringname){
this.name=name;
}


publicStringgetSex(){
returnsex;
}

publicvoidsetSex(Stringsex){
this.sex=sex;
}

publicintgetAge(){
returnage;
}

publicvoidsetAge(intage){
this.age=age;
}


publicintgetSalary(){
returnsalary;
}

publicvoidsetSalary(intsalary){
this.salary=salary;
}

publicStringgetCountry(){
returncountry;
}

publicvoidsetCountry(Stringcountry){
this.country=country;
}

@Override
publicStringtoString(){
return"PersonTable[id="+id+",name="+name+",age="+age
+",sex="+sex+",salary="+salary+",country="
+country+"]";
}
}

privatevoidaddColumn(){
try{
db.addColumn(PersonTable.class,"country");
}catch(DbExceptione){
e.printStackTrace();
}
}

执行完addColumn方法，我们看到person表里面多了一个country字段.
结果如下:

总结

上面主要介绍了XUtils3的数据库模块，包括如何创建数据库，如何创建表，如何给表进行添加一列，如何对表进行增删查改的操作。说了这么多，相信大家肯定对XUtils3的数据库模块有了一个基本的理解，至于一表对一表，多表对一表，多表对多表等等这类需求，无非就是在某个表里面加入一个字段，或者创建一个第三方表用来维护表与表之间的关系，这种类型的例子我就不举例说明了，原因是那些需求都离不开上面的增删查改的方法，我相信你只要把上面的方法完全会用，你的XUtils3的数据库模块的基本使用就不会有问题了。