smart2005中间件平台

一 Java 类 ParamUtils 描述： 该类主要提供页面传入参数的处理方法,将页面传 入的参数转换成 String,Boolean,int,long,float, Double 型数据。 包名： smart.jrsoft.util 类 ID： ParamUtils 方法： 方法名 描述 getParameter (HttpServletRequest request,String parma) 将上一页面传入的参数转换成 String 型 On Entry: request:用 request 方法得到参数 parma: 上一页面的参数名 On Exit: return String 返回 String 型参数。 getBooleanParameter (HttpServletRequest request,String parma) 将上一页面传入的参数转换成 Boolean 型 On Entry: request:用 request 方法得到参数 parma: 上一页面的参数名 On Exit: return Boolean 返回 Boolean 型参数。 getIntParameter (HttpServletRequest request,String parma,0) 将上一页面传入的参数转换成 int 型 On Entry: request:用 request 方法得到参数 parma: 上一页面的参数名 0:出错后返回值 On Exit: return int 返回 int 型参数。 getFloatParameter (HttpServletRequest request,String parma,0) 将上一页面传入的参数转换成 float 型 On Entry: request: 用 request 方法得到参数 parma: 上一页面的参数名 0:出错后返回值 On Exit: return float 返回 float 型参数。 getLongParameter (HttpServletRequest request,String parma,0) 将上一页面传入的参数转换成 long 型 On Entry: request: 用 request 方法得到参数 parma: 上一页面的参数名 0:出错后返回值 On Exit: return long 返回 long 型参数。 getDoubleParameter (HttpServletRequest request,String parma,0) 将上一页面传入的参数转换成 double 型 On Entry: request: 用 request 方法得到参数 parma: 上一页面的参数名 0:出错后返回值 On Exit: return double 返回 double 型参数。 int getIntParameters(HttpServletRe quest request, String name, int defaultNum) 将上一页面传入的参数转换成 int 型数组. On Entry: request: 用 request 方法得到参数 name: 上一页面的传入参数名称 defaultNum:出错后返回值 On Exit: return int 返回 int 型数组。 double getDoubleParameters(HttpServl etRequest request, String name, double defaultNum) 将上一页面传入的参数转换成 double 型数组. On Entry: request: 用 request 方法得到参数 name: 上一页面的传入参数名称 defaultNum:出错后返回值 On Exit: return double 返回 double 型数组。 long getLongParameters(HttpServlet Request request, String name, long defaultNum) 将上一页面传入的参数转换成 long 型数组. On Entry: request: 用 request 方法得到参数 name: 上一页面的传入参数名称 defaultNum:出错后返回值 On Exit: return long 返回 long 型数组。 float getFloatParameters(HttpServlet Request request, String name, float defaultNum) 将上一页面传入的参数转换成 float 型数组. On Entry: request: 用 request 方法得到参数 name: 上一页面的传入参数名称 defaultNum:出错后返回值 On Exit: return float 返回 float 型数组。 第 3 页 使用方法： 以上方法的使用需要两个页面才能实现。第一个页面为输入页面，第二个页面为处理页 面。以上方法的使用在第二个页面上实现。 1、引用包 2、在输入页面上，添加一个文本框，并命名为“param” getParameter (HttpServletRequest request,String parma) 在处理页面中用 request 方法得到该文本框的参数，并转换成 String 型 String kk=ParamUtils.getBooleanParameter (request,“param“); getBooleanParameter (HttpServletRequest request,String parma,0) 在处理页面中用 request 方法得到该文本框的参数，并转换成 Boolean 型。如果出错， 返回值为 0 int a=ParamUtils.getIntParameter(request,“param“,0); getIntParameter (HttpServletRequest request,String parma,0) 在处理页面中用 request 方法得到该文本框的参数，并转换成 int 型。如果出错，返回 值为 0 int a=ParamUtils.getIntParameter(request,“param“,0); getFloatParameter (HttpServletRequest request,String parma,0) 在处理页面中用 request 方法得到该文本框的参数，并转换成 float 型。如果出错，返 回值为 0 float b=ParamUtils.getFloatParameter(request,“param“,0); getLongParameter (HttpServletRequest request,String parma,0) 在处理页面中用 request 方法得到该文本框的参数，并转换成 long 型。如果出错，返 回值为 0 long c=ParamUtils.getLongParameter(request,“param“,0); getDoubleAttribute (HttpServletRequest request,String parma,0) 在处理页面中用 request 方法得到该文本框的参数，并转换成 double 型。如果出错， 返回值为 0 double d=ParamUtils.getDoubleParameter(request,“param“,0); 二 Java 类 StringUtils 描述： 字符集处理类。 包名： smart.jrsoft.util 类 ID： StringUtils 引用其他类: com.tjhq.cee2.imp.web.load.SystemConfig.java 用来 读取配置文件中内码,外码信息.在方法 exchange( )和 getISO8859( )将用到. 方法： 方法名 描述 exchange (String str) 将非中文字符转换为中文字符 On Entry: String: str 需要转换的字符 On Exit: return String 返回转换后的字符 getISO8859 (String str) 将 GB2312 转换成 ISO8859-1 On Entry: String: str 需要转换的字符 On Exit: return String 返回转换后的字符 replace (String line,String oldString,String newString) 用子字符串 newString 替换字符串 line 中的子字符串 oldString On Entry: String: line String: oldString String : newString On Exit: return String 返回处理后的字符 line encodeBase64(String data) base64 加密 On Entry: String: data 要加密的数据 On Exit: return String 返回加密后处理字符 decodeBase64(String data) base64 解密 On Entry: String: data 要解密的数据 On Exit: return String 返回解密后处理字符 splittoArray (String) 除去字符串中特殊字符并将以特殊字符隔断的子字符串分组存 放.特殊字符包括(,!,#,$,%,）将字符串隔开的子字符串的个数 On Entry: String: str 字符串 On Exit: return int 返回子字符串的个数 getCharacterItem (String,int) 取得第 n 个(,或者；)与第 n+1 个(,或者;)之间的字符串 On Entry: String:字符串 Int:第 n 个断句字符 On Exit: return String 返回字符串 getOutPut (String) 输出 HTML 格式字符串 如: kkkk JJJJJJJJ 输出结果为kkkk JJJJJJJJ On Entry: String:字符串 第 5 页 On Exit: return String 返回字符串 addSingleQuotation (String) 用字符将字符串包含“,“的字符分开如：将 AB,CD,EFGHI,JKL转换成 AB,CD,EFGHI,JKL On Entry: String:字符串 On Exit: return String 返回字符串 使用方法： 1、引用包 2、简单示例-1 String str=“ABSCDE,FGHI;JKLMNO,PQRS,TUVWX,YZ“; int a= StringUtils .getCharacterCount (str); a 的值为 6. String substr= StringUtils .getCharacterItem(str,1); substr 的值为 FGHI. 3. 简单示例-2 String str=“ABSCDE#FGHIJKLMNOPQRS String a= StringUtils.splittoArray (str); int len=a.length; for (int i=0;i 2、调用组件里的方法 format(String d, int length) 将字符型小数 xx 四舍五入后返回字符型，保留三位小数 String xx=“0.34894“; String y= NumberUtils.getInstance().format(xx,3); 结果为：字符串 y=”0.348” format(double d, int length) 将双精度型小数 yy 四舍五入后返回字符型，保留三位小数 double yy=0.34894; String z= NumberUtils.getInstance().format(yy,3); 结果为：字符串 z=”0.348” 前两种方法的不同之处是：第一种方法，输入的字符串型，后一种方法输入的是双精度 型 getPrecent (int a, int b,int c) a 为被除数，b 为除数，结果为字符串型百分数，保留 3 位小数 int a=23; int b=39; String pre= NumberUtils.getInstance().getPrecent(a,b,3); 结果为：字符串 pre23/39”58.974%” 五 Java 类 FileOperation 描述： 封装了对文件目录以及文件的操作。包括创建目录,创建 文件,删除目录,删除文件,目录移除,文件移除,判断文件是否存在,取文件名与文 件扩展名等方法。 包名： smart.jrsoft.file 类 ID： FileOperation 引用的包、类说明：smart.jrsoft.utils.StringUtils.java 用来处 理字符。 方法： 方法名 描述 makeDir(String dirName) 创建本地目录,支持三级以上目录的创建 On Entry: dirName: 目录名称包括目录路径如 (D:testPublic JR) On Exit: return true/false 返回成功/失败 makeRemoteDir(HttpServletRe quest request,String dirs) 创建 web 目录,支持三级以上目录的创建 On Entry: request:Http 回应 request 类 dirs:Web 路径 /相对路径 例如/Document/Contract/ On Exit: return true/false 返回成功/失败 deleteDirectory(String fullDirName) 删除本地目录,将删除该目录下所有文件夹以及文件 On Entry: dirName 目录所在路径(绝对路径 如: D:testPublic JR) On Exit: return true/false 返回成功/失败 deleteRemoteDir(HttpServletRe quest request,String filePath) 删除 Web 目录将删除该目录下所有文件夹以及文件 On Entry: request:Http 回应 request 类 filePath:Web 路径 /相对路径例如/Document/Contract/ On Exit: return true/false 返回成功/失败 moveDirectory(String sourceDir,String desDir) 将本地一个目录中文件移动本地另一个目录中.包括所有文件夹 和文件 目标目录不存在程序可以自己创建 On Entry: SourDir: 源目录 DesDir: 目标目录 On Exit: return true/false 返回成功/失败 第 9 页 moveDirectory(String sourceDir,String desDir,String dirName) 将本地一个目录中文件移动本地另一个目录的指定文件中.包括 所有文件夹和文件 目标目录不存在程序可以自己创建 此方法与上一方法 moveDirectory(String sourceDir,String desDir)类似. On Entry: SourDir: 源目录 DesDir: 目标目录 DirName: 目标目录指定文件夹的名称 On Exit: return true/false 返回成功/失败 createFile(String fullFileName,String txt) 创建本地文件如创建.txt,.doc 文件（不支持 a.c.d.x.txt 文件的 创建） On Entry: fullFileName 文件路径+文件名称 如 D:testPublictest.txt txt 文件内容 On Exit: return true/false 返回成功/失败 deleteFile(String fullFileName) 删除本地文件（不支持通配符删除） On Entry: FullFileName: 文件绝对路径+文件名称 如:D:testtest.jsp On Exit: return true/false 返回成功/失败 deleteRemoteFile(HttpServletRe quest request,String filePath) 删除 web 文件（不支持通配符删除） On Entry: request:Http 回应 request 类 filePath:文件路径 /相对路径例如/Document/Contract/Test.xml On Exit: return true/false 返回成功/失败 getFileExtName(String fullFileName) 取得文件扩展名 On Entry: FullFileName: 文件路径+文件名称 文件路径+文件名称或者 文件名 如:D:testtest.jsp 或者/test/test.jsp 或者 test.jsp On Exit: Return String 扩展名 getFileNoExtName(String fullFileName) 取得文件名称不含扩展名 On Entry: FullFileName: 文件路径+文件名称或者文件名 如: D:testtest.jsp 或者/test/test.jsp 或者 test.jsp On Exit: Return String 文件名 getFile (String path) 取得文件名称含扩展名 On Entry: path: 文件路径+ 文件名称或者文件名 如:D:testtest.jsp 或者 /test/test.jsp On Exit: Return String 文件名 isExist(String fullFileName) 判断本地目录或者文件是否存在 On Entry: FullFileName: 文件路径+文件名称或者文件目录（绝对路径） On Exit: return true/false 返回成功/失败 isRemoteExist(HttpServletRequ est request,String fullFileName) 判断 web 目录或者文件是否存在 On Entry: FullFileName: 文件路径+文件名称或者 web 目录（相对路径） On Exit: return true/false 返回成功/失败 reName(String oldFileName,String newFileName) 本地文件更名 On Entry: OldFileName: 文件路径+文件名称 如:D:testtest.jsp NewFileName: 更改后文件名（ 只能是文件名不能带文件路径） On Exit: return true/false 返回成功/失败 reNameRemoteFile(HttpServlet Request request ,String oldFileName,String newFileName) web 目录文件更名 On Entry: OldFileName: 文件路径+文件名称 如:/test/test.jsp NewFileName: 更改后文件名（ 只能是文件名不能带文件路径） On Exit: return true/false 返回成功/失败 moveFile(String src,String des) 源文件移动到新的路径下 des 路径不存在方法可以自己创建. des 为目标文件路径.此处 des 必须是文件路径名,并且必须要以” ”结尾. On Entry: Src: 源文件路径及文件名 Des: 目的文件路径及文件名 On Exit: return true/false 返回成功/失败 六 Java 类 DateUtils 描述： 封装了对一些对日期常见的操作方法。 包名： smart.jrsoft.util 类 ID： DateUtils 方法： 方法名 描述 getToday( ) 得到当前日期字符串 On Entry: On Exit: return 当前日期 按“yyyy-MM-dd“ 格式获取 format(Date) 将日期型转换为字符型.转换后的日期格式为 yyyy-MM-dd On Entry: Date: 如: Tue Jan 01 00:09:00 CST 2002 On Exit: return String 返回字符型日期 getTime（） 获得当前时间.显示格式如：2005-07-18 10:21:41 第 11 页 On Entry: On Exit: return String 返回当前时间字符串 getTimeNoSeparate( ) 获得当前时间.显示格式如：20050826102109 一般用于作为新 建文件夹或者文件名的一部分 On Entry: On Exit: return String 返回当前时间字符串 getNow（） 得到当前日期,格式如:20050825 On Entry: On Exit: return String 返回当前日期字符串 format（String） 将字符串转换成 Date 型如:2005-08-25 to Wed Aug 24 00:00:00 CST 2005 On Entry: On Exit: return Date 返回 Date 型日期. 七 Java 类 DropList 描述： 连动下拉框组件 包名： smart.css.droplist 类 ID： DropList 方法： 方法名 描述 getDropList(String form,String tableName,String thisDeepID,String nextDeepID,long deep,long sum) 得到下拉框 On Entry: String form：指下拉框所在 form String thisDeepID：本下拉框的 name String tableName：所要查询的表 String nextDeepID：下个下拉框的 name long deep：要查询的机构树的层次 long sum：机构树的层次数 On Exit: 机构树的下拉框 注意：thisDeepID 的下达框，可由组件自己生成，但 nestDeepID 的下拉框不能自动生成， 必须在页面上加入代码 请选择 需要注意的地方：tableName 表的表结构必须与 org_tree 表结构一致(字段名,类型,长度等). 八 Java 类 XmlHandler 描述： Xml 文本读取类。 包名： smart.jrsoft.xml 类 ID： XmlHandler 引用的包、类说明： 需要引用 xml.jar,将其放至 WEB-INF 文件夹的 lib 下. 方法： 方法名 描述 setConfigXml(String configXml) 设置 XML 配置文件的路径 On Entry: String: configXml XML 配置文件的路径 On Exit: getConfigXml () 获得 XML 配置文件的路径 On Entry: On Exit: return: String XML 配置文件的路径 open (String xmlPath) 打开一个指定路径的 XML 文档 On Entry: String: xmlPath 如: C:smart_config.xml On Exit: return boolean 返回 true/false getRoot（） 得到 XML 根节点名称 On Entry: On Exit: return: String 返回 XML 根节点名称 getSingleNodeValue（String Tag） 获得单个节点的值 On Entry: String: Tag 节点名称 On Exit: return String 返回单个节点的值 getNodeValue（ String nodePath） 获得节点的 value 值 On Entry: String: nodePath 节点路径 On Exit: return String 返回节点的 value 值 getAllAttributes(String nodePath) 获得某个节点所有的属性集合 On Entry: String: nodePath 节点路径 On Exit: return String返回属性 value 的二维数组 getItem(String str, int n) 获得节点路径中第 N 个节点的名称 On Entry: String str 节点路径 example:root.nodea.nodeb int n 第 N 个节点 On Exit: return String 返回节点路径中第 N 个节点的名称 getGlobleValue(String XPath,String NPath) 获取指定路径下的 xml 文件中指定节点 value 值 On Entry: String XPath 指定路径下的 xml 文件 第 13 页 String NPath 节点路径 example:root.nodea.nodeb On Exit: return String 返回指定节点 value 值 close（） 关闭已经打开的 XML 文件 On Entry: On Exit: return boolean 返回 true/false 使用方法： 1.为了方便测试人员进行测试下面先看看 xml 文件的结构 . value All properties must be under the “jive“ element. This file should live in your jiveHome directory. The path to that directory should be specified in your jive_perties file. The jive_perties must be in your appservers classpath. 25 110 2.页面引用 java 类: 3.测试用例-1 /获得节点路径中第 N 个节点的名称 . String mm=xml.getItem(“smart.mail.pop3“,2);返回结果为: mail 4.测试用例-2 String kl=xml.getGlobleValue(“C:smart_config.xml“,“smart.mail.host“); 返回结果为 5.测试用例-3 String root=xml.getRoot(); 返回结果为: smart 九 Java 类 ZipUtils 描述： 对文件进行压缩、解压缩。支持中文，支持对目 录的压缩和解压缩 包名： smart.jrsoft.util 类 ID： ZipUtils 引用的包、类说明： 需要引用 Zip.jar 包,将 Zip.jar 放在 WEB-INF 文 件夹的 lib 下。需要引用 smart.jrsoft.file.FileOperation.java. 说明：在写文件路径字符串时， “”要修改成 “”或“/ ” 方法名 描述 Zip(String FileDirName) 对文件进行压缩 On Entry: String FileDirName:需要压缩的文件 On Exit: return String 返回压缩后的文件，存放路径与原文件相同，后 缀为.zip Zip(String FileDirName,String ZipFileName) 将文件压缩到指定路径 On Entry: FileDirName:需要压缩的文件名 String ZipFileName：压缩后的文件名 On Exit: 加密后的文件，后缀为.zip UnZip(String ZipFileName) 对压缩后的文件进行解压。解压到当前路径下 On Entry: String ZipFileName：需要解压缩的文件名，文件扩展名必须 为.zip On Exit: Return int 返回 int 型结果.0:成功;1:源文件不存在;2:源文件 不是压缩格式文件 5:其他 UnZip(String ZipFileName,String DestPath) 对压缩后的文件进行解压。 On Entry: String ZipFileName：需要解压缩的文件名，文件扩展名必然 为.zip String DestPath：存放路径（注意：存放路径 ,不存在可以创建 , 第 15 页 创建失败返回 3） On Exit: Return int 返回 int 型结果.0:成功;1:源文件不存在;2:源文件 不是压缩格式文件 3:目标路径不存在 ;4:目标路径不是目录;5: 其他 十 Java 类 CreatPdf 描述： 该类主要用于生成 Pdf 文件 使用方法 生成生成 Pdf 文件主要分三步 1. 生成要产生 pdf 文件的对象 2. 给文章对象添加内容(内容包括 文本 图象 表格) 3. 保存文档 包名： smart.app.pdf.CreatPdf 父类 java.long.Object 引用的包、类说明： import java.awt.Color; import java.io.FileOutputStream; import smart.app.pdf.*; 方法： 方法名 描述 public CreatPdf(); 构造函数同时初始化字体对象 On Entry: On Exit: return new CreatPdf () public void setPageSize( Rectangle pageSize) 设置页面大小 On Entry: param pageSize 页面大小 On Exit: public void setFont( String fontFamily, float size, String fontColor, String fontStyle ) 设置字体基本属性 例如： setFont(“宋体“,16,“black“,“Font.NORMAL“); On Entry: param fontFamily 基本字体 param size 字体大小 param fontColor 字体颜色 param fontStyle 字体风格 On Exit: public void addContent(String str) 给文章添加内容 不换行 On Entry: param str 添加文章的内容 On Exit: public void addAlignContent( String str, String align) 给文章添加内容（不换行）附带内容的对齐方式 On Entry: param str 添加文章的内容 param align 对齐方式 如 (left center right ) On Exit: public void addContentLn(String str) 以文章断的方式给文章添加内容 On Entry: param str 添加文章的内容 On Exit: public void addAbsImage( String path, float width, float height, String align) 以绝对大小的方式给文章添加图片（有对齐方式） On Entry: param path 图片路径名称 param width 图片的绝对宽度 param height 图片的绝对高度 param align 图片在文章中的对齐方式 (left center right) On Exit: public void addAbsImage( String path, float width, float height) * 以绝对大小的方式给文章添加图片（没有对齐方 式） On Entry: param path 图片路径名称 param width 图片的绝对宽度 param height 图片的绝对高度 On Exit: public void addPerImage( String path, float width, float height, String align) 以相对大小的方式给文章添加图片 （有对齐方式） On Entry: param path 图片路径名称 param width 图片的相对页面宽度的百分比 0-100 param height 图片的相对页面高度的百分比 0-100 param align图片的对齐方式 On Exit: public void addPerImage( String path, float width, float height) 以相对大小的方式给文章添加图片 （没有对齐方式） On Entry: param path 图片路径名称 第 17 页 param width 图片的相对页面宽度的百分比 0-100 param height 图片的相对页面高度的百分比 0-100 On Exit: public void setTable(int row,int col) 设置一个 row 行 col 列的表格 On Entry: param row 表格的行数 param col 表格的列数 On Exit: public boolean setTableBW(int value) 设置表格边框的宽度 On Entry: param value 表格边框的宽度 On Exit: return 成功 true 失败 false public boolean setTableBC(String str) 设置表格的边框颜色 On Entry: param str 表格的边框颜色 (如 blue white red 等 ) On Exit: return 成功 true 失败 false public boolean setTablePadd(float value) 设置表格填充值 On Entry: param value 表格填充值 On Exit: return 成功 true 失败 false public boolean setTableSpac( float value) 设置表格间隙值 On Entry: param value 表格间隙值 On Exit: return 成功 true 失败 false public boolean setTableEndHead() 设置表格的头部分结束 On Entry: On Exit: return 成功 true 失败 false public boolean addTable() 向文章添加表格 On Entry: On Exit: return 成功 true 失败 false public void setCell(String str) 设置表格基本单元格的内容 On Entry: param str 表格基本单元格的内容 On Exit: public boolean setCellAlign(String str) 设置基本单元格内容的对齐方式 On Entry: param str 基本单元格内容的对齐方式 如: left center right On Exit: return 成功 true 失败 false public boolean setCellColspan(int value) 设置单元格所占列数 On Entry: param value 单元格所占列数 On Exit: return 成功 true 失败 false public boolean setCellRowSpan(int value) 设置单元格所占行数 On Entry: param value 单元格所占行数 On Exit: return 成功 true 失败 false public boolean setCellbC(String str) 设置基本单元格边框颜色 On Entry: param str 基本单元格边框颜色 (如 blue black white 等) On Exit: return 成功 true 失败 false public boolean a