雅加达项目：可复用对话组件 (RDC) 标签库

版本：1.0.0

概述

JSP-2.0 可复用对话组件 (RDC) —— 一个用于创建 JSP 标签库的框架，旨在帮助快速开发语音和多模态应用程序。

服务器端 HTML 生成已被证明是生成使用 Struts 等服务器端应用程序框架实现的可视化 Web 应用程序用户界面的有效方式。随着时间的推移，各种 JSP 标签库的出现减少了此类 HTML 生成所需的工作量，这些标签库抽象掉了 HTML 标记的细节。RDC 项目的目标是为语音应用程序实现 JSP 标签库在可视化 Web 应用程序领域已经实现的成就。

随着语音技术的成熟以及 W3C VoiceXML 2.0 REC 中定义的稳定可靠的语音编程模型的出现，语音应用程序领域正在快速发展。在 Tomcat 等环境中将服务器端语音应用程序的开发主流化，必要的一步是提供适当的标签库，帮助 JSP 开发人员摆脱语音交互的复杂性。目标是帮助以 JSP 标签库的形式打包专业的语音设计技能，使 JSP 开发人员能够轻松地为 Web 应用程序启用语音功能。

要求

此自定义标签库需要支持 JavaServer Pages 规范 2.0 或更高版本的 servlet 容器 + Apache 项目的 jstl.jar 和 standard.jar + 用于延迟 EL 评估的 commons-el.jar + struts.jar、commons-beanutils.jar 和 commons-digester.jar（用于构建 Struts 支持）。

配置

请按照以下步骤配置您的 Web 应用程序以使用此标签库

将标签库描述符文件复制到您的 Web 应用程序的 /WEB-INF 子目录中。
将标签库 JAR 文件复制到您的 Web 应用程序的 /WEB-INF/lib 子目录中。

将 <taglib> 元素添加到您的 Web 应用程序部署描述符 /WEB-INF/web.xml 中，如下所示

        <taglib>
        <taglib-uri>https://tomcat.net.cn/taglibs/rdc-1.0</taglib-uri>
        <taglib-location>/WEB-INF/taglibs-rdc.tld</taglib-location>
        </taglib>

要在您的 JSP 页面中使用此库中的标签，请在每个页面顶部添加以下指令

      <%@ taglib uri="https://tomcat.net.cn/taglibs/rdc-1.0" prefix="rdc" %>

其中 "rdc" 是您希望用于此库中标签的标签名前缀。您可以将其更改为任何您喜欢的前缀。

标签摘要

原子组件

日期	收集日期
时间	收集时间
持续时间	收集持续时间
信用卡金额	收集信用卡账单金额
信用卡有效期	收集信用卡有效期
信用卡号	收集信用卡号
信用卡类型	收集信用卡类型
邮政编码	收集邮政编码
美国主要城市	收集美国主要城市名称
美国州份	收集美国州份名称
字母	收集一串字母
货币	收集货币值
字母数字	收集字母数字字符串
单选	从选项列表中收集一个选择
国家	收集国家名称
SSN	收集社会安全号码
ISBN	收集国际标准书号
百分比	收集百分比
数字	收集数值
数字串	收集数字串
抵押贷款类型	收集抵押贷款类型
模板	用于快速开发原子 RDC 的模板

复合组件

抵押贷款	收集抵押贷款信息：包括抵押贷款类型和首付百分比
信用卡信息	收集信用卡信息：包括卡类型、卡号、有效期和安全码

框架标签

任务	提供 RDC 所需的脚手架
分组	用作托管多个 RDC 并使用可插拔对话管理策略管理它们之间对话的容器
推入	将元素推入堆栈。
弹出	从堆栈顶部弹出元素。
窥视	窥视堆栈顶部元素。

辅助标签

注释	RDC 注释
暂停	应用程序暂停的可能处理程序
你好	RDC Hello World 标签
FSM 输入	生成 VoiceXML 的辅助标签，用于收集使用默认 RDC FSM 的组件的输入。
FSM 确认	生成 VoiceXML 的辅助标签，用于确认使用默认 RDC FSM 的组件的输入。
FSM 运行	定义默认 RDC FSM 的辅助标签。
提取参数	从浏览器发送的 HTTP 请求中提取必要的参数。
设置结果	设置此组件的属性，这些属性影响浏览器提交结果的方式和位置。
设置配置复合	在复合组件中设置页面上下文和配置。
设置语法	使用资源包中给定属性作为语法 URI 来设置语法。
配置	配置此组件的提示、属性等。如果用户未提供配置，则使用预设的默认配置。
展开	将包含使用自定义语法 "#{...}" 的表达式的文本评估为 JSP 2.0 EL 表达式
包含 FSM 片段	为此 RDC 模板实例包含标签片段。
Struts 提交	将 namelist 中指定的 RDC 值提交到 Struts 层。
Struts 错误	播放前一个 Struts 动作中的所有错误消息。
获取配置	从此 RDC 的配置文件中获取与给定 XPath 对应的元素
获取资源	从资源包中获取由键指定的资源。
获取默认配置	获取此组件的默认配置。

标签参考

日期 - 日期
收集日期
属性	名称	值	必填	运行时表达式评估	摘要
	ID	某个名称	是	否	组件 ID

	最小日期	xxxxxxxx	否	是	最小可接受日期

	最大日期	xxxxxxxx	否	是	最大可接受日期

	初始值	xxxxxx	否	是	日期的默认值

	确认	true/false	否	是	确认选项

	回显	true/false	否	是	播放选项

	区域设置	[语言](-[国家])?	否	是	RDC 区域设置

	最大无输入次数	[0-9]*	否	是	无输入时的优雅退出

	最大无匹配次数	[0-9]*	否	是	无匹配时的优雅退出

	配置	xxx-cfg.xml	否	是	组件的配置文件

	N 最佳数量	[0-9]*	否	是	请求的 N 最佳值的最大数量

	最小置信度	[0-9][0-9].[0-9]*F	否	是	识别输出的最小置信度值

	提交	自身 URI	否	是	提交结果的位置

用法	<rdc:date id="myDate" minDate="01012004" maxDate="12312005" echo="true" />
示例	请参见 rdc-examples 应用程序中的 date-test.jsp。

时间 - 时间
收集时间
属性	名称	值	必填	运行时表达式评估	摘要
	ID	某个名称	是	否	组件 ID

	最小时间	xxxxxx	否	是	最小可接受时间

	最大时间	xxxxxx	否	是	最大可接受时间

	初始值	xxxxxx	否	是	时间的默认值

	确认	true/false	否	是	确认选项

	回显	true/false	否	是	播放选项

	区域设置	[语言](-[国家])?	否	是	RDC 区域设置

	配置	xxx-cfg.xml	否	是	组件的配置文件

	N 最佳数量	[0-9]*	否	是	请求的 N 最佳值的最大数量

	最小置信度	[0-9][0-9].[0-9]*F	否	是	识别输出的最小置信度值

	最大无输入次数	[0-9]*	否	是	无输入时的优雅退出

	最大无匹配次数	[0-9]*	否	是	无匹配时的优雅退出

	提交	自身 URI	否	是	提交结果的位置

用法	<rdc:time id="myTime" minTime="xx30x" maxTime="xx60x" confirm="true" />
示例	请参见 rdc-examples 应用程序中的 time-test.jsp。

持续时间 - 持续时间
收集持续时间
属性	名称	值	必填	运行时表达式评估	摘要
	ID	某个名称	是	否	组件 ID

	最小持续时间	P([0-9]{2}Y)?([0-9]{2}M)?([0-9]{2}D)?	否	是	最小可接受持续时间

	最大持续时间	P([0-9]{2}Y)?([0-9]{2}M)?([0-9]{2}D)?	否	是	最大可接受持续时间

	初始值	P([0-9]{2}Y)?([0-9]{2}M)?([0-9]{2}D)?	否	是	持续时间的默认值

	确认	true/false	否	是	确认选项

	区域设置	[语言](-[国家])?	否	是	RDC 区域设置

	回显	true/false	否	是	播放选项

	最大无输入次数	[0-9]*	否	是	无输入时的优雅退出

	最大无匹配次数	[0-9]*	否	是	无匹配时的优雅退出

	配置	xxx-cfg.xml	否	是	组件的配置文件

	N 最佳数量	[0-9]*	否	是	请求的 N 最佳值的最大数量

	最小置信度	[0-9][0-9].[0-9]*F	否	是	识别输出的最小置信度值

	提交	自身 URI	否	是	提交结果的位置

用法	<rdc:duration id="myDuration" echo="true" />
示例	请参见 rdc-examples 应用程序中的 duration-test.jsp。

信用卡金额 - 信用卡金额
收集信用卡账单金额
属性	名称	值	必填	运行时表达式评估	摘要
	ID	某个名称	是	否	组件 ID

	配置	xxx-cfg.xml	否	是	组件的配置文件

	N 最佳数量	[0-9]*	否	是	请求的 N 最佳值的最大数量

	区域设置	[语言](-[国家])?	否	是	RDC 区域设置

	最小置信度	[0-9][0-9].[0-9]*F	否	是	识别输出的最小置信度值

	回显	true/false	否	是	播放选项

	最大无输入次数	[0-9]*	否	是	无输入时的优雅退出

	最大无匹配次数	[0-9]*	否	是	无匹配时的优雅退出

	初始值	信用卡金额	否	是	信用卡金额的默认值

	确认	true/false	否	是	确认选项

	提交	自身 URI	否	是	提交 URL

用法	<rdc:creditcardAmount id="myCCAmount" minAmount="USD20.00" balance="USD123.45" />
示例	请参见 rdc-examples 应用程序中的 creditcardAmount-test.jsp。

信用卡有效期 - 信用卡有效期
收集信用卡有效期
属性	名称	值	必填	运行时表达式评估	摘要
	ID	某个名称	是	否	组件 ID

	配置	xxx-cfg.xml	否	是	组件的配置文件

	N 最佳数量	[0-9]*	否	是	请求的 N 最佳值的最大数量

	区域设置	[语言](-[国家])?	否	是	RDC 区域设置

	最小置信度	[0-9][0-9].[0-9]*F	否	是	识别输出的最小置信度值

	回显	true/false	否	是	播放选项

	最大无输入次数	[0-9]*	否	是	无输入时的优雅退出

	最大无匹配次数	[0-9]*	否	是	无匹配时的优雅退出

	初始值	信用卡有效期	否	是	信用卡有效期的默认值

	确认	true/false	否	是	确认选项

	提交	自身 URI	否	是	提交 URL

用法	<rdc:creditcardExpiry id="myCCExpiry" />
示例	请参见 rdc-examples 应用程序中的 creditcardExpiry-test.jsp。

信用卡号 - 信用卡号
收集信用卡号
属性	名称	值	必填	运行时表达式评估	摘要
	ID	某个名称	是	否	组件 ID

	配置	xxx-cfg.xml	否	是	组件的配置文件

	N 最佳数量	[0-9]*	否	是	请求的 N 最佳值的最大数量

	区域设置	[语言](-[国家])?	否	是	RDC 区域设置

	最小置信度	[0-9][0-9].[0-9]*F	否	是	识别输出的最小置信度值

	回显	true/false	否	是	播放选项

	最大无输入次数	[0-9]*	否	是	无输入时的优雅退出

	最大无匹配次数	[0-9]*	否	是	无匹配时的优雅退出

	初始值	信用卡号	否	是	信用卡号的默认值

	确认	true/false	否	是	确认选项

	提交	自身 URI	否	是	提交 URL

用法	<rdc:creditcardNumber id="myCCNumber" confirm="true" />
示例	请参见 rdc-examples 应用程序中的 creditcardNumber-test.jsp。

信用卡类型 - 信用卡类型
收集信用卡类型
属性	名称	值	必填	运行时表达式评估	摘要
	ID	某个名称	是	否	组件 ID

	配置	xxx-cfg.xml	否	是	组件的配置文件

	N 最佳数量	[0-9]*	否	是	请求的 N 最佳值的最大数量

	区域设置	[语言](-[国家])?	否	是	RDC 区域设置

	最小置信度	[0-9][0-9].[0-9]*F	否	是	识别输出的最小置信度值

	回显	true/false	否	是	播放选项

	最大无输入次数	[0-9]*	否	是	无输入时的优雅退出

	最大无匹配次数	[0-9]*	否	是	无匹配时的优雅退出

	初始值	信用卡类型	否	是	信用卡类型的默认值

	确认	true/false	否	是	确认选项

	提交	自身 URI	否	是	提交 URL

用法	<rdc:creditcardType id="myCCType" initial="Visa" echo="true" />
示例	请参见 rdc-examples 应用程序中的 creditcardType-test.jsp。

邮政编码 - 邮政编码
收集邮政编码
属性	名称	值	必填	运行时表达式评估	摘要
	ID	一个名称	是	否	组件 ID

	配置	xxx-cfg.xml	否	是	组件的配置文件

	N 最佳数量	[0-9]*	否	是	请求的 N 最佳值的最大数量

	最小置信度	[0-9][0-9].[0-9]*F	否	是	识别输出的最小置信度值

	回显	true/false	否	是	播放选项

	区域设置	[语言](-[国家])?	否	是	RDC 区域设置

	最大无输入次数	[0-9]*	否	是	无输入时的优雅退出

	最大无匹配次数	[0-9]*	否	是	无匹配时的优雅退出

	确认	true/false	否	是	确认选项

	长度	一个正整数	否	是	邮政编码中的位数

	模式	一个正则表达式	否	是	表示有效邮政编码集的正则表达式

	提交	提交 URI	否	是	JSP 页面的 URI

用法	<rdc:zipCode id="myZip" confirm="true" echo="true" />
示例	请参见 rdc-examples 应用程序中的 zipCode-test.jsp。

美国主要城市 - 美国主要城市
收集美国主要城市名称
属性	名称	值	必填	运行时表达式评估	摘要
	ID	一个名称	是	否	组件 ID

	配置	xxx-cfg.xml	否	是	组件的配置文件

	N 最佳数量	[0-9]*	否	是	请求的 N 最佳值的最大数量

	最小置信度	[0-9][0-9].[0-9]*F	否	是	识别输出的最小置信度值

	回显	true/false	否	是	播放选项

	区域设置	[语言](-[国家])?	否	是	RDC 区域设置

	最大无输入次数	[0-9]*	否	是	无输入时的优雅退出

	最大无匹配次数	[0-9]*	否	是	无匹配时的优雅退出

	确认	true/false	否	是	确认选项

	提交	提交 URI	否	是	JSP 页面的 URI

用法	<rdc:usMajorCity id="myCity" echo="true" />
示例	请参见 rdc-examples 应用程序中的 usMajorCity-test.jsp。

美国州份 - 美国州份
收集美国州份名称
属性	名称	值	必填	运行时表达式评估	摘要
	ID	一个名称	是	否	组件 ID

	配置	xxx-cfg.xml	否	是	组件的配置文件

	N 最佳数量	[0-9]*	否	是	请求的 N 最佳值的最大数量

	最小置信度	[0-9][0-9].[0-9]*F	否	是	识别输出的最小置信度值

	回显	true/false	否	是	播放选项

	区域设置	[语言](-[国家])?	否	是	RDC 区域设置

	最大无输入次数	[0-9]*	否	是	无输入时的优雅退出

	最大无匹配次数	[0-9]*	否	是	无匹配时的优雅退出

	确认	true/false	否	是	确认选项

	提交	提交 URI	否	是	JSP 页面的 URI

用法	<rdc:usState id="myState" />
示例	请参见 rdc-examples 应用程序中的 usState-test.jsp。

字母 - 字母
收集一串字母
属性	名称	值	必填	运行时表达式评估	摘要
	ID	某个名称	是	否	组件 ID

	提交	自身 URI	否	是	提交结果的位置

	配置	xxx-cfg.xml	否	是	组件的配置文件

	N 最佳数量	[0-9]*	否	是	请求的 N 最佳值的最大数量

	最小置信度	[0-9][0-9].[0-9]*F	否	是	识别输出的最小置信度值

	回显	true/false	否	是	播放选项

	区域设置	[语言](-[国家])?	否	是	RDC 区域设置

	最大无输入次数	[0-9]*	否	是	无输入时的优雅退出

	最大无匹配次数	[0-9]*	否	是	无匹配时的优雅退出

	初始值	[a-zA-Z ']*	否	是	字母的默认值

	确认	true/false	否	是	确认选项

	最小长度	[0-9]*	否	是	最小可接受长度

	最大长度	[0-9]*	否	是	最大可接受长度

	模式	正则表达式	否	是	可接受值的模式

用法	<rdc:alpha id="myAlpha" echo="true" />
示例	请参见 rdc-examples 应用程序中的 alpha-test.jsp。

货币 - 货币
收集货币值
属性	名称	值	必填	运行时表达式评估	摘要
	ID	某个名称	是	否	组件 ID

	最小值	[0-9]*.?[0-9]{0,2}	否	是	最小可接受金额

	最大值	[0-9]*.?[0-9]{0,2}	否	是	最大可接受金额

	货币代码	[A-Za-z][A-Za-z][A-Za-z]	否	是	ISO 4217 货币代码

	初始值	xxxxxx	否	是	默认金额

	确认	true/false	否	是	确认选项

	回显	true/false	否	是	播放选项

	区域设置	[语言](-[国家])?	否	是	RDC 区域设置

	最大无输入次数	[0-9]*	否	是	无输入时的优雅退出

	最大无匹配次数	[0-9]*	否	是	无匹配时的优雅退出

	配置	xxx-cfg.xml	否	是	组件的配置文件

	N 最佳数量	[0-9]*	否	是	请求的 N 最佳值的最大数量

	最小置信度	[0-9][0-9].[0-9]*F	否	是	识别输出的最小置信度值

	提交	自身 URI	否	是	提交 URL

用法	<rdc:currency id="myCurrency" minValue="100" echo="true" />
示例	请参见 rdc-examples 应用程序中的 currency-test.jsp。

字母数字 - 字母数字
收集字母数字字符串
属性	名称	值	必填	运行时表达式评估	摘要
	ID	某个名称	是	否	组件 ID

	提交	自身 URI	否	是	提交结果的位置

	配置	xxx-cfg.xml	否	是	组件的配置文件

	N 最佳数量	[0-9]*	否	是	请求的 N 最佳值的最大数量

	最小置信度	[0-9][0-9].[0-9]*F	否	是	识别输出的最小置信度值

	回显	true/false	否	是	播放选项

	区域设置	[语言](-[国家])?	否	是	RDC 区域设置

	最大无输入次数	[0-9]*	否	是	无输入时的优雅退出

	最大无匹配次数	[0-9]*	否	是	无匹配时的优雅退出

	初始值	[a-z0-9]*	否	是	字母数字的默认值

	确认	true/false	否	是	确认选项

	最小长度	[0-9]*	否	是	最小可接受长度

	最大长度	[0-9]*	否	是	最大可接受长度

	模式	正则表达式	否	是	可接受值的模式

用法	<rdc:alphanum id="myAlphanum" minLength="5" maxLength="5" pattern="[0-9]" confirm="true" echo="true"/>*
示例	请参见 rdc-examples 应用程序中的 alphanum-test.jsp。

单选 - 单选
从选项列表中收集一个选择
属性	名称	值	必填	运行时表达式评估	摘要
	ID	某个名称	是	否	组件 ID

	选项列表	*-opt.xml	是	是	用户将被要求从中选择的列表

	初始值	某个选项	否	是	默认选择

	确认	true/false	否	是	确认选项

	回显	true/false	否	是	播放选项

	区域设置	[语言](-[国家])?	否	是	RDC 区域设置

	配置	xxx-cfg.xml	否	是	组件的配置文件

	N 最佳数量	[0-9]*	否	是	请求的 N 最佳值的最大数量

	最小置信度	[0-9][0-9].[0-9]*F	否	是	识别输出的最小置信度值

	最大无输入次数	[0-9]*	否	是	无输入时的优雅退出

	最大无匹配次数	[0-9]*	否	是	无匹配时的优雅退出

	提交	自身 URI	否	是	提交 URL

用法	<rdc:select1 id="myChoice" config="myConfig.xml" optionsList="myOptions.xml" echo="true" />
示例	请参见 rdc-examples 应用程序中的 select1-test.jsp。

国家 - 国家
收集国家名称
属性	名称	值	必填	运行时表达式评估	摘要
	ID	某个名称	是	否	组件 ID

	初始值	印度	否	是	国家的默认值

	确认	true/false	否	是	确认选项

	回显	true/false	否	是	播放选项

	区域设置	[语言](-[国家])?	否	是	RDC 区域设置

	最大无输入次数	[0-9]*	否	是	无输入时的优雅退出

	最大无匹配次数	[0-9]*	否	是	无匹配时的优雅退出

	配置	xxx-cfg.xml	否	是	组件的配置文件

	N 最佳数量	[0-9]*	否	是	请求的 N 最佳值的最大数量

	最小置信度	[0-9][0-9].[0-9]*F	否	是	识别输出的最小置信度值

	提交	自身 URI	否	是	提交结果的位置

用法	<rdc:country id="myCountry" />
示例	请参见 rdc-examples 应用程序中的 country-test.jsp。

SSN - SSN
收集社会安全号码
属性	名称	值	必填	运行时表达式评估	摘要
	ID	某个名称	是	否	组件 ID

	模式	一个正则表达式	否	是	表示有效社会安全号码集的正则表达式

	配置	xxx-cfg.xml	否	是	组件的配置文件

	回显	true/false	否	是	播放选项

	确认	true/false	否	是	确认选项

	区域设置	[语言](-[国家])?	否	是	RDC 区域设置

	初始值	xxxxxxxxxx	否	是	SSN 的默认值

	N 最佳数量	[0-9]*	否	是	请求的 N 最佳值的最大数量

	最小置信度	[0-9][0-9].[0-9]*F	否	是	识别输出的最小置信度值

	最大无输入次数	[0-9]*	否	是	无输入时的优雅退出

	最大无匹配次数	[0-9]*	否	是	无匹配时的优雅退出

	提交	提交 URI	否	是	JSP 页面的 URI

用法	<rdc:ssn id="mySSN" />
示例	请参见 rdc-examples 应用程序中的 ssn-test.jsp。

ISBN - ISBN
收集国际标准书号
属性	名称	值	必填	运行时表达式评估	摘要
	ID	某个名称	是	否	组件 ID

	模式	一个正则表达式	否	是	表示有效国际标准书号集的正则表达式

	配置	xxx-cfg.xml	否	是	组件的配置文件

	回显	true/false	否	是	播放选项

	确认	true/false	否	是	确认选项

	区域设置	[语言](-[国家])?	否	是	RDC 区域设置

	最大无输入次数	[0-9]*	否	是	无输入时的优雅退出

	最大无匹配次数	[0-9]*	否	是	无匹配时的优雅退出

	初始值	xxxxxxxxxxx	否	是	ISBN 的默认值

	N 最佳数量	[0-9]*	否	是	请求的 N 最佳值的最大数量

	最小置信度	[0-9][0-9].[0-9]*F	否	是	识别输出的最小置信度值

	提交	提交 URI	否	是	JSP 页面的 URI

用法	<rdc:isbn id="myISBN" confirm="true" echo="true" />
示例	请参见 rdc-examples 应用程序中的 isbn-test.jsp。

百分比 - 百分比
收集百分比
属性	名称	值	必填	运行时表达式评估	摘要
	ID	某个名称	是	否	组件 ID

	最小值	[0-9]{1,2}	否	是	最小可接受百分比

	最大值	[0-9]{1,2}	否	是	最大可接受百分比

	初始值	[0-9]{1,2}	否	是	百分比的默认值

	区域设置	[语言](-[国家])?	否	是	RDC 区域设置

	确认	true/false	否	是	确认选项

	回显	true/false	否	是	播放选项

	最大无输入次数	[0-9]*	否	是	无输入时的优雅退出

	最大无匹配次数	[0-9]*	否	是	无匹配时的优雅退出

	配置	xxx-cfg.xml	否	是	组件的配置文件

	N 最佳数量	[0-9]*	否	是	请求的 N 最佳值的最大数量

	最小置信度	[0-9][0-9].[0-9]*F	否	是	识别输出的最小置信度值

	提交	自身 URI	否	是	提交结果的位置

用法	<rdc:percent id="myPercent" minPercent="10" maxPercent="75" />
示例	请参见 rdc-examples 应用程序中的 percent-test.jsp。

数字 - 数字
收集数值
属性	名称	值	必填	运行时表达式评估	摘要
	ID	某个名称	是	否	组件 ID

	提交	自身 URI	否	是	提交结果的位置

	配置	xxx-cfg.xml	否	是	组件的配置文件

	N 最佳数量	[0-9]*	否	是	请求的 N 最佳值的最大数量

	最小置信度	[0-9][0-9].[0-9]*F	否	是	识别输出的最小置信度值

	回显	true/false	否	是	播放选项

	区域设置	[语言](-[国家])?	否	是	RDC 区域设置

	最大无输入次数	[0-9]*	否	是	无输入时的优雅退出

	最大无匹配次数	[0-9]*	否	是	无匹配时的优雅退出

	初始值	[0-9].[0-9]	否	是	字母的默认值

	确认	true/false	否	是	确认选项

	最小值	[0-9].[0-9]	否	是	最小可接受值

	最大值	[0-9].[0-9]	否	是	最大可接受值

用法	<rdc:number id="myNumber" minValue="0" maxValue="100" />
示例	请参见 rdc-examples 应用程序中的 number-test.jsp。

数字串 - 数字串
收集数字串
属性	名称	值	必填	运行时表达式评估	摘要
	ID	某个名称	是	否	组件 ID

	最小位数	[0-9]*	否	是	最小可接受数字长度

	最大位数	[0-9]*	否	是	最大可接受数字长度

	初始值	[0-9]*	否	是	数字的默认值

	确认	true/false	否	是	确认选项

	回显	true/false	否	是	播放选项

	区域设置	[语言](-[国家])?	否	是	RDC 区域设置

	最大无输入次数	[0-9]*	否	是	无输入时的优雅退出

	最大无匹配次数	[0-9]*	否	是	无匹配时的优雅退出

	配置	xxx-cfg.xml	否	是	组件的配置文件

	N 最佳数量	[0-9]*	否	是	请求的 N 最佳值的最大数量

	最小置信度	[0-9][0-9].[0-9]*F	否	是	识别输出的最小置信度值

	提交	自身 URI	否	是	提交结果的位置

用法	<rdc:digits id="myDigits" minLength="3" maxLength="7" />
示例	请参见 rdc-examples 应用程序中的 digits-test.jsp。

抵押贷款类型 - 抵押贷款类型
收集抵押贷款类型
属性	名称	值	必填	运行时表达式评估	摘要
	ID	某个名称	是	否	组件 ID

	最小期限	[0-9]{1,2}Y(fixed\|adjustable)	否	是	最小可接受抵押贷款类型

	最大期限	[0-9]{1,2}Y(fixed\|adjustable)	否	是	最大可接受抵押贷款类型

	区域设置	[语言](-[国家])?	否	是	RDC 区域设置

	初始值	[0-9]{1,2}Y(fixed\|adjustable)	否	是	抵押贷款类型的默认值

	确认	true/false	否	是	确认选项

	最大无输入次数	[0-9]*	否	是	无输入时的优雅退出

	最大无匹配次数	[0-9]*	否	是	无匹配时的优雅退出

	回显	true/false	否	是	播放选项

	配置	xxx-cfg.xml	是	是	组件的配置文件

	N 最佳数量	[0-9]*	否	是	请求的 N 最佳值的最大数量

	最小置信度	[0-9][0-9].[0-9]*F	否	是	识别输出的最小置信度值

	提交	自身 URI	否	是	提交结果的位置

用法	<rdc:mortgageType id="myMortgageType" echo="true" />
示例	请参见 rdc-examples 应用程序中的 mortgageType-test.jsp。

模板 - RDC 模板
用于快速开发原子 RDC 的模板
属性	名称	值	必填	运行时表达式评估	摘要
	ID	某个名称	是	否	组件 ID

	语法	xxx.grxml	是	是	此实例所需的一个或多个语法

	配置	xxx-cfg.xml	是	是	组件的配置文件

	约束	实例特定映射	否	是	此实例返回值的约束

	Bean	完全限定数据模型类	否	是	此实例的数据模型

	数据	实例特定对象	否	是	此实例所需的外部数据

	初始值	实例特定	否	是	此实例的默认值

	确认	true/false	否	是	确认选项

	回显	true/false	否	是	播放选项

	N 最佳数量	[0-9]*	否	是	请求的 N 最佳值的最大数量

	最小置信度	[0-9][0-9].[0-9]*F	否	是	识别输出的最小置信度值

	最大无输入次数	[0-9]*	否	是	无输入时的优雅退出

	最大无匹配次数	[0-9]*	否	是	无匹配时的优雅退出

	提交	自身 URI	否	是	提交结果的位置

用法	<rdc:template id="myTemplate" grammar="grammar/myGrammar.grxml" config="config/myConfig.xml" />
示例	请参见 rdc-examples 应用程序中的 simple-template-test.jsp。

抵押贷款 - 抵押贷款
收集抵押贷款信息：包括抵押贷款类型和首付百分比
属性	名称	值	必填	运行时表达式评估	摘要
	ID	某个名称	是	否	组件 ID

	提交	自身 URI	否	是	提交结果的位置

	子对话	true/false	否	是	此 RDC 是否作为子对话被调用

用法	<rdc:mortgage id="myMortgage" />
示例	请参见 rdc-examples 应用程序中的 mortgage-test.jsp。

信用卡信息 - 信用卡信息
收集信用卡信息：包括卡类型、卡号、有效期和安全码
属性	名称	值	必填	运行时表达式评估	摘要
	ID	某个名称	是	否	组件 ID

	提交	自身 URI	否	是	提交结果的位置

	子对话	true/false	否	是	此 RDC 是否作为子对话被调用

	模式	FULL	否	是	此信用卡信息复合组件将运行的模式

用法	<rdc:creditcardInfo id="myCCInfo" mode="short" />
示例	请参见 rdc-examples 应用程序中的 creditcardInfo-test.jsp。

分组
用作托管多个 RDC 并使用可插拔对话管理策略管理它们之间对话的容器
标签体	无脚本
属性	名称	必填	运行时表达式评估	可用性
	ID	是	是
	此分组的唯一标识符。
	策略	是	否
	可插拔对话管理策略的完全限定类名。
	配置	否	否
	策略特定的配置属性。
	提交	否	是
	此容器将提交其中间结果的 URI。
变量	无
用法	<rdc:group id="myDateTime" strategy="org.apache.taglibs.rdc.dm.SimpleDirectedDialog"> <rdc:date id="myDate" /> <rdc:time id="myTime" /> </rdc:group>
示例	rdc-examples 应用程序提供了多个 <rdc:group> 示例。示例中包含以下对话管理策略简单引导对话 - 子项按文档顺序执行。参见 group-test.jsp nested-group-test.jsp 基于规则的引导对话 - 子项根据 XML 导航规则集中定义的规则执行。参见 rulebased-nested.jsp rulebased-conditions.jsp

推入
将元素推入堆栈。
标签体	空
属性	名称	必填	运行时表达式评估	可用性
	堆栈	是	是
	存储目标堆栈的变量。
	元素	是	是
	存储被推入值的变量。
变量	无
用法	<rdc:push stack="${rdcStack}" element="${dialogMap}"/>

弹出
从堆栈顶部弹出元素。
标签体	空
属性	名称	必填	运行时表达式评估	可用性
	var	是	否
	存储将被弹出的值的变量。
	堆栈	是	是
	存储目标堆栈的变量。
变量	名称		范围	可用性
	var 属性值		从标签开始到页面结束

	属性	无
用法	<rdc:pop var="discard" stack="${rdcStack}"/>

窥视
窥视堆栈顶部元素。
标签体	空
属性	名称	必填	运行时表达式评估	可用性
	var	是	否
	存储窥视操作结果的变量。
	堆栈	是	是
	存储目标堆栈的变量。
变量	名称		范围	可用性
	var 属性值		从标签开始到页面结束

	属性	无
用法	<rdc:peek var="stateMap" stack="${requestScope.rdcStack}"/>

任务 - 任务标签
提供 RDC 所需的脚手架
用法	<rdc:task map="${taskmap}"> <rdc:date id="myDate" confirm="true" /> </rdc:task>
示例	请参见 rdc-examples 应用程序中的 task-test.jsp。

展开
将包含使用自定义语法 "#{...}" 的表达式的文本评估为 JSP 2.0 EL 表达式
标签体	无脚本
属性	无
变量	无
用法	<rdc:expand>#{model.utterance} </rdc:expand>

包含 FSM 片段
为此 RDC 模板实例包含标签片段。
标签体	空
属性	名称	必填	运行时表达式评估	可用性
	模板	是	是
	此模板实例的数据模型。
	上下文	是	是
	主标签文件的 pageContext。
变量	无
用法	<rdc:include-fsm-fragment template="${model}" context="${pageContext}" />

Struts 提交
将 namelist 中指定的 RDC 值提交到 Struts 层。
标签体	空
属性	名称	必填	运行时表达式评估	可用性
	提交	是	是
	提交结果的 URI（一个 Struts 映射）。
	上下文	是	是
	主 JSP 的 pageContext。
	名称列表	否	是
	应提交其值的 RDC 列表。
	清除列表	否	是
	应清除其值的 RDC 列表。列表中的项可以是组件或容器。
	对话映射	否	是
	主 JSP 使用的 RDC 对话映射。
变量	无
用法	<rdc:struts-submit submit=${self}" context="${pageContext}" namelist="myDate myTime"/>

Struts 错误
播放前一个 Struts 动作中的所有错误消息。
标签体	空
属性	无
变量	无
用法	<rdc:struts-errors />

获取配置
从此 RDC 的配置文件中获取与给定 XPath 对应的元素
标签体	空
属性	名称	必填	运行时表达式评估	可用性
	XML	是	是
	此组件的已解析配置文件。
	定位器	是	是
	兴趣元素的 XPath。
变量	无
用法	<rdc:get-configuration xml="${parsedDoc}" locator="/config/input/property-list/property" />

获取资源
从资源包中获取由键指定的资源。
标签体	空
属性	名称	必填	运行时表达式评估	可用性
	捆绑包	是	是
	要查找的 ResourceBundle。
	键	是	是
	要检索的属性的键。
	var	是	是
	将保存属性值的变量。
	是否为语法URI	否	是
	逃逸 RDC 语法 URI 特定处理的能力。
变量	无
用法	<rdc:get-resource bundle="${rdcResourceBundle}" key="my.property.key" var="myResourceString" />

获取默认配置
获取此组件的默认配置。
标签体	空
属性	名称	必填	运行时表达式评估	可用性
	名称	是	是
	此组件默认配置文件的 URI。
	模型	是	是
	此组件的数据模型。
变量	无
用法	<rdc:getDefaultConfig name="${defaultConfig}" model="${model}" />

注释 - 注释标签
RDC 注释
用法	<rdc:comment> 这是一个 RDC 注释 </rdc:comment>

暂停 - 暂停标签
应用程序暂停的可能处理程序
属性	名称	值	必填	运行时表达式评估	摘要
	ID	某个名称	是	否	组件 ID

	区域设置	[语言](-[国家])?	否	是	RDC 区域设置

	配置	xxx-cfg.xml	否	是	组件的配置文件

	最小置信度	[0-9][0-9].[0-9]*F	否	是	识别输出的最小置信度值

用法	<rdc:pause id="myPause" />

你好 - Hello World 标签
RDC Hello World 标签
用法	<rdc:hello name="whole wide world" />

FSM 输入 - FSM 输入标签
生成 VoiceXML 的辅助标签，用于收集使用默认 RDC FSM 的组件的输入。
用法	<rdc:fsm-input model="${model}" />

FSM 确认 - FSM 确认标签
生成 VoiceXML 的辅助标签，用于确认使用默认 RDC FSM 的组件的输入。
用法	<rdc:fsm-confirm model="${model}" />

FSM 运行 - FSM 运行标签
定义默认 RDC FSM 的辅助标签。
用法	<rdc:fsm-run model="${model}" />

提取参数 - 提取参数标签
从浏览器发送的 HTTP 请求中提取必要的参数。
用法	<rdc:extract-params target="${model}" parameters="${model.paramsMap}"/>

设置结果 - 设置结果标签
设置此组件的属性，这些属性影响浏览器提交结果的方式和位置。
用法	<rdc:setup-results model="${model}" submit="${submit}" minConfidence="${minConfidence}" numNBest="${numNBest}" />

设置配置复合 - 设置配置复合标签
在复合组件中设置页面上下文和配置。
用法	<rdc:set-config-composite model="${model}" context="${pageContext}" config="${config}" />

设置语法 - 设置语法标签
使用资源包中给定属性作为语法 URI 来设置语法。
用法	<rdc:set-grammar model="${model}" bundle="${rdcResourceBundle}" key="my.property.key" />

配置 - 配置标签
配置此组件的提示、属性等。如果用户未提供配置，则使用预设的默认配置。
用法	<rdc:configure model="${model}" config="${config}" defaultConfig="META-INF/tags/rdc/config/date.xml" />

示例

请参见示例应用程序 rdc-examples.war，了解此自定义标签库中标签的使用示例。

雅加达项目：可复用对话组件 (RDC) 标签库

版本：1.0.0

目录

概述

要求

配置

标签摘要

标签参考

示例