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

摘要

Icon

本文描述获得JxADF企业级快速开发平台的安装步骤。

1、环境准备

1、从 http://osgia.com官网中下载稳定版或从Github中(deploy目录)获得较新的版本。

2、安装好数据库(略)

3、安装好JDK(略)

4、安装好中间件(略)

说明备注
中间件

Tomcat 7、8

Jetty

Weblogic

JBoss

Websphere

 

 

JDKJDK1.7及以上 
数据库

Oracle10g及以上

MySQL

MS SQL Server

 

选项程序源码
基础平台免费免费:下载地址
Oracle DB支持免费免费
MySQL支持免费免费
MS SQL Server免费免费
健新工作流可在插件市场购买收费
Oracle BPM 工作流支持免费收费
手机自适应免费免费
Oracle Service Bus支持收费收费
用户、角色、权限管理免费版、收费版都有免费版、收费版都有
插件控制台免费收费
其它
技术支持在线支持免费现场支持收费
其它插件参考插件市场收费

说明

Icon

1、插件市场中并没有列出所有的插件,如有需要可咨询我们,QQ群:429895245,邮件:jxadf@osgi.help 电话:400-8800-881

2、健新科技使用本开发平台开发的成套产品(有部份定制系统未列出,如有需求可咨询)包括:

产品名称简要说明
巡检系统主要用于电力行业的巡检、点检管理,包括路线规划、巡检、报缺等,手机端有独立的程序。
综合系统类似办公系统、项目管理系统,如:请假管理、误餐补贴、合同管理、项目立项、项目变更等。
生产管理主要应用于电力行业生产管理系统
基建管理主要应用于电力、物业等行业的基建管理系统。
贷后管理主要应用于金融行业。
临时接地线管理主要应用于电力行业
报销管理包括:请款、差旅报销、业务报销、日常报销、福利报销、个人结算等。


提示

Icon

为了获得更加详细的报价,请与健新科技联系,谢谢。

QQ群:429895245

邮件:jxadf@osgi.help

电话:400-8800-881

13926159309

2、中间件配置

安装包:将下载之后的jxweb.zip解压到您的安装目录,例:D:\deploy\jxweb\

1、在Tomcat\conf\Catalina\localhost\目录中创建一个jxweb.xml,内容如下:

jxweb.xml

2、修改TOMCAT_HOME\bin\catalina.bat,在最前面添加如下内容(注意:第二行的路径要换成你自己的路径):

catalina.bat

如果是Linux内核的系统,请修改TOMCAT_HOME\bin\catalina.sh,在最前面添加如下内容(注意:第二行的路径要换成你自己的路径):

ubuntu中的示例修改 catalina.sh

3、server.xml中需要修改编码为UTF-8,端口可自定义

TOMCAT_HOME/conf/server.xml

4、启动Tomcat


1、下载 jetty 最新稳定版 http://www.eclipse.org/jetty/

2、在Jetty-home的 bin 目录中创建一个jetty.bat文件,内容如下:

jetty.bat

3、双击 jetty.bat启动即可访问:http://127.0.0.1/jxweb

 

 

1、创建 jxadf_domain 域(略)。

2、修改 jxadf_domain\bin\setDomainEnv.cmd,在前面添加如下内容:

     (注意,你的JAVA_HOME最好配置1.7及以上的版本)

setDomainEnv.cmd

3、启动Weblogic,发布应用即可。(略)

JVM参数说明

Icon
参数说明
-Xms
建议与-Xmx 设置为一样大小
-Xmx
32位JDK,一般不要超过1024M
-Xss
对于非Oracle数据库,建议设为2~4M,否则可能安装失败。
3.数据库配置

1、访问http://127.0.0.1/jxweb/ 系统会自动跳转到数据库初始化的安装界面,如下图所示:

 

在初始化之前,需要注意数据库字符集

Icon

查询字符集
查询字符集结果
查询字符集

2、点“初始化数据库”到下一步

3、点击“创建用户”到下一步(这里填写Oracle管理员的帐号密码,为创建本系统的帐号密码做准备,当然如果你已创建本系统的帐号、密码,则可略过此步)

4、填写要为本系统创建的帐号、密码、表空间信息等。

5、点“初始化数据库”等待执行完毕,执行过程中会有一些错误信息输出,可不用管。

6、执行完毕之后,重启Tomcat

4. 测试

1、输入 http://127.0.0.1/jxweb/ 即可出现登录界面,注意,有的中间件(如:Tomcat8)不能少了最后一个斜杠。

2、默认的初始帐号: admin 密码:123456

附:插件安装说明

1、免费插件可在健新科技插件集市中下载,也可直接在插件控制台下载安装。

2、下载的插件安装方法:登录系统,转到“系统与资源”-“控制台”,上传您下载的插件。

3、安装完毕插件之后,如果有“配置”菜单,则点“配置”,然后执行数据库安装,即可安装此应用的数据库脚本。

4、安装完毕之后,管理员默认就有权限了,可以直接访问,刷新整个页面,也可看到安装之后,出来的新菜单。

 

 

摘要

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

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

摘要

Icon

本文描述,如何在Eclipse中部署、调试JXADF基础平台。

如果只是做插件开发,并不需要部署源码,详细参见《JxADF开发入门

建议在开发一个插件(Bundle)之后,再进行源码部署,这样学习源码会快一点。

前提条件

Icon

1、必须安装好了运行环境,即按《JxADF安装向导》完成了部署,且能正常登录。

2、必须从github中下载了本项目的源码。

3、如有需要,可加QQ群(429895245【已满】、371832126)获得免费技术支持。

目录结构说明
目录说明
deploy部署的目录
development开发插件的目录
doc文档目录
Source源码目录

摘要

Icon

本文演示,直接使用maven编译、打包,不需要Eclipse。

pom.xml 说明

红色框中,指定部署路径,为了多人开发,不要频繁修改pom.xml,建议路径,不要加盘符,这样直接会打包部署到当前源码的根目录下的deploy目录中。

果你修改了这个路径,也一定要修改mvndoit.bat中的路径。

 

编译打包

1、直接双击 mvndoti.bat

2、选择1. 编译JxPlatform


3、根据你的需要,选择对应的选项,即可完成编译打包。

注意:选项E,将对JS、CSS进行压缩,这是最终发布时的选择,调试模式,建议选A即可。

4、检查对应部署目录中是否存在打包之后的文件。


 

 

摘要

Icon

将源码以Maven的工程形式导入Eclipse即可。

导入Eclipse

1、选择导入

2、选择一个存在的Maven项目

3、选择你的源码目录

4、导入效果

配置Tomcat

再次提示

Icon

一定要先搭建好运行环境,否则这里配置了,也无法使用,没有数据库。

搭建运行环境,参见《JxADF安装向导

1、选择windows-Preferences

2、配置好你的Tomcat路径

3、为了不用每次都改数据库链接的配置文件,建议您使用JNDI进行数据库连接配置,即在%TOMCAT_HOME%\conf\Catalina\localhost\jxweb.xml文件中配置数据库链接,如下所示(其它数据源配置参见:jxweb.xml for tomcat):

jxweb.xml

4、base.properties中配置使用JNDI,如下图所示:

5、配置调试环境,注意配置协议路径以及你的内存参数,如下图所示:

6、启动Tomcat开始调试

7、启动效果如下图所示,你就可以愉快地进行调试了。

 

注意

不论是你哪种方式打包部署,都不能把原来的运行环境删除(需要直接覆盖原来的运行环境),因为运行环境中包含了对OSGi容器的支持,基础平台则不包含这部份内容。

OSGi容器以及OSGi的基础支持,本身也是插件来的,所以不包含在基础平台中,这部份插件也在运行环境中的\jxweb\WEB-INF\lib\目录中。

JXADF是什么?

Icon

JXADF是一个基于插件化(OSGi)的企业级快速开发平台。

JXADF是免费的么?

Icon

JXADF基础平台是开源的、免费的、

部份插件是免费的,部分插件是收费的,在插件市场中。更多详细参见:JxADF 购买说明

JXADF 是全部开源的么?

Icon

JXADF的基础平台全部开源,在github中,而且是免费的。

所有的插件均没有开源,但源码可以出售。