JarCasting1. easy-http 是什么
是否还在为如何写http/https请求而烦恼。是否有想过能有一个包能帮你屏蔽掉一切细节，让你能够专心的应付自己的业务逻辑 那么easy-http正是为了帮你解决这些问题而出现的。
你只需要简单的定义一个接口，标注一下请求方式，就能帮你实现网络请求了。
2. 如何使用
看个简单的例子：
2.1 get请求
- 启动类似加@EnableApi(basePackages = {"com.github.cnzhoutao.api"}) 注解，并标明定义的api所在的路径
- 定义接口，接口上申明需要请求的接口的信息，不需要实现
import com.github.easy_http.annotation.Api;
import org.springframework.web.bind.annotation.GetMapping;
/**
* @author zt
* @Date: 2021/2/10 10:30 上午
*/
@Api(url = "", hostName = "www.jianshu.com", https = true)
public interface JianShuApi {
@GetMapping(value = "/")
String indexPage();
}
- 调用
package com.github.cnzhoutao;
import com.github.cnzhoutao.api.JianShuApi;
import org.junit.jupiter.api.Test;
import org.springframework.boot.test.context.SpringBootTest;
import javax.annotation.Resource;
@SpringBootTest
class EasyHttpTestApplicationTests {
@Resource
private JianShuApi jianShuApi;
@Test
public void testJianshu() {
String s = jianShuApi.indexPage();
System.out.println(s);
}
}
-
返回结果
2.2 post请求
-
先来个controller吧,实现一个简单的登录功能
package com.github.cnzhoutao.controller; import com.github.cnzhoutao.dto.UserDTO; import org.springframework.web.bind.annotation.PostMapping; import org.springframework.web.bind.annotation.RequestBody; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RestController; /** * @author zt * @Date: 2021/2/10 12:04 下午 */ @RestController @RequestMapping(value = "/test") public class LoginController { @PostMapping(value = "/login") public String login(@RequestBody UserDTO userDTO) { System.out.println("接收到登录请求:用户名:" + userDTO.getUserName() + "----密码：" + userDTO.getPwd()); return "{\"res\":\"登录成功\"}"; } }
-
UserDTO
package com.github.cnzhoutao.dto; import lombok.AllArgsConstructor; import lombok.Data; import lombok.NoArgsConstructor; import lombok.experimental.Accessors; import java.io.Serializable; /** * @author zt * @Date: 2021/2/10 12:05 下午 */ @Data @Accessors(chain = true) @AllArgsConstructor @NoArgsConstructor public class UserDTO implements Serializable { //用户名 private String userName; //密码 private String pwd; }
-
api接口定义
package com.github.cnzhoutao.api; import com.github.cnzhoutao.dto.UserDTO; import com.github.easy_http.annotation.Api; import org.springframework.web.bind.annotation.PostMapping; import org.springframework.web.bind.annotation.RequestBody; /** * @author zt * @Date: 2021/2/10 12:08 下午 */ @Api(url = "/test", hostName = "127.0.0.1:8080", https = false) public interface LoginApi { @PostMapping(value = "/login") String login(@RequestBody UserDTO userDTO); }
-
单元测试
package com.github.cnzhoutao; import com.github.cnzhoutao.api.JianShuApi; import com.github.cnzhoutao.api.LoginApi; import com.github.cnzhoutao.dto.UserDTO; import org.junit.jupiter.api.Test; import org.springframework.boot.test.context.SpringBootTest; import javax.annotation.Resource; @SpringBootTest class EasyHttpTestApplicationTests { @Resource private JianShuApi jianShuApi; @Resource private LoginApi loginApi; @Test public void testJianshu() { String s = jianShuApi.indexPage(); System.out.println(s); } @Test public void testLogin(){ UserDTO userDTO=new UserDTO("cnzhoutao","github"); String result = loginApi.login(userDTO); System.out.println(result); } }
-
返回结果
3. header和cookie如何添加
很简单，只需要在需要操作的接口上添加，@CookieHandler 或@HeaderHandler 注解就好了
CookieHandler和HeaderHandler会规格自提供一个map,只需要将想要添加的header或cookie放入相应的map即可
特别注意：因为cookie和header是存放在ThreadLocal中，在api使用结束时，需要手动清理
测试项目地址
https://github.com/cnzhoutao/easy-http-test
依赖
<dependency>
<groupId>com.github.cnzhoutao</groupId>
<artifactId>easy-http</artifactId>
<version> ${latest.version} </version>
</dependency>