Javadoc: Add missing constructor Javadoc comments

Author: garydgregory

src/main/java/org/apache/commons/io/ByteBuffers.java

@@ -0,0 +1,65 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+package org.apache.commons.io;
+
+import java.nio.ByteBuffer;
+import java.nio.ByteOrder;
+
+/**
+ * Manufactures {@link ByteBuffer} instances.
+ *
+ * @since 2.19.0
+ */
+public class ByteBuffers {
+
+    /**
+     * Allocates a new byte buffer with little-endian byte order. The bytes of a multibyte value are ordered from least significant to most significant.
+     * <p>
+     * The new buffer's position is zero, the limit is its capacity, the mark is undefined, and each of element is initialized to zero. The new buffer has the
+     * given backing {@code array}, and its {@link ByteBuffer#arrayOffset() array offset} is zero.
+     * </p>
+     *
+     * @param array The array that will back the new byte buffer.
+     * @return The new byte buffer.
+     */
+    public static ByteBuffer littleEndian(final byte[] array) {
+        return littleEndian(ByteBuffer.wrap(array));
+    }
+
+    public static ByteBuffer littleEndian(final ByteBuffer allocate) {
+        return allocate.order(ByteOrder.LITTLE_ENDIAN);
+    }
+
+    /**
+     * Allocates a new byte buffer with little-endian byte order. The bytes of a multibyte value are ordered from least significant to most significant.
+     * <p>
+     * The new buffer's position is zero, the limit is its capacity, the mark is undefined, and each of element is initialized to zero. The new buffer has a
+     * {@link ByteBuffer#array() backing array}, and its {@link ByteBuffer#arrayOffset() array offset} is zero.
+     * </p>
+     *
+     * @param capacity The new buffer's capacity, in bytes.
+     * @return The new byte buffer.
+     * @throws IllegalArgumentException If the <code>capacity</code> is negative.
+     */
+    public static ByteBuffer littleEndian(final int capacity) {
+        return littleEndian(ByteBuffer.allocate(capacity));
+    }
+
+}

src/main/java/org/apache/commons/io/filefilter/WildcardFileFilter.java

@@ -98,6 +98,13 @@ public static class Builder extends AbstractSupplier<WildcardFileFilter, Builder
         /** Whether the comparison is case-sensitive. */
         private IOCase ioCase = IOCase.SENSITIVE;
 
+        /**
+         * Constructs a new builder of {@link WildcardFileFilter}.
+         */
+        public Builder() {
+            // empty
+        }
+
         @Override
         public WildcardFileFilter get() {
             return new WildcardFileFilter(ioCase, wildcards);

src/main/java/org/apache/commons/io/input/AbstractInputStream.java

@@ -32,6 +32,13 @@ public abstract class AbstractInputStream extends InputStream {
      */
     private boolean closed;
 
+    /**
+     * Constructs a new instance for subclasses.
+     */
+    public AbstractInputStream() {
+        // empty
+    }
+
     /**
      * Checks if this instance is closed and throws an IOException if so.
      *

src/main/java/org/apache/commons/io/input/AutoCloseInputStream.java

@@ -62,6 +62,13 @@ public class AutoCloseInputStream extends ProxyInputStream {
     // @formatter:on
     public static class Builder extends AbstractBuilder<AutoCloseInputStream, Builder> {
 
+        /**
+         * Constructs a new builder of {@link AutoCloseInputStream}.
+         */
+        public Builder() {
+            // empty
+        }
+
         /**
          * Builds a new {@link AutoCloseInputStream}.
          * <p>

src/main/java/org/apache/commons/io/input/BOMInputStream.java

@@ -141,6 +141,13 @@ static ByteOrderMark getDefaultByteOrderMark() {
 
         private boolean include;
 
+        /**
+         * Constructs a new builder of {@link BOMInputStream}.
+         */
+        public Builder() {
+            // empty
+        }
+
         /**
          * Builds a new {@link BOMInputStream}.
          * <p>

src/main/java/org/apache/commons/io/input/BoundedInputStream.java

@@ -242,6 +242,13 @@ public T setPropagateClose(final boolean propagateClose) {
     //@formatter:on
     public static class Builder extends AbstractBuilder<Builder> {
 
+        /**
+         * Constructs a new builder of {@link BoundedInputStream}.
+         */
+        public Builder() {
+            // empty
+        }
+
         /**
          * Builds a new {@link BoundedInputStream}.
          * <p>

src/main/java/org/apache/commons/io/input/BufferedFileChannelInputStream.java

@@ -75,6 +75,13 @@ public static class Builder extends AbstractStreamBuilder<BufferedFileChannelInp
 
         private FileChannel fileChannel;
 
+        /**
+         * Constructs a new builder of {@link BufferedFileChannelInputStream}.
+         */
+        public Builder() {
+            // empty
+        }
+
         /**
          * Builds a new {@link BufferedFileChannelInputStream}.
          * <p>

src/main/java/org/apache/commons/io/input/CharSequenceInputStream.java

@@ -85,6 +85,13 @@ public static class Builder extends AbstractStreamBuilder<CharSequenceInputStrea
 
         private CharsetEncoder charsetEncoder = newEncoder(getCharset());
 
+        /**
+         * Constructs a new builder of {@link CharSequenceInputStream}.
+         */
+        public Builder() {
+            // empty
+        }
+
         /**
          * Builds a new {@link CharSequenceInputStream}.
          * <p>

src/main/java/org/apache/commons/io/input/ChecksumInputStream.java

@@ -118,6 +118,13 @@ public static class Builder extends AbstractBuilder<ChecksumInputStream, Builder
          */
         private long expectedChecksumValue;
 
+        /**
+         * Constructs a new builder of {@link ChecksumInputStream}.
+         */
+        public Builder() {
+            // empty
+        }
+
         /**
          * Builds a new {@link ChecksumInputStream}.
          * <p>

src/main/java/org/apache/commons/io/input/MemoryMappedFileInputStream.java

@@ -92,7 +92,7 @@ public final class MemoryMappedFileInputStream extends AbstractInputStream {
     public static class Builder extends AbstractStreamBuilder<MemoryMappedFileInputStream, Builder> {
 
         /**
-         * Constructs a new {@link Builder}.
+         * Constructs a new builder of {@link MemoryMappedFileInputStream}.
          */
         public Builder() {
             setBufferSizeDefault(DEFAULT_BUFFER_SIZE);