# http-helper

**Repository Path**: durcframework/http-helper

## Basic Information

- **Project Name**: http-helper
- **Description**: http请求工具
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2023-09-11
- **Last Updated**: 2023-09-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: HttpClient, http-helper

## README

# http-helper

一个http请求工具

- maven依赖

```xml
<dependency>
    <groupId>net.oschina.durcframework</groupId>
    <artifactId>http-helper</artifactId>
    <version>1.0.0</version>
</dependency>
```

- 测试用例

```java
/**
 * 普通get请求
 * @throws IOException
 */
@Test
public void get() throws IOException {
    String s = HttpHelper.get("http://localhost:8089/http/get")
            // 添加请求参数
            .parameter("id", "1")
            .parameter("name", "jim")
            .execute()
            .asString();
    System.out.println(s);
}

/**
 * post提交表单
 * @throws IOException
 */
@Test
public void postForm() throws IOException {
    Map<String, Object> form = new HashMap<>();
    form.put("id", 1);
    form.put("name", "tom");
    String s = HttpHelper.postForm("http://localhost:8089/http/postForm", form)
            .execute()
            .asString();
    System.out.println(s);
}

/**
 * post提交表单，并上传文件。multipart
 * @throws IOException
 */
@Test
public void postFormFile() throws IOException {
    Map<String, Object> form = new HashMap<>();
    UploadFile file = new UploadFile("file", "a.txt", "hello world".getBytes());
    form.put("id", 1);
    form.put("name", "tom");
    String s = HttpHelper.postForm("http://localhost:8089/http/postFormFile", form, file)
            .execute()
            .asString();
    System.out.println(s);
}

/**
 * post提交json
 * @throws IOException
 */
@Test
public void postJson() throws IOException {
    Map<String, Object> form = new HashMap<>();
    form.put("id", 1);
    form.put("name", "tom");
    String json = JSON.toJSONString(form);
    String s = HttpHelper.postJson("http://localhost:8089/http/postJson", json)
            .execute()
            .asString();
    System.out.println(s);
}

/**
 * 设置header
 * @throws IOException
 */
@Test
public void setHeader() throws IOException {
    String s = HttpHelper.get("http://localhost:8089/http/header")
            // 设置单个header
            .header("token", "xxx")
            .execute()
            .asString();
    System.out.println(s);

    Map<String, String> headers = new HashMap<>();
    headers.put("token", "bbbb");
    String s2 = HttpHelper.get("http://localhost:8089/http/header")
            // 设置全部header
            .headers(headers)
            .execute()
            .asString();
    System.out.println(s2);
}

/**
 * 返回流
 * @throws IOException
 */
@Test
public void getStream() throws IOException {
    InputStream inputStream = HttpHelper.get("http://localhost:8089/http/stream")
            .execute()
            .asStream();
    String s = IOUtils.toString(inputStream);
    System.out.println(s);
}

/**
 * 获取http状态
 * @throws IOException
 */
@Test
public void getStatus() throws IOException {
    ResponseResult responseResult = HttpHelper.get("http://localhost:8089/http/get")
            .parameter("id", "1")
            .parameter("name", "jim")
            .execute();
    int status = responseResult.getStatus();
    if (status == HttpStatus.SC_OK) {
        System.out.println(responseResult.asString());
    }
}

/**
 * 获取响应头
 * @throws IOException
 */
@Test
public void getHeaders() throws IOException {
    Map<String, Object> form = new HashMap<>();
    form.put("id", 1);
    form.put("name", "tom");
    String json = JSON.toJSONString(form);
    ResponseResult responseResult = HttpHelper.postJson("http://localhost:8089/http/responseHeader", json)
            .execute();
    Map<String, String> headers = responseResult.getHeaders();
    System.out.println(headers.get("code"));
    System.out.println(headers.get("token"));
    System.out.println(responseResult.asString());
}

/**
 * 获取HttpResponse对象
 * @throws IOException
 */
@Test
public void getResponse() throws IOException {
    ResponseResult responseResult = HttpHelper.get("http://localhost:8089/http/get")
            .parameter("id", "1")
            .parameter("name", "jim")
            .execute();
    HttpResponse response = responseResult.getResponse();
    Locale locale = response.getLocale();
    System.out.println(locale);
}

/**
 * 自定义
 * @throws IOException
 */
@Test
public void custom() throws IOException {
    String s = HttpHelper.create()
            .url("http://localhost:8089/http/get")
            .method("get")
            .parameter("id", "1")
            .parameter("name", "jim")
            .header("token", "xx")
            .execute()
            .asString();
    System.out.println(s);

    String json = "{ \"name\": \"Jim\" }";
    String s2 = HttpHelper.create()
            .url("http://localhost:8089/http/postJson")
            .method("POST")
            .header("token", "xx")
            .entity(new StringEntity(json, ContentType.APPLICATION_JSON))
            .execute()
            .asString();
    System.out.println(s2);
}
```