Android xutil3.0完全解析

转载自:http://www.androidchina.net/4177.html?utm_source=tuicool&utm_medium=referral  Android开发中文站 »xUtils更新到3.0后的基本使用规则

说实话，对于xUtils，是我最近才用到的开发框架（也是刚接触），对于其功能不得不说，简化了很多的开发步骤，可以说是非常好的开发工具，但是其最近更新到3.0也没有解决加载自定义ImageView报错的问题。

我总是喜欢用一些最新的东西，xUtils 3.0才刚更新，是一次比较大的重构，对于百度到的使用规则，基本都是3.0以前的，使得用3.0的开发者需要求解用法的时候，遇到许多阻碍，故此在这里简单介绍xUtils 3.0的使用规则。关于怎么导入功能，其实并不是本文的内容，不过在此文最后一节简单讲解了一下导入的方式。

1.xUtils中的IOC框架

使用xUtils的第一步就是必须创建自己的Application类，代码如下：

public class LYJApplication extends Application {
   @Override
   public void onCreate() {
       super .onCreate();
       x.Ext.init( this ); //Xutils初始化
   }
}

在AndroidManifest.xml的application标签中添加如下代码：

android:name=”.LYJApplication”

这样初始化就算完成了。

使用IOC框架的代码如下：

import org.xutils.view.annotation.ContentView;
import org.xutils.view.annotation.Event;
import org.xutils.view.annotation.ViewInject;
import org.xutils.x;
@ContentView (value = R.layout.activity_main)
public class MainActivity extends AppCompatActivity {
   @ViewInject (value = R.id.mybut)
   private Button mybut;
   @Override
   protected void onCreate(Bundle savedInstanceState) {
       super .onCreate(savedInstanceState);
       x.view().inject( this );
   }
   @Event (value = R.id.mybut,type = View.OnClickListener. class )
   private void onButtonClick(View v){
       switch (v.getId()){
           case R.id.mybut:
               Toast.makeText( this , "你好我是Xutils的IOC功能" ,Toast.LENGTH_SHORT).show();
               break ;
       }
   }
}

需要解释的以下几点：

其一：使用IOC必须全部为私有，不然无效，这里就做演示了，不信你可以把用到IOC框架的注解的成员变量及方法全部换成public ,那么全部会无效，当然除了ContentView例外。

其二，所有用到IOC成员变量，使用的时候，必须在x.view().inject(this)后，如果写在前面，那么程序会崩溃。

2.xUtils加载图片功能

现在我们需要设置两个权限，如下：

< uses-permission android:name = "android.permission.INTERNET" />
< uses-permission android:name = "android.permission.WRITE_EXTERNAL_STORAGE" />

接下来就是加载网络图片到imageView中：

x.image().bind(image,”http://pic.baike.soso.com/p/20090711/20090711101754-314944703.jpg“);

也可以设置参数：

ImageOptions imageOptions = new ImageOptions.Builder()
       .setSize(DensityUtil.dip2px( 120 ), DensityUtil.dip2px( 120 )) //图片大小
       .setRadius(DensityUtil.dip2px( 5 )) //ImageView圆角半径
       .setCrop( true ) // 如果ImageView的大小不是定义为wrap_content, 不要crop.
       .setImageScaleType(ImageView.ScaleType.CENTER_CROP)
       .setLoadingDrawableId(R.mipmap.ic_launcher) //加载中默认显示图片
       .setFailureDrawableId(R.mipmap.ic_launcher) //加载失败后默认显示图片
       .build();
x.image().bind(image, "http://pic.baike.soso.com/p/20090711/20090711101754-314944703.jpg" ,imageOptions);

你也可以将第2个参数设置为图片文件路径，那么将从SD卡中加载图片。

3.xUtils操作数据库

我们都知道，一个App中操作数据库的地方有很多，就像是否登录一样，有些地方必须登录后才能操作，那么肯定是全局变量，所以，必须将数据库的初始化放在Application，且必须提供获取数据库的方法，使得在应用程序的任何地方都可以直接获取数据库，并操作数据库，不然重复的获取与释放只能增加内存无谓的消耗。

初始化数据库：

public class LYJApplication extends Application {
   private DbManager.DaoConfig daoConfig;
   public DbManager.DaoConfig getDaoConfig() {
       return daoConfig;
   }
   @Override
   public void onCreate() {
       super .onCreate();
       x.Ext.init( this ); //Xutils初始化
       daoConfig = new DbManager.DaoConfig()
               .setDbName( "lyj_db" ) //创建数据库的名称
               .setDbVersion( 1 ) //数据库版本号
               .setDbUpgradeListener( new DbManager.DbUpgradeListener() {
                   @Override
                   public void onUpgrade(DbManager db, int oldVersion, int newVersion) {
                       // TODO: ...
                       // db.addColumn(...);
                       // db.dropTable(...);
                       // ...
                   }
               }); //数据库更新操作
   }
}

上面的注释明了，有必要说明的一点是setDbDir(new File(“/sdcard”))，可以将数据库存储在你想存储的地方，如果不设置，那么数据库默认存储在/data/data/你的应用程序/database/xxx.db下。这里我们就默认放在应用程序下。

我们首先创建一个实体类，如下：

@Table (name= "lyj_person" )
public class LYJPerson {
   @Column (name = "id" , isId = true )
   private int id;
   @Column (name = "name" )
   private String name;
   @Column (name = "age" )
   private String age;
   public String getAge() {
       return age;
   }
   public void setAge(String age) {
       this .age = age;
   }
   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;
   }
}

通过实体类可以直接操作数据库。

我们在Application中加入如下代码，向数据库添加数据：

DbManager db = x.getDb(daoConfig);
LYJPerson person1= new LYJPerson();
person1.setName( "liyuanjinglyj" );
person1.setAge( "23" );
LYJPerson person2= new LYJPerson();
person2.setName( "xutilsdemo" );
person2.setAge( "56" );
try {
   db.save(person1);
   db.save(person2);
} catch (DbException e) {
   e.printStackTrace();
}

在Activity中操作获取数据库数据的代码如下：

DbManager db = x.getDb(((LYJApplication)getApplicationContext()).getDaoConfig());
try {
   List<LYJPerson> lyjPersons=db.selector(LYJPerson. class ).findAll();
   for ( int i= 0 ;i<lyjPersons.size();i++){
       Log.i( "liyuanjinglyj" , "LYJPerson" +i+ ".name=" +lyjPersons.get(i).getName());
       Log.i( "liyuanjinglyj" , "LYJPerson" +i+ ".name=" +lyjPersons.get(i).getAge());
   }
} catch (DbException e) {
   e.printStackTrace();
}

那么肯定会得到如下结果：

4.xUtils的网络请求

Android规定UI线程是不能涉及网络任务的，所以，这里主要简单介绍Xutils的异步网络请求，同步的自行探究。

使用格式如下：

RequestParams params = new RequestParams( "http://blog.csdn.net/mobile/experts.html" );
x.http().get(params, new Callback.CommonCallback<String>() {
   @Override
   public void onSuccess(String result) {
       Document doc = Jsoup.parse(result);
       Element div = doc.select( "div.list_3" ).get( 0 );
       Elements imgs = div.getElementsByTag( "img" );
       for ( int i = 0 ; i < imgs.size(); i++) {
           Element img = imgs.get(i);
           Log.i( "liyuanjinglyj" ,img.attr( "alt" ));
       }
   }
   @Override
   public void onError(Throwable ex, boolean isOnCallback) {
   }
   @Override
   public void onCancelled(Callback.CancelledException cex) {
   }
   @Override
   public void onFinished() {
   }
});

这里获取的是CSDN移动博客专家的HTML页面信息，看看下面的日志，就知道Xutils网络功能还是很强大的。

本文最后附带了一下粗略模仿CSDN APP的源码，有意者可以下载看看，里面用到另一个开发框架，我用来专门处理图片的（afinal）。都说xUtils是afinal的进化版，不过在图片方面，我们觉得xUtils还有点不足。

http://download.csdn.net/detail/liyuanjinglyj/9379103

5.导入xUtils工程到Android Studio

下载地址如下：

https://github.com/wyouflf/xUtils3/tree/master

㈠将下载的工程复制到Project目录下：

㈡添加到settings.gradle文件：

include ‘:app’,':xutils’

㈢编译到工程中

dependencies {
    compile fileTree(dir: 'libs', include: ['*.jar'])
    compile 'com.android.support:appcompat-v7:23.0.1'
    compile project(':xutils')
}

㈣将xutils文件夹下的build.gradle中的版本与最低版本调整到与创建工程一致

compileSdkVersion 23
buildToolsVersion "23.0.1"

defaultConfig {
    minSdkVersion 15
    targetSdkVersion 23
    versionCode 20151224
    versionName version
}

㈤添加如下代码到build.gradle（Project:XutilsDemo）中

dependencies {
    classpath 'com.android.tools.build:gradle:1.3.0'
    classpath 'com.jfrog.bintray.gradle:gradle-bintray-plugin:1.2'
    classpath 'com.github.dcendents:android-maven-gradle-plugin:1.3'
    // NOTE: Do not place your application dependencies here; they belong
    // in the individual module build.gradle files
}

其中红色标记为添加的代码。

点击Sync now就可以使用xUtils了。

 

 

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

今天给大家带来XUtils3的基本介绍，本文章的案例都是基于XUtils3的API语法进行的演示。相信大家对这个框架也都了解过，下面简单介绍下XUtils3的一些基本知识。

XUtils3一共有4大功能：注解模块，网络模块，图片加载模块，数据库模块。

使用XUtils只需要在libs文件夹里面加入一个jar包，如果对服务器返回的数据进行封装的话，还需要导入一个Gson的jar包。

"android.permission.INTERNET" />
"android.permission.WRITE_EXTERNAL_STORAGE" />

 

注解模块

Activity的注解
1.在Application的oncreate方法中加入下面代码:
x.Ext.init(this);
2.在Activity的oncreate方法中加入下面代码:
x.view().inject(this);
3.加载当前的Activity布局需要如下注解:
@ContentView加入到Activity的上方
4.给View进行初始化需要如下注解:
@InjectView
5.处理控件的各种响应事件需要如下注解:
@Envent

@ContentView(R.layout.activity_main)
public class MainActivity extends ActionBarActivity {

    @ViewInject(R.id.btn_get)
    Button btn_get;
    @ViewInject(R.id.btn_post)
    Button btn_post;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        x.view().inject(this);

        btn_get.setText("发送get请求");
        btn_post.setText("发送post请求");
    }
    //等同于@Event(value={R.id.btn_get,R.id.btn_post},type=View.OnClickListener.class)
    @Event(value={R.id.btn_get,R.id.btn_post})
    private void getEvent(View view){
        switch(view.getId()){
        case R.id.btn_get:
            Toast.makeText(MainActivity.this, btn_get.getText().toString().trim(), 0).show();
            break;
        case R.id.btn_post:
            Toast.makeText(MainActivity.this, btn_post.getText().toString().trim(), 0).show();
            break;
        }
    }

@ContentView(R.layout.activity_main)
public class MainActivity extends ActionBarActivity {

    @ViewInject(R.id.btn_get)
    Button btn_get;
    @ViewInject(R.id.btn_post)
    Button btn_post;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        x.view().inject(this);

        btn_get.setText("发送get请求");
        btn_post.setText("发送post请求");
    }
    //等同于@Event(value={R.id.btn_get,R.id.btn_post},type=View.OnClickListener.class)
    @Event(value={R.id.btn_get,R.id.btn_post})
    private void getEvent(View view){
        switch(view.getId()){
        case R.id.btn_get:
            Toast.makeText(MainActivity.this, btn_get.getText().toString().trim(), 0).show();
            break;
        case R.id.btn_post:
            Toast.makeText(MainActivity.this, btn_post.getText().toString().trim(), 0).show();
            break;
        }
    }

通过测试，我们发现当点击btn_get按钮时，弹出了“发送get请求”的效果。到这里，大家算是对XUtils的注解有个一个基本的认识，下面我在强调一点的是，@Event这个注解默认情况下type属性为View.OnClickListener.class.如果你想实现其余点击事件效果，只需要把type值进行修改即可。
另外需要注意的一点是按钮的点击事件必须用private进行修饰。

Fragment的注解:

@ContentView(R.layout.fragment_first)
public class FirstFragment extends Fragment{
    private MyAdapter adapter;
    private List list=new ArrayList<>();
    private List listUrl=new ArrayList<>();
    private List listName=new ArrayList<>();

    @ViewInject(R.id.btn_test)
    Button btn_test;
    @ViewInject(R.id.listView)
    ListView listView;

    @Override
    public View onCreateView(LayoutInflater inflater,
            @Nullable ViewGroup container, @Nullable Bundle savedInstanceState) {
        return  x.view().inject(this, inflater, container);
    }

@ContentView(R.layout.fragment_first)  
public class FirstFragment extends Fragment{  
    private MyAdapter adapter;
    private List list=new ArrayList<>();  
    private List listUrl=new ArrayList<>();  
    private List listName=new ArrayList<>();    

    @ViewInject(R.id.btn_test)
    Button btn_test;
    @ViewInject(R.id.listView)
    ListView listView;

    @Override
    public View onCreateView(LayoutInflater inflater,
            @Nullable ViewGroup container, @Nullable Bundle savedInstanceState) {
        return  x.view().inject(this, inflater, container);
    } 

ViewHolder的注解:

public class MyAdapter extends  BaseAdapter{
    private Context context;
    private List list;
    private LayoutInflater mInflater;
    private ImageOptions options;
    public ViewHolder holder;
    public MyAdapter(Context context, List list) {
        this.context = context;
        this.list = list;
        this.mInflater=LayoutInflater.from(context);
        options=new ImageOptions.Builder().setLoadingDrawableId(R.drawable.ic_launcher)
                .setLoadingDrawableId(R.drawable.ic_launcher).setUseMemCache(true).setCircular(true).build();
    }

    @Override
    public int getCount() {
        return list.size();
    }

    @Override
    public Object getItem(int position) {
        return list.get(position);
    }

    @Override
    public long getItemId(int position) {
        return position;
    }

    @Override
    public View getView(int position, View convertView, ViewGroup parent) {
        holder=null;
        if(convertView==null){
            convertView=mInflater.inflate(R.layout.itemone,  null);
            holder=new ViewHolder();
            x.view().inject(holder,convertView);
            convertView.setTag(holder);
        }
        else{
            holder=(ViewHolder) convertView.getTag();
        }
        Person bean=list.get(position);
        holder.tv_name.setText(bean.getName());
        x.image().bind(holder.iv_image, bean.getImgUrl(), options);
        return convertView;
    }

    class ViewHolder{
        @ViewInject(R.id.tv_name)
        private TextView tv_name;
        @ViewInject(R.id.iv_image)
        private ImageView iv_image;
    }

public class MyAdapter extends  BaseAdapter{
    private Context context;
    private List list;
    private LayoutInflater mInflater;
    private ImageOptions options;
    public ViewHolder holder;
    public MyAdapter(Context context, List list) {
        this.context = context;
        this.list = list;
        this.mInflater=LayoutInflater.from(context);
        options=new ImageOptions.Builder().setLoadingDrawableId(R.drawable.ic_launcher)
                .setLoadingDrawableId(R.drawable.ic_launcher).setUseMemCache(true).setCircular(true).build();
    }

    @Override
    public int getCount() {
        return list.size();
    }

    @Override
    public Object getItem(int position) {
        return list.get(position);
    }

    @Override
    public long getItemId(int position) {
        return position;
    }

    @Override
    public View getView(int position, View convertView, ViewGroup parent) {
        holder=null;
        if(convertView==null){
            convertView=mInflater.inflate(R.layout.itemone, null);
            holder=new ViewHolder();
            x.view().inject(holder,convertView);
            convertView.setTag(holder);
        }
        else{
            holder=(ViewHolder) convertView.getTag();
        }
        Person bean=list.get(position);
        holder.tv_name.setText(bean.getName());
        x.image().bind(holder.iv_image, bean.getImgUrl(), options);
        return convertView;
    }

    class ViewHolder{
        @ViewInject(R.id.tv_name)
        private TextView tv_name;
        @ViewInject(R.id.iv_image)
        private ImageView iv_image;
    }

 

上面的代码是注解ViewHolder的标准模式，相信大家完全能够看明白。这里我加载图片使用到了XUtils3的加载网络图片的方法。后面我会详细进行讲解。

网络模块

XUtils的网络请求方法和一些网络请求框架的用法非常类似，我进行了一些简单的封装。
封装一共有3个文件，分别是网络请求工具类XUtil,请求响应数据的解析类，还有一个就是一个请求成功的一个接口回调类。
代码如下:

public class XUtil {
    /**
     * 发送get请求
     * @param
     */
    public static  Cancelable Get(String url,Map map,CommonCallback callback){
        RequestParams params=new RequestParams(url);
        if(null!=map){
            for(Map.Entry entry : map.entrySet()){
                params.addQueryStringParameter(entry.getKey(), entry.getValue());
            }
        }
        Cancelable cancelable = x.http().get(params, callback);
        return cancelable;
    }

    /**
     * 发送post请求
     * @param
     */
    public static  Cancelable Post(String url,Map map,CommonCallback callback){
        RequestParams params=new RequestParams(url);
        if(null!=map){
            for(Map.Entry entry : map.entrySet()){
                params.addParameter(entry.getKey(), entry.getValue());
            }
        }
        Cancelable cancelable = x.http().post(params, callback);
        return cancelable;
    }


    /**
     * 上传文件
     * @param
     */
    public static  Cancelable UpLoadFile(String url,Map map,CommonCallback callback){
        RequestParams params=new RequestParams(url);
        if(null!=map){
            for(Map.Entry entry : map.entrySet()){
                params.addParameter(entry.getKey(), entry.getValue());
            }
        }
        params.setMultipart(true);
        Cancelable cancelable = x.http().get(params, callback);
        return cancelable;
    }

    /**
     * 下载文件
     * @param
     */
    public static  Cancelable DownLoadFile(String url,String filepath,CommonCallback callback){
        RequestParams params=new RequestParams(url);
        //设置断点续传
        params.setAutoResume(true);
        params.setSaveFilePath(filepath);
        Cancelable cancelable = x.http().get(params, callback);
        return cancelable;
    }
}


public class JsonResponseParser implements ResponseParser {
    //检查服务器返回的响应头信息
    @Override
    public void checkResponse(UriRequest request) throws Throwable {
    }

    /**
     * 转换result为resultType类型的对象
     *
     * @param resultType  返回值类型(可能带有泛型信息)
     * @param resultClass 返回值类型
     * @param result      字符串数据
     * @return
     * @throws Throwable
     */
    @Override
    public Object parse(Type resultType, Class resultClass, String result) throws Throwable {
        return new Gson().fromJson(result, resultClass);
    }
}


public class MyCallBack implements Callback.CommonCallback{

    @Override
    public void onSuccess(ResultType result) {
        //可以根据公司的需求进行统一的请求成功的逻辑处理
    }

    @Override
    public void onError(Throwable ex, boolean isOnCallback) {
        //可以根据公司的需求进行统一的请求网络失败的逻辑处理
    }

    @Override
    public void onCancelled(CancelledException cex) {

    }

    @Override
    public void onFinished() {

    }


}

public class XUtil {
    /**
     * 发送get请求
     * @param 
     */
    public static  Cancelable Get(String url,Map map,CommonCallback callback){
        RequestParams params=new RequestParams(url);
        if(null!=map){
            for(Map.Entry entry : map.entrySet()){
                params.addQueryStringParameter(entry.getKey(), entry.getValue());
            }
        }
        Cancelable cancelable = x.http().get(params, callback);
        return cancelable;
    }

    /**
     * 发送post请求
     * @param 
     */
    public static  Cancelable Post(String url,Map map,CommonCallback callback){
        RequestParams params=new RequestParams(url);
        if(null!=map){
            for(Map.Entry entry : map.entrySet()){
                params.addParameter(entry.getKey(), entry.getValue());
            }
        }
        Cancelable cancelable = x.http().post(params, callback);
        return cancelable;
    }


    /**
     * 上传文件
     * @param 
     */
    public static  Cancelable UpLoadFile(String url,Map map,CommonCallback callback){
        RequestParams params=new RequestParams(url);
        if(null!=map){
            for(Map.Entry entry : map.entrySet()){
                params.addParameter(entry.getKey(), entry.getValue());
            }
        }
        params.setMultipart(true);
        Cancelable cancelable = x.http().get(params, callback);
        return cancelable;
    }

    /**
     * 下载文件
     * @param 
     */
    public static  Cancelable DownLoadFile(String url,String filepath,CommonCallback callback){
        RequestParams params=new RequestParams(url);
        //设置断点续传
        params.setAutoResume(true);
        params.setSaveFilePath(filepath);
        Cancelable cancelable = x.http().get(params, callback);
        return cancelable;
    }
}


public class JsonResponseParser implements ResponseParser {
    //检查服务器返回的响应头信息
    @Override
    public void checkResponse(UriRequest request) throws Throwable {
    }

    /**
     * 转换result为resultType类型的对象
     *
     * @param resultType  返回值类型(可能带有泛型信息)
     * @param resultClass 返回值类型
     * @param result      字符串数据
     * @return
     * @throws Throwable
     */
    @Override
    public Object parse(Type resultType, Class resultClass, String result) throws Throwable {
        return new Gson().fromJson(result, resultClass);
    }
}


public class MyCallBack implements Callback.CommonCallback{

    @Override
    public void onSuccess(ResultType result) {
        //可以根据公司的需求进行统一的请求成功的逻辑处理
    }

    @Override
    public void onError(Throwable ex, boolean isOnCallback) {
        //可以根据公司的需求进行统一的请求网络失败的逻辑处理
    }

    @Override
    public void onCancelled(CancelledException cex) {

    }

    @Override
    public void onFinished() {

    }


}

1.发送get请求示例:

//本get请求来自于免费测试接口：http://www.k780.com/api/entry.baidu
String url="http://api.k780.com:88/?app=idcard.get";
        Map map=new HashMap<>();
        map.put("appkey", "10003");
        map.put("sign",  "b59bc3ef6191eb9f747dd4e83c99f2a4");
        map.put("format", "json");
        map.put("idcard", "110101199001011114");
        XUtil.Get(url, map, new MyCallBack(){

            @Override
            public  void onSuccess(PersonInfoBean result) {
                super.onSuccess(result);
                Log.e("result", result.toString());
            }

            @Override
            public  void onError(Throwable ex, boolean isOnCallback) {
                super.onError(ex, isOnCallback);


            }

        });

//本get请求来自于免费测试接口：http://www.k780.com/api/entry.baidu
String url="http://api.k780.com:88/?app=idcard.get";
        Map map=new HashMap<>();
        map.put("appkey", "10003");
        map.put("sign", "b59bc3ef6191eb9f747dd4e83c99f2a4");
        map.put("format", "json");
        map.put("idcard", "110101199001011114");
        XUtil.Get(url, map, new MyCallBack(){

            @Override
            public void onSuccess(PersonInfoBean result) {
                super.onSuccess(result);
                Log.e("result", result.toString());
            }

            @Override
            public void onError(Throwable ex, boolean isOnCallback) {
                super.onError(ex, isOnCallback);


            }

        });

 

2.发送post请求

String url="http://api.k780.com:88/?app=idcard.get";
        Map map=new HashMap<>();
        map.put("appkey", "10003");
        map.put("sign", "b59bc3ef6191eb9f747dd4e83c99f2a4");
        map.put("format", "json");
        map.put("idcard", "110101199001011114");
        XUtil.Post(url, map, new MyCallBack(){

            @Override
            public void onSuccess(PersonInfoBean result) {
                super.onSuccess(result);
                Log.e("result", result.toString());
            }

            @Override
            public void onError(Throwable ex, boolean isOnCallback) {
                super.onError(ex, isOnCallback);

            }
        });

String url="http://api.k780.com:88/?app=idcard.get";
        Map map=new HashMap<>();
        map.put("appkey", "10003");
        map.put("sign", "b59bc3ef6191eb9f747dd4e83c99f2a4");
        map.put("format", "json");
        map.put("idcard", "110101199001011114");
        XUtil.Post(url, map, new MyCallBack(){

            @Override
            public void onSuccess(PersonInfoBean result) {
                super.onSuccess(result);
                Log.e("result", result.toString());
            }

            @Override
            public void onError(Throwable ex, boolean isOnCallback) {
                super.onError(ex, isOnCallback);

            }
        });

3.上传文件

/**
     * 上传文件(支持多文件上传)
     */
    private void uploadfile() {
        //图片上传地址
        String url="";
        Map map=new HashMap<>();
        //传入自己的相应参数
        //map.put(key, value);
        //map.put(key, value);
        XUtil.UpLoadFile(url, map, new MyCallBack(){

            @Override
            public void onSuccess(String result) {
                super.onSuccess(result);
            }

            @Override
            public  void onError(Throwable ex, boolean isOnCallback) {
                super.onError(ex, isOnCallback);
            }

        });

    }

/**
     * 上传文件(支持多文件上传)
     */
    private void uploadfile() {
        //图片上传地址
        String url="";
        Map map=new HashMap<>();
        //传入自己的相应参数
        //map.put(key, value);
        //map.put(key, value);
        XUtil.UpLoadFile(url, map, new MyCallBack(){

            @Override
            public void onSuccess(String result) {
                super.onSuccess(result);
            }

            @Override
            public void onError(Throwable ex, boolean isOnCallback) {
                super.onError(ex, isOnCallback);
            }

        });

    }

4.下载文件

private void downloadfile() {
        //文件下载地址
        String url="";
        //文件保存在本地的路径
        String filepath="";
        XUtil.DownLoadFile(url, filepath,new MyCallBack(){
            @Override
            public void onSuccess(File result) {
                super.onSuccess(result);

            }

            @Override
            public void onError(Throwable ex, boolean isOnCallback) {
                super.onError(ex, isOnCallback);

            }
        });

private void downloadfile() {
        //文件下载地址
        String url="";
        //文件保存在本地的路径
        String filepath="";
        XUtil.DownLoadFile(url, filepath,new MyCallBack(){
            @Override
            public void onSuccess(File result) {
                super.onSuccess(result);

            }

            @Override
            public void onError(Throwable ex, boolean isOnCallback) {
                super.onError(ex, isOnCallback);

            }
        });

5.下载文件带进度条

private void downloadprogressfile() {
        //文件下载地址
        String url="";
        //文件保存在本地的路径
        String filepath="";
        XUtil.DownLoadFile(url, filepath,new MyProgressCallBack(){

            @Override
            public  void onSuccess(File result) {
                super.onSuccess(result);

            }

            @Override
            public  void onError(Throwable ex, boolean isOnCallback) {
                super.onError(ex, isOnCallback);

            }
            @Override
            public void onLoading(long total, long current,
                    boolean isDownloading) {
                super.onLoading(total, current, isDownloading);

            }
        });
    }

private void downloadprogressfile() {
        //文件下载地址
        String url="";
        //文件保存在本地的路径
        String filepath="";
        XUtil.DownLoadFile(url, filepath,new MyProgressCallBack(){

            @Override
            public void onSuccess(File result) {
                super.onSuccess(result);

            }

            @Override
            public void onError(Throwable ex, boolean isOnCallback) {
                super.onError(ex, isOnCallback);

            }
            @Override
            public void onLoading(long total, long current,
                    boolean isDownloading) {
                super.onLoading(total, current, isDownloading);

            }
        });
    }

6.发送get请求(服务器以xml格式返回)

private void getxml() {
        String url="http://flash.weather.com.cn/wmaps/xml/china.xml";
        XUtil.Get(url, null, new MyCallBack(){

            @Override
            public void onSuccess(String xmlString) {
                super.onSuccess(xmlString);
                try{
                    XmlPullParserFactory factory = XmlPullParserFactory.newInstance();
                    XmlPullParser xmlPullParser = factory.newPullParser();
                    xmlPullParser.setInput(new StringReader(xmlString));
                    int eventType = xmlPullParser.getEventType();
                    while (eventType != XmlPullParser.END_DOCUMENT) {
                        switch (eventType) {
                        case XmlPullParser.START_TAG:
                            String nodeName = xmlPullParser.getName();
                            if ("city".equals(nodeName)) {
                                String pName = xmlPullParser.getAttributeValue(0);
                                Log.e("TAG", "city is " + pName);
                            }
                            break;
                        }
                        eventType = xmlPullParser.next();
                    }
                }catch(Exception e){
                    e.printStackTrace();
                }
            }

            @Override
            public  void onError(Throwable ex, boolean isOnCallback) {
                super.onError(ex, isOnCallback);
            }

        });
    }

private void getxml() {
        String url="http://flash.weather.com.cn/wmaps/xml/china.xml";
        XUtil.Get(url, null, new MyCallBack(){

            @Override
            public void onSuccess(String xmlString) {
                super.onSuccess(xmlString);
                try{
                    XmlPullParserFactory factory = XmlPullParserFactory.newInstance();  
                    XmlPullParser xmlPullParser = factory.newPullParser();  
                    xmlPullParser.setInput(new StringReader(xmlString));  
                    int eventType = xmlPullParser.getEventType();  
                    while (eventType != XmlPullParser.END_DOCUMENT) {  
                        switch (eventType) {  
                        case XmlPullParser.START_TAG:  
                            String nodeName = xmlPullParser.getName();  
                            if ("city".equals(nodeName)) {  
                                String pName = xmlPullParser.getAttributeValue(0);  
                                Log.e("TAG", "city is " + pName);  
                            }  
                            break;  
                        }  
                        eventType = xmlPullParser.next();  
                    }  
                }catch(Exception e){
                    e.printStackTrace();
                }
            }

            @Override
            public void onError(Throwable ex, boolean isOnCallback) {
                super.onError(ex, isOnCallback);
            }

        });
    }

 

图片加载模块

用法:

x.image().bind(imageView, url, imageOptions);
x.image().bind(imageView, "file:///sdcard/test.gif", imageOptions);
x.image().bind(imageView, "assets://test.gif", imageOptions);
x.image().bind(imageView, url, imageOptions, new Callback.CommonCallback() {...});
x.image().loadDrawable(url, imageOptions,  new Callback.CommonCallback() {...});
x.image().loadFile(url, imageOptions, new Callback.CommonCallback() {...});

x.image().bind(imageView, url, imageOptions);
x.image().bind(imageView, "file:///sdcard/test.gif", imageOptions);
x.image().bind(imageView, "assets://test.gif", imageOptions);
x.image().bind(imageView, url, imageOptions, new Callback.CommonCallback() {...});
x.image().loadDrawable(url, imageOptions, new Callback.CommonCallback() {...});
x.image().loadFile(url, imageOptions, new Callback.CommonCallback() {...});

Xutils3的api还是比较简单的,相信大家都可以看懂，第一个参数传入一个View，第二个参数传入一个图片的网络地址，第三个参数一般是加载图片的配置。
下面看一下ImageOptions这个类吧:

ImageOptions options=new ImageOptions.Builder()
//设置加载过程中的图片
.setLoadingDrawableId(R.drawable.ic_launcher)
//设置加载失败后的图片
.setFailureDrawableId(R.drawable.ic_launcher)
//设置使用缓存
.setUseMemCache(true)
//设置显示圆形图片
.setCircular(true)
//设置支持gif
.setIgnoreGif(false)
.build();

ImageOptions options=new ImageOptions.Builder()
//设置加载过程中的图片
.setLoadingDrawableId(R.drawable.ic_launcher)
//设置加载失败后的图片
.setFailureDrawableId(R.drawable.ic_launcher)
//设置使用缓存
.setUseMemCache(true)
//设置显示圆形图片
.setCircular(true)
//设置支持gif
.setIgnoreGif(false)
.build();

 

其余的一些配置请参考源码

如果需要对加载的图片进行操作的话，可以使用:

x.image().loadDrawable(url, imageOptions, new Callback.CommonCallback() {...});

 

通过返回的Drawable对象进行图片的处理，满足项目的个性化的要求.

说了这么多，我想大家至少会对XUtils3有了一个基本的了解，由于XUtils3的数据库的用法比较多，本篇文章不会去涉及，下一篇文章我会为大家详细讲解XUtils3的数据库模块。大家赶紧现在动手操作一下吧！本文涉及到的所有实例都会在下面的demo中有涉及到，请自行参考。

源码下载地址:http://download.csdn.net/detail/a1002450926/9364413

 

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

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

@Table(name="person")
public class PersonTable {
    @Column(name="id",isId=true,autoGen=true)
    private int id;
    //姓名
    @Column(name="name")
    private String name;

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

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

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

    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 getSex() {
        return sex;
    }

    public void setSex(String sex) {
        this.sex =  sex;
    }

    public int getAge() {
        return age;
    }

    public void setAge(int age) {
        this.age =  age;
    }


    public String getSalary() {
        return salary;
    }

    public void setSalary(String salary) {
        this.salary = salary;
    }

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

@Table(name="person")
public class PersonTable {
    @Column(name="id",isId=true,autoGen=true)
    private int id;
    //姓名
    @Column(name="name")
    private String name;

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

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

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

    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 getSex() {
        return sex;
    }

    public void setSex(String sex) {
        this.sex = sex;
    }

    public int getAge() {
        return age;
    }

    public void setAge(int age) {
        this.age = age;
    }


    public String getSalary() {
        return salary;
    }

    public void setSalary(String salary) {
        this.salary = salary;
    }

    @Override
    public String toString() {
        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了，下面看看如何在程序中创建一个数据库和如何生成表的吧。

public class XUtil {
    static DbManager.DaoConfig daoConfig;
    public static DaoConfig getDaoConfig(){
        File file=new File(Environment.getExternalStorageDirectory().getPath());
        if(daoConfig==null){
            daoConfig=new DbManager.DaoConfig()
            .setDbName("shiyan.db")
            .setDbDir(file)
            .setDbVersion(1)
            .setAllowTransaction(true)
            .setDbUpgradeListener(new DbUpgradeListener() {
                @Override
                public  void onUpgrade(DbManager db, int oldVersion, int newVersion) {

                }
            });
        }
        return daoConfig;
    }
}

public class XUtil {
    static DbManager.DaoConfig daoConfig;
    public static DaoConfig getDaoConfig(){
        File file=new File(Environment.getExternalStorageDirectory().getPath());
        if(daoConfig==null){
            daoConfig=new DbManager.DaoConfig()
            .setDbName("shiyan.db")
            .setDbDir(file)
            .setDbVersion(1)
            .setAllowTransaction(true)
            .setDbUpgradeListener(new DbUpgradeListener() {
                @Override
                public void onUpgrade(DbManager db, int oldVersion, int newVersion) {

                }
            });
        }
        return daoConfig;
    }
}

通过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部分源码如下:

public interface DbManager extends Closeable {

    DaoConfig getDaoConfig();

    SQLiteDatabase getDatabase();

    /**
     * 保存实体类或实体类的List到数据库,
     * 如果该类型的id是自动生成的, 则保存完后会给id赋值.
     *
     * @param entity
     * @return
     * @throws DbException
     */
    boolean saveBindingId(Object entity) throws DbException;

    /**
     * 保存或更新实体类或实体类的List到数据库, 根据id对应的数据是否存在.
     *
     * @param entity
     * @throws DbException
     */
    void saveOrUpdate(Object entity) throws DbException;

    /**
     * 保存实体类或实体类的List到数据库
     *
     * @param entity
     * @throws DbException
     */
    void save(Object entity) throws DbException;

    /**
     * 保存或更新实体类或实体类的List到数据库, 根据id和其他唯一索引判断数据是否存在.
     *
     * @param entity
     * @throws DbException
     */
    void replace(Object entity) throws DbException;

    ///////////// delete
    void deleteById(Class entityType, Object idValue) throws DbException;

    void delete(Object entity)  throws DbException;

    void delete(Class entityType) throws DbException;

    void delete(Class entityType, WhereBuilder whereBuilder) throws DbException;

    ///////////// update
    void update(Object entity, String... updateColumnNames) throws DbException;

    void update(Object entity, WhereBuilder whereBuilder, String... updateColumnNames) throws DbException;

    ///////////// find
     T findById(Class entityType, Object idValue)  throws DbException;

     T findFirst(Class entityType) throws DbException;

     List findAll(Class entityType) throws DbException;

     Selector selector(Class entityType)  throws DbException;

    DbModel findDbModelFirst(SqlInfo sqlInfo) throws DbException;

    List findDbModelAll(SqlInfo sqlInfo)  throws DbException;

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

    /**
     * 删除表
     *
     * @param entityType
     * @throws DbException
     */
    void dropTable(Class entityType) throws DbException;

    /**
     * 添加一列,
     * 新的entityType中必须定义了这个列的属性.
     *
     * @param entityType
     * @param column
     * @throws DbException
     */
    void addColumn(Class entityType, String column) throws DbException;

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

    /**
     * 删除库
     *
     * @throws DbException
     */
    void dropDb()  throws DbException;

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

    ///////////// custom
    void execNonQuery(SqlInfo sqlInfo) throws DbException;

    void execNonQuery(String sql)  throws DbException;

    Cursor execQuery(SqlInfo sqlInfo) throws DbException;

    Cursor execQuery(String sql) throws DbException;
}

public interface DbManager extends Closeable {

    DaoConfig getDaoConfig();

    SQLiteDatabase getDatabase();

    /**
     * 保存实体类或实体类的List到数据库,
     * 如果该类型的id是自动生成的, 则保存完后会给id赋值.
     *
     * @param entity
     * @return
     * @throws DbException
     */
    boolean saveBindingId(Object entity) throws DbException;

    /**
     * 保存或更新实体类或实体类的List到数据库, 根据id对应的数据是否存在.
     *
     * @param entity
     * @throws DbException
     */
    void saveOrUpdate(Object entity) throws DbException;

    /**
     * 保存实体类或实体类的List到数据库
     *
     * @param entity
     * @throws DbException
     */
    void save(Object entity) throws DbException;

    /**
     * 保存或更新实体类或实体类的List到数据库, 根据id和其他唯一索引判断数据是否存在.
     *
     * @param entity
     * @throws DbException
     */
    void replace(Object entity) throws DbException;

    ///////////// delete
    void deleteById(Class entityType, Object idValue) throws DbException;

    void delete(Object entity) throws DbException;

    void delete(Class entityType) throws DbException;

    void delete(Class entityType, WhereBuilder whereBuilder) throws DbException;

    ///////////// update
    void update(Object entity, String... updateColumnNames) throws DbException;

    void update(Object entity, WhereBuilder whereBuilder, String... updateColumnNames) throws DbException;

    ///////////// find
     T findById(Class entityType, Object idValue) throws DbException;

     T findFirst(Class entityType) throws DbException;

     List findAll(Class entityType) throws DbException;

     Selector selector(Class entityType) throws DbException;

    DbModel findDbModelFirst(SqlInfo sqlInfo) throws DbException;

    List findDbModelAll(SqlInfo sqlInfo) throws DbException;

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

    /**
     * 删除表
     *
     * @param entityType
     * @throws DbException
     */
    void dropTable(Class entityType) throws DbException;

    /**
     * 添加一列,
     * 新的entityType中必须定义了这个列的属性.
     *
     * @param entityType
     * @param column
     * @throws DbException
     */
    void addColumn(Class entityType, String column) throws DbException;

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

    /**
     * 删除库
     *
     * @throws DbException
     */
    void dropDb() throws DbException;

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

    ///////////// custom
    void execNonQuery(SqlInfo sqlInfo) throws DbException;

    void execNonQuery(String sql) throws DbException;

    Cursor execQuery(SqlInfo sqlInfo) throws DbException;

    Cursor execQuery(String sql) throws DbException;
}

通过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 删除数据库

插入操作

"font-size:18px;">private void insert() {
        try {
            PersonTable person=new PersonTable();
            person.setName("小丽");
            person.setAge(19);
            person.setSex("woman");
            person.setSalary(4000);
            db.save(person);
          //db.saveOrUpdate(person);
          //db.saveBindingId(person);
        } catch (DbException e) {
            e.printStackTrace();
        }
    }

private void insert() {
        try {
            PersonTable person=new PersonTable();
            person.setName("小丽");
            person.setAge(19);
            person.setSex("woman");
            person.setSalary(4000);
            db.save(person);
          //db.saveOrUpdate(person);
          //db.saveBindingId(person);
        } catch (DbException e) {
            e.printStackTrace();
        }
    }

结果如下:

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

查询操作

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

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

private void query(){
        try {
            PersonTable person = db.findById(PersonTable.class, "2");
            Log.e("person",person.toString());
        } catch (DbException e) {
            e.printStackTrace();
        }
    }

private void query(){
        try {
            PersonTable person = db.findById(PersonTable.class, "2");
            Log.e("person",person.toString());
        } catch (DbException e) {
            e.printStackTrace();
        }
    }

结果如下:

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

private void query() {
        try {
            PersonTable person = db.findFirst(PersonTable.class);
            Log.e("person", person.toString());
        } catch (DbException e) {
            e.printStackTrace();
        }
    }

private void query() {
        try {
            PersonTable person = db.findFirst(PersonTable.class);
            Log.e("person", person.toString());
        } catch (DbException e) {
            e.printStackTrace();
        }
    }

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

private void query() {
        try {
            List persons = db.findAll(PersonTable.class);
            Log.e("persons", persons.toString());
        } catch (DbException e) {
            e.printStackTrace();
        }
    }

private void query() {
        try {
            List persons = db.findAll(PersonTable.class);
            Log.e("persons", persons.toString());
        } catch (DbException e) {
            e.printStackTrace();
        }
    }

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

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

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

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

public final class DbModel {

    /**
     * key: columnName
     * value: valueStr
     */
    private HashMap dataMap = new HashMap();

    public String getString(String columnName) {
        return dataMap.get(columnName);
    }

    public int getInt(String columnName) {
        return Integer.valueOf(dataMap.get(columnName));
    }

    public boolean getBoolean(String columnName) {
        String value = dataMap.get(columnName);
        if (value !=  null) {
            return value.length() == 1 ? "1".equals(value) : Boolean.valueOf(value);
        }
        return false;
    }

    public double getDouble(String columnName) {
        return Double.valueOf(dataMap.get(columnName));
    }

    public float getFloat(String columnName) {
        return Float.valueOf(dataMap.get(columnName));
    }

    public long getLong(String columnName) {
        return Long.valueOf(dataMap.get(columnName));
    }

    public Date getDate(String columnName) {
        long date = Long.valueOf(dataMap.get(columnName));
        return new Date(date);
    }

    public java.sql.Date getSqlDate(String columnName) {
        long date = Long.valueOf(dataMap.get(columnName));
        return new java.sql.Date(date);
    }

    public void add(String columnName, String valueStr) {
        dataMap.put(columnName, valueStr);
    }

    /**
     * @return key: columnName
     */
    public HashMap getDataMap() {
        return dataMap;
    }

    /**
     * @param columnName
     * @return
     */
    public boolean isEmpty(String columnName) {
        return TextUtils.isEmpty(dataMap.get(columnName));
    }
}

public final class DbModel {

    /**
     * key: columnName
     * value: valueStr
     */
    private HashMap dataMap = new HashMap();

    public String getString(String columnName) {
        return dataMap.get(columnName);
    }

    public int getInt(String columnName) {
        return Integer.valueOf(dataMap.get(columnName));
    }

    public boolean getBoolean(String columnName) {
        String value = dataMap.get(columnName);
        if (value != null) {
            return value.length() == 1 ? "1".equals(value) : Boolean.valueOf(value);
        }
        return false;
    }

    public double getDouble(String columnName) {
        return Double.valueOf(dataMap.get(columnName));
    }

    public float getFloat(String columnName) {
        return Float.valueOf(dataMap.get(columnName));
    }

    public long getLong(String columnName) {
        return Long.valueOf(dataMap.get(columnName));
    }

    public Date getDate(String columnName) {
        long date = Long.valueOf(dataMap.get(columnName));
        return new Date(date);
    }

    public java.sql.Date getSqlDate(String columnName) {
        long date = Long.valueOf(dataMap.get(columnName));
        return new java.sql.Date(date);
    }

    public void add(String columnName, String valueStr) {
        dataMap.put(columnName, valueStr);
    }

    /**
     * @return key: columnName
     */
    public HashMap getDataMap() {
        return dataMap;
    }

    /**
     * @param columnName
     * @return
     */
    public boolean isEmpty(String columnName) {
        return TextUtils.isEmpty(dataMap.get(columnName));
    }
}

 

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

private void query() {
        try {
            DbModel model = db.findDbModelFirst(new SqlInfo("select * from person"));
            Log.e("age", model.getString("age"));
        } catch (DbException e) {
            e.printStackTrace();
        }
    }

private void query() {
        try {
            DbModel model = db.findDbModelFirst(new SqlInfo("select * from person"));
            Log.e("age", model.getString("age"));
        } catch (DbException e) {
            e.printStackTrace(); 
        }
    }

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

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

private void query() {
        try {
            List persons = db.findDbModelAll(new SqlInfo("select * from person where age > 25"));
            for(DbModel person:persons){
                Log.e("name", person.getString("name"));
            }
        } catch (DbException e) {
            e.printStackTrace();
        }
    }

private void query() {
        try {
            List persons = db.findDbModelAll(new SqlInfo("select * from person where age > 25"));
            for(DbModel person:persons){
                Log.e("name", person.getString("name"));
            }
        } catch (DbException e) {
            e.printStackTrace();
        }
    }

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

修改操作

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

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

private void update() {
        try{
            PersonTable person = db.findById(PersonTable.class, 1);
            person.setAge(25);
            db.update(person, "age");
        }catch(Exception e){
            e.printStackTrace();
        }
    }

private void update() {
        try{
            PersonTable person = db.findById(PersonTable.class, 1);
            person.setAge(25);
            db.update(person, "age");
        }catch(Exception e){
            e.printStackTrace();
        }
    }

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

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

private void update() {
        try {
            List persons = db.findAll(PersonTable.class);
            for(PersonTable person:persons){
                person.setSalary(6000);
                db.update(person, WhereBuilder.b("sex", "=", "man"), "salary");
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }

private void update() {
        try {
            List persons = db.findAll(PersonTable.class);
            for(PersonTable person:persons){
                person.setSalary(6000);
                db.update(person, WhereBuilder.b("sex", "=", "man"), "salary");
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }

 

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

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

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

删除操作

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

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

private void delete() {
        try {
            db.deleteById(PersonTable.class, 5);
        } catch (DbException e) {
            e.printStackTrace();
        }
    }

private void delete() {
        try {
            db.deleteById(PersonTable.class, 5);
        } catch (DbException e) {
            e.printStackTrace();
        }
    }

 

结果如下:

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

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

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

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

private void delete() {
        try {
            db.delete(PersonTable.class);
        } catch (DbException e) {
            e.printStackTrace();
        }
    }

private void delete() {
        try {
            db.delete(PersonTable.class);
        } catch (DbException e) {
            e.printStackTrace(); 
        }
    }

 

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

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

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

5.dropTable(Class entityType)

该方法是用来删除表

private void delete() {
        try {
            db.dropTable(PersonTable.class);
        } catch (DbException e) {
            e.printStackTrace();
        }
    }

private void delete() {
        try {
            db.dropTable(PersonTable.class);
        } catch (DbException e) {
            e.printStackTrace();
        }
    }

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

db.dropDb();

db.dropDb();

 

其他方法

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

@Table(name="person")
public class PersonTable {
    @Column(name="id",isId=true,autoGen=true)
    private int id;
    //姓名
    @Column(name="name")
    private String name;

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

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

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

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

    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 getSex() {
        return sex;
    }

    public void setSex(String sex) {
        this.sex =  sex;
    }

    public int getAge() {
        return age;
    }

    public void setAge(int age) {
        this.age =  age;
    }


    public int getSalary() {
        return salary;
    }

    public void setSalary(int salary) {
        this.salary = salary;
    }

    public String getCountry() {
        return country;
    }

    public void setCountry(String country) {
        this.country = country;
    }

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

@Table(name="person")
public class PersonTable {
    @Column(name="id",isId=true,autoGen=true)
    private int id;
    //姓名
    @Column(name="name")
    private String name;

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

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

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

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

    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 getSex() {
        return sex;
    }

    public void setSex(String sex) {
        this.sex = sex;
    }

    public int getAge() {
        return age;
    }

    public void setAge(int age) {
        this.age = age;
    }


    public int getSalary() {
        return salary;
    }

    public void setSalary(int salary) {
        this.salary = salary;
    }

    public String getCountry() {
        return country;
    }

    public void setCountry(String country) {
        this.country = country;
    }

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

 

private void addColumn() {
        try {
            db.addColumn(PersonTable.class, "country");
        } catch (DbException e) {
            e.printStackTrace();
        }
    }

private void addColumn() {
        try {
            db.addColumn(PersonTable.class, "country");
        } catch (DbException e) {
            e.printStackTrace();
        }
    }

 

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

总结

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