專案執行環境與配置

專案使用Ant1.9進行打包，依賴JDK1.8來執行。安裝好Ant後，在專案目錄下開啟DOS介面，輸入ant命令後會生成target目錄（或輸入ant zip命令，將會打包專案並生成zip壓縮檔案），進入到target目錄，雙擊run.bat即可執行，在主介面中將會輸出執行日誌。

使用方法與操作步驟

• 配置執行環境引數
  
  • 點選Setup -> Settings，通過Connection設定Dubbo伺服器連線引數，Generation設定API的類讀取過濾
• 新增Dubbo服務的API
  
  1. 點選Setup -> Api Jar Files -> Add
     ，新增需要載入的API的jar包；
  2. 輸入API的jar包的Group Id、Artifact Id、Version（如果有依賴jar包，點選Add依次新增依賴的jar包）；
  3. 點選OK -> Save儲存API的jar包。（注：如果出現異常，一般是缺少依賴的jar包，點選Setup -> Restart後，重複上述操作，新增缺少的依賴jar包即可）。
• 執行Dubbo服務的API
  
  1. 點選Run -> Run As，選擇需要執行的API的方法，點選OK -> Apply儲存執行配置（注：已經存在的配置不需要此步驟）；
  2. 點選Run -> Run Configurations
     ，選擇需要執行的API方法的配置，在配置中輸入引數的值（引數配置見以說明），點選Run即可。
• 執行操作介面例圖

支援API的引數型別

• 基本型別
  
  • byte / java.lang.Byte
  • boolean / java.lang.Boolean
  • char / java.lang.Character
  • short / java.lang.Short
  • int / java.lang.Integer
  • long / java.lang.Long
  • float / java.lang.Float
  • double / java.lang.Double
  • java.lang.String
• 列舉型別
  
  • java.lang.Enum
• 大小數型別
  
  • java.math.BigDecimal
• 日期型別
  
  • java.util.Date
• 集合型別
  
  • java.util.List
  • java.util.Set
  • java.util.Collection
  • java.util.Map
• 自定義型別
  
  • 由以上型別構成的複合型別
• 陣列型別
  
  • 由以上型別構成的陣列型別

隱含引數或屬性配置

• 有參構造器，新增constructor-args結點，如：

    <employee class="com.jwiki.api.entity.Employee">
        <constructor-args>
            <arg0 class="java.lang.String">bob</arg0>
        </constructor-args>
    </employee>

• 特殊設定值的方法名，新增setter屬性，如：

    <bCardNo class="java.lang.String" setter="setbCardNo"/>

• configuration可配置Dubbo(x)相關屬性與輸出結果
  group, version, check, timeout, retries結點為Dubbo(x)的Reference的相關對應配置，output：配置輸出結果，它的值為object或json，如：

    <configuration>
        <group></group>
        <version></version>
        <check></check>
        <timeout></timeout>
        <retries></retries>
        <output>object</output>
    </configuration>