標準環境
請按照如下軟件版本搭建開發環境,開發環境中的版本可以高於但不得低於標準環境要求。較低版本也可以使用,但未做全面測試。
名稱 | 版本 | 說明 |
---|---|---|
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