Instances of this class are used for defining and setting exporter parameters.
The
JasperPrint object needed for the export can be specified in many ways: an instance of JasperPrint,
an input stream, a file on disk, or an URL. The export engine will search for this object through parameters in the following
order: JASPER_PRINT_LIST, JASPER_PRINT, INPUT_STREAM, INPUT_URL, INPUT_FILE, INPUT_FILE_NAME.
The output type of the export process can also vary: a string buffer, an output stream / writer of a file on disk. The order of
parameters used by JasperReports when looking for the output depends on the final document format and is explained in detail
for each format (see documentation for the children of this class).
JasperReports allows users to export only a page range from the entire report or even a single page. The engine first
searches for the PAGE_INDEX parameter. If this is not present, it looks for the START_PAGE_INDEX and END_PAGE_INDEX
parameters. The engine will try to narrow the page range (which is initially the entire report) by using these two
parameters, if present.
author: Teodor Danciu (teodord@users.sourceforge.net) version: $Id: JRExporterParameter.java 1824 2007-08-23 14:19:12Z teodord $
A java.io.File pointing to a file representing the serialized form of the
JasperPrint object. This is
useful if the JasperPrint object is representing a file on disk.
The input stream that the exported
JasperPrint object will be read from. If you want to read the JasperPrint
object from an input stream (like a web location), you can pass the stream to this parameter.
The URL that the
JasperPrint object will be read from. If the JasperPrint object is available as a web
resource, you can use this parameter, instead of opening a HTTP connection and read from the input stream.
A parameter that allows users to move the entire content of each page horizontally. It is mostly useful for printing,
when the report data does not fit inside the page margins.
A parameter that allows users to move the entire content of each page vertically. It is mostly useful for printing,
when the report data does not fit inside the page margins.
The java.io.File instance that will be used to specify the file name of the exported report. This is useful when
exporting to a file and the File instance is already there.
The java.io.OutputStream instance that will be used to send the export output to. This is useful for sending
the export result to an output stream, such as a ServletOutputStream.
The java.io.Writer instance that will be used to send the export output to. This is useful for sending
the export result to a character stream, such as the PrintWriter of a servlet.
A
JRExportProgressMonitor instance for monitoring export status. This is useful for users who need to be
notified after each page is exported (a GUI tool that shows a progress bar might need this feature).
PROPERTY_CHARACTER_ENCODING
final public static String PROPERTY_CHARACTER_ENCODING(Code)