JFRAMEWORK架构设计

JFRAMEWORK 2020 4 4 1 JFRAMEWORK 架构设计 编撰 赵万刚 JFRAMEWORK 2020 4 4 2 目录 1 系统设计架构说明 5 1 1 总体架构示意图 6 1 1 1 各层示意图 7 1 1 1 1 WEB 页面请求 返回结果处理过 7 1 1 1 2 逻辑层 8 1 1 1 3 统一错误处理 8 1 1 1 4 日志记录 9 1 1 2 各层采用 JAVA 技术 9 2 各层设计 11 2 1 页面层 HTML 11 2 1 1 页面脚本处理 11 2 1 1 1 Enter to tab 处理 11 2 1 1 2 客户端输入域判断 11 2 1 1 3 快捷键的使用 12 2 1 1 4 打印处理 12 2 1 2 CSS 样式表 13 2 1 3 控件样式 13 2 2 数据处理层 JSP 13 2 2 1 注意问题 13 2 2 2 公用变量 14 2 3 数据分离层 SERVLET 14 2 3 1 注意事项 14 2 3 2 错误处理 15 2 3 3 公用参数 15 2 3 4 样例说明 15 2 4 过滤层 18 2 4 1 过滤 FILTER 18 2 4 2 事件 LISTENERS 20 2 5 逻辑层 22 2 5 1 调用数据库操作 22 2 5 2 调用 EMAIL 操作 23 2 5 3 参数传递说明 24 2 5 4 错误处理 24 2 5 5 公用参数 28 2 6 持久层 29 2 6 1 数据库操作部分 29 2 6 2 离线数据集 WzResult 30 2 6 3 结果封装集 WzTyResult 31 2 6 4 持久类规范 31 2 7 配置文件 34 2 7 1 信息配置文件 ApplicationResources properties 35 2 7 2 标记库配置文件 DTHTML TLD 35 JFRAMEWORK 2020 4 4 3 2 7 3 WEB 配置文件 WEB XML 固有 35 2 7 4 日志配置文件 LOG4J properties 39 2 7 5 应用服务器配置和发布 40 2 7 5 1 RESIN 配置文件 RESIN properties 应用服务器相关 40 2 7 5 2 TOMCAT 41 2 7 6 持久生成器主类 MANIFEST MF 43 2 7 7 配置文件 CONFIG XML 43 2 7 8 数据库 SQL 配置文件 CONFIGSQL XML 48 2 8 测试 49 2 8 1 说明 49 2 8 2 测试文件命名 49 2 8 3 JUNIT 说明 49 2 8 3 1 JUNIT 架构说明 49 2 8 3 2 样例文件 60 3 系统开发约定 66 3 1 程序命名约定 66 3 1 1 1 一般程序名字约定 66 3 1 1 2 数据库命名约定 67 3 1 1 3 WEB 67 3 2 书写规范 68 3 2 1 1 数据库 68 3 2 1 2 Java 书写规范 69 备注 69 Java 文件样式约定 70 一般性编程约定 72 3 2 1 3 Web 73 网页 73 4 各模块设计 74 4 1 持久层生成器 74 4 1 1 格式化信息定义 74 4 2 JAVA 类路径 74 4 3 通用维护 75 4 3 1 设计目的 75 4 3 2 数据库设计 75 4 3 3 通用维护 77 4 3 4 复合通用维护 77 4 3 4 1 功能 77 4 3 4 2 web 端设计 77 4 3 4 2 1 初始化 77 4 3 4 2 1 1 子表查询参数初始化原则 78 4 3 4 2 1 2 隐含字段初始化原则 78 4 3 4 2 1 3 默认查询条件原则 78 4 3 4 2 1 4 spcid 取得 78 4 3 4 2 2 Web 端调用流程说明 78 JFRAMEWORK 2020 4 4 4 4 3 4 2 3 样例说明 79 4 4 servlet 集成类 86 4 4 1 验证信息配置 86 4 4 1 1 样例文件 86 4 4 2 调用方法 87 4 4 3 样例文件 87 4 5 外部邮件 公用包 90 4 5 1 1 发送 90 A simple text email 90 Sending emails with attachments 90 Sending HTML formatted email 92 Debugging 93 Authentication 93 Handling Bounced Messages 94 4 5 1 2 接收 95 4 6 压缩 公用包 95 4 6 1 1 压缩 95 4 6 1 2 解压 95 JFRAMEWORK 2020 4 4 5 1 系统设计架构说明 本系统设计主要是概要设计 具体详细设计见 详细设计 名称 开发工具 程序 UML Dcework2 TOGAHTER 6 数据库建模 DCEWORK2DB SYBASE PowerDesign10 程序开发 DCJFRAMEWORKPER BORLAND JBUILERX WEB WAR DCWEB WAR BORLAND JBUILERX JAVA 基类包 DCJFRAMEWORK JAR BORLAND JBUILERX 持久层生成器 DCJFRAMEWORKPER EXE BORLAND JBUILERX 代码生成器 DCJFRAMEWORKPER EXE BORLAND JBUILERX JAVA 帮助 DCEWORK2DOC 开发工具 工具名称 备注 TOGAHTER 6 JAVA 程序 UML SYBASE POWLERDESIGNER10 数据库建模 BORLAND JBUILERX JAVA 程序开发 DCJFRAMEWORKPER EXE 持久层生成器 DCJFRAMEWORKPER EXE 代码生成器 PLSQL Developer 数据库调试工具 Visio2003 流程开发工具 RESIN2 运行环境 JFRAMEWORK 2020 4 4 6 1 1 总体架构示意图 页 1 架 构 示 意 图 数据分离层 W e b W e b H T M L X M L A P P L E T 逻辑处 理层 数据库 其他资 源 数据持 久层 存储层 过滤 数据显示层 数据库 操作 JFRAMEWORK 2020 4 4 7 1 1 1 各层示意图 1 1 1 1 WEB 页面请求 返回结果处理过 数 据 分 离 层 显 示 层 和 数 据 分 离 层 架 构 设 计 基 于 B R O W S E R 的 页 面 处 理 技 术 一 般 采 用 H T M L C S S S C R I P T 的 输 出 对 于 要 求 比 较 高 的 可 以 采 用 A P P L E T 技 术 数 据 交 换 协 议 一 般 通 过 H T T P H T T P S 协 议 B R O W S E R B R O W S E R 对 R E Q U E S T S E S S I O N A P P 数 据 取 得 格 式 化 封 装 逻 辑 处 理 层 1 取 得 离 线 可 序 列 化 的 结 果 集 2 统 一 错 误 判 定 是 否 符 合 简 单 验 证 统 一 错 误 处 理 否 判 断 是 否 取 得 预 期 结 果 统 一 错 误 处 理 否 数 据 结 果 集 预 处 理 显 示 层 产 生 并 格 式 化 输 出 转 向 处 理 过 滤 层 JFRAMEWORK 2020 4 4 8 1 1 1 2 逻辑层 逻 辑 处 理 层 数 据 持 久 层 表 视 图 等 基 本 操 作 数 据 库 通 用 数 据 库 操 作 J N D I J D B C E M A I L 层 其 他 资 源 封 装 层 E M A I L 资 源 J A V A M A I L X M L 资 源 D O M 4 J J A X P J A X R N I O 1 1 1 3 统一错误处理 错 误 处 理 日 志 分 类 记 录 错 误 显 示 处 理 标 题 1 统 一 错 误 吗 定 义 2 标 准 的 错 误 显 示 信 息 定 义 可 以 F O R M A T JFRAMEWORK 2020 4 4 9 1 1 1 4 日志记录 输 出 信 息 是 否 记 录 日 志 结 束否 日 志 记 录 记 录 结 束 1 1 2 各层采用 JAVA 技术 层 技术方案 采用技术方案 显示层 HTML XML APPLETE HTML APPLETE 显示处理层 JSP JSF JSP TAGLIB XLST JSP TAGLIB 应该是离线的结果集 过滤层 FILTER LISTENER FILTER LISTENER 数据分离层 SERVLET 及相关衍生 JSP SERVLET 扩展 封装和处理的结果应该 是可序列化的 数据持久层 CMP 自定义持久层 JFRAMEWORK 2020 4 4 10 JDO HIBERNATE 自定义 日志记录 LOG4J LOGFACTORY J2SE1 4 LOG4J 错误信息定义 BOUDERSOURCE 相关技术 BOUDERSOURCE 国际化语言定义 BOUDERSOURCE BOUDERSOURCE JFRAMEWORK 2020 4 4 11 2 各层设计 2 1 页面层 HTML 2 1 1 页面脚本处理 通过规则定义 使用统一脚本处理 以下脚本通过 VBS 实现 请在页面的低端加入 2 1 1 1 Enter to tab 处理 通过统一脚本实现 脚本 entertotabs vbs 2 1 1 2 客户端输入域判断 判断内容 值的判断 非空 数字 整数 日期 范围 比较 判断规则 通过 title 表示 title 格式组成 通过 分割 域 内容 名称 提示内容 简单判断 not 不为空 num 数字 d 日期 t 时间 dt 日期 时间 int 整数 格式 正则表达式 范围 分割 比较 l g n 相关域 L 小于 g 大于 n 不等于 脚本 Checkclient vbs 的方法 Checkclient x x 表示 FORM 的名称或序号 返回 BOOLEAN 类型 方法调用 2 1 1 3 快捷键的使用 定义 快捷键 Id 代号 功能 PAGEDOWN 34 PAGEDOWN 下一页 PAGEUP 33 PAGEUP 上一页 HOME 36 PAGEHOME 首页 END 35 PAGEEND 尾页 INSERT 45 DATAINSERT 新增 DELETE 46 DATADELETE 删除 CTRL ENTER DATASAVE 保存 F9 120 PAGEREFRES H 重载页面 ESC 27 关闭本页 脚本 entertotab vbs 2 1 1 4 打印处理 通过调用本地 EXCEL 实现 对规则的 table 调用 没有跨行 跨列的 进行页面打印或 EXCEL 文档格式导出 脚本 printclient vbs 调用方法 msg print bt table id row start row end col start col end ym yj 参数说明 参数 说明 bt 标题 table id 要打印表格的 ID row start 开始打印的行数 如第一行从 0 开始 col end 打印结束的行数 指到最后一行的行数 如最后一行为 0 col start 开始打印的列 从 0 开始 col end 打印结束的列数 指到最后一列的列数 如最后一列为 0 等 ym 页眉内容 yj 页脚内容 JFRAMEWORK 2020 4 4 13 2 1 2 CSS 样式表 统一存放在目录 CSS 下 样式表 body css 表和连接定义 putong 1t css 仿 XP 风格定义 2 1 3 控件样式 控件 CLASS 备注 text input file input TEXTAREA InputArea checkbox checkbox radio radio SELECT Inputselect button button 2 2 数据处理层 JSP 这一层主要是把要显示的数据生成 HTML 格式 分两种方式生成 动态和静态的 动态 JSP SERVLET 及其相关衍生技术 静态 HTML 2 2 1 注意问题 对名称命名和属性的定义见 页面 对于 JSP 等页面处理 对于数据分离层传递过来的数据应该是离线 最好是序列 化 对结果集的传递应用 wzresult 已继承 java sql resultset 不应 在页面中出现资源操作代码 如数据库操作 文件操作 邮件操作等 数据的处理 对结果集的封装应该适用 wztyresult 其 GetDisplayLabel 方法可以取得字段对应代码的含义 字符集设定 response setContentType text html charset gb2312 request setCharacterEncoding gb2312 JFRAMEWORK 2020 4 4 14 在使用 request 和 response 之前 进行设置 验证处理 主要是非空判断 其他不做判断 错误处理 本层不设错误处理 对 NULL 的处 理 Ob null Ob 对页面的连接 在路径前加上上下文环境 变量 标准信息的定 义 通过在 ApplicationResources properties 定义错误信息 以 msg html button label menu title 开头 HTML 其他注意问题 使用统一 css 处理 对日期和时间的输入 应通过脚本取得 2 2 2 公用变量 session 变量 名称 含义 用户信息请继承 wz elec web pubs bean LoginUserIMp 用户类 EWORK SYSTEM APP USER SESSION 存储变量 全部小写 application 变量 名称 含义 EWORK SYSTEM ORGANIZE USER 记录在线用户信息 用户编号 用户 名称 登陆计算机 登陆时间 2 3 数据分离层 SERVLET 2 3 1 注意事项 把提交的数据进行 主要指 request SESSION APPLICATION 分离 验 证 封装 传递到逻辑层 JFRAMEWORK 2020 4 4 15 把逻辑层返回的结果进行分离 验证 根据错误码 进行错误处理 封装 传递到数据结果显示层 处理方式 SERVLET 及其相关衍生技术 2 3 2 错误处理 2 3 3 公用参数 wz elec web pubs webConst Web 端公用参数 2 3 4 样例说明 package wz elec web xt action 功能含义 含义 说明 Request 数据 首先通过 GETPARMTER 方法取得数据 非空判断 null 和 验证 对取得的数据进行格式验证 验证 对取得的数据进行类型转换 验证 对验证和转换完毕的数据按逻辑层需要的格式进行封装 封装 SESSION 和 APPLICATIN 数据 逻辑层需要的数据可能来自 SESSION 和 APPLICATIN 变量 这 样在分离层取得后 封装传递到逻辑层 通过在 ApplicationResources properties 定义错误信息 以 error 开 头 通过 ActionError 进行错误处理封装 通过 ActionErrors 进行错误结果类的封装 通过 saveErrors request errors 保存错误集合到 request 对象 errors isEmpty 判断是否进行错误处理 定义 调 用 通过在 ApplicationResources properties 定义错误信息 以 error 开 头 通过 ActionError 进行错误处理封装 通过 ActionErrors 进行错误结果类的封装 通过 saveErrors request errors 保存错误集合到 request 对象 errors isEmpty 判断是否进行错误处理 ActionForward url 进行转向处理 JFRAMEWORK 2020 4 4 16 import wz elec pubs action import java io IOException import javax servlet ServletException import javax servlet http HttpServletRequest import javax servlet http HttpServletResponse import wz elec cli pubs WzCliOperation import wz elec pubs WzTyResult import java util HashMap import java util Enumeration import org apache log4j import wz elec pubs action ActionInitErrors 功能简介 实现通用模块的删除处理 version 2 0 author 原军旗 see Action since 1 3 public class FhCommonDel extends Action static Logger logger Logger getLogger FhCommonDel class getName 功能简介 处理删除以及删除后转向页面 param mapping The ActionMapping used to select this instance param form The optional ActionForm bean for this request param request The HTTP Request we are processing param response The HTTP Response we are processing public ActionForward execute ActionMapping mapping ActionForm form HttpServletRequest request HttpServletResponse response throws IOException ServletException request setCharacterEncoding GB2312 String target null String url null ActionErrors errors new ActionErrors 错误处理类 WzCliOperation dataOperate new WzCliOperation 数据操作和EJB调用类 WzTyResult resultSet null 获得删除结果集 数据删除操作开始 String tableCode request getParameter tableCode 表的名称代码 JFRAMEWORK 2020 4 4 17 if tableCode null tableCode errors add error3 new ActionError error param tableCode wrong return this ActionForwardS errors request response String sWhere 查询条件 try String str System out println request getParameter T 1 Enumeration enums request getParameterNames while enums hasMoreElements str String enums nextElement System out println str if str indexOf T 1 if request getParameter str null sWhere sWhere request getParameter str if sWhere sWhere else sWhere sWhere substring 0 sWhere length 1 System out println sWhere HashMap tableRMAP new HashMap 主要填充数据 resultSet dataOperate tyRequestDel tableCode sWhere tableRMAP 得到 删除结果 if resultSet errCode 0 errors add error2 new ActionError error ejb failure logger warn resultSet errMsg return this ActionForwardS errors request response Object head resultSet getBT 得到标题数据 Object body resultSet getTA 得到表体数据 Object set resultSet getJH new Object 得到数据集 catch Exception e errors add error1 new ActionError error data del exception logger error ActionInitErrors getProperty error data del exception e return this ActionForwardS errors request response 数据删除操作结束 JFRAMEWORK 2020 4 4 18 sWhere request getParameter sWhere if sWhere null sWhere saveErrors request errors 保存错误集合到request对象 if errors isEmpty target failure url error error jsp else target success String swh request getParameter swh if swh null swh 000 url yk FhCommonSelect do tableCode tableCode return new ActionForward url 2 4 过滤层 2 4 1 过滤 FILTER 通过继承 FILTER 进行以下方面的流程传递控制 权限 判断是否登录 是否允许登录到相关页面等 字符集 对 REQUEST RESPONSE 等输入输出进行规定的字符设置 格式转换 对输出或输入的数据进行统一的格式化数据处理 样例 package wz elec web pubs filter import javax servlet ServletResponse import javax servlet Filter import javax servlet ServletException import javax servlet FilterConfig import javax servlet ServletRequest import javax servlet FilterChain JFRAMEWORK 2020 4 4 19 import java io IOException import javax servlet http import wz elec web pubs bean LoginUserMap import javax servlet RequestDispatcher import wz elec cli pubs WzCliOperation 功能简介 URL 地址过滤器 对 URL 地址进行过滤 创建日期 2003 1 6 修改日期 修改说明 版权所有 Copyright 2003 山东五洲科技开发有限公司 Inc All rights reserved version 2 0 author 原军旗 see Filter since 1 3 public class UrlAddressMonitorFilter implements Filter private FilterConfig filterConfig null public final static String url invalid 功能简介 初始化 param filterConfig public void init FilterConfig filterConfig throws ServletException this filterConfig filterConfig 功能简介 破坏掉 public void destroy this filterConfig null 功能简介 执行过滤器 param request param response param chain public void doFilter ServletRequest request ServletResponse response FilterChain chain throws IOException ServletException JFRAMEWORK 2020 4 4 20 HttpServletRequest req HttpServletRequest request HttpServletResponse res HttpServletResponse response HttpSession session req getSession true LoginUserMap user LoginUserMap session getAttribute userId if user null urlForward request response chain doFilter req res return chain doFilter req res 功能简介 过滤私有方法 private void urlForward ServletRequest request ServletResponse response String url throws IOException ServletException RequestDispatcher dispath request getRequestDispatcher forward jsp url url dispath forward request response 2 4 2 事件 LISTENERS 主要有四个事件 名称 解释 备注 ServletContextListener 上下文事件 产生 销毁 ServletContextAttributeListen er 上下文属性事件 添加 删除 修改 HttpSessionAttributeListener 会话属性事件 添加 删除 修改 HttpSessionListener 会话事件 产生 销毁 样例 package wz elec web pubs servlet import javax servlet http HttpSessionBindingEvent import javax servlet http HttpSession import javax servlet ServletContextAttributeListener import java util Hashtable import wz elec web pubs bean LoginUserMap import javax swing JFRAMEWORK 2020 4 4 21 import java util 功能简介 SESSION 变量的参数处理 主要用于登录模块的监听处理 创建日期 2003 12 25 修改日期 修改说明 版权所有 Copyright 2003 山东五洲科技开发有限公司 Inc All rights reserved version 2 0 author 原军旗 see HttpSessionAttributeListener since 1 3 public class LoginSessionAttributeListener implements javax servlet http HttpSessionAttributeListener private HttpSession session null private String name null SESSION 参数添加操作 param event 监听参数添加处理 public void attributeAdded HttpSessionBindingEvent event name event getName session event getSession if name equals userId Hashtable users Hashtable event getSession getServletContext getAttribute users if users null if users containsKey event getValue users put event getValue session event getSession getServletContext setAttribute users users 功能简介 SESSION 参数注销操作 param event 监听参数注销处理 public void attributeRemoved HttpSessionBindingEvent event JFRAMEWORK 2020 4 4 22 name event getName if name equals userId Hashtable users Hashtable event getSession getServletContext getAttribute users if users null HttpSession session HttpSession users get event getValue if session null users remove event getValue event getSession getServletContext setAttribute users users session event getSession 功能简介 SESSION 参数取代操作 param event 监听参数取代处理 public void attributeReplaced HttpSessionBindingEvent event name event getName if name equals userId session event getSession System out println event getValue getClass getName LoginUserMap old LoginUserMap event getValue Hashtable users Hashtable event getSession getServletContext getAttribute users if old null users remove old users put session getAttribute name session event getSession getServletContext setAttribute users users JFRAMEWORK 2020 4 4 23 2 5 逻辑层 2 5 1 调用数据库操作 一般不提倡直接调用数据库连接 通过 JNDI 方式进行数据库连接和数据库连接池的处理 数 据 库 调 用 持 久 类 d b o p e r a t i o n 类 数 据 库 资 源 d b o p e r a t i o n 类 其 他 操 作 2 5 2 调用 EMAIL 操作 低层调用标准的 JAVAMAIL 进行邮件收发操作 JFRAMEWORK 2020 4 4 24 E M A I L 操 作 S e n d M a i l E M A I L 服 务 器 发 件 人 收 件 人 标 题 内 容 附 件 选 择 邮 件 格 式 0 文 本 1 H T M L 发 送 S E N D 2 5 3 参数传递说明 参数传递 传入参数和返回参数一般要求是可序列化的 如不要传输 httpservletrequest 等 结果集封装 对有多个数据集的结果 WzResult 可以通过 WzTyResult 进行封装 2 5 4 错误处理 错误要进行分类处理 已知通过熟悉语言提示给用户 避免提示系统原生错误 一般错误需经过以下类处理 wzServerErr 对 DebugWhere 变量进行设置以便调式信息 package wz elec pubs import java text import javax naming JFRAMEWORK 2020 4 4 25 import java io import java sql public final class wzServerErr 调试信息用 默认不显示出错位置 public static boolean DebugWhere true ejb 主键重复信息处理 public static String getDuplicateKeyErr String fmt Object value if fmt null fmt trim equals throw new ArrayIndexOutOfBoundsException fmt 参数 不合法 if value null value length 0 throw new IllegalArgumentException value 参数 不合法 String result MessageFormat format fmt value return result 分解错误信息 param ex 错误信息类 param append 附加信息 param isDisOldErr 是否追加原有错误信息 public static String getExceptionErr java lang Throwable ex String append boolean isDisOldErr 附加信息 系统错误信息 返回错误信息 String str null String olderr String errstr String reerr JFRAMEWORK 2020 4 4 26 if ex null throw new ArrayIndexOutOfBoundsException ex 参数 不能为 null str append if str null str if DebugWhere ByteArrayOutputStream bb new ByteArrayOutputStream ex printStackTrace new PrintStream bb olderr bb toString else olderr ex getMessage if isDisOldErr errstr olderr if str equals errstr errstr n str if ex instanceof NameNotFoundException errstr 应用服务器无此 EJB n errstr return errstr if ex instanceof NamingException reerr getNamingException olderr if reerr equals return reerr n errstr else return olderr n str if ex instanceof SQLException String sqlErr getSqlErr SQLException ex getErrorCode if sqlErr equals return sqlErr n errstr else return olderr n str JFRAMEWORK 2020 4 4 27 return olderr n str 分解错误信息 param ex 错误信息类 param append 附加信息 public static String getExceptionErr java lang Throwable ex return getExceptionErr ex null false 分解错误信息 param ex 错误信息类 public static String getExceptionErr java lang Throwable ex String append return getExceptionErr ex append false 分解错误信息 param ex 错误信息类 param isDisOldErr 是否追加原有错误信息 public static String getExceptionErr java lang Throwable ex boolean isDisOldErr return getExceptionErr ex null isDisOldErr sql 错误处理函数 public synchronized static String getSqlErr int errCode String errStr switch errCode case 17002 errStr 数据库连接出错 请与管理员联系 break case 12545 errStr 数据库连接出错 请与管理员联系 break case 1 errStr 数据重复 break case 1401 errStr 输入位数过多 请重新输入 break JFRAMEWORK 2020 4 4 28 default errStr break return errStr NamingException 错误处理函数 public static String getNamingException String olderr String errstr errstr olderr if errstr null return if olderr indexOf connect 1 errstr 连接应用服务器出错 n errstr return errstr if olderr indexOf username 1 errstr 无效的用户名或口令 n errstr return errstr if olderr indexOf application 1 errstr 无效的应用服务器程序 n errstr return errstr return errstr 记录错误信息 通过日志记录记录出错信息 调用说明 logger error ActionInitErrors getProperty error data del exception e 2 5 5 公用参数 包含在两个文件中 com borland samples swing texteditor AppCon st 数据库联接公用参数 wz elec pubs WzServerConst 其他公用参数类 JFRAMEWORK 2020 4 4 29 2 6 持久层 2 6 1 数据库操作部分 尽量通过 DbOperation 操作 主要方法说明 JFRAMEWORK 2020 4 4 30 对 S Q L 语 句 的 操 作 过 程 封 装 支 持 有 参 数 和 无 参 数 其 中 参 数 的 传 递 通 过 数 组 增 加 删 除 修 改 支 持 批 量 结 果 集 的 离 线 处 理 事 务 多 样 的 支 持 数 据 库 事 务 J T S 页 1 标 题 2 0 0 5 年 4 月 2 0 日 d b o p e r a t i o n 类 查 询 S E L E C T 执 行 s q l E x e c 插 入 i n s e r t s q l 操 作 用 户 组 合 S Q L 自 组 s q l 修 改 u p d a t e 存 储 过 程 s t o r e 其 他 关 闭 连 接 c l o s e d b 事 务 管 理 回 滚 r o l l b a c k 提 交 c o m m i t 开 始 事 务 b e g i n 持 久 类 操 作 2 6 2 离线数据集 WzResult 继承于JAVA SQL RESULTSET的基本操作 0 支持分页装入数据 JFRAMEWORK 2020 4 4 31 1 支持自定义结果集 主要方法说明 W z R e s u l t 模仿 R E S U L T S E T 0 支持分页装入数据 1 支持自定义结果集 装入 p o p u l a t e 取得总行数 g e t R o w S i z e 增加数据 a d d R o w 2 6 3 结果封装集 WzTyResult 对逻辑层处理的结果进行封装以便返回到结果分离层 W z T y R e s u l t 1 对处理的结果集封装 以便进行传递 2 如果 e r r C o d e 0 则为错误 2 6 4 持久类规范 对表的基本操作通过调用表的持久类进行相应的操作 持久类接口 InDataPer 所有的持久类接口于 InDataPer 定义如下 package wz elec pubs import java sql SQLException Title 持久类接口 JFRAMEWORK 2020 4 4 32 Copyright Copyright c 2003 Company author not attributable version public interface InDataPer extends java io Serializable 增加 throws SQLException void insert throws SQLException 修改 throws SQLException void update throws SQLException 删除 throws SQLException void delete throws SQLException 按顺序取得增加数据 return Object Object getInsertData 按顺序取得修改数据 return Object Object getUpdateData 按顺序取得删除数据 return Object Object getDeleteData JFRAMEWORK 2020 4 4 33 批量增加 param obs Object 实现类的数组 throws SQLException return String String insertBatch Object obs throws SQLException 批量修改 param obs Object 实现类的数组 throws SQLException return String String updateBatch Object obs throws SQLException 删除增加 param obs Object 实现类的数组 throws SQLException return String String deleteBatch Object obs throws SQLException 取得修改 SQL 带参数 return String String getUPSQL 取得增加 SQL 带参数 return String String getINSQL 取得删除 SQL 带参数 return String String getDELSQL 取得查询 SQL 带参数 return String JFRAMEWORK 2020 4 4 34 String getSELSQL 持久类 1 简单事项对表的查询 主键 增加 删除 修改 2 通过持久类生成 3 映射关系 类名 表名 字段 字段名 小写 实现 GET SET方法 4 没有实现的定义 字段映射定义 数据源映射定义 表关系定义 5 接口 InDataPer 方法简介 持久类 常量 执行 执行数据取得 1 简单事项对标的查询 主键 增加 删除 修改 2 通过持久类生成 3 映射关系 类名 表名 字段 字段名 小写 实现 G E T S E T 方法 4 没有实现的定义 字段映射定义 数据源映射定义 表关系定义 5 接口 I n D a t a P e r 新增 I N S Q L 删除 D E L S Q L 修改 U P S Q L 查询 U P S Q L 删除 D e l e t e d e l e t e B a t c h 新增 i n s e r t i n s e r t B a t c h 修改 U p d a t e u p d a t e B a t c h 修改 g e t U p d a t e D a t a 新增 g e t I n s e r t D a t a 新增 g e t I n s e r t D a t a 2 7 配置文件 红色为编程时 根据需要添加 修改信息 其他只要发布到规定目录下即可 JFRAMEWORK 2020 4 4 35 2 7 1 信息配置文件 ApplicationResources properties ApplicationResources properties 主要存放格式化信息和标准信息 如错误提示信息 标 准提示信息等 请放在 CLASSES 文件夹目录下 通过一下 TAG 引用 错误 显示全部错误信息 某类的错误信息 信息 文件信息的转换 对中文要执行字符转换命令 对转换得文件进行反转换得到信息 国际语言支持 按如下格式命名文件名 ApplicationResources language country properties 如简体中文表示为 ApplicationResources zh CN properties 通过设置 SESSION 的变量 wz elec pubs action Globals LOCALE KEY java util locale 类型 进行语 言选择 具体国际语言支持详细信息参见 java util locale 类 2 7 2 标记库配置文件 DTHTML TLD 本标记库主要实现 STRUTS 的 HTML 标记库中的 ERRORS MESSAGES 等功能 请 放在 WEB INF 文件夹目录下 引用说明 错误 信 息 使用说明 错误 显示全部错误信息 某类的错误信息 信息 Arg0 4 设置参数 2 7 3 WEB 配置文件 WEB XML 固有 在使用通用维护和复合通用维护时 请在 WEB XML 配置一下参数 xtcommonselectservice 转换到