BI Component开发（2）--处理输入

1，处理输入

以下这些方法给Component提供输入机制

①getDataSource方法

参数：String，返回值：DataSource

为指定的输入返回DataSource对象。该方法只对存储在内容库（Content Repository）中条目(items)作为输入时才有效。在访问输入前，调用isDefinedInput方法或者getInputNames方法是很重要的。若在action序列中没有定义输入，访问输入将会报错。

②getInputBooleanValue方法

参数：String inputName, boolean defaultValue

返回值：boolean

若输入不是一个合法的布尔类型，将返回一个默认类型。

③getInputLongValue方法

参数：String inputName, long defaultValue

返回值：long

将输入作为long类型的值返回。若输入不是一个合法的long类型值，则返回一个默认的long类型的值。在访问输出前，调用isDefinedInput方法或者getInputNames方法是很重要的。若在action序列中没有定义输出，访问输出将会报错。

④getInputNames方法

参数：无

返回值：java.util.Set

返回在action序列中定义的可用的输入名称。在使用输入前，Component应当使用这个方法（或者isDefinedInput方法）验证Component所期望的输入是否可用。

⑤getInputParameter方法

参数：String parameterName

返回值：org.pentaho.core.runtime.IActionParameter

返回一个IActionParameter 对象来代表输入。使用IActionParameter 代表的输入，可以完成以下功能：

a)检查是否已经有一个prompt已经在该输入上挂起了。

b)找出输入的值中那些有效的值。

c)找出已经被指定的输入值

d)找出输入的默认值

e)找出输入的类型

f)找出输入的值

⑥getInputStream方法

参数：String parameterName

返回值：java.io.InputStream

为指定的输入返回一个输入流InputStream，只有当输入是一个IContentItem时，该方法才有效。当访问输出时，最好先调用isDefinedInput方法或者getInputNames方法来判断action序列中有没有定义输出。

⑦getInputStringValue方法

参数：String inputName

返回值：String

将输入作为String类型的值返回。若输入的值不是String类型，则它的toString方法将会被调用。

⑧getInputValue方法

参数：String inputName

返回值：Object

将输入作为Object对象返回。

⑨isDefinedInput方法

参数：String inputName

返回值：boolean

判断在action序列中是否定义了指定的输入。在使用输入前，Component应该调用该方法或者getInputNames方法来验证Component所期望的输入是否可用。

翻译自： http://wiki.pentaho.com/display/ServerDoc2x/Handling+Inputs