【UniHttp系列】Java开源第三方接口对接框架先容
前言从企业级项目来说，如果你项目里还在用传统的编程式Http客户端比如HttpClient、Okhttp去直接对接第三方Http接口，
那么你项目一定充斥着大量的对接逻辑和代码， 并且针对不同的对接渠道方需要每次封装一次调用的简化，
一旦封装不好系统将会变得难以维护，难以阅读， 甚至不同的开发同学会用自己的方式用不同的Http客户端用不同的封装逻辑去对接接口，
这种情况一般发生于项目换了维护者，技术负责人也没把控代码质量和规范所导致
如果你的项目里也存在这样的题目大概需要办理这样的题目, 那么UniHttp就是你的版本答案。
2、快速开始
2.1、引入依赖
<dependency>
<groupId>io.github.burukeyou</groupId>
<artifactId>uniapi-http</artifactId>
<version>0.0.4</version>
</dependency>2.2、对接接口
首先随便创建一个接口，然后在接口上标记@HttpApi注解，然后指定哀求的域名url, 然后就可以在方法上去设置对接哪个接口。
比如下面两个方法的设置则对接了以下两个接口
GET http://localhost:8080/getUser和
POST http://localhost:8080/addUser
方法返回值界说成Http响应body对应的类型即可，默认会利用fastjson反序列化Http响应body的值为该类型对象。
@HttpApi(url = "http://localhost:8080")
interface UserHttpApi {
@GetHttpInterface("/getUser")
BaseRsp<String> getUser(@QueryPar("name") String param,@HeaderPar("userId") Integer id);
@PostHttpInterface("/addUser")
BaseRsp<Add4DTO> addUser(@BodyJsonPar Add4DTO req);
}@QueryPar 表现将参数值放到Http哀求的查询参数内
@HeaderPar 表现将参数值放到Http哀求的哀求头里
@BodyJsonPar 表现将参数值放到Http哀求body内，并且content-type是application/json
1、getUser方法最终构建的Http哀求报文为
GET http://localhost:8080/getUser?name=param
Header:
userId: id2、addUser最终构建的Http哀求报文为
POST:http://localhost:8080/addUser
Header:
Content-Type: application/json
Body:
{"id":1,"name":"jay"}2.3、声明界说的HttpAPI的包扫描路径
在spring的设置类上利用@UniAPIScan注解标记界说的@HttpAPI的包扫描路径,会自动为标记了@HttpApi接口生成代理对象并且注入到Spring容器中，
之后只需要像利用Spring的其他bean一样，依赖注入利用即可
@UniAPIScan("com.xxx.demo.api")
@SpringBootApplication
public class DemoApplication {
public static void main(String[] args) {
SpringApplication.run(DemoApplication.class,args);
}
}2.4 依赖注入利用即可
这样我们就可以像调用本地方法一样去执行长途PRC的http调用
@Service
class UserAppService {
@Autowired
private UserHttpApi userHttpApi;
public void doSomething(){
userHttpApi.getUser("jay",3);
}
} 最后
gitHub代码地址
新人开源项目，如果觉得项目有效，可以star下再次感谢!
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。
页:
[1]