转至元数据结尾
转至元数据起始

摘要

Icon

本文只针对非健新科技人员的入门向导,健新科技人员请看内部资料,遵循相应规范。

 

 

前提条件

Icon

1、进行了平台运行环境安装

2、掌握Eclipse、Maven的使用

下载开发辅助工具

1、从Github中下载本项目的源码,开发目录为:development

2、详细看其中的readme.txt,有详细的使用说明。

3、将 \jxweb\WEB-INF\lib 目录中的所有jar包都要放入Maven库(你的私有库,也可以点击这儿直接使用健新有库),当然有些公用包不用重复。

注意:第2、3步没做好,后面根本进行不下去,特别注意。

dev 解压之后的目录如下图所示(注意,此目录最好与jxweb目录在相同的盘符,方便后续的工作):

1、直接与健新科技联系,获得健新SVN帐号、Maven库帐号。

2、直接与健新科技联系,获得详细的环境导入说明,能更快上手开发,无需复杂的配置。

 

 

摘要

Icon

开发案例:以请假申请为例说明如何开发插件。

设计文档:\Dev\Word2Sql\test\doc\DDR20120412-请假管理详细设计说明书.doc

 

1、双击 dev\mvndoit.bat,如下图所示:

2、选择2回车,开始创建插件

3、选择A(不用按回车),我们将插件创建到ProjectA项目中去,输入插件的唯一标识:leave

4、输入包名,按回车

5、确认相关信息输入是否正确,如果正确,直接按回车确认。

6、我们可以看到创建插件成功

7、创建成功之后,界面如下图所示:

注意

Icon

由于Maven的原型工具,控制大小写有点问题,请手动修改jbo目录的类名(文件名和文件内容中的类名),将首字母大写。

 

8、打开Eclipse,选择Import导入插件,如下图所示:

9、选择刚创建好的目录,如下图所示:

10、导入后的效果如下图所示:

 

小提示

Icon

注意,如果使用命令创建插件之后,ProjectA目录下的pom.xml文件会变成ANSI编码格式的文件,需要用记事本打开,另存为UTF-8编码格式的文件。

 

 

1、修改pom.xml文件,由于批生成时有两个参数没有传入,所以这里稍做修改。

提示

Icon

以下配置,在进阶开发中可能用到,入门开发保持不变即可。

pom.xml maven-bundle-plugin

生成脚本

1、查看 \Word2Sql\bin\readme.txt 配置好Word2Ssql工具。

2、执行Word2Sql\test\test.bat 文件生成SQL脚本到目录 \Word2Sql\test\sql 中,如下图所示:

执行test.bat结果  Expand source

3、将生成的脚本复制到 \dev\plugins\ProjectA\leave\src\main\resources\META-INF\sql\install 目录下

修改脚本

1、修改 \dev\plugins\ProjectA\leave\src\main\resources\META-INF\sql\install\dev.sql 中的菜单项,主要是针应用程序的名称,将JXOSGICLOUND替换为LEAVE即可,如下

dev.sql  Expand source

2、修改install.sql,将APP.SQL 修改为LEAVE.SQL,当然你可以直接将LEAVE.SQL文件名修改为APP.SQL,效果一样。

install.sql



表结构设计

注意

Icon

由于本设计最初是针对Oracle数据库,没有考虑到MySQL中,表名LEAVE为MySQL的关键字,所以在MySQL数据库中需要稍作调整,详细在插件市场中下载此插件查看关键字的处理方法。(MySQL补丁

我们的建议:

1、命名时,尽量考虑多种数据库关键字,不要使用关键字。

2、如果使用了关键字,本系统也支持,只是需要稍做调整。

表名

Leave

请假主表Leave

字段名

类型

列标题

说明

LeaveId

Integer(12)

请假标识

唯一标识,系统自动生成,不要改。

LeaveNum

UPPER(12) not null

请假单号

自动编号

Description

ALN(512)

描述

描述

DepartmentId

UPPER(64)

请假部门

=PUB_DEPARTMENT.department_id

UserId

Upper(32)

请假人

=PUB_USER.USER_ID

LeaveDays

Number(10,2)

合计天数

默认值:0

ACTUALDAYS

Number(10,2)

实际天数

默认值:0

NEEDHRDEPT

YORN

人力审核?

默认值:0

Memo

ALN(200)

备注

 

WFT_TRANSACTOR_ID

UPPER(512)

当前处理人ID

存放PUB_USER.USER_ID

WFT_TRANSACTOR

ALN(512)

当前处理人

存放PUB_USER.NAME

WFT_INSTANCEID

ALN(100)

工作流实例ID

 

WFT_STATUS

UPPER(30)

状态

值列表:LEAVESTATUS

WFT_STATUSDATE

DATETIME

状态时间

 

CHANGEBY

UPPER(32)

更改人

=PUB_USER.USER_ID

CHANGEDATE

DateTime

更改时间

默认值:sysdate,只读显示

SITEID

UPPER(8)

地点标识符

= SITE.SITEID

ORGID

UPPER(8)

组织机构

= ORGANIZATION.ORGID

表名

LeaveLine

请假管理子表

字段名

类型

列标题

说明

LeaveLineId

Integer(12)

标识

唯一标识,系统自动生成,不要改。

LeaveNUM

UPPER(12) not null

请假标识

=Leave.LeaveNum

LeaveType

UPPER(12)

假别

值列表=LeaveType

BeginDate

DateTIME

开始日期

默认为Sysdate

EndDate

DateTIME

结束日期

 

Memo

ALN(200)

备注

 

CHANGEBY

UPPER(32)

更改人

=PUB_USER.USER_ID

CHANGEDATE

DateTime

更改时间

默认值:sysdate,只读显示

SITEID

UPPER(8)

地点标识符

= SITE. SITEID

ORGID

UPPER(8)

组织机构

= ORGANIZATION. ORGID

 

 

摘要

Icon

所有页面是采用Freemarker语法写的。

页面中的标签语法请参见:Tag

 

 

摘要

Icon

这个页面就是显示查询结果集的页面,即列表页面。

原页面生成了框架,只需要修改内容即可。

list-table.ftl

提示

Icon

第5行:通过部门ID,显示部门名称,请假表与部门表做了一个关联关系,可通过联系名直接获得部门的名称,不需要写复杂的SQL语句去获得。

第6行:同上。

摘要

Icon

本页面是新增、编辑的页面。

原页面生成了框架,只需要修改内容即可。

main.ftl

摘要

Icon

本页面是配置高级查询条件的页面。

原页面生成了框架,只需要修改内容即可。

list-search.ftl

注意,需要修改相应的国际化文件

bundle.properties  Expand source
bundle_zh_CN.properties  Expand source

摘要

Icon

完成前面的步骤之后,单表的增、删、查、改就算完成了,我们先测试一下,再接着做子表的增、删、查、改。

打包

Icon

可以使用mavedoit.bat来打包,也可以直接使用Eclipse进行Maven打包,此处我们演示使用Mavendoit.bat来打包。

1、执行mavendoit.bat,选择3

2、输入插件名 leave 如下图

3、我们可以看到打包成功之后,会将插件自动复制到jxweb的目录中,前提是jxweb要与本处的开发目录在相同的盘符对应的路径下面。(我们建议jxweb的目录放到D:\deploy\目录下。)

如果打包时下载依赖出问题,可以试试强制更新

启动测试

Icon

1、如果Tomcat没有启动,则启动之后,到插件控制台就可以看到此插件了,如果Tomcat已启动,则在插件控制台选择此文件再上传一次,也可以看到此插件。

2、点“配置”链接,我们将创建数据库表。

3、点击“初始化数据库”按钮,等待执行完毕

4、这时,刷新整个页面,就可以看到我们的请假菜单了,如下

5、这时,我们就可以测试、新增、编辑、删除功能了。(如果测试有问题,重启一下Tomcat试试)

 

如果你的版本支持移动,你可以用手机访问试一下,也支持哦。

总结

1、我们创建了一个插件,支持即插即用。

2、从设计到数据库建模,自动完成。

3、实现了一个单表的增、删、查、改,只进行了界面配置,没有写任何JAVA代码、JS代码 、CSS代码。

4、只做了一套页面,具备桌面和手机端自适应功能。

摘要

Icon

前面我们实现了单表的增删查改操作,本文我们介绍主从表的增、删、查、改。

1、撰写JAVA业务逻辑

说明

Icon

此类是处理Leave表所有记录操作的类,原型自动生成的,不需要修改。

LeaveSet.java

说明

Icon

此类是处理Leave表中的单条记录的相关信息,原型自动生成不需要修改

Leave.java

说明

Icon

此类是处理 LeaveLine 子表的所有记录的类,需要新增,内容如下。

LeaveLineSet.java

说明

Icon

此类是处理LeaveLine表单条记录的相关信息。

LeaveLine.java
2、撰写页面视图

说明

Icon

添加一个文件leave-line-table.ftl 处理LeaveLine表的增、删、查、改操作。

leave-line-table.ftl

说明

Icon

修改main.ftl 添加子表的内容,在28行之后插入以下内容

main.ftl
3、注册业务逻辑类

说明

Icon

我们写了Java类之后,需要进行注册,才能有效使用。修改dev.sql 添加如下内容,为了测试方便,建议您不仅需要修改SQL文件,还将这两句直接在数据库中执行注册。

 

另:看一下第3步,需要将JboSet导出成为服务类,在pom.xml中,补充 <Export-Service></Export-Service>

修改dev.sql
4、打包测试

提示

Icon

如果您没有重启Tomcat,则您需要转到插件控制台,重启一下本插件即可生效。

完善功能

说明

Icon

修改Leave.java 添加自动计算请假天数的方法

Leave.java

说明

Icon

在Leave.java中添加方法,当新增时,自动设置请假人为当前登录用户。

Leave.java
Icon

重新打包,测试即可看到新增的功能效果。