11，參數驗證

參數驗證功能 ¹ 是基於 JSR303 實現的，用戶只需標識 JSR303 標準的驗證 annotation，並通過聲明 filter 來實現驗證 ²。

Maven 依賴

<dependency>
    <groupId>javax.validation</groupId>
    <artifactId>validation-api</artifactId>
    <version>1.0.0.GA</version>
</dependency>
<dependency>
    <groupId>org.hibernate</groupId>
    <artifactId>hibernate-validator</artifactId>
    <version>4.2.0.Final</version>
</dependency>

示例

參數標註示例

import java.io.Serializable;
import java.util.Date;

import javax.validation.constraints.Future;
import javax.validation.constraints.Max;
import javax.validation.constraints.Min;
import javax.validation.constraints.NotNull;
import javax.validation.constraints.Past;
import javax.validation.constraints.Pattern;
import javax.validation.constraints.Size;

public class ValidationParameter implements Serializable {
    private static final long serialVersionUID = 7158911668568000392L;

    @NotNull // 不允許爲空
    @Size(min = 1, max = 20) // 長度或大小範圍
    private String name;

    @NotNull(groups = ValidationService.Save.class) // 保存時不允許爲空，更新時允許爲空 ，表示不更新該字段
    @Pattern(regexp = "^\\s*\\w+(?:\\.{0,1}[\\w-]+)*@[a-zA-Z0-9]+(?:[-.][a-zA-Z0-9]+)*\\.[a-zA-Z]+\\s*$")
    private String email;

    @Min(18) // 最小值
    @Max(100) // 最大值
    private int age;

    @Past // 必須爲一個過去的時間
    private Date loginDate;

    @Future // 必須爲一個未來的時間
    private Date expiryDate;

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public String getEmail() {
        return email;
    }

    public void setEmail(String email) {
        this.email = email;
    }

    public int getAge() {
        return age;
    }

    public void setAge(int age) {
        this.age = age;
    }

    public Date getLoginDate() {
        return loginDate;
    }

    public void setLoginDate(Date loginDate) {
        this.loginDate = loginDate;
    }

    public Date getExpiryDate() {
        return expiryDate;
    }

    public void setExpiryDate(Date expiryDate) {
        this.expiryDate = expiryDate;
    }
}

分組驗證示例

public interface ValidationService { // 缺省可按服務接口區分驗證場景，如：@NotNull(groups = ValidationService.class)   
    @interface Save{} // 與方法同名接口，首字母大寫，用於區分驗證場景，如：@NotNull(groups = ValidationService.Save.class)，可選
    void save(ValidationParameter parameter);
    void update(ValidationParameter parameter);
}

關聯驗證示例

import javax.validation.GroupSequence;

public interface ValidationService {   
    @GroupSequence(Update.class) // 同時驗證Update組規則
    @interface Save{}
    void save(ValidationParameter parameter);

    @interface Update{} 
    void update(ValidationParameter parameter);
}

參數驗證示例

import javax.validation.constraints.Min;
import javax.validation.constraints.NotNull;

public interface ValidationService {
    void save(@NotNull ValidationParameter parameter); // 驗證參數不爲空
    void delete(@Min(1) int id); // 直接對基本類型參數驗證
}

配置

在客戶端驗證參數

<dubbo:reference id="validationService" interface="com.alibaba.dubbo.examples.validation.api.ValidationService" validation="true" />

在服務器端驗證參數

<dubbo:service interface="com.alibaba.dubbo.examples.validation.api.ValidationService" ref="validationService" validation="true" />

驗證異常信息

import javax.validation.ConstraintViolationException;
import javax.validation.ConstraintViolationException;

import org.springframework.context.support.ClassPathXmlApplicationContext;

import com.alibaba.dubbo.examples.validation.api.ValidationParameter;
import com.alibaba.dubbo.examples.validation.api.ValidationService;
import com.alibaba.dubbo.rpc.RpcException;

public class ValidationConsumer {   
    public static void main(String[] args) throws Exception {
        String config = ValidationConsumer.class.getPackage().getName().replace('.', '/') + "/validation-consumer.xml";
        ClassPathXmlApplicationContext context = new ClassPathXmlApplicationContext(config);
        context.start();
        ValidationService validationService = (ValidationService)context.getBean("validationService");
        // Error
        try {
            parameter = new ValidationParameter();
            validationService.save(parameter);
            System.out.println("Validation ERROR");
        } catch (RpcException e) { // 拋出的是RpcException
            ConstraintViolationException ve = (ConstraintViolationException) e.getCause(); // 裏面嵌了一個ConstraintViolationException
            Set<ConstraintViolation<?>> violations = ve.getConstraintViolations(); // 可以拿到一個驗證錯誤詳細信息的集合
            System.out.println(violations);
        }
    } 
}

¹. 自 2.1.0 版本開始支持, 如何使用可以參考 dubbo 項目中的示例代碼 ↩

². 驗證方式可擴展，擴展方式參見開發者手冊中的驗證擴展 ↩

11，結果緩存

結果緩存 ¹，用於加速熱門數據的訪問速度，Dubbo 提供聲明式緩存，以減少用戶加緩存的工作量 ²。

緩存類型

lru 基於最近最少使用原則刪除多餘緩存，保持最熱的數據被緩存。
threadlocal 當前線程緩存，比如一個頁面渲染，用到很多 portal，每個 portal 都要去查用戶信息，通過線程緩存，可以減少這種多餘訪問。
jcache 與 JSR107 集成，可以橋接各種緩存實現。

緩存類型可擴展，參見：緩存擴展

配置

<dubbo:reference interface="com.foo.BarService" cache="lru" />

或：

<dubbo:reference interface="com.foo.BarService">
    <dubbo:method name="findBar" cache="lru" />
</dubbo:reference>

12，回聲測試

回聲測試用於檢測服務是否可用，回聲測試按照正常請求流程執行，能夠測試整個調用是否通暢，可用於監控。

所有服務自動實現 EchoService 接口，只需將任意服務引用強制轉型爲 EchoService，即可使用。

Spring 配置：

<dubbo:reference id="memberService" interface="com.xxx.MemberService" />

代碼：

// 遠程服務引用
MemberService memberService = ctx.getBean("memberService"); 

EchoService echoService = (EchoService) memberService; // 強制轉型爲EchoService

// 回聲測試可用性
String status = echoService.$echo("OK"); 

assert(status.equals("OK"));

13異步調用

基於 NIO 的非阻塞實現並行調用，客戶端不需要啓動多線程即可完成並行調用多個遠程服務，相對多線程開銷較小。 ¹

在 consumer.xml 中配置：

<dubbo:reference id="fooService" interface="com.alibaba.foo.FooService">
      <dubbo:method name="findFoo" async="true" />
</dubbo:reference>
<dubbo:reference id="barService" interface="com.alibaba.bar.BarService">
      <dubbo:method name="findBar" async="true" />
</dubbo:reference>

調用代碼:

// 此調用會立即返回null
fooService.findFoo(fooId);
// 拿到調用的Future引用，當結果返回後，會被通知和設置到此Future
Future<Foo> fooFuture = RpcContext.getContext().getFuture(); 

// 此調用會立即返回null
barService.findBar(barId);
// 拿到調用的Future引用，當結果返回後，會被通知和設置到此Future
Future<Bar> barFuture = RpcContext.getContext().getFuture(); 

// 此時findFoo和findBar的請求同時在執行，客戶端不需要啓動多線程來支持並行，而是藉助NIO的非阻塞完成

// 如果foo已返回，直接拿到返回值，否則線程wait住，等待foo返回後，線程會被notify喚醒
Foo foo = fooFuture.get(); 
// 同理等待bar返回
Bar bar = barFuture.get(); 

// 如果foo需要5秒返回，bar需要6秒返回，實際只需等6秒，即可獲取到foo和bar，進行接下來的處理。

你也可以設置是否等待消息發出： ²

sent="true" 等待消息發出，消息發送失敗將拋出異常。
sent="false" 不等待消息發出，將消息放入 IO 隊列，即刻返回。

<dubbo:method name="findFoo" async="true" sent="true" />

如果你只是想異步，完全忽略返回值，可以配置 return="false"，以減少 Future 對象的創建和管理成本：

<dubbo:method name="findFoo" async="true" return="false" />

14，本地調用

本地調用使用了 injvm 協議，是一個僞協議，它不開啓端口，不發起遠程調用，只在 JVM 內直接關聯，但執行 Dubbo 的 Filter 鏈。

配置

定義 injvm 協議

<dubbo:protocol name="injvm" />

設置默認協議

<dubbo:provider protocol="injvm" />

設置服務協議

<dubbo:service protocol="injvm" />

優先使用 injvm

<dubbo:consumer injvm="true" .../>
<dubbo:provider injvm="true" .../>

或

<dubbo:reference injvm="true" .../>
<dubbo:service injvm="true" .../>

注意：服務暴露與服務引用都需要聲明 injvm="true"

自動暴露、引用本地服務

從 2.2.0 開始，每個服務默認都會在本地暴露。在引用服務的時候，默認優先引用本地服務。如果希望引用遠程服務可以使用一下配置強制引用遠程服務。

<dubbo:reference ... scope="remote" />

15，併發控制

配置樣例

樣例 1

限制 com.foo.BarService 的每個方法，服務器端併發執行（或佔用線程池線程數）不能超過 10 個：

<dubbo:service interface="com.foo.BarService" executes="10" />

樣例 2

限制 com.foo.BarService 的 sayHello 方法，服務器端併發執行（或佔用線程池線程數）不能超過 10 個：

<dubbo:service interface="com.foo.BarService">
    <dubbo:method name="sayHello" executes="10" />
</dubbo:service>

樣例 3

限制 com.foo.BarService 的每個方法，每客戶端併發執行（或佔用連接的請求數）不能超過 10 個：

<dubbo:service interface="com.foo.BarService" actives="10" />

或

<dubbo:reference interface="com.foo.BarService" actives="10" />

樣例 4

限制 com.foo.BarService 的 sayHello 方法，每客戶端併發執行（或佔用連接的請求數）不能超過 10 個：

<dubbo:service interface="com.foo.BarService">
    <dubbo:method name="sayHello" actives="10" />
</dubbo:service>

或

<dubbo:reference interface="com.foo.BarService">
    <dubbo:method name="sayHello" actives="10" />
</dubbo:service>

如果 <dubbo:service> 和 <dubbo:reference> 都配了actives，<dubbo:reference> 優先，參見：配置的覆蓋策略。

Load Balance 均衡

配置服務的客戶端的 loadbalance 屬性爲 leastactive，此 Loadbalance 會調用併發數最小的 Provider（Consumer端併發數）。

<dubbo:reference interface="com.foo.BarService" loadbalance="leastactive" />

或

<dubbo:service interface="com.foo.BarService" loadbalance="leastactive" />

16，連接控制

服務端連接控制

限制服務器端接受的連接不能超過 10 個 ¹：

<dubbo:provider protocol="dubbo" accepts="10" />

或

<dubbo:protocol name="dubbo" accepts="10" />

客戶端連接控制

限制客戶端服務使用連接不能超過 10 個 ²：

<dubbo:reference interface="com.foo.BarService" connections="10" />

或

<dubbo:service interface="com.foo.BarService" connections="10" />

如果 <dubbo:service> 和 <dubbo:reference> 都配了 connections，<dubbo:reference> 優先，參見：配置的覆蓋策略

¹. 因爲連接在 Server上，所以配置在 Provider 上 ↩

². 如果是長連接，比如 Dubbo 協議，connections 表示該服務對每個提供者建立的長連接數 ↩

17，

Dubbo用戶手冊關鍵點整理（四-2）