Spring MVC @JsonView使用详解

Spring 提供了对Jackson 很是好的支持，能够查看此spring-jackson-demo代码来掌握。这里着重说一下@JsonView的用法

JSON Views 基本用法

@JsonView能够过滤序列化对象的字段属性，能够使你有选择的序列化对象。下面看一个例子: 首先咱们定义一个View类，里面包含咱们对“要序列化的字段”的定义，咱们暂时归为Summary（摘要）。属于Summary的字段都是咱们要序列化的字段。

这里也能够将View类理解为一组“标识”，而Summary就是其中的一个“标识”。

public class View {
   interface Summary {}
}

View类的定义很简单。

而后咱们定义咱们的Bean类：User

public class User { 
  @JsonView(View.Summary.class) 
  private Long id; 
  @JsonView(View.Summary.class) 
  private String firstname; 
  @JsonView(View.Summary.class) 
  private String lastname; 
  private String email; 
  private String address; 
  private String postalCode; 
  private String city; 
  private String country;
}

能够看到，@JsonView使用很简单，加在属性上，指定一个“标识”就行了。上面例子咱们将Summary指定给了id、firstname、lastname三个属性，这样，当咱们使用@JsonView序列化User对象的时候，就只会序列化这三个属性，能够隐藏一些不想序列化的字段属性。 SpringMVC根据@JsonView序列化的方法以下：

@RestController
public class UserRestController{
  @Autowired 
  private UserService userService;

  @RequestMapping("/user")
  @JsonView(View.Summary.class) 
  public List<User> getUsers(){
    return userService.listUsers();
  }
}

在Controller中指定JsonVIew便可。 当咱们访问/user时，会获得以下结果：

[
  { "id" : 1, "firstname" : "Brian", "lastname" : "Clozel" },
  { "id" : 2, "firstname" : "Stéphane", "lastname" : "Nicoll" },
  { "id" : 3, "firstname" : "Rossen", "lastname" : "Stoyanchev" }
]

用法是否是很简单？

JSON Views 继承用法

JsonView 同时还支持继承 好比咱们须要将User分两个规则进行序列化，一个是“基本资料”，即上面那三个属性的规则；另外一个是“详细资料”，除了包含“基本资料”中的三个属性外，另外还要包含几个详细资料email、address。

咱们在View中再加一个“标识”SummaryWithDetail，定义以下：

public class View {
  interface Summary {}
  interface SummaryWithDetail extends Summary{}
}

这里使用了继承，SummaryWithDetail继承了Summary，也就是说，当咱们以SummaryWithDetail的方式进行对象序列化时，出来的属性同时也包含Summary指定的属性。咱们在User中指定SummaryWithDetail:

public class User { 
  @JsonView(View.Summary.class) 
  private Long id; 
  @JsonView(View.Summary.class) 
  private String firstname; 
  @JsonView(View.Summary.class) 
  private String lastname; 

  @JsonView(View.SummaryWithDetail .class) 
  private String email; 
  @JsonView(View.SummaryWithDetail .class) 
  private String address; 

  private String postalCode; 
  private String city; 
  private String country;
}

能够看到，咱们对email和address指定了SummaryWithDetail标识。

增长Controller方法，测试：

@RestController
public class UserRestController{
  @Autowired 
  private UserService userService;

  @RequestMapping("/user")
  @JsonView(View.Summary.class) 
  public List<User> getUsers(){
    return userService.listUsers();
  }

  @RequestMapping("/user-with-detail")
  @JsonView(View.SummaryWithDetail.class) 
  public List<User> getUsersWithDetail(){
    return userService.listUsers();
  }
}

这样，当咱们访问/user-with-detail时，会获得以下结果：

[
  { 
    "id" : 1, 
    "firstname" : "Brian", 
    "lastname" : "Clozel", 
    "email": "brian@163.com", 
    "address": "beijing China" 
  },
  { 
    "id" : 2, 
    "firstname" : "Stéphane", 
    "lastname" : "Nicoll", 
    "email": "nicoll@163.com", 
    "address": "beijing China" 
   },
  { 
    "id" : 3, 
    "firstname" : "Rossen", 
    "lastname" : "Stoyanchev" , 
    "email": "stoyanchev@163.com", 
    "address": "beijing China" 
  }
]

其实要想实现对属性的排除过滤，Jackson还有一种更简单的方法：@JsonFilter。 官方文档地址：http://wiki.fasterxml.com/JacksonFeatureJsonFilter Java及开源