本人推荐使用idea编译器，不建议使用eclipse
以下2种依赖，自行选择一种
1、使用gradle添加依赖
【注：】需要在build.gradle添加jcenter()仓库
compile 'com.circlq:http-api:1.1.5'
2、使用pom文件添加依赖
<dependency>
<groupId>com.circlq</groupId>
<artifactId>http-api</artifactId>
<version>1.1.5</version>
</dependency>
使用pom依赖会有java版本问题，这边截图两张自己看下
image.png
image.png
只需要简单的2步骤就能实现请求。
定义接口
@DealClass(HttpDealMethodImpl.class)
//@DealAll
@NetServiceClass("")
public interface NetService {
/**
* get的简单请求
*/
@GET("https://qybeta.321go.com/api/v1/home/index")
String get(@Query("cid") String cid, @Query("token") String token);
/**
* get请求(URL中带有参数)
*/
@GET("https://qybeta.321go.com/api/{version}/home/index")
String get(@Path("version") String version, @Query("cid") String cid, @Query("token") String token);
/**
* 表单提交
*/
@POST("https://marathonbeta.321go.com/api/v5/assis/user")
String postForm(@Field("token") String token, @Field("auid") String auid, @Field("step") String step, @Field("formId") String formId);
/**
* json提交
*/
@POST("http://public.api.fashionworldcn.com/api/my/login")
String postJson(@Param("mobile") String mobile, @Param("password") String password);
/**
* json 整串提交
*/
@POST("http://public.api.fashionworldcn.com/api/my/login")
String postJson(@Body String json);
/**
* json 实体类提交
*/
@POST("http://public.api.fashionworldcn.com/api/my/login")
String postJson(@Body LoginBuild json);
/**
* 请求跟返回经过统一特殊处理。
*/
@POST("http://a.szy.com:4480/SignManageServer/sign/appHandle")
@Deal
String onDeal(@Field("reqcode") String reqcode, @Param("pageNo") String pageNo, @Param("pageSize") String pageSize, @Param("schoolId") String schoolId);
}
执行请求
/**
* 表单提交
*/
public static void postForm() {
String token = "QpglbXabpgvKa5d1cqjq5Qb6KKldbvz6dmr0AVjXUlljQsVC5gkKA8IkEChX1ssY";
String auid = "2c93e148674de85b01674ebc7e760018";
String step = "2";
String formId = "4f0e43a7c6095adfc0e5b216d9914f9e";
String result = HttpRequest.getNetService().postForm(token, auid, step, formId);
System.out.println("postForm : " + result);
//返回类型支持java实体类，只需要在方法返回类型String换成java实体类，它会自动给你转化成实体类。
}
强大的Json解析器
我们可以看到返回类型支持java实体类跟String类型，但是这边建议使用String类型
然后解析的时候使用JsonUtils类，这是一个强大解析器
直接
int forum_id = JsonUtils.parse(json,Integer.class,"notice","forum_id");
我们可以看到直接解析出第二层forum_id里面的数据，直接转换成int类型，
如果需要转换实体类，直接在第二个参数改成 类名.class ,然后指定那一层就解析那一层数据转化成实体类。
这样是不是很方便。
该例子是以同步请求为demo，如果需要异步请求则看下面的进行下载demo查看
下面讲解下，如何使用。
1、添加依赖
compile 'com.circlq:http-api:1.1.0'
2、定义接口
如一张图，创建一个接口类，下面给一个完整接口定义，包含（get提交，表单提交，json提交，还有统一接口处理）
@DealClass(HttpDealMethodImpl.class)
//@DealAll
@NetServiceClass("")
public interface NetService {
/**
* get的简单请求
*/
@GET("https://qybeta.321go.com/api/v1/home/index")
String get(@Query("cid") String cid, @Query("token") String token);
/**
* get请求(URL中带有参数)
*/
@GET("https://qybeta.321go.com/api/{version}/home/index")
String get(@Path("version") String version, @Query("cid") String cid, @Query("token") String token);
/**
* 表单提交
*/
@POST("https://marathonbeta.321go.com/api/v5/assis/user")
String postForm(@Field("token") String token, @Field("auid") String auid, @Field("step") String step, @Field("formId") String formId);
/**
* json提交
*/
@POST("http://public.api.fashionworldcn.com/api/my/login")
String postJson(@Param("mobile") String mobile, @Param("password") String password);
/**
* json 整串提交
*/
@POST("http://public.api.fashionworldcn.com/api/my/login")
String postJson(@Body String json);
/**
* json 实体类提交
*/
@POST("http://public.api.fashionworldcn.com/api/my/login")
String postJson(@Body LoginBuild json);
/**
* 请求跟返回经过统一特殊处理。
*/
@POST("http://a.szy.com:4480/SignManageServer/sign/appHandle")
@Deal
String onDeal(@Field("reqcode") String reqcode, @Param("pageNo") String pageNo, @Param("pageSize") String pageSize, @Param("schoolId") String schoolId);
}
3、初始化NetService 类
public class HttpRequest {
private static NetService netService;
public static NetService getNetService() {
try {
if (netService == null) {
synchronized (HttpRequest.class) {
if (netService == null) {
netService = (NetService) Class.forName(ElementUtils.getImplName(NetService.class))
.getConstructor().newInstance();
}
}
}
} catch (Exception e) {
e.printStackTrace();
}
return netService;
}
}
4、然后就是用上面的的类直接获取NetService 来调用请求，HttpRequest.getNetService().postForm()
5、注解的使用，我们按照第2点的定义接口的图片按顺序一个个解释，
NetServiceClass
@NetServiceClass("") ： 创建接口类的时候，这句话是必备的，括号里面可以填写你们公司的域名，如：
@NetServiceClass("http://a.szy.com:4480/")
Query
用于retrofit就了解他的用法，就是拼接在url后面的参数，如上图的接口，使用Query后，url变成：
https://qybeta.321go.com/api/v1/home/index?cid=xxxxxx&token=xxxxx
Path
也是跟retrofit 一样，就说我们url的中间有些值是动态的，如图的urlhttps://qybeta.321go.com/api/v1/home/index中的v1是动态的，写法就是把v1写成{version}，然后在参数@Path("version") String version 就可以动态替换了
Field
看注释我们写着表单提交，那就是用于提交表单的字段
Param
这个retrofit 是没有的，看注释是用于json提交，但是只限制一层的json,
Body
@Body String json 就是用于整串的json格式
@Body LoginBuild json 就是json字符串转化成实体类进行，这个可能会很经常使用
Deal，
/**
* 请求跟返回经过统一特殊处理。
*/
@POST("http://a.szy.com:4480/SignManageServer/sign/appHandle")
@Deal
String onDeal(@Field("reqcode")String reqcode,@Param("pageNo") String pageNo, @Param("pageSize") String pageSize, @Param("schoolId") String schoolId);
我们看到最后一个接口，我们有用到@Deal ，@Field ，@Param，是不是很混乱，
我们先来看下我们公司的请求：
我们每个接口都要自带一个Cookies,然后提交是表单提交，然后有固定的值，又有变化的值，然后每个接口都需要，那我岂不是每次写接口的时候，每次都要写这些参数，是不是很复杂，，最关键的body里面的值竟然是json传。这种接口不封装下岂能忍。
我们看到第2点的定义接口图，最上面一行代码，如果不需统一处理，这句话可以不用写，【注意这个类一定要实现HttpDealMethod接口，不然他会提示你报错。】
@DealClass(HttpDealMethodImpl.class)
然后在我们的定义接口的方法，打上@Deal这样的标记，就是代表该接口请求的时候要处理下，如果你需要每个接口都需要处理，那就在类上面打上@DealAll 代表该类下，所以的接口请求，都需要统一处理。
如：
@POST("http://a.szy.com:4480/SignManageServer/sign/appHandle")
@Deal
String onDeal(@Field("reqcode")String reqcode,@Param("pageNo") String pageNo, @Param("pageSize") String pageSize, @Param("schoolId") String schoolId);
@NetServiceClass("")
@DealClass(HttpDealMethodImpl.class)
@DealAll
public interface NetService {
然后我们看下HttpDealMethodImpl类，就实现统一处理的类。
**
* 统一处理方法跟回调
*/
public class HttpDealMethodImpl implements HttpDealMethod {
@Override
public void init(OkHttpClient okHttpClient) {
}
/**
* 处理请求
* 如果处理后，各种字段都有，则会优先表单请求，然后再者json请求
* 注意一定要return dealParams 不然不处理
*/
@Override
public DealParams dealRequest(DealParams dealParams) {
//设置Cookie
Map<String, String> headers = dealParams.getHeaders();
headers.put("Cookie","JSESSIONID=AE7B1C9D73D448EEAECF5EC8363C55B0"
+ ";ClientVersion=6.8.1");
dealParams.setHeaders(headers);
//设置表单参数
Map<String, String> mapField = dealParams.getMapField();
mapField.put("reqcodeversion","6.8");
//获取@Params里的参数，然后设置成json串，设置到表单body里
Map<String, String> mapParams = dealParams.getParams();
JSONObject jb = new JSONObject();
String json = "";
for (Map.Entry<String, String> entry : mapParams.entrySet()) {
try {
jb.put(entry.getKey(), entry.getValue());
} catch (JSONException e) {
}
}
json = jb.toString();
mapField.put("body",json);
dealParams.setMapField(mapField);
return dealParams;
}
/**
* 处理回调,
* 如果要设置返回错误，则new CallBack(-1,"请求失败") ，第一个参数不能为0即可，0代表成功
* 如果要请求成功，直接 new CallBack(json)
* return null 则不做任何处理
*/
@Override
public CallBack dealCallBack(String str) {
String json = null;
try {
JSONObject jsonObject = JSON.parseObject(str);
json = jsonObject.getString("body");
} catch (JSONException e) {
e.printStackTrace();
}
// return new CallBack(-1,"请求失败");
return new CallBack(json);
}
}
我们看到两个实现方法，分别是dealRequest，跟dealCallBack ，处理请求跟处理回调。
我们再去看下我们公司请求图片，需要每个接口添加Cookie
然后我们就在dealRequest里，看到
//设置Cookie
Map<String, String> headers = dealParams.getHeaders();
headers.put("Cookie","JSESSIONID=AE7B1C9D73D448EEAECF5EC8363C55B0"
+ ";ClientVersion=6.8.1");
dealParams.setHeaders(headers);
这样我们就可以为我们需要的接口添加Cookie，然后我们公司接口请求再去看下参数，reqcodeversion是固定，然后直接
//设置表单参数
Map<String, String> mapField = dealParams.getMapField();
mapField.put("reqcodeversion","6.8");
body里面就有的复杂了，我们再来看下是怎么定义接口，跟请求的图片
/**
* 请求跟返回经过统一特殊处理。
*/
@POST("http://a.szy.com:4480/SignManageServer/sign/appHandle")
@Deal
String onDeal(@Field("reqcode")String reqcode,@Param("pageNo") String pageNo, @Param("pageSize") String pageSize, @Param("schoolId") String schoolId);
image.png
我们看到参数里面有2种注解
@Field 跟,@Param
因为我们接口是表单，reqcode是动态变化的
所以@Field("reqcode")String reqcode,只要好理解，然后body里面的是一个json串，
这时候我们就可以使用@Param，这时候的@Param不再是上面解释的那样用于json提交。而是自定义参数，只要你们公司有规律性，那么就可以用@Param，因为你已经设置了统一处理，所以@Param变身为，任意形态的参数。
我们可以看到dealRequest里面dealParams.getParams();获取@Param里的所以字段值，然后循环取出里面的字段，转换成json串，然后添加到body的里面，然后在dealParams.setMapField(mapField);设置表单的值，，这样我们请求不必要写的就不需要写了，，简单的传递几个参数就可以，，具体的逻辑按你们公司的来，这里只是简单的举个我们公司的例子。
dealCallBack
然后还要一个dealCallBack用于处理回调，比如我们可以在这里面统一处理下服务器返回的字段下是正确还是错误，然后取出你指定下的字段值，比如我们公司的，我只取出body里面的参数进行返回，其他参数不需要。
init用于初始化，目前功能暂未开放，下次版本再弄，就是初始化一些参数，比如超时时间之类的设置
哦对了还一个注解忘记讲了，那就是头部，用法就
@GET("https://qybeta.321go.com/api/v1/home/index")
@Headers({"Content-Type:application/json; charset=utf-8"
,"Content-Type:application/json; charset=utf-8"})
String get(@Query("cid") String cid, @Query("token") String token);
如果是动态的话那就是，弄在参数里面
@GET("https://qybeta.321go.com/api/v1/home/index")
String get(@Header("Content-Type")String headType, @Query("cid") String cid, @Query("token") String token);
如果不需要同步，需要异步的话，那就是吧String返回类型改成void类型，添加参数DataCallBack callBack
如：
@POST("https://marathonbeta.321go.com/api/v5/assis/user")
void postForm(@Field("token") String token, @Field("auid") String auid, @Field("step") String step, @Field("formId") String formId,DataCallBack callBack);
网友评论