org.unix4j.io.FileInput Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of unix4j-base Show documentation
There is a newer version: 0.6
package org.unix4j.io;

import java.io.File;
import java.io.FileDescriptor;
import java.io.FileInputStream;
import java.io.FileNotFoundException;
import java.io.FileReader;
import java.io.InputStreamReader;
import java.util.ArrayList;
import java.util.List;

/**
 * Input device reading from a {@link File}.
 */
public class FileInput extends ReaderInput {

	private final String fileInfo;

	public FileInput(FileReader fileReader) {
		super(fileReader);
		this.fileInfo = fileReader.toString();
	}

	public FileInput(File file) {
		super(createFileReader(file));
		this.fileInfo = file.toString();
	}

	public FileInput(FileInputStream fileStream) {
		super(new InputStreamReader(fileStream));
		this.fileInfo = fileStream.toString();
	}

	public FileInput(FileDescriptor fileDesc) {
		super(new FileReader(fileDesc));
		this.fileInfo = fileDesc.toString();
	}

	public FileInput(String file) {
		this(new File(file));
	}
	
	/**
	 * Creates a new {@link FileInput} object for each of the specified files
	 * and resturns a list with all input objects.
	 * 
	 * @param files the files for whose to create a {@code FileInput} object
	 */
	public static List multiple(File... files) {
		final List inputs = new ArrayList(files.length);
		for (int i = 0; i < files.length; i++) {
			inputs.add(new FileInput(files[i]));
		}
		return inputs;
	}

	/**
	 * Creates a new {@link FileInput} object for each of the specified files
	 * and resturns a list with all input objects.
	 * 
	 * @param files the files for whose to create a {@code FileInput} object
	 */
	public static List multiple(List files) {
		final List inputs = new ArrayList(files.size());
		for (int i = 0; i < files.size(); i++) {
			inputs.add(new FileInput(files.get(i)));
		}
		return inputs;
	}

	/**
	 * Creates and returns an input composed from the specified files 
	 * altogether. The resulting input object returns the lines lines of the 
	 * first file first, then the lines of the second file etc.
	 * 
	 * @param files the files to combine into a single input object
	 */
	public static Input composite(File... files) {
		if (files.length == 0) return NullInput.INSTANCE;
		if (files.length == 1) return new FileInput(files[0]);
		return new CompositeInput(multiple(files));
	}
	/**
	 * Creates and returns an input composed from the specified files 
	 * altogether. The resulting input object returns the lines lines of the 
	 * first file first, then the lines of the second file etc.
	 * 
	 * @param files the files to combine into a single input object
	 */
	public static Input composite(List files) {
		if (files.size() == 0) return NullInput.INSTANCE;
		if (files.size() == 1) return new FileInput(files.get(0));
		return new CompositeInput(multiple(files));
	}

	private static FileReader createFileReader(File file) {
		try {
			return new FileReader(file);
		} catch (FileNotFoundException e) {
			throw new RuntimeException(e);
		}
	}
	
	/**
	 * Returns the file info string, for instance a file path or file name.
	 * @return the file info string, usually the file name or path.
	 */
	public String getFileInfo() {
		return fileInfo;
	}

	@Override
	public String toString() {
		return getClass().getSimpleName() + "(fileInfo=" + getFileInfo() + ")";
	}
}