org.pentaho.platform.api.engine
Interface IParameterProvider

All Known Subinterfaces:
IParameterSetter
All Known Implementing Classes:
BaseParameterProvider, CustomSettingsParameterProvider, FlashChartRequestMapper, FlashChartRequestMapper, HttpRequestParameterProvider, HttpSessionParameterProvider, JVMParameterProvider, PentahoSessionParameterProvider, PortletPreferencesParameterProvider, PortletRequestParameterProvider, PortletSessionParameterProvider, SecurityParameterProvider, SimpleParameterProvider, SimpleParameterSetter, SystemSettingsParameterProvider

public interface IParameterProvider

A ParameterProvider is a source for input, output or resource parameters for a given action. The parameter definitions exist within the SequenceDefinition. The values for the parameters are supplied from the ParameterProvider.


Field Summary
static String SCOPE_REQUEST
           
static String SCOPE_SESSION
           
 
Method Summary
 Object[] getArrayParameter(String name, Object[] defaultValue)
          Retrieve the requested parameter as an Object array
 Date getDateParameter(String name, Date defaultValue)
          Retrieve the requested parameter as type java.util.Date.
 BigDecimal getDecimalParameter(String name, BigDecimal defaultValue)
          Retrieve the requested parameter as decimal, returning a java.lang.Object.
 long getLongParameter(String name, long defaultValue)
          Retrieve the requested parameter as primitive Java type long.
 Object getParameter(String name)
          Gets the named parameter from the provider as it's native type
 Iterator getParameterNames()
          Return list of all avialable parameter names in this provider
 String[] getStringArrayParameter(String name, String[] defaultValue)
          Retrieve the requested parameter as a String array
 String getStringParameter(String name, String defaultValue)
          Retrieve the requested parameter as type java.lang.String
 boolean hasParameter(String name)
           
 

Field Detail

SCOPE_REQUEST

static final String SCOPE_REQUEST
See Also:
Constant Field Values

SCOPE_SESSION

static final String SCOPE_SESSION
See Also:
Constant Field Values
Method Detail

getStringParameter

String getStringParameter(String name,
                          String defaultValue)
Retrieve the requested parameter as type java.lang.String

Parameters:
name - name of parameter to retrieve
defaultValue - value to return if the named parameter can not be found
Returns:
value of requested parameter, or the defaultValue if not found

getLongParameter

long getLongParameter(String name,
                      long defaultValue)
Retrieve the requested parameter as primitive Java type long.

Parameters:
name - name of parameter to retrieve
defaultValue - value to return if the named parameter can not be found
Returns:
value of requested parameter, or the defaultValue if not found

getDateParameter

Date getDateParameter(String name,
                      Date defaultValue)
Retrieve the requested parameter as type java.util.Date.

Parameters:
name - name of parameter to retrieve
defaultValue - value to return if the named parameter can not be found
Returns:
value of requested parameter, or the defaultValue if not found

getDecimalParameter

BigDecimal getDecimalParameter(String name,
                               BigDecimal defaultValue)
Retrieve the requested parameter as decimal, returning a java.lang.Object.

Parameters:
name - name of parameter to retrieve
defaultValue - value to return if the named parameter can not be found
Returns:
value of requested parameter, or the defaultValue if not found

getArrayParameter

Object[] getArrayParameter(String name,
                           Object[] defaultValue)
Retrieve the requested parameter as an Object array

Parameters:
name - name of parameter to retrieve
defaultValue - value to return if the named parameter can not be found
Returns:
value of requested parameter converted to an array if it wasn't already an array, or the defaultValue if not found

getStringArrayParameter

String[] getStringArrayParameter(String name,
                                 String[] defaultValue)
Retrieve the requested parameter as a String array

Parameters:
name - name of parameter to retrieve
defaultValue - value to return if the named parameter can not be found
Returns:
value of requested parameter converted to a String array if it wasn't already a String array, or the defaultValue if not found

getParameterNames

Iterator getParameterNames()
Return list of all avialable parameter names in this provider

Returns:
Set of parameter names

getParameter

Object getParameter(String name)
Gets the named parameter from the provider as it's native type

Parameters:
name - The name of the parameter to retrieve
Returns:
The native object

hasParameter

boolean hasParameter(String name)
Parameters:
name - Name of the parameter to look up
Returns:
true if the parameter exists in the parameter provider