FisherGrid使用说明
列信息配置ConditionFormatterParserConnectionProviderColumnFilterSQLBuilderQueryFisherServiceTagData.jspModelGrid模板文件FisherGrid总体设计结构图
类/资源 功能描述 页面开发人员的入口,通过自定义的tag生成Grid Grid的模型对象 Grid的模板文件(目前采用freemarker作为Grid的模板) 服务端JSON格式的查询结果生成入口 组件对外提供的服务的总入口 不同类型的字段格式化器,在返回结果给Grid之前格式化内容 Tag Model Grid模板文件 Data.jsp FisherService Formatter Parser 配置资源解析器,目前默认实现的是根据xml配置文件 ConnectionProvider 数据库连接提供者,提供数据库连接信息,目前默认的提供是配置jdbc链接信息获取连接 ColumnFilter Condition SQLBuilder 字段过滤条件,不同的字段类型对应不同的过滤条件 字段过滤条件项目,对应过滤条件中的某一个条件项目 SQL构造器,目前默认的是解析from、where、order部分然后替换组装的,所以不支持复杂的查询,例如嵌套查询、union查询等 Query 5. 依赖组件
1) Jquery 2) Flexigrid 3) Digester 4) Freemarker
查询器,执行分页查询 让Java软件开发变得更加容易
5
FisherGrid使用说明
5) Sojo 6) Log4j 7) Beanutils 8) Collections 9) Chardet
10) SkyCommon
11) Hsqldb(可选,运行示例需要)
12) Hibernate3.*(可选,如果使用HQL需要)
6. 详细使用步骤
1) 将${WebRoot}/WEB-INF/lib下面的jar包复制到工程的
${WebRoot}/WEB-INF/lib中;
2) 将${WebRoot}下的fisher文件夹复制到工程的${WebRoot}根目录下(注意文件
夹名称和结构一定要正确);
3) 复制【fisher.properties】(也可以放置到webroot的根目录)和【log4j.properties】
到classpath默认包;
4) 配置FisherGrid系统配置(具体配置请参考【FisherGrid系统配置文件
fisher.properties详解】); 5) 配置xml配置文件(具体配置请参考【Grid的Xml配置文件结构详解】),可以放
置到webroot或者classpath中都可,优先找webroot; 例如,/test/fisher/demo/demo.xml配置文件如下:
xsi:noNamespaceSchemaLocation=\er\\Fisher-1.0.xsd\xmlns:xsi=\> name=\width=\defaultSort=\renderer=\/> name=\align=\type=\/> 期\name=\type=\width=\formatter=\/> name=\type=\align=\formatter=\/> 让Java软件开发变得更加容易 6 FisherGrid使用说明 name=\width=\/> name=\visual=\/> U,T_DEPARTMENT D WHERE U.DEPARTMENT=D.ID ORDER BY U.NAME
6) 编写jsp页面显示Grid
例如/WebRoot/test/fisher.jsp文件如下:
<%@ page language=\contentType=\pageEncoding=\%>
<%@taglib prefix=%uri=\%>
with a dynamic data, paging, search, toolbar, and connected to an JSON file.\name=\errormsg=\连接错误\>
styleClass=\onclick=\>
7. FisherGrid系统配置文件fisher.properties详解
配置项 CacheModelsEnabled 默认值 true 说明 是否开启列表配置缓存功能,此处的缓存是缓存列表Xml配置文件 默认主题 DefaultTheme SQLBuilder default com.sky.fisher.builder.DefaSQL语句构造器 ultSQLBuilder简单SQL构造器 com.sky.fisher.parser.Defa配置解析器 ultParser XML配置文件解析器 # 英文井号 多个查询字段名称以及对应值的与(and)分隔符配置的名称 多个查询字段名称以及对应值的或(or)分隔符配置的名称 多个查询字段名称以及对应值的左括号(()分隔符配置的名称 Parser Separator.query.and Separator.query.or _ 英文下划线 Separator.query.brackets.left ( 英文左括号 让Java软件开发变得更加容易
9