VisualDB 1.3 二次开发手册.doc

VisualDB 1.3 二次开发手册 目录 1二次开发所需知识背景 3 2 VDB数据目录结构 3 3 主要xml配置文件说明 7 4 VDB1.2向VDB1.3 迁移 9 5增加数据类型 9 6增加主题风格 11 7 VDB模板语言 11 8 VDB工具对象 20 9 VDB核心对象 20 10 目录对象引用 29 11 bean对象引用 31 12 条件查询的用法 31 13 sql查询的用法 33 14 bean列表的用法 35 15 bean对象引用 36 16 VDB Service 38 1二次开发所需知识背景 如果VDB用户需要针对已发布数据库进行二次开发工作，理论上需要具备以下知识：html、css、java、jsp、javascript、VTL（VDB Template Language）。 2 VDB数据目录结构 上图为vdb目录结构，其中： 目录下的vpage页面主要是网站前台涉及的文件； 所有以”~”开头的文件，均是发布之后自动生成的页面，这些生成的页面都是只读属性，若想对这些文件进行修改，首先需要修改文件的属性为非只读属性，修改完毕，如果需要重新发布网页，只需选择“安全发布”即可，切忌用“强制发布”； Console文件夹下为除了网站前台之外其他四个模块相关的页面，后面会详细介绍； WEB-INF文件夹下为系统配置文件，比如主题风格、数据类型、数据集配置文件等等，后续会有该文件夹的详细介绍； ~bottom.vpage为网页底部信息，比如版权信息； ~head.vpage为网页头部信息，比如网站logo，导航条等； ~layout.vpage为网页前台的整体布局； ~menu.vpage为网页左侧菜单列表； ~listBeans[***].vpage为某表概览视图中的记录列表显示区域； ~queryEntity[***]..vpage为某表对应的弹出查询框； ~showBean[***].vpage为某条记录的详细显示页面； ~showEntity[***].vpage为某表的概览视图； 上图为console目录结构，其中： Catalog文件夹主要为目录发布模块相关页面； Editor文件夹主要为编辑模块相关页面，后续有详细介绍； Report为统计分析模块相关页面； Security为安全中心模块相关页面； 上图为editor文件夹主要目录结构，其中： template1.jsp为编辑模块整体布局页面； ~listBeans[***].vpage为某表概览视图中的记录列表显示区域； ~updateBean [***]..vpage为新增或者修改页面； 上图为WEB-INF文件夹主要目录结构，其中： Conf/下以及conf/core下为系统核心配置文件，其中的security.xml为资源过滤器相关配置文件； Lib下为系统相关jar包； Themes下为系统提供的主题风格； Typelib下为系统提供的数据类型，包括数据的显示风格、编辑风格等页面； Vdb文件夹下为数据集配置文件，其中： domain.xml：针对本域的描述信息； cn.csdb.paperdb：目录，每个数据集的存储目录，目录名为该数据集的uri； schema.xml：该数据集的结构描述文件； data：存储数据文件； files：存储文件附件； logs：针对数据访问的记帐信息； report：针对数据库的报表； 3 主要xml配置文件说明 1）meta.xml格式说明： className：对应于该类型的类，该类型必须实现vdb.mydb.typelib.FieldType，推荐的做法是继承vdb.mydb.typelib.type.VdbType，它提供了对FieldType接口的默认实现； name：该类型的名称，如：MyType； sortable：是否支持排序？true或者false； title：该类型的标题； defaultQueryerStyleName：缺省的查询风格； queryerStyles：可用的查询风格； 2）schema.xml文件格式 entity 的属性名和备注 属性名 备注 name 英文标识，用于对象模型以及构造uri tableName 物理表名 title 表的标题（一般显示该表的中文名） id 全球唯一编号（随机生成的，可唯一标识表） lastModified 该表的元数据最近修改时间 uri 表的全局uri，自动生成，保证全球唯一 identifier 表的主键属性 field 子节点，表的属性 identifier的属性名和备注 属性名 备注 id identifier的编号（唯一标识该identifier）