Class javax.activation.FileDataSource

java.lang.Object
    |
    +----javax.activation.FileDataSource

public class FileDataSource

extends java.lang.Object

implements DataSource

FileDataSource Typing Semantics

The FileDataSource class delegates data typing of files to an object subclassed from the FileTypeMap class. The setFileTypeMap method can be used to explicitly set the FileTypeMap for an instance of FileDataSource. If no FileTypeMap is set, the FileDataSource will call the FileTypeMap's getDefaultFileTypeMap method to get the System's default FileTypeMap.

See Also:

DataSource, FileTypeMap, MimetypesFileTypeMap

Constructor Summary

FileDataSource(java.io.File file) Creates a FileDataSource from a File object.

FileDataSource(java.lang.String name) Creates FileDataSource from the specified path name.

 

Method Summary
java.lang.String	getContentType() This method returns the MIME type of the data in the form of a string.
java.io.File	getFile() Return the File object that corresponds to this FileDataSource.
java.io.InputStream	getInputStream() This method will return an InputStream representing the the data and will throw an IOException if it can not do so.
java.lang.String	getName() Return the 'name' of this object.
java.io.OutputStream	getOutputStream() This method will return an OutputStream representing the the data and will throw an IOException if it can not do so.
void	setFileTypeMap(FileTypeMap map) Set the FileTypeMap to use with this FileDataSource

 

Methods inherited from class java.lang.Object

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

 

Constructor Detail

FileDataSource

public FileDataSource(java.io.File file)

Creates a FileDataSource from a File object. Note: The file will not actually be opened until a method is called that requires the file to be opened.

Parameters:

file - the file to be opened for reading.

FileDataSource

public FileDataSource(java.lang.String name)

Creates FileDataSource from the specified path name. Note: The file will not actually be opened until a method is called that requires the file to be opened.

Parameters:

name - the system-dependent file name.

getInputStream

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

This method will return an InputStream representing the the data and will throw an IOException if it can not do so. This method will return a new instance of InputStream with each invocation.

Implements:

getInputStream in interface DataSource

Returns:

an InputStream

getOutputStream

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

This method will return an OutputStream representing the the data and will throw an IOException if it can not do so. This method will return a new instance of OutputStream with each invocation.

Implements:

getOutputStream in interface DataSource

Returns:

an OutputStream

getContentType

public java.lang.String getContentType()

This method returns the MIME type of the data in the form of a string. The semantics of this call are to use the currently installed FileTypeMap. If there is no FileTypeMap explictly set, the FileDataSource will call the getDefaultFileTypeMap method on FileTypeMap to acquire a default FileTypeMap. Note: By default the FileTypeMap used will be a MimetypesFileTypeMap.

Implements:

getContentType in interface DataSource

Returns:

the MIME Type

See Also:

getDefaultFileTypeMap

getName

public java.lang.String getName()

Return the 'name' of this object. The FileDataSource will return the file name of the object.

Implements:

getName in interface DataSource

Returns:

the name of the object.

See Also:

DataSource

getFile

public java.io.File getFile()

Return the File object that corresponds to this FileDataSource.

Returns:

the File object for the file represented by this object.

setFileTypeMap

public void setFileTypeMap(FileTypeMap map)

Set the FileTypeMap to use with this FileDataSource

Parameters:

map - The FileTypeMap for this object.