如何參與Hibernate-ORM項目

1.註冊 hibernate jira帳戶，hibernate中的issue和bug都會在此論壇發佈

註冊地址：https://hibernate.onjira.com

2.建立Hibernate-ORM分支，前提必需要註冊一個github帳戶。

基於hibernate-orm在github上的官方主版本，建立一個fork到本身repo中。

3.安裝 git客戶端

推薦git-preview和tortoisegit配合使用。

git-preview的下載地址:http://msysgit.github.io/

tortoisegit的下載地址：https://download.tortoisegit.org/tgit/

詳細安裝配置教程見：http://blog.csdn.net/xiaobin_hlj80/article/details/10953701

4.利用git客戶端，從本身的github代碼倉庫中把代碼取到本地，命令以下

git clone https://github.com/zhulongchao/hibernate-orm.git

5.編譯hibernate-orm

hibernate-orm的默認編譯工具是gradlew，該工具和maven相似。

進入hibernate-orm目錄下，gradlew clean build命令，進行初始化編譯。

若是遇到以下問題：

     (1): core\src\main\org\hibernate\annotations\SQLDelete.java:37:錯誤:編碼GBK的不可映射字符

            須要進控制面板，修改區域語言裏面-管理-更改系統區域設置爲英語（英國）

     (2) java.lang.OutOfMemoryError: Java heap space

           修改gradlew.bat文件，調整堆最大的分配內存大小。若是是32位的jdk，需調整到64位jdk(最新依賴的jdk是1.8)

         @rem Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
          set DEFAULT_JVM_OPTS="-Xmx3072m"

6.轉爲eclipse工程

執行命令：gradlew eclipse，生成project和classpath文件

7.導入hibernate-orm到eclipse中

注意:若是hibernate-orm目錄下有project文件，須要刪除後，再導入。

8.導入後以下，項目出現不少錯誤

錯誤1：A cycle was detected in the build path of project 'hibernate-c3p0'.The cycle consists of projects {hibernate-testing, hibernate-core, hibernate-c3p0, hibernate-ehcache, hibernate-enhance-maven-plugin, hibernate-entitymanager, hibernate-envers, hibernate-gradle-plugin, hibernate-hikaricp, hibernate-infinispan, hibernate-jpamodelgen, hibernate-osgi, hibernate-proxool}hibernate-c3p0 Build pathBuild Path Problem。

解決辦法：Window -> Preferences-> Java -> Compiler -> Building -> Building path problems -> Circular dependencies -> 將Error改爲Warning。

錯誤2：是某些依賴類，沒有加入到build path

解決辦法：把依賴類所在的class文件夾，加入到build path

錯誤3:某些動態生成的java文件，所在目錄有誤，好比target目錄，

解決辦法:把該目錄不做爲source code目錄

9.提交和更新

提交針對jira上的修改時，commit的message內容必需要爲jira上的issue key。

在提交以前，最好獲取一下hibernate-orm官方git中的最新代碼，獲取的方式以rebase，而不是merge，merge容易打亂分支圖。

 

提交代碼，命令以下  git push zhulongchao HHH-123，一旦提交後，hibernate-orm官方的維護人員會看到你提交的代碼，決定是否是要把你的提交拉倒主版本里面。

 

 

總結：通過以上配置後，盡情happy吧。