dubbo学习五--服务分组，多版本，参数验证，结果缓存

服务分组

当一个接口有多种实现时，可以用group区分

 

<dubbo:service group="feedback" interface="com.xxx.IndexService" />
<dubbo:service group="member" interface="com.xxx.IndexService" />
<dubbo:reference id="feedbackIndexService" group="feedback" interface="com.xxx.IndexService" />
<dubbo:reference id="memberIndexService" group="member" interface="com.xxx.IndexService" />
任意组：(2.2.0以上版本支持，总是只调一个可用组的实现)
<dubbo:reference id="barService" interface="com.foo.BarService" group="*" />

 

 

 

 

 

多版本

当一个接口实现，出现不兼容升级时，可以用版本事情过度，版本号不同的服务相互间不引用。

 

<dubbo:service interface="com.foo.BarService" version="1.0.0" />
<dubbo:service interface="com.foo.BarService" version="2.0.0" />
<dubbo:reference id="barService" interface="com.foo.BarService" version="1.0.0" />
<dubbo:reference id="barService" interface="com.foo.BarService" version="2.0.0" />
不区分版本：(2.2.0以上版本支持)
<dubbo:reference id="barService" interface="com.foo.BarService" version="*" />

 

 

 

 

 

分组聚合

按组合并返回结果，比如菜单服务，接口一样，但有多种实现，用group区分，现在消费方需从每种group中调用一次返回结果，合并结果返回，这样就可以实现聚合菜单项。

 

配置如：(搜索所有分组)

<dubbo:reference interface="com.xxx.MenuService" group="*" merger="true" />

或：(合并指定分组)

<dubbo:reference interface="com.xxx.MenuService" group="aaa,bbb" merger="true" />

或：(指定方法合并结果，其它未指定的方法，将只调用一个Group)

<dubbo:reference interface="com.xxx.MenuService" group="*">     <dubbo:method name="getMenuItems" merger="true" /> </dubbo:service>

或：(某个方法不合并结果，其它都合并结果)

<dubbo:reference interface="com.xxx.MenuService" group="*" merger="true">     <dubbo:method name="getMenuItems" merger="false" /> </dubbo:service>

或：(指定合并策略，缺省根据返回值类型自动匹配，如果同一类型有两个合并器时，需指定合并器的名称)
参见：[合并结果扩展]

<dubbo:reference interface="com.xxx.MenuService" group="*">     <dubbo:method name="getMenuItems" merger="mymerge" /> </dubbo:service>

或：(指定合并方法，将调用返回结果的指定方法进行合并，合并方法的参数类型必须是返回结果类型本身)

<dubbo:reference interface="com.xxx.MenuService" group="*">     <dubbo:method name="getMenuItems" merger=".addAll" /> </dubbo:service>

 

 

 

参数验证

参数验证功能是基于JSR303实现的，用户只需标识JSR303标准的验证Annotation，并通过声明filter来实现验证。

 

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);         }     }   }

需要加入依赖：

<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>

 

 

 

结果缓存

dubbo提供声明式缓存，以减少用户加缓存的工作量。

 

最后欢迎大家访问我的个人网站：1024s