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文件里,分離