chore(doc): Polish Javadoc.

src/main/java/io/github/nstdio/http/ext/BodyHandlers.java

@@ -49,6 +49,7 @@ public static <T> BodyHandler<T> ofDecompressing(BodyHandler<T> downstream) {
    *
    * @param targetType The type.
    * @param <T>        The required type.
+   *
    * @return The JSON body handler.
    */
   public static <T> BodyHandler<Supplier<T>> ofJson(Class<T> targetType) {
@@ -75,6 +76,7 @@ public static final class DecompressingBodyHandlerBuilder {
      * Sets whether throw exception when compression directive not supported or not.
      *
      * @param failOnUnsupportedDirectives Whether throw exception when compression directive not supported or not
+     *
      * @return this for fluent chaining.
      */
     public DecompressingBodyHandlerBuilder failOnUnsupportedDirectives(boolean failOnUnsupportedDirectives) {
@@ -86,6 +88,7 @@ public DecompressingBodyHandlerBuilder failOnUnsupportedDirectives(boolean failO
      * Sets whether throw exception when unknown compression directive encountered or not.
      *
      * @param failOnUnknownDirectives Whether throw exception when unknown compression directive encountered or not
+     *
      * @return this for fluent chaining.
      */
     public DecompressingBodyHandlerBuilder failOnUnknownDirectives(boolean failOnUnknownDirectives) {
@@ -113,6 +116,9 @@ public BodyHandler<InputStream> build() {
      * <p>
      * Please use {@link #build()} if {@code downstream} is {@link HttpResponse.BodyHandlers#ofInputStream()}.
      *
+     * @param <T>        The type of the response body.
+     * @param downstream The downstream handler.
+     *
      * @return The builder for decompressing body handler.
      */
     public <T> BodyHandler<T> build(BodyHandler<T> downstream) {

src/main/java/io/github/nstdio/http/ext/ConstrainedCacheBuilder.java

@@ -33,10 +33,10 @@ abstract class ConstrainedCacheBuilder<B extends ConstrainedCacheBuilder<B>> imp
   }
 
   /**
-   * The maximum number of cache entries. After reaching the limit the eldest entries will be evicted. Default is
-   * 8192.
+   * The maximum number of cache entries. After reaching the limit the eldest entries will be evicted. Default is 8192.
    *
    * @param maxItems The maximum number of cache entries. Should be positive.
+   *
    * @return builder itself.
    */
   public B maxItems(int maxItems) {
@@ -52,6 +52,8 @@ public B maxItems(int maxItems) {
    * The amount of bytes allowed to be stored. Negative value means no memory restriction is made. Note that only
    * response body bytes are counted.
    *
+   * @param size The maximum size in bytes. Negative for no size restriction.
+   *
    * @return builder itself.
    */
   public B size(long size) {
@@ -61,10 +63,11 @@ public B size(long size) {
 
   /**
    * Adds given predicate to predicated chain. The calls with requests that did not pass given predicate will not be
-   * subjected to caching facility. Semantically request filter is equivalent to {@code Cache-Control: no-store}
-   * header in request.
+   * subjected to caching facility. Semantically request filter is equivalent to {@code Cache-Control: no-store} header
+   * in request.
    *
    * @param filter The request filter.
+   *
    * @return builder itself.
    */
   public B requestFilter(Predicate<HttpRequest> filter) {
@@ -80,11 +83,12 @@ public B requestFilter(Predicate<HttpRequest> filter) {
   }
 
   /**
-   * Adds given predicate to predicated chain. The calls resulting with response that did not pass given predicate
-   * will not be subjected to caching facility. Semantically response filter is equivalent to {@code Cache-Control:
-   * no-store} header in response.
+   * Adds given predicate to predicated chain. The calls resulting with response that did not pass given predicate will
+   * not be subjected to caching facility. Semantically response filter is equivalent to {@code Cache-Control: no-store}
+   * header in response.
    *
    * @param filter The request filter.
+   *
    * @return builder itself.
    */
   public B responseFilter(Predicate<ResponseInfo> filter) {

src/main/java/io/github/nstdio/http/ext/Predicates.java

@@ -35,6 +35,10 @@ static <T> Predicate<T> alwaysTrue() {
 
   /**
    * The {@code Predicate} that matches {@code HttpRequest}s with given {@code uri}.
+   *
+   * @param uri The uri to match.
+   *
+   * @return The {@code Predicate} that matches {@code HttpRequest}s with given {@code uri}.
    */
   public static Predicate<HttpRequest> uri(URI uri) {
     Objects.requireNonNull(uri);

src/main/java/io/github/nstdio/http/ext/spi/JsonMappingProvider.java

@@ -39,6 +39,8 @@ static JsonMappingProvider provider() {
   /**
    * Finds the {@code JsonMappingProvider} with given name.
    *
+   * @param name The provider fully qualified class name.
+   *
    * @return The {@code JsonMappingProvider} with given name.
    *
    * @throws JsonMappingProviderNotFoundException When requested provider is not found.