fr.opensagres.xdocreport.document

Class Generator<In,Out>

java.lang.Object

fr.opensagres.xdocreport.document.Generator<In,Out>

public abstract class Generator<In,Out>
extends java.lang.Object

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	CONVERTER_ID_HTTP_PARAM
static java.lang.String	DISPATCH_HTTP_PARAM
static java.lang.String	DOWNLOAD_DISPATCH
static java.lang.String	ENTRY_NAME_HTTP_PARAM
static java.lang.String	PROCESS_STATE_HTTP_PARAM
static java.lang.String	REMOVE_DISPATCH
static java.lang.String	REPORT_ID_HTTP_PARAM
static java.lang.String	TEMPLATE_ENGINE_ID_HTTP_PARAM
static java.lang.String	TEMPLATE_ENGINE_KIND_HTTP_PARAM
static java.lang.String	VIEW_DISPATCH

Constructor Summary

Constructors

Constructor and Description
Generator()

Method Summary

Modifier and Type	Method and Description
protected void	doDocumentArchive(ProcessState state, java.lang.String entryName, In request, Out response)
protected boolean	doGenerateReport(java.lang.String entryName, In request, Out response)
protected void	doRedirectAfterRemoveReport(In request, Out response)
protected void	doRemoveReport(In request, Out response) Remove report from the registry.
protected void	doSaveEntry(ProcessState processState, java.lang.String entryName, In request, Out response) Extract entry from a report.
protected void	doSaveReport(ProcessState processState, In request, Out response) Save document archive of the report.
protected abstract void	error(In request, Out response, java.lang.Exception cause) Invoked when there is an error thrown in any part of doRequest() processing.
protected java.lang.String	getConverterId(IXDocReport report, In request) Returns the converter id.
protected java.lang.String	getDispatchParameter(In request) Returns dispatch parameter value.
protected java.lang.String	getEntryName(In request) Returns the entry name of the report.
protected FieldsMetadata	getFieldsMetadata(java.lang.String reportId, In request)
protected Options	getOptionsConverter(IXDocReport report, In request)
protected abstract java.io.OutputStream	getOutputStream(Out response)
protected abstract java.lang.String	getParameter(In request, java.lang.String name)
protected ProcessState	getProcessState(In request) Returns process state (original|preprocessed|generated).
protected XDocReportRegistry	getRegistry(In request) Returns the XDocReport registry which load and cache document.
protected IXDocReport	getReport(In request)
protected java.lang.String	getReportId(In request) Returns the id of the report.
protected abstract java.io.InputStream	getSourceStream(java.lang.String reportId, In request) Returns input stream of the report to load identified with reportId.
protected ITemplateEngine	getTemplateEngine(In request) Returns the template engine from request and otherwise returns the default template engine.
protected ITemplateEngine	getTemplateEngine(IXDocReport report, In request)
protected ITemplateEngine	getTemplateEngine(java.lang.String reportId, In request) Returns the template engine to use for the report.
protected java.lang.String	getTemplateEngineId(In request) Returns the template engine id from request.
protected java.lang.String	getTemplateEngineKind(In request)
protected java.lang.String	getTemplateEngineKind(java.lang.String reportId, In request)
protected boolean	isCacheOriginalDocument(java.lang.String reportId, In request)
protected boolean	isGenerateContentDisposition(java.lang.String reportId, MimeMapping mimeMapping, In request)
protected IXDocReport	loadReport(java.lang.String reportId, XDocReportRegistry registry, In request) Load report.
protected abstract void	populateContext(IContext context, java.lang.String reportId, In request) Put the Java model in the context for the report reportId.
protected abstract void	prepareHTTPResponse(java.lang.String id, MimeMapping mimeMapping, In request, Out response)
protected abstract void	prepareHTTPResponse(java.lang.String reportId, java.lang.String entryName, In request, Out response)
protected void	prepareOptions(Options options, IXDocReport report, java.lang.String converterId, In request)
void	processRequest(In request, Out response) Handles all requests (by default).

Methods inherited from class java.lang.Object

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

Field Detail

REMOVE_DISPATCH

public static final java.lang.String REMOVE_DISPATCH

See Also:

Constant Field Values

DOWNLOAD_DISPATCH

public static final java.lang.String DOWNLOAD_DISPATCH

See Also:

Constant Field Values

VIEW_DISPATCH

public static final java.lang.String VIEW_DISPATCH

See Also:

Constant Field Values

REPORT_ID_HTTP_PARAM

public static final java.lang.String REPORT_ID_HTTP_PARAM

See Also:

Constant Field Values

TEMPLATE_ENGINE_KIND_HTTP_PARAM

public static final java.lang.String TEMPLATE_ENGINE_KIND_HTTP_PARAM

See Also:

Constant Field Values

TEMPLATE_ENGINE_ID_HTTP_PARAM

public static final java.lang.String TEMPLATE_ENGINE_ID_HTTP_PARAM

See Also:

Constant Field Values

ENTRY_NAME_HTTP_PARAM

public static final java.lang.String ENTRY_NAME_HTTP_PARAM

See Also:

Constant Field Values

PROCESS_STATE_HTTP_PARAM

public static final java.lang.String PROCESS_STATE_HTTP_PARAM

See Also:

Constant Field Values

DISPATCH_HTTP_PARAM

public static final java.lang.String DISPATCH_HTTP_PARAM

See Also:

Constant Field Values

CONVERTER_ID_HTTP_PARAM

public static final java.lang.String CONVERTER_ID_HTTP_PARAM

See Also:

Constant Field Values

Constructor Detail

Generator

public Generator()

Method Detail

processRequest

public void processRequest(In request,
                           Out response)
                    throws java.lang.Exception

Handles all requests (by default).

Parameters:

request - In object containing client request

response - Out object for the response

Throws:

java.lang.Exception

doRemoveReport

protected void doRemoveReport(In request,
                              Out response)
                       throws java.io.IOException

Remove report from the registry.

Parameters:

request -

response -

Throws:

java.io.IOException

doRedirectAfterRemoveReport

protected void doRedirectAfterRemoveReport(In request,
                                           Out response)
                                    throws java.io.IOException

Throws:

java.io.IOException

doDocumentArchive

protected void doDocumentArchive(ProcessState state,
                                 java.lang.String entryName,
                                 In request,
                                 Out response)
                          throws java.lang.Exception

Throws:

java.lang.Exception

doSaveReport

protected void doSaveReport(ProcessState processState,
                            In request,
                            Out response)
                     throws java.lang.Exception

Save document archive of the report.

Parameters:

processState -

request -

response -

Throws:

java.io.IOException

java.lang.Exception

doSaveEntry

protected void doSaveEntry(ProcessState processState,
                           java.lang.String entryName,
                           In request,
                           Out response)
                    throws java.io.IOException,
                           java.lang.Exception

Extract entry from a report.

Parameters:

processState -

request -

response -

Throws:

java.io.IOException

java.lang.Exception

doGenerateReport

protected boolean doGenerateReport(java.lang.String entryName,
                                   In request,
                                   Out response)
                            throws java.lang.Exception,
                                   java.io.IOException

Throws:

java.lang.Exception

java.io.IOException

getReport

protected IXDocReport getReport(In request)
                         throws java.io.IOException,
                                XDocReportException

Parameters:

request -

Returns:

Throws:

java.io.IOException

XDocReportException

loadReport

protected IXDocReport loadReport(java.lang.String reportId,
                                 XDocReportRegistry registry,
                                 In request)
                          throws java.io.IOException,
                                 XDocReportException

Load report.

Parameters:

reportId -

registry -

request -

Returns:

Throws:

java.io.IOException

XDocReportException

isCacheOriginalDocument

protected boolean isCacheOriginalDocument(java.lang.String reportId,
                                          In request)

getFieldsMetadata

protected FieldsMetadata getFieldsMetadata(java.lang.String reportId,
                                           In request)

error

protected abstract void error(In request,
                              Out response,
                              java.lang.Exception cause)

Invoked when there is an error thrown in any part of doRequest() processing.

Default will send a simple HTML response indicating there was a problem.

Parameters:

request - original In from servlet container.

response - Out object from servlet container.

cause - Exception that was thrown by some other part of process.

getConverterId

protected java.lang.String getConverterId(IXDocReport report,
                                          In request)

Returns the converter id.

Parameters:

request -

Returns:

getOptionsConverter

protected Options getOptionsConverter(IXDocReport report,
                                      In request)

prepareOptions

protected void prepareOptions(Options options,
                              IXDocReport report,
                              java.lang.String converterId,
                              In request)

isGenerateContentDisposition

protected boolean isGenerateContentDisposition(java.lang.String reportId,
                                               MimeMapping mimeMapping,
                                               In request)

getDispatchParameter

protected java.lang.String getDispatchParameter(In request)

Returns dispatch parameter value.

Parameters:

request -

Returns:

getReportId

protected java.lang.String getReportId(In request)

Returns the id of the report.

Parameters:

request -

Returns:

getProcessState

protected ProcessState getProcessState(In request)

Returns process state (original|preprocessed|generated).

Parameters:

request -

Returns:

getEntryName

protected java.lang.String getEntryName(In request)

Returns the entry name of the report.

Parameters:

request -

Returns:

getTemplateEngineKind

protected java.lang.String getTemplateEngineKind(java.lang.String reportId,
                                                 In request)

getTemplateEngineKind

protected java.lang.String getTemplateEngineKind(In request)

getTemplateEngineId

protected java.lang.String getTemplateEngineId(In request)

Returns the template engine id from request.

Parameters:

request -

Returns:

getTemplateEngine

protected ITemplateEngine getTemplateEngine(java.lang.String reportId,
                                            In request)

Returns the template engine to use for the report. By default, it search if there is template id from request and otherwise returns the default template engine.

Parameters:

reportId -

request -

Returns:

getTemplateEngine

protected ITemplateEngine getTemplateEngine(IXDocReport report,
                                            In request)

getTemplateEngine

protected ITemplateEngine getTemplateEngine(In request)

Returns the template engine from request and otherwise returns the default template engine.

Parameters:

request -

Returns:

getRegistry

protected XDocReportRegistry getRegistry(In request)

Returns the XDocReport registry which load and cache document. By default the registry is a singleton. If you wish manage registry per HTTP session, override this method, create an instance per session and returns the registry instance linked to the HTTP session.

Parameters:

request -

Returns:

getSourceStream

protected abstract java.io.InputStream getSourceStream(java.lang.String reportId,
                                                       In request)
                                                throws java.io.IOException,
                                                       XDocReportException

Returns input stream of the report to load identified with reportId.

Parameters:

reportId - report id.

request - Http servlet request context.

Returns:

Throws:

java.io.IOException

XDocReportException

populateContext

protected abstract void populateContext(IContext context,
                                        java.lang.String reportId,
                                        In request)
                                 throws java.io.IOException,
                                        XDocReportException

Put the Java model in the context for the report reportId.

Parameters:

context - XDocReport context to register Java data model.

reportId - report id.

request - Http servlet request context.

Throws:

java.io.IOException

XDocReportException

getOutputStream

protected abstract java.io.OutputStream getOutputStream(Out response)
                                                 throws java.io.IOException

Throws:

java.io.IOException

getParameter

protected abstract java.lang.String getParameter(In request,
                                                 java.lang.String name)

prepareHTTPResponse

protected abstract void prepareHTTPResponse(java.lang.String id,
                                            MimeMapping mimeMapping,
                                            In request,
                                            Out response)

prepareHTTPResponse

protected abstract void prepareHTTPResponse(java.lang.String reportId,
                                            java.lang.String entryName,
                                            In request,
                                            Out response)