Package org.opennms.reporting.core.svclayer.support

Class DefaultReportWrapperService

java.lang.Object

org.opennms.reporting.core.svclayer.support.DefaultReportWrapperService

All Implemented Interfaces:

ReportWrapperService

public class DefaultReportWrapperService
extends java.lang.Object
implements ReportWrapperService

Constructor Summary

Constructors

Constructor	Description
DefaultReportWrapperService()

Method Summary

Modifier and Type	Method	Description
DeliveryOptions	getDeliveryOptions(java.lang.String reportId, java.lang.String userId)	This method returns the delivery options for the report.
java.util.List<ReportFormat>	getFormats(java.lang.String reportId)	This method provides a list of formats supported by the report
ReportParameters	getParameters(java.lang.String reportId)	This method retrieves the runtime parameters taken by the report
java.lang.Boolean	hasParameters(java.lang.String reportId)	This method is used to determine whether the report takes any parameters
void	render(java.lang.String reportId, java.lang.String location, ReportFormat format, java.io.OutputStream outputStream)	This method renders the report into a given output stream.
void	run(ReportParameters parameters, ReportMode mode, DeliveryOptions deliveryOptions, java.lang.String reportId)	This method runs the report
void	runAndRender(ReportParameters parameters, ReportMode mode, java.io.OutputStream outputStream)	This method runs the report and renders in into the given output stream with no intermediate steps
void	setReportServiceLocator(ReportServiceLocator reportServiceLocator)	setReportServiceLocator
void	setReportStoreService(ReportStoreService reportStoreService)	setReportStoreService
protected static java.lang.String	substituteUrl(java.lang.String url, java.util.Map<java.lang.String,java.lang.Object> parameters)
protected static java.lang.String	substituteUrl(java.lang.String url, DeliveryOptions deliveryOptions, java.util.Map<java.lang.String,java.lang.Object> reportParameters)

Methods inherited from class java.lang.Object

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

Constructor Detail

DefaultReportWrapperService

public DefaultReportWrapperService()

Method Detail

getFormats

public java.util.List<ReportFormat> getFormats(java.lang.String reportId)

This method provides a list of formats supported by the report

Specified by:

getFormats in interface ReportWrapperService

Parameters:

reportId - reportId as defined in database-reports.xml

Returns:

a list of supported formats

getDeliveryOptions

public DeliveryOptions getDeliveryOptions(java.lang.String reportId,
                                          java.lang.String userId)

This method returns the delivery options for the report. Providing a userID will allow the report service to pre-populate the destination address

Specified by:

getDeliveryOptions in interface ReportWrapperService

Parameters:

reportId - a String object.

userId - a String object.

Returns:

a delivery options object containing information that describes how the report might be delivered.

getParameters

public ReportParameters getParameters(java.lang.String reportId)

This method retrieves the runtime parameters taken by the report

Specified by:

getParameters in interface ReportWrapperService

Parameters:

reportId - a String object.

Returns:

a ReportParameters object containing the parameters taken by the report

hasParameters

public java.lang.Boolean hasParameters(java.lang.String reportId)

This method is used to determine whether the report takes any parameters

Specified by:

hasParameters in interface ReportWrapperService

Parameters:

reportId - a String object.

Returns:

true if the report takes parameters, false if not.

render

public void render(java.lang.String reportId,
                   java.lang.String location,
                   ReportFormat format,
                   java.io.OutputStream outputStream)

This method renders the report into a given output stream.

Specified by:

render in interface ReportWrapperService

Parameters:

reportId - reportId as defined in database-reports.xml

location - location of the report on disk

format - format to render the report

outputStream - stream to render the resulting report

run

public void run(ReportParameters parameters,
                ReportMode mode,
                DeliveryOptions deliveryOptions,
                java.lang.String reportId)

This method runs the report

Specified by:

run in interface ReportWrapperService

Parameters:

parameters - runtime report parameters

mode - in which to run the report (ONLINE, BATCH or IMMEDIATE)

deliveryOptions - delivery options for the report

reportId - reportId as defined in database-reports.xml

substituteUrl

protected static java.lang.String substituteUrl(java.lang.String url,
                                                DeliveryOptions deliveryOptions,
                                                java.util.Map<java.lang.String,java.lang.Object> reportParameters)

substituteUrl

protected static java.lang.String substituteUrl(java.lang.String url,
                                                java.util.Map<java.lang.String,java.lang.Object> parameters)

setReportServiceLocator

public void setReportServiceLocator(ReportServiceLocator reportServiceLocator)

setReportServiceLocator

Parameters:

reportServiceLocator - a ReportServiceLocator object.

setReportStoreService

public void setReportStoreService(ReportStoreService reportStoreService)

setReportStoreService

Parameters:

reportStoreService - a ReportStoreService object.

runAndRender

public void runAndRender(ReportParameters parameters,
                         ReportMode mode,
                         java.io.OutputStream outputStream)
                  throws ReportException

This method runs the report and renders in into the given output stream with no intermediate steps

Specified by:

runAndRender in interface ReportWrapperService

Parameters:

parameters - runtime report parameters

mode - in which to run the report (ONLINE, BATCH or IMMEDIATE)

outputStream - stream to render the resulting report

Throws:

ReportException