javax.mail.util

Class ByteArrayDataSource

java.lang.Object

javax.mail.util.ByteArrayDataSource

All Implemented Interfaces:

javax.activation.DataSource

public class ByteArrayDataSource
extends java.lang.Object
implements javax.activation.DataSource

An activation DataSource object that sources the data from a byte[] array.

Version:

$Rev: 467553 $ $Date: 2006-10-25 06:01:51 +0200 (Wed, 25 Oct 2006) $

Constructor Summary

Constructors

Constructor and Description
ByteArrayDataSource(byte[] data, java.lang.String type) Create a ByteArrayDataSource directly from a byte array.
ByteArrayDataSource(java.io.InputStream in, java.lang.String type) Create a ByteArrayDataSource from an input stream.
ByteArrayDataSource(java.lang.String data, java.lang.String type) Create a ByteArrayDataSource from a string value.

Method Summary

Modifier and Type	Method and Description
java.lang.String	getContentType() Get the MIME content type information for this DataSource.
java.io.InputStream	getInputStream() Create an input stream for this data.
java.lang.String	getName() Retrieve the DataSource name.
java.io.OutputStream	getOutputStream() Open an output stream for the DataSource.
void	setName(java.lang.String name) Set a new DataSource name.

Methods inherited from class java.lang.Object

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

Constructor Detail

ByteArrayDataSource

public ByteArrayDataSource(java.io.InputStream in,
                           java.lang.String type)
                    throws java.io.IOException

Create a ByteArrayDataSource from an input stream.

Parameters:

in - The source input stream.

type - The MIME-type of the data.

Throws:

java.io.IOException

ByteArrayDataSource

public ByteArrayDataSource(byte[] data,
                           java.lang.String type)

Create a ByteArrayDataSource directly from a byte array.

Parameters:

data - The source byte array (not copied).

type - The content MIME-type.

ByteArrayDataSource

public ByteArrayDataSource(java.lang.String data,
                           java.lang.String type)
                    throws java.io.IOException

Create a ByteArrayDataSource from a string value. If the type information includes a charset parameter, that charset is used to extract the bytes. Otherwise, the default Java char set is used.

Parameters:

data - The source data string.

type - The MIME type information.

Throws:

java.io.IOException

Method Detail

getInputStream

public java.io.InputStream getInputStream()
                                   throws java.io.IOException

Create an input stream for this data. A new input stream is created each time.

Specified by:

getInputStream in interface javax.activation.DataSource

Returns:

An InputStream for reading the encapsulated data.

Throws:

java.io.IOException

getOutputStream

public java.io.OutputStream getOutputStream()
                                     throws java.io.IOException

Open an output stream for the DataSource. This is not supported by this DataSource, so an IOException is always throws.

Specified by:

getOutputStream in interface javax.activation.DataSource

Returns:

Nothing...an IOException is always thrown.

Throws:

java.io.IOException

getContentType

public java.lang.String getContentType()

Get the MIME content type information for this DataSource.

Specified by:

getContentType in interface javax.activation.DataSource

Returns:

The MIME content type string.

getName

public java.lang.String getName()

Retrieve the DataSource name. If not explicitly set, this returns "".

Specified by:

getName in interface javax.activation.DataSource

Returns:

The currently set DataSource name.

setName

public void setName(java.lang.String name)

Set a new DataSource name.

Parameters:

name - The new name.