您的位置：360文档中心› 泛微协同商务系统Ecology系统底层包开发指南

泛微协同商务系统Ecology系统底层包开发指南

合集下载
相关主题
  1. 1、下载文档前请自行甄别文档内容的完整性，平台不提供额外的编辑、内容补充、找答案等附加服务。
  2. 2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
  3. 3、如文档侵犯您的权益，请联系客服反馈,我们会尽快为您处理(人工客服工作时间：9:00-18:30)。

泛微协同商务系统
E c o l o g y系统底层包开
发指南
文件编码（GHTU-UITID-GGBKT-POIU-WUUI-8968）
底层包开发指南
目录
1.引言
1.1概述
本文档为泛微协同商务系统（Ecology）程序员开发指导文档，讲述了开发底层工具包的应用，常用功能的开发。

2.底层包应用及范例
本章对ecology系统的底层工具包进行讲解，开发人员可以从这里学到怎样利用底层的工具包进行开发
2.1最基本的继承类
系统中每一个java bean 都需要继承类。

这个类实现了记录日志和获取属性文件值的方法。

继承这两个类的其它类可直接应用这些方法来记录日志，获取属性文件某一个属性的值。

方法的实现见后面的例子。

继承的例子如下：
java bean 的继承
public class ResourceComInfo extends BaseBean {
public void doSomething() { 2003年8月12日2004-01-102004-03-10og'
#don't modify the file property
HH:mm:ss,SSS} %-5p %c - %m%n
上面的日志表明将所有的信息答应到文件日志文件中，其中日志的模式为：
#FATAL 0
#ERROR 3
#WARN 4 只有WARN,ERROR,FATAL输出
#INFO 6 所有的log都输出
#DEBUG 7
记录日志的例子如下：
public class ResourceComInfo extends BaseBean {
private void setResourceInfo() throws Exception{
try{
业务处理过程……….
String debugInfo = "This is test" ;
roperties。

比如：
系统的运行目录为 d:\ecology\，那么属性文件必须放在d:\ecology\WEB-
INF\prop\ 目录下，取名为，其中thefilename是任意的。

在属性文件中某一个键值的值用等号来赋值，等号后面的值必须放在一行，如果一行不够写（或者为了查看的方便），可以用 \ 来链接多行。

否则其它行的值不能被键值取得。

等号左右都可以有空格，对键值和键值的值没有影响。

比如：
thekeyname = thevalue
将键值的值放到多行：
thekeyname = thevalue1 \
thevalue2 \
thevalue3
thevalue4
这时候thekeyname 的值为thevalue1thevalue2thevalue3 ，thevalue4 取不到，因为thevalue3后面没有 \
在程序中要取得上述属性文件中键值thekeyname的值，使用方法：
getPropValue(“thefilename” , “thekeyname”) ;
获取属性文件的值的例子如下：
public class ResourceComInfo extends BaseBean {
private void setResourceInfo() throws Exception{
业务处理过程……….
String keyValue = getPropValue(“thefilename” ,
“thekeyname”) ;
getConfigFile() 来获取，当主属性文件名称因为需要改变得时候，不必改变所有用到这个属性文件的类，只需要改变GCONST类中常量的值
2.2怎样获取系统的运行目录
类提供了一个静态方法getRootPath() ，返回系统的运行目录，比如系统的运行目录为d 盘的ecology目录，将返回d:\ecology\
获取系统的运行目录的例子如下：
public class TestBean extends BaseBean {
import ；
public void getSysRunPath(){
String sysRunPath = GCONST. GetRootPath() ;
..……
}
2、使用指定的链接池ecologytest执行SQL语句
RecordSet rs = new RecordSet() ;
(" update TB_Example set name = 'the new value' " , "ecologytest" ) ;
3、使用指定的链接池ecologytest执行存储过程 PD_Example_UpdateById
存储过程PD_Example_UpdateById 如下：
CREATE PROCEDURE [PD_Example_UpdateById]
(@name varchar(100),
@id int,
@flag integer output,
@msg varchar(80) output)
AS
update TB_Example set name = @name where id = @id GO
RecordSet rs = new RecordSet() ;
String newname = ....... ;
String id = ...... ;
String procpara = newname + () + id ;
( "PD_Example_UpdateById" , procpara , "ecologytest" ) ;
procpara 是存储过程的参数值组成的字符串变量，多个参数值之间用分开
4、在一个客户程序多个执行之间，查询结果可以保留到下一次查询
RecordSet rs = new RecordSet() ;
(" select * from TB_Example ") ;
(" update TB_Example set name = 'the new value '") ;
while( () ) {
String thename = ("name") ; ..…….
}
(" select * from TB_Example ") ;
while( () ) {
String thename = ("name") ; ..……
}
访问和运行数据库脚本的例子：
public class ResourceComInfo extends BaseBean {
private void setResourceInfo() throws Exception{
业务处理过程……….
String sqlStr = “select * from Hrmresorce” ;
RecordSet rt = new RecordSet() ;
(sqlStr) ;
while()){
String id = ("id"));
String loginid = ("loginid"));
String lastname = ("lastname"));
持对一个或多个由属性文件定义的数据库连接池的访问.客户程序可以调用getInstance()方法访问本类的唯一实例。

对于一个链接池集合来说，可以有多个链接池，分别链接不同的数据库。

应用程序指定链接池的名称来调用不同的链接池。

如果应用程序没有指定链接池的名称，将使用默认的链接池。

默认链接池的指定有两种方式：
1、在Application Server设置的初始参数serverName的值，以Resin 为例：
<servlet servlet-name='InitServer' servlet-class=''>
<init-param serverName='ecology'/>
<load-on-startup/>
</servlet>
2、如果Application Server没有相应设置，则系统使用属性文件（）中设置的默认链接池名称：
DefaultPoolName = ecology
对于所有的链接池，系统需要加载相应的 JDBC Driver来建立与相应数据库的链接。

这些 Driver 在属性文件（）中指定，多个Driver中间用空格隔开：DriverClasses =
对于每一个链接池需要用到的参数在属性文件（）中指定，属性文件中参数的名称以链接池的名称开头，中间加入小数点，比如链接池 ecology 的参数指定为：
= jdbc:microsoft:10.1.1;DatabaseName=ecology DBConnectionPool类的管理和设置：
数据库链接池，所有创建的链接存放在链接池中，在客户端链接数据库时从链接池中取出链接，客户端在完成数据库操作后将链接返回链接池。

链接池创建链接需要用到的参数在属性文件（）中指定，属性文件中参数的名称以链接池的名称开头，中间加入小数点，比如链接池 ecology 的参数指定为：
件相关的信息，不需要通过数据表的查询就能得到这些信息。

存放在数据表中的信息只是供今后文件处理的时候使用！
上传文件的例子：
首先，我们要创建一个提交数据的页面，可以是jsp 的页面，也可以是html 的页面，我们将数据提交给的servlet 类来处理：
<HTML>
<HEAD>
<TITLE>文件上传</TITLE>
</HEAD>
<BODY>
<P>这是一个文件上传的例子</P>
<FORM id=weaver name=weaver action="/weaver/" method=post
enctype="multipart/form-data"><!—注意，这里需要用
enctype="multipart/form-data" 表明使用multipart/form-data 协议 -->
<input type="text" size="70" name="filedesc">
<input type="file" size="70" name="accessory1">
<input type="file" size="70" name="accessory2">
<input type="submit" name="提交">
</FORM>
</BODY>
</HTML>
将上面这段代码保存为一个html 文件，放在ecology运行目录下的/test/目录下。

在这个页面中，有一个输入框和两个文件框可以输入信息。

注意，在环境的配置中，需要告诉web服务器将 /weaver/ 的请求转给应用服务器作为servlet处理，关于配置的信息，请参考Apache 和Resin的配置文档。

下面我们来编写 ;
/**
* Title: 多文件上传处理类
* Description: 多文件上传测试
* Copyright: Copyright (c) 2001
* Company: weaver
* @author liuyu
* @version
*/
import . FileUpload;
public class MutiFileUpload extends DynamicServlet {
public void doProcess(HttpServletRequest request,
HttpServletResponse response) throws ServletException, IOException { FileUpload fu = new FileUpload(request) ;
String fileDesc = ("filedesc") ; /* 1*/
String[] fileFieldNames = {" accessory1"," accessory2"} ;
String[] fileIds = (fileFieldNames) ; /*2*/
String[] fileNames = () ; /*3*/
getParameter() 方法，而不能使用 () 方法，否则不能得到filedesc的值！
注释2：使用uploadFiles方法上传accessory1和accessory2中的文件，同时返回保存在ImageFile 表中的文件基本信息的键值imagefileid，可以将这个imagefileid记录到其它地方以便今后调用。

注释3：使用getFileNames方法获取上传文件的真实名称（包括后缀名）
将代码保存到 /src/weaver/test/ 文件中。

访问来测试一下，看看日志文件中的记录是否正确。

页面提交，文件上传完毕后将再次返回页面。

你可以查看ImageFile表来检查文件的具体存放位置等信息。

文件的存放位置在系统设置模块中设置，如果没有设置，将存放在系统运行目录下的filesystem 目录下。

2.3如何访问已经上传的文件
在jsp页面或者html页面中访问已经上传的文件非常简单，只需要调用类，并传递需要访问的文件id ，这个文件id，就是在文件上传中返回的 imagefileid。

访问上传的文件有两种方式，一种是非下载方式，这种方式如果浏览器能够显示访问的文件类型，那么就会在浏览器中直接显示。

另一种是下载方式，无论访问的文件是什么类型，都使用弹出下载窗口的形式下载。

对非下载方式的链接访问
<A href= "/weaver/">文件1</A>
对下载方式的链接访问
<A href= "/weaver/&download=1">文件1</A>
如果知道要访问的文件是图片，并需要在浏览页面中直接显示这个图片，可以使用下面的代码访问
<IMG SRC="/weaver/">
当然如果对于对应的文档，你没有权限，那么这个地址会让你返回到登录页面
2.4如何通过EXCEL导入数据
我们可以通过EXCEL导入一些数据实现系统的初始化，导入一个EXCEL需要用到. ExcelParse，在ECOLOGY中导入一个EXCEL很简单，. ExcelParse进行了封装，通过调用其中的方法：init(String filename)和getValue(String sheetname , String rownum , String columnnum)就可以实现
实例
<HTML>
<HEAD>
<TITLE>EXCEL导入</TITLE>
</HEAD>
<BODY>
<P>这是一个EXCEL导入的例子</P>
<FORM id=weaver name=weaver action="" method=post enctype="multipart/form-data"><!—注意，这里需要用enctype="multipart/form-data" 表明使用
multipart/form-data 协议 -->
<input type="text" size="70" name="filedesc">
<input type="file" size="70" name="accessory1">
<input type="file" size="70" name="accessory2">
<input type="submit" name="提交">
</FORM>
</BODY>
</HTML>
下面是的例子
<%@ page import="" %>
<jsp:useBean id="ExcelParse" class="" scope="page" />
FileUploadToPath fu = new FileUploadToPath(request) ; rim() ;
String lastname = ( ("1", ""+recordercount , "2" ) ).trim() ; String sex = ( ("1", ""+recordercount , "3" ) ).trim() ;
String department = ( ("1", ""+recordercount , "4" ) ).trim() ; String subcompany = ( ("1", ""+recordercount , "5" ) ).trim() ; String jobtitle = ( ("1", ""+recordercount , "6" ) ).trim() ; String manager = ( ("1", ""+recordercount , "7" ) ).trim() ;
String status = ( ("1", ""+recordercount , "8" ) ).trim() ;
String location = ( ("1", ""+recordercount , "9" ) ).trim() ; String loginid = ( ("1", ""+recordercount , "10" ) ).trim() ; String password = ( ("1", ""+recordercount , "11" ) ).trim() ; String seclevel = ( ("1", ""+recordercount , "12" ) ).trim() ; if( recordercount == 1 ) continue ; }
ExcelSheet，. ExcelRow进行了封装
实例
<%@ page language="java" contentType="text/html; charset=GBK" %>
<%@ page import=".*," %>
<jsp:useBean id="ExcelFile" class="" scope="session"/>
<iframe id="ExcelOut" name="ExcelOut" border=0 frameborder=no
noresize=NORESIZE height="0%" width="0%"></iframe>
<%
ExcelSheet es = new ExcelSheet() ;
(“EXCEL第n列的值”) ;
(er) ; 果是第一次调用此方法,则创建实例
*
* @return StaticObj 唯一实例
*/
public static StaticObj getInstance()
/**
* 获取 mainKey 对应的第一层对象值
*
* @param key 主键名称
* @return Object 对于的第一层对象值
*/
public Object getObject(String key)
/**
* 设置 mainKey 对应的第一层对象值
*
* @param key 主键名称
* @param obj mainKey 对应的第一层对象值
*/
public void putObject(String key, Object obj)
/**
* 从缓存中清除 mainKey 对应的第一层对象值
*
* @param key 主键名称
*/
public void removeObject(String key)
/**
* 获取 mainKey - subkey 对应的第二层对象值
*
* @param HashKey 主键名称
* @param RecKey 子主键名称
* @return Object 对于的第二层对象值
*/
public Object getRecordFromObj (String HashKey, String RecKey)
/**
* 设置 mainKey - subkey 对应的第二层对象值
*
* @param HashKey 主键名称
* @param RecKey 子主键名称
* @param obj mainKey - subkey对于的第二层对象值
*/
public void putRecordToObj (String HashKey, String RecKey, Object obj) /**
* 从缓存中清除 mainKey - subkey 对应的第二层对象值
*
* @param HashKey 主键名称
* @param RecKey 子主键名称
*/
public void removeRecordFromObj (String HashKey, String RecKey)
/**
* 从缓存中清除所有对象值
*
*/
public void clearRecord()
运用这些方法，我们可以构造所需要的缓存类，使用这些缓存类来对其它模块和功能提供缓存信息的接口，这些缓存类在系统中的命名为 XXXComInfo，其中XXX为相应缓存信息的名称。

参考如下的人力资源缓存类：。

ResourceComInfo 类主要提供人力资源信息中常用的一些信息的缓存，比如人员名称，所在部门。

对于这些信息，都需要一个键值。

常见的键值是这些信息在数据库表中的Primary Key，比如人力资源ID，其它模块和功能在关联人力资源信息的时候，只记录人力资源的ID，当需要获取人力资源的其它信息，如人员名称，所在部门的时候，从ResourceComInfo类提供的统一接口中获取。

的代码：
package .*;
import .*;
import .*;
/**
* Title: 人力资源缓存信息接口类
* Description: 对其它模块和功能提供统一的获取人力资源信息的接口
* Copyright: Copyright (c) 2002
* Company: weaver
* @author liuyu
* @version
*/
public class ResourceComInfo extends BaseBean {
/* 1 */
private ArrayList ids = null; rim() ;
}
/* 2 */
/**
* 获取当前人力资源信息指针指向的人力资源记录的部门id
*
* @return String 当前人力资源信息指针指向的人力资源记录的部门id
*/
public String getDepartmentID(){
return ((String)(current_index))).trim() ;
}
/**
* 获取人力资源id对应的人力资源名称信息
*
* @param key 人力资源id （为人力资源信息的键值）
* @return String 人力资源id对应的人力资源名称信息
*/
public String getResourcename(String key) {
int index=(key);
if(index!=-1) return ((String)(index)).trim();
else return "";
}
/**
* 获取人力资源id对应的人力资源登录名信息
*
* @param key 人力资源id （为人力资源信息的键值）
* @return String 人力资源id对应的人力资源登录名信息 */
public String getLoginID(String key) {
int index=(key);
if(index!=-1) return ((String)(index)).trim() ;
else return "";
}
/**
* 获取人力资源id对应的人力资源部门信息
*
* @param key 人力资源id （为人力资源信息的键值）
* @return String 人力资源id对应的人力资源部门信息
*/
public String getDepartmentID(String key) {
int index=(key);
if(index!=-1) return ((String)(index)).trim() ;
else return "";
}
/**
* 获取人力资源id对应的人力资源安全级别信息
*
* @param key 人力资源id （为人力资源信息的键值）
* @return String 人力资源id对应的人力资源安全级别信息 */
public String getSeclevel(String key) {
int index=(key);
if(index!=-1) return ((String)(index)).trim() ;
else return "";
}
/**
* 获取人力资源id对应的人力资源状态信息
*
* @param key 人力资源id （为人力资源信息的键值） * @return String 人力资源id对应的人力资源状态信息 */
public String getStatus(String key) {
int index=(key);
if(index!=-1) return ((String)(index)).trim() ; else return "";
}
/* 4 */
/**
* 清除人力资源缓存信息
*
*/
public void removeResourceCache() {
/* 3 */
("ResourceInfo");
}
/**
* 删除指定缓存信息
* @param key 指定缓存
*/
public void deleteResourceInfoCache(String key) { int index = (key);
if (index != -1) {
(index);
(index);
(index);
(index);
}
array_size = ();
}
/**
* 更新指定缓存信息
* @param key 指定缓存
*/
public void updateResourceInfoCache(String key) { int index = (key);
if (index != -1) {
RecordSet rs = new RecordSet();
("select * from HrmResource where id = " + key);
if ()) {
(index, ("id")));
(index, ("loginid")));
(index, ("lastname")));
(index, ("sex")));
(index, ("email")));
;
("ResourceInfo");
("ids");
(ht);
(msg);
}
}
}
}
}
以上代码需要注意的几个地方：
注释1：这里所定义的队列，用于依次存放人力资源的所需信息。

所需信息是根据我们的需要来确定的，但是必须明确一点，只有那些经常用到的信息采放到缓存中，否则将会造成缓存的臃余。

注释2：这里的指针和方法用于一些程序遍历人力资源的所有信息。

比如如下在jsp 页面中的应用：
<select name="resourceinfo">
<%
while()) {
%>
<option value="<%=
ResourceComInfo .getResourceid()%>"><%=ResourceComInfo .getLastname ()%></option>
<%
}
%>
</select>
注释3：缓存中的一级键值设置为相应的类名，根据这个键值来判断缓存中是否有相应的信息，或者清除缓存中的该信息。

需要注意的是，缓存中的键值信息必须唯一，不能重复！
注释4：在不是必须的时候，更新人力资源的时候一定要使用更新指定的缓存的方式，而不要把缓存清空，等待下一次使用到该缓存的时候在重新初始化该缓存。

注释5：对数据更新频率不高，使用频率确相对较高数据请尽量使用缓存的方式存取数据，而不是直接从数据库中读取。

2.5其它底层类基本方法
ECOLOGY中，还有一些常用的工具类，是在开发中基本都会使用到的，大家还需要看看如下几个类的API 文档：
:
提供了大量基本的工具方法（其中提供了对字符，数据等的处理），其中
null2String方法，fromScreen方法，toScreen 方法，TokenizerString ，toHtml 方法是大家需要关注的方法。

:
提供对日期操作的工具方法，如：日期转化，日期加减
. SendMail :
提供了邮件发送的基本方法，其中send方法，sendhtml方法，sendMiltipartText 方法是大家需要关注的方法。

:
提供了文件处理的工具方法。

其中createDir方法，copy方法，moveFileTo方法，DeleteFile方法，extractFileName方法，extractFileExt方法，extractFilePath 方法是大家需要关注的方法。

相关文档
最新文档