XUtils3.0学习笔记（一）

其实九姑娘在上家公司做的项目里有用到XUtils框架，但是九姑娘属于比较懒的类型，好巧不巧那时候上手那个项目的时候项目里已经用上这个框架了，所以九姑娘才被接触了这个框架。不过那时候对XUtils实在没用心去研究，现在有时间了，所以就认真地来研究研究（前话好生硬好啰嗦- -）。所以重点来了，这些学习笔记是九姑娘本人角度的心得和体会，如果有不对的地方，欢迎大家指出哈，一定要指出啊啊啊。

XUtils现在已经更新到3.0了，跟3.0以前的相比，是一次比较大的重构。先附上官网地址点击打开链接（https://github.com/wyouflf/xUtils3）

官方对XUtils3.0的介绍是这样的

 

（一）导入和配置XUtils

Android Studio：gradle构建的时候添加一下依赖就行了

compile 'org.xutils:xutils:3.3.36'

Eclipse：需要下载aar文件，然后取出其中的jar包so文件就好了

下载地址：https://github.com/wyouflf/xUtils3

注：混淆时的配置请参考示例项目sample中的配置。

导入了XUtils之后，我们可以开始在项目中进行配置了。

1）首先我们需要添加以下权限：

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

2）在项目的application中配置XUtils

public class MyApplication extends Application {
    @Override
    public void onCreate() {
        super.onCreate();
        //初始化XUtils
        x.Ext.init(this);
        //日志输出开关打开
        x.Ext.setDebug(true);
    }
}

3）在配置文件中注册application

<application
    android:name=".MyApplication"
    ......>

</application>
 

以上，就已经做好我们项目正式开工前的准备啦。

（二）注解模块

XUtils框架主要包括注解模块、数据库模块、网络模块、图片模块，这里我们先了解注解模块。

1）Activiy

 @ContentView(R.layout.activity_main)
    public class MainActivity extends Activity{
        @ViewInject(R.id.edit_pwd)
        private EditText meidt_pwd;
        @ViewInject(R.id.edit_user_name)
        private EditText medit_Uname;
        @ViewInject(R.id.btn_login)
        private Button mbtn_login;

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

        }
    }

2）fragment

@ContentView(R.layout.activity_main)
public class FragmentTest extends Fragment{
    @Nullable
    @Override
    public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {
        return x.view().inject(this, inflater, container);
    }

    @Override
    public void onActivityCreated(Bundle savedInstanceState) {
        super.onActivityCreated(savedInstanceState);
    }
}

3）设置点击事件

/**
 * 1. 方法必须是private,
 * 2. 方法参数形式必须和type对应的Listener接口一致.
 * 3. 注解参数value支持数组: value={id1, id2, id3}
 * 4. type默认View.OnClickListener.class，故此处可以简化不写，@Event(R.id.bt_main)
 * 5. 其它参数说明见{@link org.xutils.event.annotation.Event}类的说明.
 */
@Event(type = View.OnClickListener.class, value = R.id.btn_login)
private void testOnClickEvent(){

}

@Event(type = View.OnLongClickListener.class, value = R.id.btn_login)
private void testOnLongClickEvent(){

}

 

注：1.注解的成员变量及方法都必须是私有的，否则会无效（除contentView之外）

        2.所有注释的成员变量的使用都必须放在x.view().inject(this)之后，否则程序会崩溃。

 

（三）网络请求模块

XUtils封装了很多网络请求的方法，让开发方便了许多。这里会列出get请求、post请求、其他请求（这里以put请求为例）的使用、下载上传、使用缓存的方法。

（1）get请求

/**
     * get请求
     */
    @Event(R.id.btn_get)
    private void getMethod(){
        RequestParams requestParams = new RequestParams(url);
        Callback.Cancelable cancelable = x.http().get(requestParams, new Callback.CommonCallback<String>() {
            @Override
            public void onSuccess(String result) {
                LogUtil.i("Success", new Throwable("result:" + result));
            }

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

            @Override
            public void onCancelled(CancelledException cex) {
                LogUtil.i("Cancel", new Throwable("取消"));
            }

            @Override
            public void onFinished() {
                LogUtil.i("finish", new Throwable("完成"));
            }
        });
        cancelable.cancel();
    }

（2）post请求

  /**
     * post请求
     */
    @Event(R.id.btn_post)
    private void postMethod(){
        RequestParams requestParams = new RequestParams(url);
        x.http().post(requestParams, new Callback.CommonCallback<String>() {
            @Override
            public void onSuccess(String result) {

            }

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

            }

            @Override
            public void onCancelled(CancelledException cex) {

            }

            @Override
            public void onFinished() {

            }
        });
    }

（3）其他的请求方式（put为例）

  /**
     * put请求
     */
    @Event(R.id.btn_request)
    private void requestMethod(){
        RequestParams requestParams = new RequestParams(url);
        x.http().request(HttpMethod.PUT, requestParams, new Callback.CommonCallback<String>() {
            @Override
            public void onSuccess(String result) {

            }

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

            }

            @Override
            public void onCancelled(CancelledException cex) {

            }

            @Override
            public void onFinished() {

            }
        });
    }

（4）下载文件

<pre style="font-family: 宋体; font-size: 9pt; background-color: rgb(255, 255, 255);"><pre name="code" class="java">/**
     * 下载的方法
     */
    @Event(R.id.btn_download)
    private void downLoadMethod(){
        String url = "http://gdown.baidu.com/data/wisegame/5ca209b5b18ba4bc/didichuxing_156.apk";
        RequestParams requestParams = new RequestParams(url);
        //设置保存路径
        requestParams.setSaveFilePath(Environment.getExternalStorageDirectory() + "/myapp/");
        //自动定义文件名
        requestParams.setAutoRename(true);
        x.http().post(requestParams, new Callback.ProgressCallback<File>() {
            @Override
            public void onSuccess(File result) {
                Intent intent = new Intent(Intent.ACTION_VIEW);
                intent.setDataAndType(Uri.fromFile(result), "application/vnd.android.package-archive");
                startActivity(intent);
            }

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

            @Override
            public void onCancelled(CancelledException cex) {
            }

            @Override
            public void onFinished() {
            }

            /**
             * 网络请求开始之前回调的方法
             */
            @Override
            public void onWaiting() {
            }

            /**
             * 网络请求开始时回调的方法
             */
            @Override
            public void onStarted() {
            }

            /**
             * 下载时不断回调的方法
             * @param total
             * @param current
             * @param isDownloading
             */
            @Override
            public void onLoading(long total, long current, boolean isDownloading) {
                LogUtil.i("当前下载进度：" + current + "  下载文件总大小：" + total + "   是否下载完毕：" + isDownloading);
            }
        });
    }

（5）上传文件

@Event(R.id.btn_upload)
    private void upLoadMethod(){
        String url = "/mnt/sdcard/Download/icon.jpg";
        RequestParams requestParams = new RequestParams(url);
        x.http().post(requestParams, new Callback.CommonCallback<String>() {
            @Override
            public void onSuccess(String result) {
            }

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

            @Override
            public void onCancelled(CancelledException cex) {
            }

            @Override
            public void onFinished() {
            }
        });
    }

（6）缓存

<pre name="code" class="java">     /**
     * 缓存
     */
    @Event(R.id.btn_cache)
    private void cacheMethod(){
        String url = "http://www.android.com";
        RequestParams requestParams = new RequestParams(url);
        //设置缓存时间
        requestParams.setCacheMaxAge(1000*6);
        x.http().get(requestParams, new Callback.CacheCallback<String>() {
            @Override
            public void onSuccess(String result) {
                // 注意: 如果服务返回304或 onCache 选择了信任缓存, 这里将不会被调用,
                // 但是 onFinished 总会被调用.
            }

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

            @Override
            public void onCancelled(CancelledException cex) {
            }

            @Override
            public void onFinished() {
            }

            @Override
            public boolean onCache(String result) {
                //result:缓存内容。但是缓存过期后就不会进入这个方法
                //在setCacheMaxAge设置范围（上面设置的是60秒）内，如果再次调用GET请求，
                //返回true：缓存内容被返回，相信本地缓存，返回false：缓存内容被返回，不相信本地缓存，仍然会请求网络
                Log.i("JAVA","cache："+result);
                return true;
            }
        });
    }

注：以上RequestParams可自行添加参数。

搜索