net.dongliu.cute.http.body.Bodies Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of xhttp Show documentation
The newest version!
package net.dongliu.cute.http.body;

import net.dongliu.commons.collection.Collections2;
import net.dongliu.cute.http.ContentType;
import net.dongliu.cute.http.MimeType;
import net.dongliu.cute.http.Param;
import net.dongliu.cute.http.json.JsonMarshaller;
import org.checkerframework.checker.nullness.qual.Nullable;

import java.nio.charset.Charset;
import java.nio.file.Path;
import java.util.Collection;
import java.util.List;
import java.util.Map;

import static java.nio.charset.StandardCharsets.UTF_8;
import static java.util.Objects.requireNonNull;

/**
 * Utils method to create body
 */
public class Bodies {

    /**
     * Create request body sending plain text.
     */
    public static Body plainText(String value, Charset charset) {
        return of(value, MimeType.TEXT_PLAIN, charset);
    }

    /**
     * Create octet-stream request body.
     */
    public static Body octetStream(byte[] value) {
        return of(value, MimeType.OCTET_STREAM);
    }

    /**
     * Create octet-stream request body.
     */
    public static Body octetStream(InputSupplier inputSupplier) {
        return of(inputSupplier, MimeType.OCTET_STREAM);
    }

    /**
     * Create octet-stream request body.
     */
    public static Body octetStream(Path path) {
        return of(path, MimeType.OCTET_STREAM);
    }

    /**
     * Create request body sending plain text, with UTF-8 charset.
     */
    public static Body plainText(String value) {
        return plainText(value, UTF_8);
    }

    /**
     * Create request body send x-www-form-encoded data
     */
    public static Body> wwwForm(Collection params, Charset charset) {
        return new FormBody(List.copyOf(requireNonNull(params)), charset);
    }

    /**
     * Create request body send x-www-form-encoded data, with UTF-8 charset.
     */
    public static Body> wwwForm(Collection params) {
        return wwwForm(params, UTF_8);
    }

    /**
     * Create request body send x-www-form-encoded data
     */
    public static Body> wwwForm(Map map, Charset charset) {
        var params = Collections2.convertToList(map.entrySet(), e -> Param.of(e.getKey(), e.getValue()));
        return new FormBody(params, charset);
    }

    /**
     * Create request body send x-www-form-encoded data, with UTF-8 charset.
     */
    public static Body> wwwForm(Map params) {
        return wwwForm(params, UTF_8);
    }

    /**
     * Create request body send x-www-form-encoded data, with UTF-8 charset.
     */
    public static Body> wwwForm(Param... params) {
        requireNonNull(params);
        return new FormBody(List.of(params), UTF_8);
    }

    /**
     * Create multi-part encoded request body, from several Parts.
     */
    public static Body>> multiPart(List> parts) {
        return new MultiPartBody(List.copyOf(requireNonNull(parts)));
    }

    /**
     * Create multi-part encoded request body, from several Parts.
     */
    public static Body>> multiPart(Part... parts) {
        requireNonNull(parts);
        return new MultiPartBody(List.of(parts));
    }

    /**
     * Create a json body
     *
     * @param value the value to marshall to json
     * @param    the value type
     */
    public static <@Nullable T> Body json(T value, Charset charset, JsonMarshaller jsonMarshaller) {
        return new JsonBody<>(value, charset, jsonMarshaller);
    }

    /**
     * Create a json body, with charset utf-8.
     *
     * @param value the value to marshall to json
     * @param    the value type
     */
    public static <@Nullable T> Body json(T value, JsonMarshaller jsonMarshaller) {
        return new JsonBody<>(value, UTF_8, jsonMarshaller);
    }

    /**
     * Create request body from byte array data
     *
     * @param mimeType the mime-type of body
     */
    public static Body of(byte[] value, MimeType mimeType) {
        return new BinaryBody(requireNonNull(value), ContentType.of(mimeType));
    }

    /**
     * Create request body from byte array data
     *
     * @param mimeType the mime-type of body
     * @param charset  the charset encoding of body
     */
    public static Body of(byte[] value, MimeType mimeType, Charset charset) {
        return new BinaryBody(requireNonNull(value), ContentType.of(mimeType, charset));
    }

    /**
     * Create request body send string data using UTF-8 charset.
     *
     * @param mimeType the mime-type of body
     */
    public static Body of(String value, MimeType mimeType) {
        return of(value, mimeType, UTF_8);
    }

    /**
     * Create request body send string data
     *
     * @param mimeType the mime-type of body
     * @param charset  the charset encoding of body
     */
    public static Body of(String value, MimeType mimeType, Charset charset) {
        return new StringBody(requireNonNull(value), ContentType.of(mimeType, charset));
    }

    /**
     * Create request body from input stream.
     *
     * @param mimeType the mime-type of body
     */
    public static Body of(InputSupplier supplier, MimeType mimeType) {
        return new InputStreamBody(requireNonNull(supplier), ContentType.of(mimeType));
    }

    /**
     * Create request body from input stream.
     *
     * @param mimeType the mime-type of body
     * @param charset  the charset encoding of body
     */
    public static Body of(InputSupplier supplier, MimeType mimeType,
                                         Charset charset) {
        return new InputStreamBody(requireNonNull(supplier), ContentType.of(mimeType, charset));
    }

    /**
     * Create request body from file
     *
     * @param mimeType the mime-type of body
     */
    public static Body of(Path path, MimeType mimeType) {
        return new FileBody(requireNonNull(path), ContentType.of(mimeType));
    }

    /**
     * Create request body from file
     *
     * @param mimeType the mime-type of body
     * @param charset  the charset encoding of body
     */
    public static Body of(Path path, MimeType mimeType, Charset charset) {
        return new FileBody(requireNonNull(path), ContentType.of(mimeType, charset));
    }

}