net.scharlie.lj4l.core.io.local

Class LocalLineReader

java.lang.Object

net.scharlie.lj4l.core.io.local.LocalLineReader

All Implemented Interfaces:

Closeable, AutoCloseable, LineReader

public class LocalLineReader
extends Object
implements LineReader

This class implements a local line reader.

Instances of this class are not safe for use by multiple threads.

Nested Class Summary

Nested classes/interfaces inherited from interface net.scharlie.lj4l.core.io.LineReader

LineReader.LineConsumer

Constructor Summary

Constructors

Constructor and Description
LocalLineReader() Create a new local line reader.
LocalLineReader(String path) Create a new local line reader.

Method Summary

Modifier and Type	Method and Description
void	close()
boolean	exists(String pathToTest) Test whether the given file path exists.
ResultData	readLines(LineReader.LineConsumer lineConsumer) Read line by line until the current end.
void	removePath() Remove the current file path.
void	setPath(String path) Set the file path or null if you want to remove the current file path.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

LocalLineReader

public LocalLineReader()

Create a new local line reader.

LocalLineReader

public LocalLineReader(String path)

Create a new local line reader.

Parameters:

path - The file path

Method Detail

setPath

public final void setPath(String path)

Set the file path or null if you want to remove the current file path.

Resets the internal pointer to the last imported byte.

Specified by:

setPath in interface LineReader

Parameters:

path - The file path

Throws:

IllegalStateException - if this reader is already closed

IllegalArgumentException - if the path is not null but blank

removePath

public final void removePath()

Remove the current file path.

Specified by:

removePath in interface LineReader

readLines

public final ResultData readLines(LineReader.LineConsumer lineConsumer)

Read line by line until the current end.

Each call to this methods tries to continue reading after the last imported byte from the previous call.

The internal pointer to the last imported byte can and will be reseted by setting or removing the path.

The auto-connect flag is set to false.

Specified by:

readLines in interface LineReader

Parameters:

lineConsumer - The consumer which takes line by line

Returns:

A result data transfer object

Throws:

IllegalStateException - if this reader is already closed

IllegalArgumentException - if the line consumer is null

IllegalArgumentException - if the path is null or empty

exists

public final boolean exists(String pathToTest)

Test whether the given file path exists. The answer will be false if the file path does not exist or in case of any problem, e.g. no connection.

Specified by:

exists in interface LineReader

Parameters:

pathToTest - The file path

Returns:

answer whether the given file path exists

Throws:

IllegalStateException - if this reader is already closed

IllegalArgumentException - if the path is null or blank

close

public final void close()

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Specified by:

close in interface LineReader