javatools.filehandlers

Class CSVLines

java.lang.Object

javatools.datatypes.PeekIterator<java.util.List<java.lang.String>>

javatools.filehandlers.CSVLines

All Implemented Interfaces:

java.io.Closeable, java.lang.AutoCloseable, java.lang.Iterable<java.util.List<java.lang.String>>, java.util.Iterator<java.util.List<java.lang.String>>

public class CSVLines
extends PeekIterator<java.util.List<java.lang.String>>

This class is part of the Java Tools (see http://mpii.de/yago-naga/javatools). It is licensed under the Creative Commons Attribution License (see http://creativecommons.org/licenses/by/3.0) by the YAGO-NAGA team (see http://mpii.de/yago-naga). The class provides an iterator over the lines in a comma-separated file
Example:

      for(List columns : new CSVFile("c:\\autoexec.csv")) {
         System.out.println(columns);
      }
  

Recognizes column headers if introduced by '#'. Recognizes all types of encodings (see Char.decode()).

Nested Class Summary

Nested classes/interfaces inherited from class javatools.datatypes.PeekIterator

PeekIterator.ElementaryPeekIterator<T>, PeekIterator.SimplePeekIterator<T>

Field Summary

Fields

Modifier and Type	Field and Description
protected long	announceChars number of chars for announce (or -1)
protected java.util.List<java.lang.String>	columns Holds the column names
protected java.io.Reader	in Containes the Reader
protected int	nextChar Holds the next char in line
protected char	separator Holds the spearator

Fields inherited from class javatools.datatypes.PeekIterator

closed, EMPTY, initialized, next

Constructor Summary

Constructors

Constructor and Description
CSVLines(java.io.File f) Constructs a CSVReader
CSVLines(java.io.Reader reader) Constructs a CSVReader
CSVLines(java.lang.String file) Constructs a CSVReader

Method Summary

Modifier and Type	Method and Description
void	close() Closes the underlying resource
java.util.List<java.lang.String>	columnNames() returns the column names (or NULL)
protected java.lang.String	component() Reads a component and the following comma
protected java.util.List<java.lang.String>	internalNext() Returns the next or NULL if no next element is available
static void	main(java.lang.String[] args) Test method
java.lang.Integer	numColumns() returns the number of columns (or NULL)
void	setSeparator(char s) Sets the separator (comma by default)

Methods inherited from class javatools.datatypes.PeekIterator

asList, asList, asSet, asSet, asSet, emptyIterator, hasNext, internalSilentNext, iterator, list, list, next, nextOrNull, numElements, numElements, peek, remove, toString, toString, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.Iterator

forEachRemaining

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Field Detail

announceChars

protected long announceChars

number of chars for announce (or -1)

in

protected java.io.Reader in

Containes the Reader

columns

protected java.util.List<java.lang.String> columns

Holds the column names

nextChar

protected int nextChar

Holds the next char in line

separator

protected char separator

Holds the spearator

Constructor Detail

CSVLines

public CSVLines(java.io.File f)
         throws java.io.IOException

Constructs a CSVReader

Throws:

java.io.IOException

CSVLines

public CSVLines(java.io.Reader reader)
         throws java.io.IOException

Constructs a CSVReader

Throws:

java.io.IOException

CSVLines

public CSVLines(java.lang.String file)
         throws java.io.IOException

Constructs a CSVReader

Throws:

java.io.IOException

Method Detail

setSeparator

public void setSeparator(char s)

Sets the separator (comma by default)

component

protected java.lang.String component()
                              throws java.io.IOException

Reads a component and the following comma

Throws:

java.io.IOException

internalNext

protected java.util.List<java.lang.String> internalNext()
                                                 throws java.lang.Exception

Description copied from class: PeekIterator

Returns the next or NULL if no next element is available

Specified by:

internalNext in class PeekIterator<java.util.List<java.lang.String>>

Throws:

java.lang.Exception

columnNames

public java.util.List<java.lang.String> columnNames()

returns the column names (or NULL)

numColumns

public java.lang.Integer numColumns()

returns the number of columns (or NULL)

close

public void close()

Description copied from class: PeekIterator

Closes the underlying resource

Specified by:

close in interface java.io.Closeable

Specified by:

close in interface java.lang.AutoCloseable

Overrides:

close in class PeekIterator<java.util.List<java.lang.String>>

main

public static void main(java.lang.String[] args)
                 throws java.lang.Exception

Test method

Throws:

java.lang.Exception