JEESITE快速開發平臺（三）項目文件結構與配置文件詳解
1. 文件結構
1.0. 源碼目錄
src/main/Java
|
com.thinkgem.jeesite |
Jeesite平臺目錄 |
|
├ common |
公共模塊存放目錄 |
|
│ ├ beanvalidator |
實體Bean驗證相關類 |
|
│ ├ log |
日誌工具相關類 |
|
│ ├ mapper |
各種Object到Xml、Object到Json的映射轉換類 |
|
│ ├ persistence |
持久層相關類 |
|
│ ├ security |
安全相關類 |
|
│ ├ service |
業務層相關類 |
|
│ ├ servlet |
公共servlet相關類 |
|
│ ├ utils |
各種操作小工具類 |
|
│ └ web |
模型控制器層相關類 |
|
└ modules |
JeeSite內置功能模塊存放目錄 |
|
├ act |
Activiti工作流引擎目錄 |
|
├ cms |
內容管理、新聞發布模塊目錄 |
|
├ gen |
Web版本代碼生成器目錄 |
|
├ oa |
在線辦公模塊演示用例存放目錄 |
|
└ sys |
系統核心模塊存放目錄 |
|
├ dao |
數據訪問層相關類 |
|
├ entity |
實體相關類 |
|
├ interceptor |
系統模塊攔截器相關類 |
|
├ service |
業務處相關類 |
|
├ web |
模型控制器層相關類 |
|
└ utils |
系統模塊的工具類 |
1.1. 資源目錄
src/main/resource
|
act |
Activiti工作流引擎相關文件（部署文件、bpmn） |
|
cache |
Ehcache緩存配置存放目錄 |
|
mappings |
Mybatis Sql映射文件存放目錄 |
|
jeesite.properties |
系統配置屬性文件 |
|
spring-*.xml |
Spring相關文件 |
|
log4j.properties |
Log4j日誌配置屬性文件 |
1.2. 發布目錄
src/main/webapp
|
static |
靜態文件存放目錄（JS、CSS、前端插件類庫等） |
|
└ compressor.bat |
JavaScrpt和CSS文件壓縮腳本 |
|
userfiles |
用戶上傳文件目錄 |
|
WEB-INF |
WEB應用安全目錄，通過映射訪問相關文件。 |
|
├ lib |
依賴jar包目錄 |
|
├ tags |
Tags標簽存放目錄 |
|
├ views |
視圖文件目錄 |
|
│ ├ reportlets |
帆軟報表文件存放路徑 |
|
│ ├ resources |
帆軟報表配置文件存放目錄 |
|
│ ├ error |
系統異常映射相關頁面 |
|
│ ├ include |
視圖相關包含文件 |
|
│ ├ layouts |
視圖布局相關文件 |
|
│ └ modules |
內置核心功能模塊視圖相關文件 |
|
│ ├ act |
Activiti模塊視圖相關文件 |
|
│ ├ cms |
內容管理模塊視圖相關文件 |
|
│ ├ gen |
代碼生成模塊視圖相關文件 |
|
│ ├ oa |
在線辦公模塊視圖相關文件 |
|
│ └ sys |
系統管理模塊視圖相關文件 |
|
├ ckfinder.xml |
CKfinder配置文件 |
|
├ decorators.xml |
Decorator配置文件 |
|
└ web.xml |
Web配置文件 |
1.3. 執行目錄
db
|
db |
數據庫相關腳本、模型及執行文件 |
|
├ act |
各模塊數據初始化， Oracle建表腳本，數據初始數據腳本文件。 |
|
├ cms |
|
|
├ gen |
|
|
├ oa |
|
|
├ sys |
|
|
└ init-db.bat |
初始化數據庫執行腳本（需要Maven支持） |
bin
|
clean.bat |
清理項目生成的文件腳本 |
|
eclipase.bat |
生成eclipse項目執行腳本 |
|
package.bat |
生成編譯項目文件（war包） |
|
run-jetty.bat |
Jetty服務器運行腳本 |
|
run-tomcat6.bat |
Tomcat6服務器運行腳本 |
|
run-tomcat7.bat |
Tomcat7服務器運行腳本 |
2.jeesite.properties配置文件
1.1. 數據源配置
# 數據庫驅動，連接設置。
jdbc.driver=oracle.jdbc.driver.OracleDriver
jdbc.url=jdbc:oracle:thin:@127.0.0.1:1521:orcl
jdbc.username=jeesite
jdbc.password=123456
# 連接池設置，初始大小，最小，最大連接數。
jdbc.pool.init=1
jdbc.pool.minIdle=3
jdbc.pool.maxActive=20
# 測試連接sql語句
jdbc.testSql=SELECT ‘x‘ FROM DUAL
1.2. 系統配置
# 配置產品名稱，版權日期和版本號
productName=JeeSite Admin
copyrightYear=2014
version=V1.1.1
# 是否是演示模式，如果是，則如下模塊，無法進行保存操作
# sys: area/office/user/role/menu/dict, cms: site/category
demoMode=false
# 管理端跟路徑
adminPath=/a
# 前端跟路徑
frontPath=/f
# 信息發布時的URL後綴，可配置HTML後綴的頁面進行緩存
urlSuffix=.html
# 分頁大小，默認每頁15條
page.pageSize=15
# 碩正組件是否使用Cache（一般開發階段，關閉Cache）
supcan.useCache=false
# 設置通知間隔訪問時間，單位毫秒.
oa.notify.remind.interval=60000
1.3. 框架參數配置
# 設置SESSION超時時間，web.xml裏設置無效，單位毫秒.
session.sessionTimeout=120000
session.sessionTimeoutClean=120000
# 緩存設置
ehcache.configFile=cache/ehcache-local.xml
#ehcache.configFile=cache/ehcache-rmi.xml
# 首頁地址
web.view.index=/a
# 視圖文件配置，前綴和後綴
web.view.prefix=/WEB-INF/views/
web.view.suffix=.jsp
# 最大上傳字節數 10M=10*1024*1024(B)=10485760
web.maxUploadSize=10485760
# 設置日誌攔截器，攔擊的URI，@RequestMapping值
web.logInterceptExcludeUri=/, /login, /sys/menu/tree, /sys/menu/treeData, /oa/oaNotify/self/count
web.logInterceptIncludeRequestMapping=save, delete, import, updateSort
# 工作流配置
activiti.isSynActivitiIndetity=false
activiti.export.diagram.path=c:/activiti_diagram
#activiti font (windows font: \u5B8B\u4F53 linux font: simsun)
activiti.diagram.activityFontName=\u5B8B\u4F53
activiti.diagram.labelFontName=\u5B8B\u4F53
activiti.form.server.url=http://127.0.0.1:8075/xxxx
3. pom.xml
3.1. 修改項目名稱
artifactId：項目名稱 version：版本
修改完成後運行eclipse.bat重新生成項目文件。
3.2. 添加jar依賴包
可通過公司maven私服查詢相應jar依賴包。
私服地址：http://192.168.11.36:8888/nexus/
如果公司私服上沒有相應的依賴jar
1） 可聯系王震添加依賴jar，
2） 將jar文件拷貝項目WEB-INF下的lib目錄，並配置pom，例如：
<dependency>
<groupId>com.test</groupId>
<artifactId>test-core</artifactId>
<version>1.0</version>
<scope>system</scope>
<systemPath>
${project.basedir}/src/main/webapp/WEB-INF/lib/test-core-1.0.jar
</systemPath>
</dependency>
3.3. 刪除init-db插件
項目初始化完成後，一定要刪除或重命名pom裏面的init-db插件，防止項目進行中誤操作運行了init-db.bat文件，數據庫被清空。
4. 數據庫設計
模型文件：/ jeesite/db/test/jeesite.erm
業務數據表必須包含以下公共字段：
5. 重要規範
1. 類註釋：必須包含類功能描述，作者，時間
2. 方法註釋：除非常容易理解的方法如get、form、save、delete等方法外的方法必須加註釋來說明用途，傳遞參數。
3. 按照以上命名結構進行文件分配存放。
4. 視圖文件名要加模塊或功能前綴，例如actTaskTodoList.jsp，代表：工作流任務待辦列表,不要寫成list.jsp或todoList.jsp或taskTodoList.jsp。
5. Sql與定義分離：不在萬不得已的情況下不要寫在java文件裏，分離
JEESITE快速開發平臺（三）項目文件結構與配置文件詳解