Skip to content

javaRepository/common-tool-httpapi

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 

Repository files navigation

common-tool-httpapi------java工具类

简易基于http的api请求客户端。不依赖其他库直接使用HttpURLConnection,支持keepalives。支持map和pojo作为请求参数。支持设置header。默认支持tool的_logId日志系统。

#Quick start 1.添加tool的github的repository

<repositories>
    <repository>
        <id>tool-maven-repository</id>
        <url>https://raw.github.com/javaRepository/maven-repository/master/releases</url>
    </repository>
</repositories>

2.添加依赖

<dependency>
    <groupId>common.tool</groupId>
    <artifactId>tool-httpapi</artifactId>
    <version>0.0.6</version>
</dependency>

2.添加import

import static HttpApi.Api;

3.使用

Api().get("http://www.example.org");
or
Api().post("http://www.example.org");

##方法介绍 ###header方法。当发送的请求需要带上header:

Map<String, String> header = new HashMap<String, String>();
header.put("Authorization", "Basic xxx");
Api().header(header).post("http://www.example.org");

###param方法。当请求需要带上参数:
带pojo参数:

public class User{
  private String name;
  ...
}
...
User user = new User();
user.setName("Andy");
Api().param(user).post("http://www.example.org");

带Map参数(推荐:Map<String, Object>):

//普通参数
Map<String, Object> user = new HashMap<>();
user.put("user", "Andy");
Api().param(user).post("http://www.example.org");
//发文件
Map<String, Object> uploadImgParam = new HashMap<>();
uploadImgParam.put("img", new File("~/photo.jpg"));
uploadImgParam.put("fileName", "myphoto");
Api().param(uploadImgParam).post("http:/www.example.org");

#关于tool的_logId的说明 get/post方法默认会添加一个_logId参数到你的header _logId参数来自于MDC,当需要别的线程发送又希望请求带上_logId, 可以手动设置_logId:

Api().logId("a_random_logId").get("http://www.example.org");

#异常:StatusCodeNot200Exception 当请求返回的status code返回的码不在大于等于200,小于400的时候,会抛出一个自定义的运行时异常:StatusCodeNot200Exception

About

简易基于http的api请求

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages