Ecology系统接口指南

<service-point id="local" interface="weaver.interfaces.datasource.DataSource">
<invoke-factory>
<construct class="weaver.interfaces.datasource.BaseDataSource">
</construct>
</invoke-factory>
</service-point>
声明一个CronJob的方法和IntervalJob类似，在ecology安装目录/WEB-INF/service/schedule.xml中声明：
<service-point id="job3" interface="weaver.interfaces.schedule.CronJob">
}
str字符串变量是被集成系统的登录页面html表单提交代码，客户开发人员可以自己修改str的值来实现自己的登陆代码。大多数情况下可以不用自己开发，但是对基于.net技术的网站系统可能需要自己实现登陆部分的代码。
4.注意事项。
被集成的系统必须是B/S架构的系统，登录页面必须是传统的登录页面（没有验证码、动态密码等）
1
企业在信息化的过程中不可避免的会购置各种各样的业务系统，为了登陆不同的系统，用户需要频繁的打开不同的窗口、输入各自的帐号密码，费时费力。但是通过ecology系统的自定义菜单功能和集成登陆接口，可以比较方便的实现登陆ecology系统后直接到达其他业务系统的功能，省去了繁琐的登陆过程。
1.1
1.系统管理员维护待集成系统的登陆页面地址，如图所示：
<set-service property="ds" service-id="datasource.local"/>
<set property="second" value="60"/>
</construct>
</invoke-factory>
</service-point>
上面的声明定义了一个名为job1的IntervalJob，该接口中的方法execute()将会每60秒执行一次。同时把前面定义的local数据源注入到了接口中，这样的话就可以在execute（）中读写local数据源。我们也可以注入两个数据源到接口中，这样就可以在两个数据源之间交换数据：
<set property="user" value="sa"/>
<set property="password" value="ecology"/>
<set property="minconn" value="5"/>
<set property="maxconn" value="10"/>
</construct>
<service-point id="job2" interface="weaver.interfaces.schedule.IntervalJob">
<invoke-factory>
<construct class="weaver.interfaces.schedule.BaseIntervalJob">
"0 0/5 14,18 * *"在每天下午2点到2:55期间和下午6点到6:55期间的每5分钟触发
"0 0-5 14 * * ?"在每天下午2点到下午2:05期间的每1分钟触发
"0 10,44 14 ? 3 WED"每年三月的星期三的下午2:10和2:44触发
"0 15 10 ? * MON-FRI"周一至周五的上午10:15触发
<set property="user" value="dcwork1"/>
<set property="password" value="dcwork1"/>
<set property="minconn" value="5"/>
<set property="maxconn" value="10"/>
（图四，给待集成的系统添加左侧菜单）
（图五）
（图六，链接地址必须设为/interface/Entrance.jsp?id=待集成系统的标识值）
（图七，这个菜单用来给系统用户维护集成系统的帐号信息。链接地址必须是
/interface/AccountSetting.jsp)
2.到目前为止，系统设置已经完成，系统用户可以使用被集成的系统了。在使用被集成的系统之前需要先设置一下自己在被集成系统中的账号信息（通过前文所述的“账号设置”左侧菜单进行设置，设置一次就可以了，只有在被集成系统的帐号改变了的情况下才需要再次设置。）
3.
客户开发人员可以利用计划任务接口定时执行一段自己定义的操作，比如在两个数据源之间交换数据。
Ecology提供两种计划任务接口
1.IntervalJob接口，此接口每隔一段时间执行一次（自己定义间隔时间）
2.CronJob接口，此接口在指定的时间点执行（自己定义时间点）
定义计划任务的方法是在ecology安装目录/WEB-INF/service/schedule.xml中声明：
<set-service property="ds" service-id="datasource.local"/>
<set-service property="ds1" service-id="datasource.msds"/>
<set property="second" value="60"/>
<set property="type" value="oracle"/>
<set property="host" value="192.168.0.204"/>
<set property="port" value="1521"/>
<set property="dbname" value="weaver1"/>
“*”字符代表所有可能的值
因此，“*”在子表达式（月）里表示每个月的含义，“*”在子表达式（天（星期））表示星期的每一天
“/”字符用来指定数值的增量
例如：在子表达式（分钟）里的“0/15”表示从第0分钟开始，每15分钟
在子表达式（分钟）里的“3/20”表示从第3分钟开始，每20分钟（它和“3，23，43”）的含义一样
0 0 12 ? * WED表示每个星期三中午12点
"0 0 12 * * ?"每天中午12点触发
"0 15 10 ? * *"每天上午10:15触发
"0 15 10 * * ?"每天上午10:15触发
"0 * 14 * * ?"在每天下午2点到下午2:59期间的每1分钟触发
"0 0/5 14 * * ?"在每天下午2点到下午2:55期间的每5分钟触发
（图一，集成登陆菜单入口）
（图二，点“集成登陆”菜单后的显示页面，我们可以通过“新建”来维护需要集成的系统。本文以集成网易163邮箱为例。注意：标识很重要，不能重复，在后面的步骤中会用到标识值）
（图三，新建页面。内网地址为局域网访问，外网地址为internet访问。账号参数名和密码参数名通过查看该系统登录页面的html源码获得，如果登陆页面还有其他输入项的话则添加其他参数）
</construct>
</invoke-factory>
</service-point>
上面的声明定义了一个oracle数据源，我们可以在datasource.xml文件中定义多个数据源，只需按照上面的格式添加一段新的声明就可以了，仅仅需要改动红色标出来的部分。例如添加一个sql server数据源：msds
</invoke-factory>
</service-point>
说明：
type:数据库类型。有效值为oracle、sqlserver、db2、mysql、odbc
host:数据库主机名或ip
dbname:数据库名
user：数据库账号
password:数据库密码
minconn:连接池最小连接数
maxconn:连接池最大连接数
（图一）
（图二）
（图三，设置好账号信息后点“网易163邮箱”左侧菜单，直接登录进入163邮箱系统）
3.接口开发
如果上面的设置不能达到直接进入被集成系统的目的，可以通过修改接口文件来自己写集成登陆的代码。
1.找到ecology安装目录/interface/Entrance.jsp文件并打开（最好先备份一下）
<invoke-factory>
<construct class="weaver.interfaces.schedule.BaseCronJob">
<set-service property="ds" service-id="datasource.local"/>
<set-service property="ds1" service-id="datasource.msds"/>
"0 15 10 15 * ?"每月15日上午10:15触发
"0 1510 L* ?"每月最后一日的上午10:15触发
"0 15 10 ? *6L"每月的最后一个星期五上午10:15触发
"0 15 10 ? * 6#3"每月的第三个星期五上午10:15触发
有些子表达式能包含一些范围或列表
例如：子表达式（天（星期））可以为“MON-FRI”，“MON，WED，FRI”，“MON-WED,SAT”
<service-point id="msds" interface="weaver.interfaces.datasource.DataSource">
<invoke-factory>
<construct class="weavwenku.baidu.comr.interfaces.datasource.BaseDataSource">
<set property="cronExpr" value="0 44 12 ? * MON-FRI"/>
</construct>
</invoke-factory>
</service-point>
上面的声明定义了一个周一到周五12：44执行的计划任务。什么时候执行计划任务由cronExpr表达式决定。一个cron表达式有至少6个有空格分隔的时间元素，
按顺序依次为：
秒（0~59）
分钟（0~59）
小时（0~23）
天（月）（0~31，但是你需要考虑你月的天数）
月（0~11）
天（星期）（1~7 1=SUN或SUN，MON，TUE，WED，THU，FRI，SAT）
0 0 10,14,16 * * ?每天上午10点，下午2点，4点
0 0/30 9-17 * * ?朝九晚五工作时间内每半小时
“？”字符仅被用于天（月）和天（星期）两个子表达式，表示不指定值
当2个子表达式其中之一被指定了值以后，为了避免冲突，需要将另一个子表达式的值设为“？”
2
ecology提供了许多系统扩展接口，开发人员可以通过这些接口操作不同的数据源。例如把ecology的数据同步到其他的系统中去，或把其他系统中的数据同步到ecology中来，本质上就是在两个数据源之间交换数据。定义数据源的方法很简单，只需要在ecology安装目录/WEB-INF/service/datasource.xml中声明一下就可以了。
<dependency module-id="datasource" version="1.0.0"/>
<service-point id="job1" interface="weaver.interfaces.schedule.IntervalJob">
<invoke-factory>
<construct class="weaver.interfaces.schedule.BaseIntervalJob">
<set property="type" value="sqlserver"/>
<set property="host" value="192.168.0.38"/>
<set property="port" value="1433"/>
<set property="dbname" value="ecology"/>
2.注意文件中的这段代码：
if(sysid.equals("1")){//如果系统标识值等于1
//163邮件系统集成
out.print(str);
}else if(sysid.equals("2")){//如果系统标识值等于2
//第二套待集成系统
out.print(str);
}
。。。。
else{
out.print(str);