服務端輕量級開發框架：lightning4j

簡介

一個基于Netty網絡庫的java服務端輕量級開發框架，用于快速開發手游，頁游等服務端程序，使用WebSocket通信協議，支持mysql，redis，連接池，全局定時任務，心跳檢測，可配置邏輯處理線程等，使用簡單，部署方便。

項目網站：http://www.53hql.com/lightning4j
項目WiKi：http://www.53hql.com/lightning4j/wiki

使用（基于IntelliJ IDEA）

新建一個maven project或在已有project中新建一個maven module，編輯pom.xml中的依賴包：

<dependencies>
    <dependency>
        <groupId>netty</groupId>
        <artifactId>netty</artifactId>
        <version>4.0.25.Final</version>
    </dependency>
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>5.1.30</version>
    </dependency>
    <dependency>
        <groupId>redis.clients</groupId>
        <artifactId>jedis</artifactId>
        <version>2.4.0</version>
    </dependency>
    <dependency>
        <groupId>c3p0</groupId>
        <artifactId>c3p0</artifactId>
        <version>0.9.1.2</version>
    </dependency>
    <dependency>
        <groupId>org.slf4j</groupId>
        <artifactId>slf4j-log4j12</artifactId>
        <version>1.7.6</version>
    </dependency>
    <dependency>
        <groupId>log4j</groupId>
        <artifactId>log4j</artifactId>
        <version>1.2.17</version>
    </dependency>
    <dependency>
        <groupId>dom4j</groupId>
        <artifactId>dom4j</artifactId>
        <version>1.6.1</version>
    </dependency>
    <dependency>
        <groupId>org.mybatis</groupId>
        <artifactId>mybatis</artifactId>
        <version>3.2.3</version>
    </dependency>
    <dependency>
        <groupId>junit</groupId>
        <artifactId>junit</artifactId>
        <version>4.11</version>
        <scope>test</scope>
    </dependency>
    <dependency>
        <groupId>com.alibaba</groupId>
        <artifactId>fastjson</artifactId>
        <version>1.1.41</version>
    </dependency>
    <dependency>
        <groupId>com.hql</groupId>
        <artifactId>lightning4j</artifactId>
        <version>1.0.0</version>
    </dependency>
</dependencies>

• lib目錄下為框架的jar包，用于添加到maven倉庫
• 建議使用maven私服管理依賴包
• confFile下為項目所需的配置文件、模塊文件及log存放目錄
• 示例代碼請參考test目錄
• client.html為測試客戶端

基本用法

• 在IDEA的project目錄下新建一個文件夾例如：conf存放配置文件及log，將源碼目錄下confFile里的內容拷貝到該文件夾中。
• 修改配置選項為開發者自己的配置
• 在初始化代碼中設置配置文件根路徑：ServerInit.getInstance().initConfPath("conf");
• 簡歷游戲模塊工程（new maven module in IntelliJ IDEA）參考項目結構：
  ......包
  |--handler（業務邏輯handler）
  |--model（MyBatis使用的數據dao）
  |--manager(緩存數據管理)
  |--vo（用于映射json的對象）
  
• 使用maven打包該module為jar文件
• 拷貝至confFile里的module目錄

• 配置moduleConf.xml

  <?xml version="1.0" encoding="UTF-8"?>
  <handlers>
    <!--模塊名和模塊jar文件名對應-->
    <test>
      <test><!--handler注冊名-->
        com.hql.test.handler.HandlerTest<!--類名-->
      </test>
      <onDisconnect>
        com.hql.test.handler.DisconnectHandlerTest
      </onDisconnect>
      ......
    </test>
    ......
  </handlers>

• 啟動代碼示例：

  public class Server {
      public void run() throws Exception {
          ServerInit.getInstance().initConfPath("conf");
          ServerInit.getInstance().initLog4j();
          ServerInit.getInstance().initGameWorkers();
          ServerInit.getInstance().initModules();
  
          GameBoss.getInstance().boot(new GameUpProcessor() {
              @Override
              public void process(GameUpBuffer buffer) {
                  GameWorkerManager.getInstance().pushDataToWorker(buffer);
              }
          });
      }
  
      public static void main(String[] args) throws Exception {
          new Server().run();
      }
  }

• 熱更新示例

  ModuleUtil.getInstance().updateModule("test2");//更新test2模塊

項目主頁：http://www.baiduhome.net/lib/view/home/1423830845357