之前一直听闻OKHTTP框架,但并未使用过,近期开发一个原生项目,想着就用上吧,上网查询了很多资料,借鉴了很多被人的代码,终于添加上了。为了方便以后使用,特写出来防止自己遗忘。
主要借鉴:https://blog.csdn.net/liu_guizhou/article/details/52953560#
首先是添加网络权限请求:
<uses-permission android:name="android.permission.INTERNET"/>
然后在build.gradle添加第三方库:
compile 'com.squareup.okhttp3:okhttp:3.4.1'
compile 'com.google.code.gson:gson:2.3.1'
compile 'com.github.d-max:spots-dialog:0.7@aar'
操作完成之后,开始真正的框架编写
主要分为OkHttpManager以及BaseCallBack两个类
其中OkHttpManager类主要为网络请求方法。
import android.os.Handler;
import android.os.Looper;
import android.util.Log;
import com.google.gson.Gson;
import com.google.gson.JsonParseException;
import java.io.File;
import java.io.FileOutputStream;
import java.io.IOException;
import java.io.InputStream;
import java.net.FileNameMap;
import java.net.URLConnection;
import java.util.Map;
import java.util.Set;
import java.util.concurrent.TimeUnit;
import okhttp3.Call;
import okhttp3.Callback;
import okhttp3.FormBody;
import okhttp3.Headers;
import okhttp3.MediaType;
import okhttp3.MultipartBody;
import okhttp3.OkHttpClient;
import okhttp3.Request;
import okhttp3.RequestBody;
import okhttp3.Response;
/**
*
*/
public class OkHttpManager {
private static OkHttpManager mOkHttpManager;
private OkHttpClient mOkHttpClient;
private Gson mGson;
private Handler handler;
private OkHttpManager() {
mOkHttpClient = new OkHttpClient();
mOkHttpClient.newBuilder().connectTimeout(10, TimeUnit.SECONDS).readTimeout(10, TimeUnit.SECONDS)
.writeTimeout(10, TimeUnit.SECONDS);
mGson = new Gson();
handler = new Handler(Looper.getMainLooper());
}
//创建 单例模式(OkHttp官方建议如此操作)
public static OkHttpManager getInstance() {
if (mOkHttpManager == null) {
mOkHttpManager = new OkHttpManager();
}
return mOkHttpManager;
}
/***********************
* 对外公布的可调方法
************************/
public void getRequest(String url, final BaseCallBack callBack) {
Request request = buildRequest(url, null, HttpMethodType.GET);
doRequest(request, callBack);
}
public void postRequest(String url, final BaseCallBack callBack, Map<String, String> params) {
Request request = buildRequest(url, params, HttpMethodType.POST);
doRequest(request, callBack);
}
public void postUploadSingleImage(String url, final BaseCallBack callback, File file, String fileKey, Map<String, String> params) {
Param[] paramsArr = fromMapToParams(params);
try {
postAsyn(url, callback, file, fileKey, paramsArr);
} catch (IOException e) {
e.printStackTrace();
}
}
public void postUploadMoreImages(String url, final BaseCallBack callback, File[] files, String[] fileKeys, Map<String, String> params) {
Param[] paramsArr = fromMapToParams(params);
try {
postAsyn(url, callback, files, fileKeys, paramsArr);
} catch (IOException e) {
e.printStackTrace();
}
}
/***********************
* 对内方法
************************/
//单个文件上传请求 不带参数
private void postAsyn(String url, BaseCallBack callback, File file, String fileKey) throws IOException {
Request request = buildMultipartFormRequest(url, new File[]{file}, new String[]{fileKey}, null);
doRequest(request, callback);
}
//单个文件上传请求 带参数
private void postAsyn(String url, BaseCallBack callback, File file, String fileKey, Param... params) throws IOException {
Request request = buildMultipartFormRequest(url, new File[]{file}, new String[]{fileKey}, params);
doRequest(request, callback);
}
//多个文件上传请求 带参数
private void postAsyn(String url, BaseCallBack callback, File[] files, String[] fileKeys, Param... params) throws IOException {
Request request = buildMultipartFormRequest(url, files, fileKeys, params);
doRequest(request, callback);
}
//异步下载文件
public void asynDownloadFile(final String url, final String destFileDir, final BaseCallBack callBack) {
final Request request = buildRequest(url, null, HttpMethodType.GET);
callBack.OnRequestBefore(request); //提示加载框
mOkHttpClient.newCall(request).enqueue(new Callback() {
@Override
public void onFailure(Call call, IOException e) {
callBack.onFailure(call, e);
}
@Override
public void onResponse(Call call, Response response) throws IOException {
// callBack.onResponse(response);
InputStream is = null;
byte[] buf = new byte[1024*2];
final long fileLength = response.body().contentLength();
int len = 0;
long readLength = 0;
FileOutputStream fos = null;
try {
is = response.body().byteStream();
File file = new File(destFileDir, getFileName(url));
fos = new FileOutputStream(file);
while ((len = is.read(buf)) != -1) {
fos.write(buf, 0, len);
readLength += len;
int curProgress = (int) (((float) readLength / fileLength) * 100);
Log.e("lgz", "onResponse: >>>>>>>>>>>>>" + curProgress + ", readLength = " + readLength + ", fileLength = " + fileLength);
callBack.inProgress(curProgress, fileLength, 0);
}
fos.flush();
//如果下载文件成功,第一个参数为文件的绝对路径
callBackSuccess(callBack, call, response, file.getAbsolutePath());
} catch (IOException e) {
callBackError(callBack, call, response.code());
} finally {
try {
if (is != null)
is.close();
} catch (IOException e) {
}
try {
if (fos != null)
fos.close();
} catch (IOException e) {
}
}
}
});
}
//构造上传图片 Request
private Request buildMultipartFormRequest(String url, File[] files, String[] fileKeys, Param[] params) {
params = validateParam(params);
MultipartBody.Builder builder = new MultipartBody.Builder().setType(MultipartBody.FORM);
for (Param param : params) {
builder.addPart(Headers.of("Content-Disposition", "form-data; name=\"" + param.key + "\""),
RequestBody.create(MediaType.parse("image/png"), param.value));
}
if (files != null) {
RequestBody fileBody = null;
for (int i = 0; i < files.length; i++) {
File file = files[i];
String fileName = file.getName();
fileBody = RequestBody.create(MediaType.parse(guessMimeType(fileName)), file);
//TODO 根据文件名设置contentType
builder.addPart(Headers.of("Content-Disposition",
"form-data; name=\"" + fileKeys[i] + "\"; filename=\"" + fileName + "\""),
fileBody);
}
}
RequestBody requestBody = builder.build();
return new Request.Builder()
.url(url)
.post(requestBody)
.build();
}
//Activity页面所有的请求以Activity对象作为tag,可以在onDestory()里面统一取消,this
public void cancelTag(Object tag) {
for (Call call : mOkHttpClient.dispatcher().queuedCalls()) {
if (tag.equals(call.request().tag())) {
call.cancel();
}
}
for (Call call : mOkHttpClient.dispatcher().runningCalls()) {
if (tag.equals(call.request().tag())) {
call.cancel();
}
}
}
private String guessMimeType(String path) {
FileNameMap fileNameMap = URLConnection.getFileNameMap();
String contentTypeFor = fileNameMap.getContentTypeFor(path);
if (contentTypeFor == null) {
contentTypeFor = "application/octet-stream";
}
return contentTypeFor;
}
private String getFileName(String path) {
int separatorIndex = path.lastIndexOf("/");
return (separatorIndex < 0) ? path : path.substring(separatorIndex + 1, path.length());
}
private Param[] fromMapToParams(Map<String, String> params) {
if (params == null)
return new Param[0];
int size = params.size();
Param[] res = new Param[size];
Set<Map.Entry<String, String>> entries = params.entrySet();
int i = 0;
for (Map.Entry<String, String> entry : entries) {
res[i++] = new Param(entry.getKey(), entry.getValue());
}
return res;
}
//去进行网络 异步 请求
private void doRequest(Request request, final BaseCallBack callBack) {
callBack.OnRequestBefore(request);
mOkHttpClient.newCall(request).enqueue(new Callback() {
@Override
public void onFailure(Call call, IOException e) {
callBack.onFailure(call, e);
}
@Override
public void onResponse(Call call, Response response) throws IOException {
callBack.onResponse(response);
String result = response.body().string();
if (response.isSuccessful()) {
if (callBack.mType == String.class) {
// callBack.onSuccess(call, response, result);
callBackSuccess(callBack, call, response, result);
} else {
try {
Object object = mGson.fromJson(result, callBack.mType);//自动转化为 泛型对象
// callBack.onSuccess(call, response, object);
callBackSuccess(callBack, call, response, object);
} catch (JsonParseException e) {
//json解析错误时调用
callBack.onEror(call, response.code(), e);
}
}
} else {
callBack.onEror(call, response.code(), null);
}
}
});
}
//创建 Request对象
private Request buildRequest(String url, Map<String, String> params, HttpMethodType methodType) {
Request.Builder builder = new Request.Builder();
builder.url(url);
if (methodType == HttpMethodType.GET) {
builder.get();
} else if (methodType == HttpMethodType.POST) {
RequestBody requestBody = buildFormData(params);
builder.post(requestBody);
}
return builder.build();
}
//构建请求所需的参数表单
private RequestBody buildFormData(Map<String, String> params) {
FormBody.Builder builder = new FormBody.Builder();
builder.add("platform", "android");
builder.add("version", "1.0");
builder.add("key", "123456");
if (params != null) {
for (Map.Entry<String, String> entry : params.entrySet()) {
builder.add(entry.getKey(), entry.getValue());
}
}
return builder.build();
}
private void callBackSuccess(final BaseCallBack callBack, final Call call, final Response response, final Object object) {
handler.post(new Runnable() {
@Override
public void run() {
callBack.onSuccess(call, response, object);
}
});
}
private void callBackError(final BaseCallBack callBack, final Call call, final int code) {
handler.post(new Runnable() {
@Override
public void run() {
callBack.onEror(call, code, null);
}
});
}
private Param[] validateParam(Param[] params) {
if (params == null)
return new Param[0];
else
return params;
}
public static class Param {
public Param() {
}
public Param(String key, String value) {
this.key = key;
this.value = value;
}
String key;
String value;
}
enum HttpMethodType {
GET, POST
}
}
而BaseCallBack主要是回调函数:
import com.google.gson.internal.$Gson$Types;
import java.io.IOException;
import java.lang.reflect.ParameterizedType;
import java.lang.reflect.Type;
import okhttp3.Call;
import okhttp3.Request;
import okhttp3.Response;
/**
*
*/
public abstract class BaseCallBack<T> {
public Type mType;
static Type getSuperclassTypeParameter(Class<?> subclass) {
Type superclass = subclass.getGenericSuperclass();
if (superclass instanceof Class) {
throw new RuntimeException("Missing type parameter.");
}
ParameterizedType parameterized = (ParameterizedType) superclass;
return $Gson$Types.canonicalize(parameterized.getActualTypeArguments()[0]);
}
public BaseCallBack() {
mType = getSuperclassTypeParameter(getClass());
}
protected abstract void OnRequestBefore(Request request);
protected abstract void onFailure(Call call, IOException e);
protected abstract void onSuccess(Call call, Response response, T t);
protected abstract void onResponse(Response response);
protected abstract void onEror(Call call, int statusCode, Exception e);
protected abstract void inProgress(int progress, long total , int id);
}
当然你也可以根据自己实际情况编写回调函数继承BaseCallBack类。
实际调用时,只要代码为:
OkHttpManager.getInstance().postRequest(Constants.WS_USER_LOGIN, new LoadCallBack<String>(LoginActivity.this) {
@Override
protected void onSuccess(Call call, Response response, String s) {
Log.e("lgz", "onSuccess = " + s);
Toast.makeText(LoginActivity.this, "登录成功!", Toast.LENGTH_LONG).show();
}
@Override
protected void onEror(Call call, int statusCode, Exception e) {
Log.e("lgz", "Exception = " + e.toString());
}
}
, params);
其中的LoadCallBack就是继承BaseCallBack编写的。其中主要添加了一些第三方对话框。