Skip to content

Commit 8828e66

Browse files
committed
Javadoc
1 parent 92352a7 commit 8828e66

26 files changed

Lines changed: 66 additions & 59 deletions

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

Lines changed: 6 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -98,26 +98,24 @@ public class BOMInputStream extends ProxyInputStream {
9898

9999
/**
100100
* Builds a new {@link BOMInputStream} instance.
101-
* <h2>
102-
* Using NIO
103-
* </2>
101+
*
102+
* <h2>Using NIO</h2>
104103
* <pre>{@code
105104
* BOMInputStream s = BOMInputStream.builder()
106105
* .setPath(Paths.get("MyFile.xml"))
107106
* .setByteOrderMarks(ByteOrderMark.UTF_8)
108107
* .setInclude(false)
109-
* .get()}
108+
* .get();}
110109
* </pre>
111-
* <h2>
112-
* Using IO
113-
* </2>
110+
* <h2>Using IO</h2>
114111
* <pre>{@code
115112
* BOMInputStream s = BOMInputStream.builder()
116113
* .setFile(new File("MyFile.xml"))
117114
* .setByteOrderMarks(ByteOrderMark.UTF_8)
118115
* .setInclude(false)
119-
* .get()}
116+
* .get();}
120117
* </pre>
118+
*
121119
* @since 2.12.0
122120
*/
123121
public static class Builder extends AbstractStreamBuilder<BOMInputStream, Builder> {

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

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -52,7 +52,7 @@ public final class BufferedFileChannelInputStream extends InputStream {
5252
* BufferedFileChannelInputStream s = BufferedFileChannelInputStream.builder()
5353
* .setFile(file)
5454
* .setBufferSize(4096)
55-
* .get()}
55+
* .get();}
5656
* </pre>
5757
* <p>
5858
* Using NIO Path:
@@ -62,7 +62,7 @@ public final class BufferedFileChannelInputStream extends InputStream {
6262
* BufferedFileChannelInputStream s = BufferedFileChannelInputStream.builder()
6363
* .setPath(path)
6464
* .setBufferSize(4096)
65-
* .get()}
65+
* .get();}
6666
* </pre>
6767
*
6868
* @since 2.12.0

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

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -55,8 +55,9 @@ public class CharSequenceInputStream extends InputStream {
5555
* .setBufferSize(8192)
5656
* .setCharSequence("String")
5757
* .setCharsetEncoder(Charset.defaultCharset())
58-
* .get()}
58+
* .get();}
5959
* </pre>
60+
*
6061
* @since 2.13.0
6162
*/
6263
public static class Builder extends AbstractStreamBuilder<CharSequenceInputStream, Builder> {

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

Lines changed: 13 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -45,15 +45,24 @@
4545
* <p>
4646
* To build an instance, see {@link Builder}.
4747
* </p>
48-
* <pre>
49-
* new BufferedInputStream(new GzipInputStream(new MemoryMappedFileInputStream(path))))
48+
* <pre>{@code
49+
* BufferedInputStream s = new BufferedInputStream(new GzipInputStream(MemoryMappedFileInputStream.builder()
50+
* .setPath(path)
51+
* .setBufferSize(256 * 1024)
52+
* .get()));}
5053
* </pre>
5154
* <p>
5255
* should outperform:
5356
* </p>
5457
* <pre>
5558
* new GzipInputStream(new MemoryMappedFileInputStream(path))
5659
* </pre>
60+
* <pre>{@code
61+
* GzipInputStream s = new GzipInputStream(MemoryMappedFileInputStream.builder()
62+
* .setPath(path)
63+
* .setBufferSize(256 * 1024)
64+
* .get());}
65+
* </pre>
5766
*
5867
* @since 2.12.0
5968
*/
@@ -68,9 +77,9 @@ public final class MemoryMappedFileInputStream extends InputStream {
6877
* MemoryMappedFileInputStream s = MemoryMappedFileInputStream.builder()
6978
* .setPath(path)
7079
* .setBufferSize(256 * 1024)
71-
* .get()}
80+
* .get();}
7281
* </pre>
73-
* <p>
82+
*
7483
* @since 2.12.0
7584
*/
7685
public static class Builder extends AbstractStreamBuilder<MemoryMappedFileInputStream, Builder> {

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

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -52,9 +52,9 @@ public class MessageDigestCalculatingInputStream extends ObservableInputStream {
5252
* MessageDigestCalculatingInputStream s = MessageDigestCalculatingInputStream.builder()
5353
* .setPath(path)
5454
* .setMessageDigest("SHA-512")
55-
* .get()}
55+
* .get();}
5656
* </pre>
57-
* <p>
57+
*
5858
* @since 2.12.0
5959
*/
6060
public static class Builder extends AbstractStreamBuilder<MessageDigestCalculatingInputStream, Builder> {

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

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -71,9 +71,8 @@ public class QueueInputStream extends InputStream {
7171
* QueueInputStream s = QueueInputStream.builder()
7272
* .setBlockingQueue(new LinkedBlockingQueue<>())
7373
* .setTimeout(Duration.ZERO)
74-
* .get()}
74+
* .get();}
7575
* </pre>
76-
* <p>
7776
*
7877
* @since 2.12.0
7978
*/

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

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -43,9 +43,9 @@ public class RandomAccessFileInputStream extends InputStream {
4343
* RandomAccessFileInputStream s = RandomAccessFileInputStream.builder()
4444
* .setPath(path)
4545
* .setCloseOnClose(true)
46-
* .get()}
46+
* .get();}
4747
* </pre>
48-
* <p>
48+
*
4949
* @since 2.12.0
5050
*/
5151
public static class Builder extends AbstractStreamBuilder<RandomAccessFileInputStream, Builder> {

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

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -57,9 +57,9 @@ public class ReadAheadInputStream extends FilterInputStream {
5757
* ReadAheadInputStream s = ReadAheadInputStream.builder()
5858
* .setPath(path)
5959
* .setExecutorService(Executors.newSingleThreadExecutor(ReadAheadInputStream::newThread))
60-
* .get()}
60+
* .get();}
6161
* </pre>
62-
* <p>
62+
*
6363
* @since 2.12.0
6464
*/
6565
public static class Builder extends AbstractStreamBuilder<ReadAheadInputStream, Builder> {

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

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -89,9 +89,9 @@ public class ReaderInputStream extends InputStream {
8989
* ReaderInputStream s = ReaderInputStream.builder()
9090
* .setPath(path)
9191
* .setCharsetEncoder(Charset.defaultCharset().newEncoder())
92-
* .get()}
92+
* .get();}
9393
* </pre>
94-
* <p>
94+
*
9595
* @since 2.12.0
9696
*/
9797
public static class Builder extends AbstractStreamBuilder<ReaderInputStream, Builder> {

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

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -58,9 +58,9 @@ public class ReversedLinesFileReader implements Closeable {
5858
* .setPath(path)
5959
* .setBufferSize(4096)
6060
* .setCharset(StandardCharsets.UTF_8)
61-
* .get()}
61+
* .get();}
6262
* </pre>
63-
* <p>
63+
*
6464
* @since 2.12.0
6565
*/
6666
public static class Builder extends AbstractStreamBuilder<ReversedLinesFileReader, Builder> {

0 commit comments

Comments
 (0)