课程内容
利用NC-UAP提供的几个插件包,放入Eclipse(本次课件内容以Eclipse3.2版本为准)的plugins中,搭建NC-UAP的开发环境。在上一章节中,演示了怎么搭建NC产品的应用环境,但作为开发人员,日常的工作都是在Eclipse开发环境中进行。在Eclipse中如何建立开发环境,请看本章详细介绍。
实例讲解
加入NC开发所需的MDE插件
在Eclipse插件中加入NC开发所需的MDE插件如下插件:
- nc.uap.mde.editor_1.0.1.jar
- nc.uap.mde_1.0.2.jar
- nc.uap.mde.wstools_1.0.3.jar
- nc.uap.mde_1.0.12.11.jar
- NCMDP_1.0.8.6b.jar
- NCPlugin_1.0.5.3a.jar
以上插件可以在教程附带的“配套示例\插件包”目录中找到,拷贝到eclipse安装路径下的plugins目录下即可。
Eclipse中JRE设置
占击Eclipse的菜单Preferences进行 Installed JREs的设置。如下图所示
在上图中点“Add”按钮如下图所示:
点击Browser选择安装NCHome目录下找到ufjdk目录并确定后的结果如下图志示:
在上图中再点击“Add External JARs”按钮分别加载NCHome下的ufjdk\lib\tolls.jar和 ufjdk\jre\lib\ plugin.jar后如下图所示:
点击“OK”按钮完成JRE设置。
取得NC Home、数据源设置和模块的选择
NC Home包含了开发环境所需的所有jar包, NC Home就是安装完NC产品的主目录。具本操作如如下:点击Eclipse的Preferences,弹出如下图,选中MDE Development页签,在其可设置NC Home,同时还可以设置数据源和模块的选择。
- 第一步:取得NC Home及数据源设置,如下图所示:
说明:
ü NC Home 通过点击Browse...按钮选择您本机所安装NC产品所在的NC Home目录。
ü DriverList 通过下拉框选择数据源,默认design。
ü Database Type 选择你所使用数据库类型,一般选用ORACLE 或 SQL Server的最高版本。
ü Driver Type 通常选择JDBC,也建议选JDBC。
ü HostName 输入所使用数据库安装机器的IP地址(如装在本机则为127.0.0.1)。
ü ConnectPort 一般在选择在数据类型后,系统会自动带出数据的默认连接端口(除非数据库连接端口修改过,建议不要手工修改他)。
ü DB/ODBCName 对SQL Server来说就是数据库实例名,对于Oracle数据库来说就是SID。
ü OIDMark 是一个由数字或字母 (0-9、A-Z)组成两位NC系统生成数据ID标识区别符。
ü UserName 数据库用户句
ü Password 数据库口令
- 第二步:开发环境所用到的模块的选择,如下图所示:
说明:
ü 此处比较关键,在此选择大家在开发时所用到的哪些模块,通常UAP模块是必需选择的,其他产品的模块需要大家结合项目情况进行判断是否选择。
- 第三步:Client Connection设置,如下图所示:
Eclipse中Error/Warnings设置
由于我们开发过程中,特别是在开发环境中引用原有产品的某个模块private下的某个类时,经常提示错误,所以建议将此页签中的Forbidden Reference (Access rules)设置成Warning。如下图所示
新建NC Module Project
打开Eclipse,点击菜单“新建/项目”,弹出下面的对话框:
选择MDE Development下的Moudle Project项后,点击下一步,开始创建Moudle Project,在下面的对话框中填入项目信息和所要创建的Moudle Name如下图所示:
点击完成后,会创建项目,形成下图所示的目录结构:
至此,开发环境已建立完毕。
在Eclipse中创建中间件、客户端两个调试程序
在开发环境中调试程序,一般需要首先启动NC中间件,然后启动客户端调试器。下面我们介如何创建两个调试程序。
中间件调试程序创建如下图所示,在所建项目NC_DEMO图标上点击右键在弹出的快捷菜单上选择Debug As->NC Middleware就创建了一个NC_DEMO_Server的中间件调试程序。MDE插件会为它设置默认参数,建议一般情况下不需要去修改他。
客户端调试程序创类似下图所示,在所建项目NC_DEMO图标上点击右键在弹出的快捷菜单上选择Debug As->NC Client就创建了一个NC_DEMO_JStarter的客户端调试程序。MDE插件会为它设置默认参数,建议一般情况下不需要去修改他。
在Eclipse中运行参数设置
在运行中间件中配置如下参数解决内存不足的问题:
-Xms512M -Xmx1024M -XX:PermSize=128M -XX:MaxPermSize=512M
实例如下图所示:
当本机内存有限时,为了在运行过程中不会溢出,也可以在Debug的VM Arguments 里添加-Xms512M -Xmx1024M -XX:PermSize=128M -XX:MaxPermSize=512M 如下图所示
注意:
在设立这两个调试点之后,要注意两个问题。
1、你的项目所使用的JRE的安全策略必须是:
grant {
permission java.security.AllPermission;
};
这可以通过修改 {$JRE根目录}/jre/lib/security下的java.policy文件来实现,否则在启动中间件时会出现java.security.AccessControlException;
2、要成功运行UAP客户端调试器(JStarter),必须将jre/lib下的plugin.jar,Tools.jar也加入到项目默认的JRE的classpath中(详见:2.2.2节描述)
此时即可先启动NC Middleware,之后运行NC Client,就可以得到如下图所示的界面了:
至此,NC-UAP的开发环境完全建立起来了!