OkHttp基本用法
URL和Uri
- 所属的包不同。URI位置在java.net.URI,显然是Java提供的一个类。而Uri位置在android.net.Uri,是由Android提供的一个类。所以初步可以判断,Uri是URI的“扩展”以适应Android系统的需要。
- 作用的不同。URI类代表了一个URI(这个URI不是类,而是其本来的意义:通用资源标志符——Uniform Resource Identifier)实例。官方文档Uri类是一个不可改变的URI引用,包括一个URI和一些碎片,碎片时跟在URI中“#”后面的部分。建立并且转换URI引用。出于对性能的考虑Uri类对无效的行为不敏感,对于无效的输入没有定义相应的行为,如果没有另外制定,它将返回垃圾而不是抛出一个异常。
综上所述,Uri是Android开发的,扩展了Java中URI的一些功能来特定的适用于Android开发。参考自Uri详解之——Uri结构与代码提取
那什么时候需要用到java.net.URL呢。当需要访问某个网页时,例如https://www.baidu.com,这就是URL。这里有一篇值得阅读的博客关于URL编码
fragment,用于聚焦到资源的某部分。
OkHttp基础用法
OkHttp是一款优秀的HTTP框架,它支持get请求和post请求,支持基于Http的文件上传和下载,支持加载图片,支持下载文件透明的GZIP压缩,支持响应缓存避免重复的网络请求,支持使用连接池来降低响应延迟问题。
配置OkHttp
AndroidStudio可以通过从Maven下载jar包。在build.gradle(app)中构建,
dependencies {
compile fileTree(include: ['*.jar'], dir: 'libs')
testCompile 'junit:junit:4.12'
compile 'com.android.support:appcompat-v7:23.4.0'
compile 'com.nostra13.universalimageloader:universal-image-loader:1.9.5'
compile 'com.squareup.okhttp3:okhttp:3.4.1'
compile 'com.squareup.okio:okio:1.11.0'
}
由于okhttp内部依赖okio,所以同时导入okio。
关键类
OkHttpClient,Request,RequestBody,Call,Callback,Response,ResponseBody
Http Get
//创建okHttpClient对象
OkHttpClient mOkHttpClient = new OkHttpClient();
//创建一个Request
final Request request = new Request.Builder()
.url("https://github.com/hongyangAndroid")
.build();
//new call
Call call = mOkHttpClient.newCall(request);
//请求加入调度
call.enqueue(new Callback()
{
@Override
public void onFailure(Request request, IOException e)
{
}
@Override
public void onResponse(final Response response) throws IOException
{
//String htmlStr = response.body().string();
}
});
代码分析:
- 首先实例化一个OkHttpClient对象,OkHttp官方文档并不建议我们创建多个OkHttpClient,因此全局使用一个。
- 创建一个请求(Request),可以通过RequestBuilder来设置参数,例如header,method。但是至少有一个URL
- 通过request的对象去构造得到一个Call对象,类似于将你的请求封装成了任务,既然是任务,就会有execute()和cancel()等方法。
- 以异步的方式去执行请求,所以我们调用的是call.enqueue,将call加入调度队列,然后等待任务执行完成,我们在Callback中即可得到结果。
当整个GET成功,我们就回调在onResponse()方法中的方法处理ResponseBody包含的数据。通过response.body()方法得到ResponseBody对象。ResponseBody有几种方式转换返回的数据,
- string(),获得返回的字符串,方法对于小文档来说十分方便、高效。但是如果响应体太大(超过1MB),应避免适应 string()方法 ,因为他会将把整个文档加载到内存中。
- btyes(),返回二进制字节数组。
- byteStream(),返回InputStream。
Call有一个线程阻塞方法,execute()。可以直接调用这个方法返回一个Response。
注意当我们使用Call.execute()方法返回的Response,首先要进行判断是否成功。调用Response.isSuccessful()(Returns true if the code is in [200..300),这里的code指的是Http响应消息的状态码)方法来判断。
Http Post
关键类
MediaType,FormEncodingBuilder
POST提交Json数据
public static final MediaType JSON = MediaType.parse("application/json; charset=utf-8");
OkHttpClient client = new OkHttpClient();
String post(String url, String json) throws IOException {
RequestBody body = RequestBody.create(JSON, json);
Request request = new Request.Builder()
.url(url)
.post(body)
.build();
Response response = client.newCall(request).execute();
f (response.isSuccessful()) {
return response.body().string();
} else {
throw new IOException("Unexpected code " + response);
}
}
使用Request的post方法来提交请求体RequestBody
POST提交键值对
很多时候我们会需要通过POST方式把键值对数据传送到服务器。 OkHttp提供了很方便的方式来做这件事情。
OkHttpClient client = new OkHttpClient();
String post(String url, String json) throws IOException {
RequestBody formBody = new FormEncodingBuilder()
.add("platform", "android")
.add("name", "bug")
.add("subject", "XXXXXXXXXXXXXXX")
.build();
Request request = new Request.Builder()
.url(url)
.post(body)
.build();
Response response = client.newCall(request).execute();
if (response.isSuccessful()) {
return response.body().string();
} else {
throw new IOException("Unexpected code " + response);
}
}
实践
图片的下载
封装OkHttp的GET访问
public static void get(String url, Callback callback) {
URL requestURL = null;
try {
requestURL = new URL(Constant.BASE_URL + url);
} catch (MalformedURLException e) {
e.printStackTrace();
}
Request request = new Request.Builder()
.url(requestURL)
.build();
Call call = mClient.newCall(request);
call.enqueue(callback);
}
public static void getImage(String url, Callback callback) {
Request request = new Request.Builder()
.url(url)
.build();
Call call = mClient.newCall(request);
call.enqueue(callback);
}
调用封装的访问方法
HttpUtil.get(imageUrl, new Callback() {
@Override
public void onFailure(Call call, IOException e) {
e.printStackTrace();
startActivity();
}
@Override
public void onResponse(Call call, Response response) throws IOException {
try {
//获取到真正图片下载URL
JSONObject jsonObject = new JSONObject(response.body().string());
String imageUrl = jsonObject.getString("img");
loadImage(imageUrl, imageFile);
} catch (JSONException e) {
e.printStackTrace();
}
}
});
下载图片并保存
private void loadImage(String url, final File file) {
HttpUtil.getImage(url, new Callback() {
@Override
public void onFailure(Call call, IOException e) {
e.printStackTrace();
startActivity();
}
@Override
public void onResponse(Call call, Response response) throws IOException {
byte[] imageBytes = response.body().bytes();
//保存图片到app私有文件中
saveImage(file, imageBytes);
startActivity();
}
});
}
总结,这里主要思想就是利用ResponseBody.bytes()方法实现图片的下载。
检测网络连接
既然App需要连接网络来下载一些文件,那么应该在下载之前判断用户是否打开数据连接(蜂窝数据,wifi等)。确保连接正常后再进行网络操作。
Internet权限在6.0中属于安全权限,所以只需要在AndroidManifest.xml中申请权限就可以
获取网络状态
获取连接管理对象
// 获取手机所有连接管理对象(包括对wi-fi,net等连接的管理)
Context context = activity.getApplicationContext();
ConnectivityManager connectivityManager = (ConnectivityManager)context.getSystemService(Context.CONNECTIVITY_SERVICE);
获取NetworkInfo对象
NetworkInfo networkInfo = manager.getActiveNetworkInfo();
判断当前连接是否可用
if(networkInfo != null) {
return networkInfo.isAvailable();
}
注意权限
由于需要访问连接状态,所以需要申请安全权限ACCESS_NETWORK_STATE。
问题
ConnectivityManager包含了所有的数据连接,wifi,蜂窝数据,蓝牙...当设备同时有很多数据连接保持连接状态时,怎么判断某一个连接是否可用呢?
杂技
获取屏幕的宽,高像素
DisplayMetrics metrics = getResources().getDisplayMetrics();
int screenWidth = metrics.widthPixels;
int screenHeight = metrics.heightPixels;
网友评论
OkHttpUtils.get().url(url).build().execute(new FileCallBack(Environment.getExternalStorageDirectory().getAbsolutePath(), "BBB") {}这个方法您看行么