org.pentaho.reporting.libraries.base.util

Class IOUtils

java.lang.Object

org.pentaho.reporting.libraries.base.util.IOUtils

public class IOUtils
extends Object

The IOUtils provide some IO related helper methods.

Author:

Thomas Morgner.

Method Summary

Methods

Modifier and Type	Method and Description
void	copyStreams(InputStream in, OutputStream out) Copies the InputStream into the OutputStream, until the end of the stream has been reached.
void	copyStreams(InputStream in, OutputStream out, int buffersize) Copies the InputStream into the OutputStream, until the end of the stream has been reached.
void	copyWriter(Reader in, Writer out) Copies the contents of the Reader into the Writer, until the end of the stream has been reached.
void	copyWriter(Reader in, Writer out, int buffersize) Copies the contents of the Reader into the Writer, until the end of the stream has been reached.
String	createRelativePath(String targetFile, String baseFile) Creates a relative url by stripping the common parts of the the url.
String	createRelativeURL(URL url, URL baseURL) Creates a relative url by stripping the common parts of the the url.
File	findFileOnClassPath(String name) Returns a reference to a file with the specified name that is located somewhere on the classpath.
String	getAbsolutePath(String targetFile, String baseFile) Computes the absolute filename for the target file using the baseFile as root directory.
String	getFileExtension(String file) Returns the file extension of the given file name.
String	getFileName(String path) Extracts the last file name from the given pathname.
String	getFileName(URL url) Extracts the file name from the URL.
static IOUtils	getInstance() Gets the singleton instance of the utility package.
String	getPath(String path) Returns the path-portion of the given path (anything before the last slash or backslash) or an empty string.
boolean	isSubDirectory(File base, File child) Checks, whether the child directory is a subdirectory of the base directory.
byte[]	readBlob(Blob clob) Converts a SQL-Clob object into a String.
String	readClob(Clob clob) Converts a SQL-Clob object into a String.
void	readFully(InputStream in, byte[] data, int offset, int length) Reads the given number of bytes into the target array.
int	readSafely(InputStream in, byte[] data, int offset, int length) Reads the given number of bytes into the target array.
String	stripFileExtension(String file) Removes the file extension from the given file name.

Methods inherited from class java.lang.Object

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

Method Detail

getInstance

public static IOUtils getInstance()

Gets the singleton instance of the utility package.

Returns:

the singleton instance.

createRelativePath

public String createRelativePath(String targetFile,
                        String baseFile)

Creates a relative url by stripping the common parts of the the url. If the baseFile denotes a directory, it must end with a slash.

Parameters:

targetFile - the to be stripped url

baseFile - the base url, to which the url is relative to.

Returns:

the relative url, or the url unchanged, if there is no relation beween both URLs.

createRelativeURL

public String createRelativeURL(URL url,
                       URL baseURL)

Creates a relative url by stripping the common parts of the the url. If the base-URL denotes a directory, it must end with a slash.

Parameters:

url - the to be stripped url

baseURL - the base url, to which the url is relative to.

Returns:

the relative url, or the url unchanged, if there is no relation beween both URLs.

copyStreams

public void copyStreams(InputStream in,
               OutputStream out)
                 throws IOException

Copies the InputStream into the OutputStream, until the end of the stream has been reached. This method uses a buffer of 4096 kbyte.

Parameters:

in - the inputstream from which to read.

out - the outputstream where the data is written to.

Throws:

IOException - if a IOError occurs.

copyStreams

public void copyStreams(InputStream in,
               OutputStream out,
               int buffersize)
                 throws IOException

Copies the InputStream into the OutputStream, until the end of the stream has been reached.

Parameters:

in - the inputstream from which to read.

out - the outputstream where the data is written to.

buffersize - the buffer size.

Throws:

IOException - if a IOError occurs.

copyWriter

public void copyWriter(Reader in,
              Writer out)
                throws IOException

Copies the contents of the Reader into the Writer, until the end of the stream has been reached. This method uses a buffer of 4096 kbyte.

Parameters:

in - the reader from which to read.

out - the writer where the data is written to.

Throws:

IOException - if a IOError occurs.

copyWriter

public void copyWriter(Reader in,
              Writer out,
              int buffersize)
                throws IOException

Copies the contents of the Reader into the Writer, until the end of the stream has been reached.

Parameters:

in - the reader from which to read.

out - the writer where the data is written to.

buffersize - the buffer size.

Throws:

IOException - if a IOError occurs.

readFully

public void readFully(InputStream in,
             byte[] data,
             int offset,
             int length)
               throws IOException

Reads the given number of bytes into the target array. This method does not return until all bytes are read. In case a end-of-stream is reached, the method throws an Exception.

Parameters:

in - the inputstream from where to read.

data - the array where to store the data.

offset - the offset in the array where to store the data.

length - the number of bytes to be read.

Throws:

IOException - if an IO error occured or the End of the stream has been reached.

readSafely

public int readSafely(InputStream in,
             byte[] data,
             int offset,
             int length)
               throws IOException

Reads the given number of bytes into the target array. This method does not return until all bytes are read. In case a end-of-stream is reached, the method throws an Exception.

Parameters:

in - the inputstream from where to read.

data - the array where to store the data.

offset - the offset in the array where to store the data.

length - the number of bytes to be read.

Throws:

IOException - if an IO error occured or the End of the stream has been reached.

getFileName

public String getFileName(URL url)

Extracts the file name from the URL.

Parameters:

url - the url.

Returns:

the extracted filename.

getFileName

public String getFileName(String path)

Extracts the last file name from the given pathname.

Parameters:

path - the path name.

Returns:

the extracted filename.

stripFileExtension

public String stripFileExtension(String file)

Removes the file extension from the given file name.

Parameters:

file - the file name.

Returns:

the file name without the file extension.

getFileExtension

public String getFileExtension(String file)

Returns the file extension of the given file name. The returned value will contain the dot.

Parameters:

file - the file name.

Returns:

the file extension.

isSubDirectory

public boolean isSubDirectory(File base,
                     File child)
                       throws IOException

Checks, whether the child directory is a subdirectory of the base directory.

Parameters:

base - the base directory.

child - the suspected child directory.

Returns:

true, if the child is a subdirectory of the base directory.

Throws:

IOException - if an IOError occured during the test.

findFileOnClassPath

public File findFileOnClassPath(String name)
                         throws SecurityException

Returns a reference to a file with the specified name that is located somewhere on the classpath. The code for this method is an adaptation of code supplied by Dave Postill.

Parameters:

name - the filename.

Returns:

a reference to a file or null if no file could be found.

Throws:

SecurityException - if access to the system properties or filesystem is forbidden.

getAbsolutePath

public String getAbsolutePath(String targetFile,
                     String baseFile)

Computes the absolute filename for the target file using the baseFile as root directory. If the baseFile is null or empty, the target file will be normalized (all navigation elements like ".." are removed).

Parameters:

targetFile - the target file name.

baseFile - the base file (can be null).

Returns:

the absolute path.

getPath

public String getPath(String path)

Returns the path-portion of the given path (anything before the last slash or backslash) or an empty string.

Parameters:

path - the path or filename from where to extract the path name.

Returns:

the extracted path or a empty string.

readClob

public String readClob(Clob clob)
                throws IOException,
                       SQLException

Converts a SQL-Clob object into a String. If the Clob is larger than 2^31 characters, we cannot convert it. If there are errors converting it, this method will log the cause and return null.

Parameters:

clob - the clob to be read as string.

Returns:

the string or null in case of errors.

Throws:

IOException

SQLException

readBlob

public byte[] readBlob(Blob clob)
                throws IOException,
                       SQLException

Converts a SQL-Clob object into a String. If the Clob is larger than 2^31 characters, we cannot convert it. If there are errors converting it, this method will log the cause and return null.

Parameters:

clob - the clob to be read as string.

Returns:

the string or null in case of errors.

Throws:

IOException

SQLException