安卓網絡訪問（xUtils3）

xUtils3是安卓網絡訪問的重要庫，基本上的網絡請求所涉及的內容都有集成。筆者將實現xUtils3的簡單使用，包括簡單GET和POST請求、文件上傳、文件下載、圖片顯示。

其主要特性有以下幾點：

①提供異步網絡請求

②支持超大文件（超過2G）上傳

③有了強大的HTTP及其下載緩存的支持，支持文件斷點續傳

④全面的HTTP請求協議支持（GET,POST等）

⑤圖片綁定支持gif（受系統兼容性影響，部分gif文件只能靜態顯示），支持圓角、圓形、方形顯示圖片，支持圖片裁剪，支持自動旋轉

 

初始化工作：

添加依賴

compile 'org.xutils:xutils:3.4.0'

新建初始化類

新建一個類：Xutilsinit，將新建的類放在MainActivity同級目錄下（同一個包下）即可

import org.xutils.x;
class Xutilsinit extends Application {
    @Override
    public void onCreate() {
        super.onCreate();
        x.Ext.init(this);
        x.Ext.setDebug(true);//是否輸出Debug日志
    }
}

必要權限獲取及類聲明

在AndroidManifest.xml，第一個權限為網絡訪問權限，第二個為文件讀寫權限，文件讀寫權限在某些手機上是需要另外手動獲取，否則將影響文件的上傳和下載功能。

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

 

簡單的GET和POST請求實現：

 不用自己另起線程，直接在主線程寫就好了，框架實現了線程訪問。

/設置需要訪問的URL
String url="http://193.112.87.88/library/user_login.php";


//設置post表單數據，以鍵值對設置
RequestParams params =new RequestParams(url);
params.addBodyParameter("account","164");
params.addBodyParameter("password","dong");

//簡單的加載提示框
final ProgressDialog dia=new ProgressDialog(MainActivity.this);
dia.setMessage("東小東加載中……");
dia.show();

//開始網絡訪問
//如果是get請求，則x.http().get(params, new Callback.CommonCallback<String>() 即可
x.http().post(params, new Callback.CommonCallback<String>() {
    @Override
    public void onSuccess(String result) {
        //訪問成功時進入，得到訪問返回的數據
        Toast.makeText(x.app(),"東小東提示獲取的數據為："+ result, Toast.LENGTH_LONG).show();
        System.out.println("獲取到的數據是"+result);

    }

    @Override
    public void onError(Throwable ex, boolean isOnCallback) {
        //請求錯誤進入
        Toast.makeText(x.app(),"東小東提示：請求錯誤", Toast.LENGTH_LONG).show();
        
    }

    @Override
    public void onCancelled(Callback.CancelledException cex) {
     ////主動調用取消請求的回調方法
    }

    @Override
    public void onFinished() {
        //訪問結束時進入，停止加載框
        dia.dismiss();
    }
});

 

POST文件上傳：

利用POST提交表單的形式進行文件上傳，其中params.setMultipart(true);是表示使用二進制的方式上傳數據，需要進行文件上傳時必須加入這句。

//設置需要訪問的URL
 String url="http://193.112.87.55/file1.php";


 //設置post表單數據，以鍵值對設置
 RequestParams params =new RequestParams(url);
 params.setMultipart(true);
 params.addBodyParameter("yzm","112233");

//File filex= new File(Environment.getExternalStorageDirectory()+"/東小東.jpg");
// params.addBodyParameter("img", filex, "multipart/form-data","dongxiaodong.jpg");//其中dongxiaodong.jpg為重命名
 
 //生成文件對象，需要絕對路徑
 File filex= new File(Environment.getExternalStorageDirectory()+"/gg.mp3");
 params.addBodyParameter("img", filex, "multipart/form-data");//保留文件原名


 //簡單的加載提示框
 final ProgressDialog dia=new ProgressDialog(MainActivity.this);
 dia.setMessage("東小東加載中……");
 dia.show();

 //開始網絡訪問
 x.http().post(params, new Callback.CommonCallback<String>() {
     @Override
     public void onSuccess(String result) {
         //訪問成功時進入，得到訪問返回的數據
         Toast.makeText(x.app(),"東小東提示獲取的數據為："+ result, Toast.LENGTH_LONG).show();
         System.out.println("獲取到的數據是"+result);

     }

     @Override
     public void onError(Throwable ex, boolean isOnCallback) {
         //請求錯誤進入
         Toast.makeText(x.app(),"東小東提示：請求錯誤", Toast.LENGTH_LONG).show();

     }

     @Override
     public void onCancelled(Callback.CancelledException cex) {
         ////主動調用取消請求的回調方法
         Toast.makeText(x.app(),"東小東提示：已取消請求", Toast.LENGTH_LONG).show();
     }

     @Override
     public void onFinished() {
         //訪問結束時進入，停止加載框
         Toast.makeText(x.app(),"東小東提示：完成請求", Toast.LENGTH_LONG).show();
         dia.dismiss();
     }
 });

 

文件下載實現：

 文件下載時使用異步任務進行的，其還實現了斷點續傳功能，觀看下載文件夾可了解到下載時會自動生成一個緩存文件存放下載內容。基本判斷應該是下次下載時會將下載文件與緩存文件進行對比，而實現斷點續傳功能。

private void downloadUpdateApk() {
    if (Environment.getExternalStorageState().equals(Environment.MEDIA_MOUNTED)) {

        //簡單的加載提示框
        final ProgressDialog dia=new ProgressDialog(MainActivity.this);
        dia.setMessage("東小東馬上下載中........");
        dia.show();
        
        //下載地址
        RequestParams requestParams = new RequestParams("http://193.112.87.88/filexxx/gg.mp3");
        // 文件下載后的保存路徑及文件名
        requestParams.setSaveFilePath(Environment.getExternalStorageDirectory()+"/dongxiaodong/東小東.mp3");
        // 下載完成后自動為文件命名
        requestParams.setAutoRename(false);
        //下載請求
        x.http().get(requestParams, new Callback.ProgressCallback<File>() {

            @Override
            public void onSuccess(File result) {
               //倒數第二調用
                Toast.makeText(MainActivity.this,"下載完成",Toast.LENGTH_SHORT).show();
                System.out.println("---------------下載完成---------------------------");
                dia.setMessage("東小東下載完成**");
            }

            @Override
            public void onError(Throwable ex, boolean isOnCallback) {
                Toast.makeText(MainActivity.this,"下載失敗",Toast.LENGTH_SHORT).show();
                System.out.println("---------------下載失敗---------------------------");

            }

            @Override
            public void onCancelled(CancelledException cex) {

                Toast.makeText(MainActivity.this,"取消下載",Toast.LENGTH_SHORT).show();
                System.out.println("---------------取消下載---------------------------");
            }

            @Override
            public void onFinished() {
                //最后調用
                Toast.makeText(MainActivity.this,"下載結束",Toast.LENGTH_SHORT).show();
                System.out.println("---------------下載結束---------------------------");
                dia.dismiss();

            }

            @Override
            public void onWaiting() {
                // 最開始調用
                Toast.makeText(MainActivity.this,"等待下載",Toast.LENGTH_SHORT).show();
                System.out.println("---------------等待下載---------------------------");

            }

            @Override
            public void onStarted() {
                //第二調用
                Toast.makeText(MainActivity.this,"開始下載",Toast.LENGTH_SHORT).show();
                System.out.println("---------------開始下載---------------------------");
                dia.setMessage("東小東下載開始----");
            }

            @Override
            public void onLoading(long total, long current, boolean isDownloading) {
                // 當前的下載進度和文件總大小
                // 下載的時候不斷回調的方法
                //參數：總大小，已經下載的大小，是否正在下載
                System.out.println("***"+total+"********"+current+"****************"+isDownloading+"**********");
                //百分比為整數
                System.out.println("下載進度為："+(int)(((float)current/total)*100)+"%");
                //百分比為小數
                dia.setMessage("東小東下載進度為："+((float)current/total)*100+"%");

            }
        });
    }

}

 

 圖片顯示：

 ImageOptions是強大的網絡圖片加載顯示的工具類，可以實現圖片的緩存、圖片的直角、圓角、圓形顯示及圖片的裁剪，另外還支持gif動態顯示。

顯示效果

 圖片顯示封裝類

import android.widget.ImageView;
import org.xutils.common.util.DensityUtil;
import org.xutils.image.ImageOptions;
import org.xutils.x;

/**
 * Created by 東東 on 2018/12/29.
 */
public class ShowImage {

   //顯示默認圖片，參數（圖片控件，圖片地址），地址可為網絡或本地地址
    public static void displaydDfault(ImageView imageView, String iconUrl) {
        ImageOptions imageOptions = new ImageOptions.Builder()
                .setIgnoreGif(false)//是否忽略gif圖。false表示不忽略。不寫這句，默認是true
                .setImageScaleType(ImageView.ScaleType.CENTER_CROP)
                .setIgnoreGif(false)//是否忽略gif圖,false表示不忽略,不寫這句，默認是true
                .setUseMemCache(true)//是否支持緩存
                .setFailureDrawableId(R.mipmap.ic_launcher)//設置加載失敗顯示的圖片
                .setLoadingDrawableId(R.mipmap.ic_launcher)//設置加載中顯示的圖片
                .build();
        x.image().bind(imageView, iconUrl,imageOptions);
    }

    //顯示圓角圖片，參數（圖片控件，圓角半徑，圖片地址），地址可為網絡或本地地址
    //圓角半徑，100為圓形
    public static void displayCutR(ImageView imageView, int radius, String iconUrl) {
        ImageOptions imageOptions = new ImageOptions.Builder()
                // .setSize(DensityUtil.dip2px(120), DensityUtil.dip2px(120))//圖片大小
                .setImageScaleType(ImageView.ScaleType.CENTER_CROP)
                .setRadius(DensityUtil.dip2px(radius))
                .setIgnoreGif(false)//是否忽略gif圖,false表示不忽略,不寫這句，默認是true
                .setCrop(true)//是否對圖片進行裁剪
                .setFailureDrawableId(R.mipmap.ic_launcher)
                .setLoadingDrawableId(R.mipmap.ic_launcher)
                .build();
        x.image().bind(imageView, iconUrl, imageOptions);
    }


    //顯示圓形圖片，參數（圖片控件，圖片地址），地址可為網絡或本地地址
    public static void displayRoundness(ImageView imageView, String iconUrl) {
        ImageOptions imageOptions = new ImageOptions.Builder()
                .setImageScaleType(ImageView.ScaleType.CENTER_CROP)
                .setCircular(true)//顯示圓形，半徑根據控件控制
                .setCrop(true)
                .setIgnoreGif(false)//是否忽略gif圖,false表示不忽略,不寫這句，默認是true
                .setLoadingDrawableId(R.mipmap.ic_launcher)
                .setFailureDrawableId(R.mipmap.ic_launcher)
                .build();
        x.image().bind(imageView, iconUrl, imageOptions);
    }
}

在需要顯示中使用

//圖片地址
String urlx="https://timgsa.baidu.com/timg?image&quality=80&size=b9999_10000&sec=1546085784363&di=8ab50ca92e77dcc09ef658b636872f51&imgtype=0&src=http%3A%2F%2Fi0.bbs.fd.zol-img.com.cn%2Ft_s800x5000%2Fg5%2FM00%2F0D%2F05%2FChMkJlnHskGIC8gjAAJBAWB0pxwAAgwNgI_jqMAAkEZ946.jpg";

//找到imgview控件
main_img1=(ImageView)findViewById(R.id.main_img1);
//傳遞參數，顯示圖片到控件上
ShowImage.displaydDfault(main_img1,urlx);

main_img2=(ImageView)findViewById(R.id.main_img2);
ShowImage.displayCutR(main_img2,30,urlx);


main_img3=(ImageView)findViewById(R.id.main_img3);
ShowImage.displayRoundness(main_img3,urlx);

 

 

---

 參考：

https://github.com/wyouflf/xUtils3

https://blog.csdn.net/u014620028/article/details/51063377