fixed javadoc to reflect current implementation (SPR-6390)

This commit is contained in:
Juergen Hoeller 2009-11-19 19:27:40 +00:00
parent b41e3956bc
commit 856fefeaad
1 changed files with 12 additions and 14 deletions

View File

@ -518,11 +518,10 @@ public abstract class AbstractJasperReportsView extends AbstractUrlBasedView {
/** /**
* Finds the report data to use for rendering the report and then invokes the * Finds the report data to use for rendering the report and then invokes the
* <code>renderReport</code> method that should be implemented by the subclass. * {@link #renderReport} method that should be implemented by the subclass.
* @param model the model map, as passed in for view rendering. Must contain * @param model the model map, as passed in for view rendering. Must contain
* a report data value that can be converted to a <code>JRDataSource</code>, * a report data value that can be converted to a <code>JRDataSource</code>,
* acccording to the <code>getReportData</code> method. * acccording to the rules of the {@link #fillReport} method.
* @see #getReportData
*/ */
@Override @Override
protected void renderMergedOutputModel( protected void renderMergedOutputModel(
@ -579,9 +578,11 @@ public abstract class AbstractJasperReportsView extends AbstractUrlBasedView {
/** /**
* Create a populated <code>JasperPrint</code> instance from the configured * Create a populated <code>JasperPrint</code> instance from the configured
* <code>JasperReport</code> instance. * <code>JasperReport</code> instance.
* <p>By default, thois method will use any <code>JRDataSource</code> instance * <p>By default, this method will use any <code>JRDataSource</code> instance
* (or wrappable <code>Object</code>) that can be located using {@link #getReportData}. * (or wrappable <code>Object</code>) that can be located using {@link #setReportDataKey},
* If no <code>JRDataSource</code> can be found, this method will use a JDBC * a lookup for type <code>JRDataSource</code> in the model Map, or a special value
* retrieved via {@link #getReportData}.
* <p>If no <code>JRDataSource</code> can be found, this method will use a JDBC
* <code>Connection</code> obtained from the configured <code>javax.sql.DataSource</code> * <code>Connection</code> obtained from the configured <code>javax.sql.DataSource</code>
* (or a DataSource attribute in the model). If no JDBC DataSource can be found * (or a DataSource attribute in the model). If no JDBC DataSource can be found
* either, the JasperReports engine will be invoked with plain model Map, * either, the JasperReports engine will be invoked with plain model Map,
@ -709,17 +710,14 @@ public abstract class AbstractJasperReportsView extends AbstractUrlBasedView {
} }
/** /**
* Find an instance of <code>JRDataSource</code> in the given model map or create an * Create an appropriate <code>JRDataSource</code> for passed-in report data.
* appropriate JRDataSource for passed-in report data. * Called by {@link #fillReport} when its own lookup steps were not successful.
* <p>The default implementation checks for a model object under the * <p>The default implementation looks for a value of type <code>java.util.Collection</code>
* specified "reportDataKey" first, then falls back to looking for a value * or object array (in that order). Can be overridden in subclasses.
* of type <code>JRDataSource</code>, <code>java.util.Collection</code>,
* object array (in that order).
* @param model the model map, as passed in for view rendering * @param model the model map, as passed in for view rendering
* @return the <code>JRDataSource</code> or <code>null</code> if the data source is not found * @return the <code>JRDataSource</code> or <code>null</code> if the data source is not found
* @see #setReportDataKey
* @see #convertReportData
* @see #getReportDataTypes * @see #getReportDataTypes
* @see #convertReportData
*/ */
protected JRDataSource getReportData(Map<String, Object> model) { protected JRDataSource getReportData(Map<String, Object> model) {
// Try to find matching attribute, of given prioritized types. // Try to find matching attribute, of given prioritized types.