Noka 标签技术白皮书
Noka art white book
诺亚开源科技
项目 名称:
Noka 软件标签
版本 号:
Noka tag V3.0
使用部 门:
评审负责人:
评审日 期:
作者:
谢 方 建
时间:
2007 年 07 月 28 日
部门:
OA 产品研发部
Noka 标签技术白皮书
日录
第 1 章 标签配置..............................................................................................................................2
第 2 章 编码拦截器工具类..............................................................................................................3
第 3 章 数据标签系列......................................................................................................................4
3.1 数据表格(DBTable)标签..............................................................................................4
3.2 时间日期(DateOrTime)标签 ........................................................................................6
3.3 组合选择框(selectDouble)标签 .........................................................................................7
3.4 下拉选择框(select)标签.....................................................................................................9
3.5 树形菜单(TreeDB)标签<不带 Checkbox 框> ..................................................................9
3.6 树形菜单(TreeMenuCheckbox)标签 ...............................................................................10
3.7 选项卡(tabs/ Divs)标签....................................................................................................12
3.8 数据查询录入(dataselectinput)标签到.......................................................................13
3.9 QQ 菜单标签.....................................................................................................................14
3.10 下拉选择框树形菜单.....................................................................................................16
3.11 年份选择标签(YearSelect) ............................................................................................17
3.12 日期时间格式化标签(FormatData)...............................................................................17
3.13 字符串格式标签(StringLenFormat) ..............................................................................18
属性说明..........................................................................................................................18
例用实例..........................................................................................................................18
第 4 章 基础录入框系列标签........................................................................................................18
4.1 实例图...............................................................................................................................18
4.2 通用属性说明:...............................................................................................................18
4.3 使用说明...........................................................................................................................20
4.4 基础标签列表...................................................................................................................20
第 5 章 文件服务标签(fileserverpath)...........................................................................................20
属性说明..........................................................................................................................20
例用实例..........................................................................................................................21
第 6 章 富文本编辑器(HTML 简单编辑器).................................................................................21
属性说明..........................................................................................................................21
例用实例..........................................................................................................................21
Noka 标签技术白皮书
使用申明
本标签库知识产权归诺亚开源科技所有,同时本标签遵循开源组织原则,源码公
开,不对使用源码作任何限制,不对源码用途承担任何责任,提供技术交流平台,
不提供技术支持.对成品组件的使用(既 noka.jar)保留知识产权及追究使用责任的
权力(对标签参与开发内部人员不在此限制内)。为了本标签更好的发展,对源码
的任何重大修改请以邮件或其它方式通知开发组织(诺亚开源科技-谢方建)。
第1章 标签配置
注:noka 2.0 以上版本需要 jdom.jar 支持
1 将根目录下的“Noka.jar”和”jdom.jar”文件拷贝在 WEB-INF/lib 下面。
2 将根目录下的“noka.tld”文件拷贝在 WEB-INF 下面(注:此文件可以拷在
WEB-INF 下的任意一个目录里,这取决于第 4 步)。
3 打开 WEB-INF 下的 web.xml 文件在“<web-app>”与“</web-app>”之间加入
如下代码
<filter>
<filter-name>NokaTagFile</filter-name>
<filter-class>org.nokatag.system.NokaTagFilter</filter-class>
<init-param>
<param-name>tablesty</param-name>
<param-value>tablemode.xml</param-value>
</init-param>
<init-param>
<param-name>fileserverpath</param-name>
<param-value>${rootpath}/fileserver</param-value>
</init-param>
</filter>
<filter-mapping>
<filter-name>NokaTagFile</filter-name>
<url-pattern>/nokatag/*</url-pattern>
</filter-mapping>
Tablesty 为数据表样式配置文件的名字(包含路径,路径是相对于 WEB-INF
的)。Fileserverpath 为文件服务器存放文件的根目录,参数${rootpath}表示为应
用的根目录。
Noka 标签技术白皮书
4 在 web.xml 中加入 noka 标签。如下所示:
<jsp-config>
<taglib>
<taglib-uri>noka</taglib-uri>
<taglib-location>/WEB-INF/noka.tld</taglib-location>
</taglib>
</jsp-config>
注:其中的 taglib-location 的值为 noka.tld 文件所有的实际目录。在需要使用 noka
标签的 JSP 页面中加入如下所示的代码:
<%@ taglib uri="noka" prefix="n" %>
注:其中的 uri 为 4 中所配的 taglib-uri 中的值。Prefix 是为 jsp 中使用时所取的
名字。
至此,你就可以在你的程序中使用 noka 标签了。祝你好运
第2章 编码拦截器工具类
此类位于: org.nokatag.system. SetCharacterEncodingFilter
配置如下:
在 web.xml 中加入如下代码(注意:通常来说编器放在 Filter 的第一位)。
<!-- 编码器 start -->
<filter>
<filter-name>Set Character Encoding</filter-name>
<filter-class>
org.nokatag.system. SetCharacterEncodingFilter
</filter-class>
<init-param>
<param-name>encoding</param-name>
<param-value>UTF-8</param-value>
</init-param>
</filter>
<filter-mapping>
<filter-name>Set Character Encoding</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
<!-- 编码器 end -->
其中 encoding 指系统编码类型,建议使用 utf-8
Noka 标签技术白皮书
第3章 数据标签系列
共用属性说明
con:数据库连接对像(java.sql.Connection)
3.1 数据表格(DBTable)标签
DBTable 用于生成一个数据显示表格。此数据表包括分页(预设三种分页方式),
按列排序,自带选择框等功能。
注:此标签集成排序功能,因此不能在 sql 语句中使用排序的了句(oracle 除外)
实例图:
属性说明
属性
是否必
须
说明
suncell
否
需要合并相同项的列,用“,”相隔如这样:0,2,3 等,
注意所有有关列号的操作都是从 0 开始的
checkvalue
否
选框的值,形如:$[0],$[1]..其中$[列号],多值之间可
以用任何符号间隔
selectSQL
是
sql 语句,像这样:select id as ID, name as 名字 from
user ,注意此处的 sql 语句不支持*号查询。Sql 语句
中列出再的顺序将决显示界面的列的顺序
checkname
否
数据表中每行前面的选择框的名字。
tableformname
否
数据表的 form 名字。DBTable 被包含在一个 form 中。
因此,它不能在一个 form 中使用
tableformAction
否
form 的 action 值,等同于 html 中的 form 中的 action
pagination:分页时超连接所指向的 url 地址,通常不需