org.dspace.app.mediafilter

Interface FormatFilter

All Known Implementing Classes:

BrandedPreviewJPEGFilter, HTMLFilter, JPEGFilter, MediaFilter, PDFFilter, PowerPointFilter, WordFilter, XPDF2Text, XPDF2Thumbnail

public interface FormatFilter

Public interface for any class which transforms or converts content/bitstreams from one format to another. This interface should be implemented by any class which defines a "filter" to be run by the MediaFilterManager.

Method Summary

Methods

Modifier and Type	Method and Description
java.lang.String	getBundleName()
java.lang.String	getDescription()
java.io.InputStream	getDestinationStream(java.io.InputStream source)
java.lang.String	getFilteredName(java.lang.String sourceName) Get a filename for a newly created filtered bitstream
java.lang.String	getFormatString()
void	postProcessBitstream(Context c, Item item, Bitstream generatedBitstream) Perform any post-processing of the generated bitstream *after* this filter has already been run.
boolean	preProcessBitstream(Context c, Item item, Bitstream source) Perform any pre-processing of the source bitstream *before* the actual filtering takes place in MediaFilterManager.processBitstream().

Method Detail

getFilteredName

java.lang.String getFilteredName(java.lang.String sourceName)

Get a filename for a newly created filtered bitstream

Parameters:

sourceName - name of source bitstream

Returns:

filename generated by the filter - for example, document.pdf becomes document.pdf.txt

getBundleName

java.lang.String getBundleName()

Returns:

name of the bundle this filter will stick its generated Bitstreams

getFormatString

java.lang.String getFormatString()

Returns:

name of the bitstream format (say "HTML" or "Microsoft Word") returned by this filter look in the bitstream format registry or mediafilter.cfg for valid format strings.

getDescription

java.lang.String getDescription()

Returns:

string to describe the newly-generated Bitstream's - how it was produced is a good idea

getDestinationStream

java.io.InputStream getDestinationStream(java.io.InputStream source)
                                         throws java.lang.Exception

Parameters:

source - input stream

Returns:

result of filter's transformation, written out to a bitstream

Throws:

java.lang.Exception

preProcessBitstream

boolean preProcessBitstream(Context c,
                          Item item,
                          Bitstream source)
                            throws java.lang.Exception

Perform any pre-processing of the source bitstream *before* the actual filtering takes place in MediaFilterManager.processBitstream().

Return true if pre-processing is successful (or no pre-processing is necessary). Return false if bitstream should be skipped for any reason.

Parameters:

c - context

item - item containing bitstream to process

source - source bitstream to be processed

Returns:

true if bitstream processing should continue, false if this bitstream should be skipped

Throws:

java.lang.Exception

postProcessBitstream

void postProcessBitstream(Context c,
                        Item item,
                        Bitstream generatedBitstream)
                          throws java.lang.Exception

Perform any post-processing of the generated bitstream *after* this filter has already been run.

Return true if pre-processing is successful (or no pre-processing is necessary). Return false if bitstream should be skipped for some reason.

Parameters:

c - context

item - item containing bitstream to process

generatedBitstream - the bitstream which was generated by this filter.

Throws:

java.lang.Exception