|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectcom.sun.javatest.report.CustomReport
public abstract class CustomReport
API to specify a customized report type for the Test Manager.
Nested Class Summary | |
---|---|
static class |
CustomReport.ReportConfigPanel
Configuration panel for a report. |
static class |
CustomReport.ReportEnviroment
Specified environment and settings for report generation. |
class |
CustomReport.ReportException
The class ReportException indicates an error during report creation. |
Constructor Summary | |
---|---|
CustomReport()
|
Method Summary | |
---|---|
abstract java.io.File |
createReport(java.io.File rootDir)
Create a report within the context of a GUI. |
abstract java.io.File |
createReport(java.lang.String args,
java.io.File rootDir,
InterviewParameters ip,
TestFilter filter)
Write a report without the context of a GUI. |
void |
dispose()
Dispose of any data or components which this class may be holding references to. |
abstract java.lang.String |
getDescription()
Get a longer description about the purpose of this report type. |
abstract java.lang.String |
getName()
Get a short name for this report type. |
CustomReport.ReportConfigPanel[] |
getOptionPanes()
Get report options panes. |
CustomReport.ReportEnviroment |
getReportEnviroment()
|
abstract java.lang.String |
getReportId()
Get a short internal name for this report type. |
java.io.InputStream |
getXmlReport()
Request the content of the standard XML report from the harness. |
boolean |
needsXmlReport()
Will this report need the standard XML data report if it is run. |
void |
setEnviroment(CustomReport.ReportEnviroment envir)
|
abstract java.lang.String |
validateOptions()
Validate the options currently in the option panes. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public CustomReport()
Method Detail |
---|
public boolean needsXmlReport()
false
. Returning false does
not mean that the report cannot ask for the XML, but by correctly
answering, the harness may be able to apply some optimization based on
which other reports are being generated.
getXmlReport()
public final java.io.InputStream getXmlReport() throws java.io.IOException, org.xml.sax.SAXException
createReport
methods.
java.io.IOException
org.xml.sax.SAXException
needsXmlReport()
public abstract java.io.File createReport(java.io.File rootDir) throws CustomReport.ReportException
rootDir
- The directory to write the report to.
CustomReport.ReportException
- - if the report creation was unsuccessful.
Harness can show Exception's textpublic abstract java.io.File createReport(java.lang.String args, java.io.File rootDir, InterviewParameters ip, TestFilter filter) throws CustomReport.ReportException
args
- Arguments given to this report format. It is encoded into
a single string, the format of which is defined by the
report implementation. In general though, the arg string
must be absent of spaces, and should not require any
characters which require escaping on common platforms
(semicolon, ampersand, exclamation, any quotation marks).rootDir
- The directory to write the report to.ip
- The interview which should be report on.filter
- The test filter that should be applied when iterating
over the results to place in the report. If the report
relies on the XML report, this parameter can usually be
ignored since the XML report itself will have been filtered
already.
CustomReport.ReportException
- - if the report creation was unsuccessful.
Harness can show Exception's textPreferences
public abstract java.lang.String getReportId()
rootDir
parameter
of the createReport
methods.
getName()
,
Character.isJavaIdentifierStart(char)
,
Character.isJavaIdentifierPart(char)
public abstract java.lang.String getName()
public abstract java.lang.String getDescription()
public CustomReport.ReportEnviroment getReportEnviroment()
public CustomReport.ReportConfigPanel[] getOptionPanes()
public abstract java.lang.String validateOptions()
getOptionPanes
.
It can be assumed that this method is called just before
createReport
to ensure that the user's settings are valid (in
GUI mode). It is not called in non-GUI mode.
getOptionPanes()
,
CustomReport.ReportConfigPanel
public void dispose()
public void setEnviroment(CustomReport.ReportEnviroment envir)
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |