com.chemaxon.calculations.util

Class CmdlineUtils

java.lang.Object

com.chemaxon.calculations.util.CmdlineUtils

@PublicAPI
 @Beta
public final class CmdlineUtils
extends java.lang.Object

Command line related utilities. IO is accessed through a CmdlineContext acquired with ServiceLoader. A single service registration is expected.

Please note that this class is marked with @Beta annotation, so it can be subject of incompatible changes or removal in later releases.

Author:

Gabor Imre

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	UTF8ENCODING UTF-8 encoding String literal.

Method Summary

Modifier and Type	Method and Description
static java.io.InputStream	autoGzip(java.io.InputStream in) Detect gzipped InputStream.
static void	exit(int status) Terminate execution with given status code.
static java.io.PrintStream	getErr() Get stderr to use.
static java.io.InputStream	getIn() Get stdin to use.
static java.io.PrintStream	getOut() Get stdout to use.
static java.io.InputStream	inputStreamFromLocation(java.lang.String location) Create InputStream from not nullable location.
static java.io.InputStream	inputStreamFromLocation(java.lang.String location, boolean autoGzip) Create InputStream from not nullable location.
static com.google.common.base.Optional<java.io.InputStream>	inputStreamFromNullableLocation(java.lang.String location) Create in input stream from nullable location.
static com.google.common.base.Optional<java.io.InputStream>	inputStreamFromNullableLocation(java.lang.String location, boolean autoGzip) Create in input stream from nullable location.
static boolean	isFileExists(java.lang.String name) Check if a file exists.
static com.chemaxon.calculations.util.CloseableLineIterator	lineIteratorFromLocation(java.lang.String location) Create a LineIterator from a not nullable location.
static com.chemaxon.calculations.util.CloseableLineIterator	lineIteratorFromLocation(java.lang.String location, boolean autoGzip) Create a LineIterator from a not nullable location.
static java.io.ObjectInputStream	objectInputStreamFromLocation(java.lang.String location) Create ObjectInputStream from a not nullable location.
static java.io.ObjectInputStream	objectInputStreamFromLocation(java.lang.String location, boolean autoGzip) Create ObjectInputStream from a not nullable location.
static com.google.common.base.Optional<java.io.ObjectInputStream>	objectInputStreamFromNullableLocation(java.lang.String location) Create in object input stream from nullable location.
static java.io.ObjectOutputStream	objectOutputStreamFromLocation(java.lang.String location) ObjectOutputStream from a location.
static com.google.common.base.Optional<java.io.ObjectOutputStream>	objectOutputStreamFromNullableLocation(java.lang.String location) ObjectOutputStream from a nullable location.
static java.io.InputStream	openUrlStream(java.lang.String spec) Open an URL connection.
static java.io.OutputStream	outputStreamFromLocation(java.lang.String location) OutputStream from a location.
static java.io.PrintStream	printStreamFromLocation(java.lang.String location) PrintStream from a location.
static com.google.common.base.Optional<java.io.PrintStream>	printStreamFromNullableLocation(java.lang.String location) PrintStream from a nullable location.
static java.lang.String	stringFromLocation(java.lang.String location) Read the contents of a location into a String.
static java.lang.String	stringFromLocation(java.lang.String location, boolean autoGzip) Read the contents of a location into a String.
static com.google.common.base.Optional<java.lang.String>	stringFromNullableLocation(java.lang.String location) Read the contents of a location when it is not null.
static com.google.common.base.Optional<java.lang.String>	stringFromNullableLocation(java.lang.String location, boolean autoGzip) Read the contents of a location when it is not null.

Methods inherited from class java.lang.Object

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

Field Detail

UTF8ENCODING

public static final java.lang.String UTF8ENCODING

UTF-8 encoding String literal.

See Also:

Constant Field Values

Method Detail

autoGzip

public static java.io.InputStream autoGzip(java.io.InputStream in)
                                    throws java.io.IOException

Detect gzipped InputStream. Checks GZIPInputStream.GZIP_MAGIC and wraps input when match found. Further validity check is not done. See http://stackoverflow.com/questions/1080381/gzipinputstream-reading-line-by-line.

Parameters:

in - Input

Returns:

Input wrapped in GZIPInputStream when GZIPInputStream.GZIP_MAGIC match, otherwise input, possibly wrapped in a BufferedInputStream.

Throws:

java.io.IOException - Propagated

getOut

public static java.io.PrintStream getOut()

Get stdout to use.

Returns:

StdOut specified by the default command line context

getErr

public static java.io.PrintStream getErr()

Get stderr to use.

Returns:

StdErr specified by the default command line context

getIn

public static java.io.InputStream getIn()

Get stdin to use.

Returns:

StdIn specified by the default command line context

isFileExists

public static boolean isFileExists(java.lang.String name)

Check if a file exists.

Parameters:

name - Name to delegate

openUrlStream

public static java.io.InputStream openUrlStream(java.lang.String spec)
                                         throws java.io.IOException

Open an URL connection.

Parameters:

spec - URL spec

Returns:

Stream

Throws:

java.io.IOException - Propagated

exit

public static void exit(int status)
                 throws com.chemaxon.calculations.util.CmdlineContext.ExitWithNonZeroStatus,
                        com.chemaxon.calculations.util.CmdlineContext.ExitWithZeroStatus

Terminate execution with given status code. By default implementation calls System.exit(int). Test time implementations might decide to throw ExitWithZeroStatus or ExitWithNonZeroStatus instead of delegating to System.exit(int). These RuntimeExceptions are helps for test implementations, regular application code must not catch them.

Parameters:

status - Status code; by convention nonzero status code indicates abnormal termination

Throws:

CmdlineContext.ExitWithZeroStatus - Test time implementation might throw this instead of delegating to System.exit(int) Note that normal application code must not catch this.

CmdlineContext.ExitWithNonZeroStatus - Test time implementation might throw this instead of delegating to System.exit(int) Note that normal application code must not catch this.

inputStreamFromLocation

public static java.io.InputStream inputStreamFromLocation(java.lang.String location)
                                                   throws java.io.FileNotFoundException

Create InputStream from not nullable location.

Parameters:

location - File name or "-" for stdin.

Returns:

Input stream representing given location. Returned input stream should be closed after usage. If stdin requested it is wrapped in a CloseShieldInputStream

Throws:

java.io.FileNotFoundException - thrown by FileInputStream.FileInputStream(java.lang.String)

inputStreamFromLocation

public static java.io.InputStream inputStreamFromLocation(java.lang.String location,
                                                          boolean autoGzip)
                                                   throws java.io.IOException

Create InputStream from not nullable location.

Parameters:

location - File name or "-" for stdin.

autoGzip - Wrap returned stream through autoGzip(java.io.InputStream).

Returns:

Input stream representing given location. Returned input stream should be closed after usage. If stdin requested it is wrapped in a CloseShieldInputStream

Throws:

java.io.IOException - propagated

objectInputStreamFromLocation

public static java.io.ObjectInputStream objectInputStreamFromLocation(java.lang.String location,
                                                                      boolean autoGzip)
                                                               throws java.io.IOException

Create ObjectInputStream from a not nullable location.

Parameters:

location - File name or "-" for stdin

autoGzip - Wrap returned stream through autoGzip(java.io.InputStream).

Returns:

ObjectInputStream to be used

Throws:

java.io.IOException - re-thrown

objectInputStreamFromLocation

public static java.io.ObjectInputStream objectInputStreamFromLocation(java.lang.String location)
                                                               throws java.io.IOException

Create ObjectInputStream from a not nullable location.

Parameters:

location - File name or "-" for stdin

Returns:

ObjectInputStream to be used

Throws:

java.io.IOException - re-thrown

lineIteratorFromLocation

public static com.chemaxon.calculations.util.CloseableLineIterator lineIteratorFromLocation(java.lang.String location,
                                                                                            boolean autoGzip)
                                                                                     throws java.io.IOException

Create a LineIterator from a not nullable location.

Note that the returned instance must be closed by calling LineIterator.close() or LineIterator.closeQuietly(org.apache.commons.io.LineIterator), preferably in a finally block

Parameters:

location - File name or "-" for stdin

autoGzip - Wrap returned stream through autoGzip(java.io.InputStream).

Returns:

LineIterator for the given location

Throws:

java.io.IOException - re-thrown

lineIteratorFromLocation

public static com.chemaxon.calculations.util.CloseableLineIterator lineIteratorFromLocation(java.lang.String location)
                                                                                     throws java.io.IOException

Create a LineIterator from a not nullable location.

Note that the returned instance must be closed by calling LineIterator.close() or LineIterator.closeQuietly(org.apache.commons.io.LineIterator), preferably in a finally block

Parameters:

location - File name or "-" for stdin

Returns:

LineIterator for the given location

Throws:

java.io.IOException - re-thrown

inputStreamFromNullableLocation

public static com.google.common.base.Optional<java.io.InputStream> inputStreamFromNullableLocation(java.lang.String location,
                                                                                                   boolean autoGzip)
                                                                                            throws java.io.IOException

Create in input stream from nullable location.

The returned InputStream should be closed in a proper finally block by invoking its InputStream.close() method. If stdin used then a CloseShieldInputStream is returned which is safe to close.

Parameters:

location - File name or "-" for stdin

autoGzip - Wrap returned stream through autoGzip(java.io.InputStream).

Returns:

Input stream representing given location

Throws:

java.io.IOException - thrown by FileInputStream.FileInputStream(java.lang.String) or by autoGzip(java.io.InputStream).

inputStreamFromNullableLocation

public static com.google.common.base.Optional<java.io.InputStream> inputStreamFromNullableLocation(java.lang.String location)
                                                                                            throws java.io.IOException

Create in input stream from nullable location.

The returned InputStream should be closed in a proper finally block by invoking its InputStream.close() method. If stdin used then a CloseShieldInputStream is returned which is safe to close.

Parameters:

location - File name or "-" for stdin

Returns:

Input stream representing given location

Throws:

java.io.IOException - thrown by FileInputStream.FileInputStream(java.lang.String) or by autoGzip(java.io.InputStream).

objectInputStreamFromNullableLocation

public static com.google.common.base.Optional<java.io.ObjectInputStream> objectInputStreamFromNullableLocation(java.lang.String location)
                                                                                                        throws java.io.IOException

Create in object input stream from nullable location.

The returned Object should be closed in a proper finally block by invoking its ObjectInputStream.close() method. If stdin used then a CloseShieldInputStream is used which is safe to close.

Parameters:

location - File name or "-" for stdin

Returns:

ObjectInputStream representing given location

Throws:

java.io.IOException - re-thrown

outputStreamFromLocation

public static java.io.OutputStream outputStreamFromLocation(java.lang.String location)
                                                     throws java.io.FileNotFoundException

OutputStream from a location.

Parameters:

location - File name or "-" for stdout, "-2" for stderr. Location "/dev/null" is considered as a NullOutputStream. Note that NullOutputStream is available both in apache commons io and in Guava, however Guava version is marked with Beta, so apache version is used.

Returns:

OutputStream for given location which is safe and should be closed explicitly

Throws:

java.io.FileNotFoundException - thrown by FileOutputStream.FileOutputStream(java.lang.String)

printStreamFromLocation

public static java.io.PrintStream printStreamFromLocation(java.lang.String location)
                                                   throws java.io.FileNotFoundException

PrintStream from a location.

Parameters:

location - File name or "-" for stdout, "-2" for stderr. Location "/dev/null" is considered as a NullOutputStream. Note that NullOutputStream is available both in apache commons io and in Guava, however Guava version is marked with Beta, so apache version is used.

Returns:

UTF-8 encoded PrintStream for given location which is safe and should be closed explicitly

Throws:

java.io.FileNotFoundException - thrown by FileOutputStream.FileOutputStream(java.lang.String)

objectOutputStreamFromLocation

public static java.io.ObjectOutputStream objectOutputStreamFromLocation(java.lang.String location)
                                                                 throws java.io.IOException

ObjectOutputStream from a location.

Parameters:

location - File name or "-" for stdout, "-2" for stderr. Location "/dev/null" is considered as a NullOutputStream. Note that NullOutputStream is available both in apache commons io and in Guava, however Guava version is marked with Beta, so apache version is used.

Returns:

ObjectOutputStream for given location which is safe and should be closed explicitly

Throws:

java.io.IOException - thrown by underlying streams

stringFromLocation

public static java.lang.String stringFromLocation(java.lang.String location,
                                                  boolean autoGzip)
                                           throws java.lang.IllegalArgumentException

Read the contents of a location into a String.

Parameters:

location - Location passed to inputStreamFromLocation(java.lang.String)

autoGzip - Wrap returned stream through autoGzip(java.io.InputStream).

Returns:

Contents read by IOUtils.toString(java.io.InputStream, java.lang.String)

Throws:

java.lang.IllegalArgumentException - When something goes wrong

stringFromLocation

public static java.lang.String stringFromLocation(java.lang.String location)
                                           throws java.lang.IllegalArgumentException

Read the contents of a location into a String.

Parameters:

location - Location passed to inputStreamFromLocation(java.lang.String)

Returns:

Contents read by IOUtils.toString(java.io.InputStream, java.lang.String)

Throws:

java.lang.IllegalArgumentException - When something goes wrong

printStreamFromNullableLocation

public static com.google.common.base.Optional<java.io.PrintStream> printStreamFromNullableLocation(java.lang.String location)
                                                                                            throws java.io.FileNotFoundException

PrintStream from a nullable location.

Parameters:

location - File name or "-" for stdout, "-2" for stderr

Returns:

UTF-8 encoded PrintStream for given location which is safe and should be closed explicitly when not null given

Throws:

java.io.FileNotFoundException - thrown by FileOutputStream.FileOutputStream(java.lang.String)

objectOutputStreamFromNullableLocation

public static com.google.common.base.Optional<java.io.ObjectOutputStream> objectOutputStreamFromNullableLocation(java.lang.String location)
                                                                                                          throws java.io.IOException

ObjectOutputStream from a nullable location.

Parameters:

location - File name or "-" for stdout, "-2" for stderr

Returns:

ObjectOutputStream for given location which is safe and should be closed explicitly when not null given

Throws:

java.io.IOException - re-thrown

stringFromNullableLocation

public static com.google.common.base.Optional<java.lang.String> stringFromNullableLocation(java.lang.String location,
                                                                                           boolean autoGzip)

Read the contents of a location when it is not null.

Parameters:

location - A location or null

autoGzip - Wrap returned stream through autoGzip(java.io.InputStream).

Returns:

Contents

stringFromNullableLocation

public static com.google.common.base.Optional<java.lang.String> stringFromNullableLocation(java.lang.String location)

Read the contents of a location when it is not null.

Parameters:

location - A location or null

Returns:

Contents