Skip to content

Commit e3785d9

Browse files
committed
Fix javadoc for module "io" (#396)
1 parent cabc095 commit e3785d9

File tree

5 files changed

+34
-0
lines changed

5 files changed

+34
-0
lines changed

metafacture-io/src/main/java/org/metafacture/io/LineReader.java

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -52,6 +52,13 @@ public void process(final Reader reader) {
5252
process(reader, getReceiver());
5353
}
5454

55+
/**
56+
* Processes input from a reader line by line and pass them line by line to a
57+
* receiver.
58+
*
59+
* @param reader the Reader
60+
* @param receiver the ObjectReceiver
61+
*/
5562
public static void process(final Reader reader, final ObjectReceiver<String> receiver) {
5663
final BufferedReader lineReader = new BufferedReader(reader, BUFFER_SIZE);
5764
try {

metafacture-io/src/main/java/org/metafacture/io/ObjectFileWriter.java

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -52,6 +52,11 @@ public final class ObjectFileWriter<T> extends AbstractObjectWriter<T> {
5252
private String encoding = "UTF-8";
5353
private FileCompression compression = FileCompression.AUTO;
5454

55+
/**
56+
* Sets the destination of a file to write objects to.
57+
*
58+
* @param path the path to be written to
59+
*/
5560
public ObjectFileWriter(final String path) {
5661
this.path = path;
5762
startNewFile();

metafacture-io/src/main/java/org/metafacture/io/ObjectJavaIoWriter.java

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -36,11 +36,20 @@ public final class ObjectJavaIoWriter<T> implements ObjectReceiver<T> {
3636
private boolean closed;
3737
private final IoWriterFactory writerFactory;
3838

39+
/**
40+
* Deprecated.
41+
* @param writer the Writer
42+
*/
3943
public ObjectJavaIoWriter(final Writer writer) {
4044
this.writer = writer;
4145
writerFactory = null;
4246
}
4347

48+
/**
49+
* Deprecated.
50+
*
51+
* @param writerFactory the IoWriterFactory
52+
*/
4453
public ObjectJavaIoWriter(final IoWriterFactory writerFactory) {
4554
this.writerFactory = writerFactory;
4655
this.writer = writerFactory.createWriter();

metafacture-io/src/main/java/org/metafacture/io/ObjectWriter.java

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -45,6 +45,14 @@ public final class ObjectWriter<T> implements ConfigurableObjectWriter<T> {
4545

4646
private final ConfigurableObjectWriter<T> objectWriter;
4747

48+
/**
49+
* Sets the destination to write objects to. If destination is set to
50+
* {@value #STDOUT} the object is written to standard out. Else it's written to
51+
* a file.
52+
*
53+
* @param destination the path to be written to or standard out if it's
54+
* {@value #STDOUT}
55+
*/
4856
public ObjectWriter(final String destination) {
4957
if (STDOUT.equals(destination)) {
5058
objectWriter = new ObjectStdoutWriter<T>();

metafacture-io/src/main/java/org/metafacture/io/RecordReader.java

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -56,6 +56,11 @@ public final class RecordReader extends DefaultObjectPipe<Reader, ObjectReceiver
5656
public RecordReader() {
5757
}
5858

59+
/**
60+
* Sets the separator. The default is the global separator character (0x001d).
61+
*
62+
* @param separator the separator
63+
*/
5964
public void setSeparator(final String separator) {
6065
if (separator.length() >= 1) {
6166
this.separator = separator.charAt(0);

0 commit comments

Comments
 (0)