Package ball.activation

Class ReaderWriterDataSource

java.lang.Object

ball.activation.AbstractDataSource

ball.activation.FilterDataSource

ball.activation.ReaderWriterDataSource

All Implemented Interfaces:

DataSourceDefaultMethods, DataSource

Direct Known Subclasses:

JAXBDataSource, TextTable, ThrowableDataSource

public class ReaderWriterDataSource
extends FilterDataSource

DataSource implementation that provides a BufferedReader wrapping the DataSource InputStream and a PrintWriter wrapping the DataSource OutputStream.

Author:

Allen D. Ball

Field Summary

Fields

Modifier and Type	Field	Description
protected static Charset	CHARSET

Fields inherited from interface ball.activation.DataSourceDefaultMethods

APPLICATION_OCTET_STREAM, APPLICATION_XML, CONTENT_TYPE, TEXT_HTML, TEXT_PLAIN

Constructor Summary

Constructors

Constructor	Description
ReaderWriterDataSource(String name, String type)
ReaderWriterDataSource(String name, String type, Charset charset)
ReaderWriterDataSource(String name, String type, Charset charset, String content)

Method Summary

Modifier and Type	Method	Description
BufferedReader	getBufferedReader()	Method to return a new BufferedReader to read the underlying InputStream.
Charset	getCharset()	Method to get the Charset used to create the BufferedReader and PrintWriter.
PrintStream	getPrintStream()	Method to return a new PrintStream to write to the underlying OutputStream.
PrintWriter	getPrintWriter()	Method to return a new PrintWriter to write to the underlying OutputStream.
Reader	getReader()	Method to return a new Reader to read the underlying InputStream.
Writer	getWriter()	Method to return a new Writer to write to the underlying OutputStream.
protected static String	nameOf(Charset charset)	Convenience method to get the name of a Charset.
String	toString()
void	writeTo(PrintWriter writer)	Method to write the contents of this DataSource to a PrintWriter.

Methods inherited from class ball.activation.FilterDataSource

getContentType, getDataSource, getInputStream, getName, getOutputStream, setContentType, setName

Methods inherited from class java.lang.Object

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

Methods inherited from interface ball.activation.DataSourceDefaultMethods

clear, getInputStream, getOutputStream, length, wrap, wrap

Field Detail

CHARSET

protected static final Charset CHARSET

Constructor Detail

ReaderWriterDataSource

@ConstructorProperties({"name","contentType"})
public ReaderWriterDataSource(String name,
                              String type)

Parameters:

name - Initial "Name" attribute value.

type - Initial "ContentType" attribute value.

ReaderWriterDataSource

@ConstructorProperties({"name","contentType","charset"})
public ReaderWriterDataSource(String name,
                              String type,
                              Charset charset)

Parameters:

name - Initial "Name" attribute value.

type - Initial "ContentType" attribute value.

charset - The Charset used to encode the OutputStream.

ReaderWriterDataSource

@ConstructorProperties({"name","contentType","charset",""})
public ReaderWriterDataSource(String name,
                              String type,
                              Charset charset,
                              String content)

Parameters:

name - Initial "Name" attribute value.

type - Initial "ContentType" attribute value.

charset - The Charset used to encode the OutputStream.

content - The initial content String.

Method Detail

getCharset

public Charset getCharset()

Method to get the Charset used to create the BufferedReader and PrintWriter.

Returns:

The Charset.

getReader

public Reader getReader()
                 throws IOException

Method to return a new Reader to read the underlying InputStream.

Returns:

A Reader wrapping the DataSource InputStream.

Throws:

IOException - If an I/O exception occurs.

See Also:

FilterDataSource.getInputStream()

getWriter

public Writer getWriter()
                 throws IOException

Method to return a new Writer to write to the underlying OutputStream.

Returns:

A Writer wrapping the DataSource OutputStream.

Throws:

IOException - If an I/O exception occurs.

See Also:

FilterDataSource.getOutputStream()

getBufferedReader

public BufferedReader getBufferedReader()
                                 throws IOException

Method to return a new BufferedReader to read the underlying InputStream.

Returns:

A BufferedReader wrapping the DataSource InputStream.

Throws:

IOException - If an I/O exception occurs.

See Also:

FilterDataSource.getInputStream()

getPrintWriter

public PrintWriter getPrintWriter()
                           throws IOException

Method to return a new PrintWriter to write to the underlying OutputStream.

Returns:

A PrintWriter wrapping the DataSource OutputStream.

Throws:

IOException - If an I/O exception occurs.

See Also:

FilterDataSource.getOutputStream()

getPrintStream

public PrintStream getPrintStream()
                           throws IOException

Method to return a new PrintStream to write to the underlying OutputStream.

Returns:

A PrintStream wrapping the DataSource OutputStream.

Throws:

IOException - If an I/O exception occurs.

See Also:

FilterDataSource.getOutputStream()

writeTo

public void writeTo(PrintWriter writer)
             throws IOException

Method to write the contents of this DataSource to a PrintWriter.

Parameters:

writer - The target PrintWriter.

Throws:

IOException - If a problem is encountered opening or reading the BufferedReader or writing to the PrintWriter.

See Also:

getBufferedReader()

toString

public String toString()

Overrides:

toString in class Object

nameOf

protected static String nameOf(Charset charset)

Convenience method to get the name of a Charset.

Parameters:

charset - The Charset.

Returns:

The name of the Charset if non-null; null otherwise.

See Also:

Charset.name()