CCAY-Freamwork 2.0 开发环境搭建

标准环境

请按照如下软件版本搭建开发环境，开发环境中的版本可以高于但不得低于标准环境要求。较低版本也可以使用，但未做全面测试。

名称	版本	说明
JDK	Oracel jdk1.7.0_80
apache-maven	3.5.0
Eclipse	Neon.3 Release (4.6.3)

创建项目

在开始创建项目前，您应该对您的项目有个初步规划，至少您先得有个名字作为您的项目名称（下文采用testccay作为项目名称），您可以使用命令行或Eclisp快速创建项目：

项目名称最为项目的最基本信息在后期创建的包目录，SQL脚本，XML配置文件都依赖此名称，选定后较难改变，请谨慎决定。

使用Eclipse创建项目

1. 打开Eclipse，使用Ctrl+N打开“新建”对话框，选择“Maven Project”–>Next;

2. 取消选中（默认未选中）Create a simple project,依据您的实际调整其他选项后–>Next;

3. 在“Select an Archetype”向导页，单击“Configure…”（在Catalog下拉框后面）打开“Preferences”对话框，单击“Add Remote Catalog…”

4. Catalog File中录入http://139.129.135.19:10001/nexus/content/repositories/snapshots/ Description 中录入ccay catalog–>OK

5. 回到“Select an Archetype”向导页，在Catalog下拉框中选择 ccay catalog，在列表中选中Artifact Id为“ccay-archetype”的记录。（如果记录不存在，请选中列表下发的Include snapshot archetypes） –>Next;

6. 依据项目实际填写Group Id（此值代表您的组织，如：org.my）及Artifact Id(此值表示您目前创建的项目，如：testccay)–Finish;

使用命令行创建项目

下载http://139.129.135.19:10001/nexus/content/repositories/snapshots/archetype-catalog.xml放入到\~/.m2/archetype-catalog.xml(\~代表当前用户目录)

创建一个新文件夹来保存您的项目（如：myProject）,并将当前目录切换至myProject；

执行命令mvn archetype:generate -DgroupId=org.my -DartifactId=testccay -DarchetypeGroupId=org.ccay -DarchetypeArtifactId=ccay-archetype -DarchetypeVersion=2.0.1-SNAPSHOT -DinteractiveMode=false -DarchetypeCatalog=local

其中-DgroupId参数代表您的组织如：org.my，-DartifactId参数代表您创建的项目名如：testccay -DarchetypeVersion代表ccay骨架工程版本

初始化数据库

如果您使用的是Eclipse,请在web项目（testccay-web）上单击右键，选择Run as–>Maven build…在打开窗口的Goals中录入ccay:exportsql–Run;

或者，您可以在命令行，将当前目录转至testccay-web，运行命令：mvn ccay:exportsql

执行成功后会在target\classes\dbscript生成sql脚本，请在数据库中执行脚本

脚本的生成过程中依赖了您的项目名称（testccay-web\src\main\resources\app_xxx.properties#application.appName值），如果项目名称有改变，需要重新生成脚本，并重新初始化您的数据库

# 修改数据库连接属性

依据项目实际及环境修改app_xxx.properties中的datasource.jdbcDriverClass，datasource.url，datasource.user，datasource.password

依据骨架工程创建的项目中包含了JNDI及非JNDI,Mysql,Oracel的配置，您可以根据实际需求打开或关闭相关注解，以支持不同情况

# 启动项目

使用Eclipse启动项目

1. 在web项目（testccay-web）上单击右键，选择Debug as–>Maven build…在打开窗口的Main选项卡的Goals中录入jetty:run(或tomcat7:run)；

2. 在JRE选项卡的VM arguments:中录入-javaagent:C:\Users\chaowangbang.m2\repository\org\ccay\ccay-override\2.0.1-SNAPSHOT\ccay-override-2.0.1-SNAPSHOT.jar

javaagent后面的路径是您Maven本地仓库中ccay-override-{ccayversion}.jar的路径，请自行调整

3. 单击Debug启动项目

使用命令行启动项目

待补充，想办法在执行启动命令时指定虚拟机参数-javaagent

在(切仅仅)开发环境下，项目中引入了Java Instrumentation特性，以支持动态修改class字节码，（目前主要用于扩展Mybatis及CXF）,所以在启动时需要加入VM参数-javaagent。在打生产包时，会自动完成class的文件替换

项目启动后，您可以在浏览器中输入http://localhost:8080/testccay可访问，默认系统管理员用户名admin密码123