本文将深入探讨如何在Spring Boot应用中，从后端实体中选择性地提取特定字段，并将其高效且安全地渲染到HTML页面。我们将重点介绍数据传输对象（DTO）作为最佳实践，结合Spring MVC控制器和模板引擎（如Thymeleaf），实现数据展示层与业务逻辑的解耦，并讨论其他序列化控制策略。
1. 问题背景与目标
在spring boot开发中，我们经常会遇到这样的场景：后端服务从数据库获取一个包含多个字段的完整实体对象（例如adventureholidays），但前端页面（html）或特定的api接口只需要其中的部分字段（例如title和description）。直接将完整实体暴露给前端可能导致不必要的数据传输、安全隐患，并增加前端解析的复杂性。我们的目标是实现一个spring boot控制器，当被调用时，能够返回一个只包含所需特定字段的html页面。
原始的AdventureHolidays实体定义如下：
@Document("adventureholidays")public class AdventureHolidays { @Id private String id; private String title; private String description; private String typeOfAdventureHolidays; // Getter方法 public String getId() { return id; } public String getTitle() { return title; } public String getDescription() { return description; } public String getTypeOfAdventureHolidays() { return typeOfAdventureHolidays; } // Setter方法（如果需要） public void setId(String id) { this.id = id; } public void setTitle(String title) { this.title = title; } public void setDescription(String description) { this.description = description; } public void setTypeOfAdventureHolidays(String typeOfAdventureHolidays) { this.typeOfAdventureHolidays = typeOfAdventureHolidays; }}
一个典型的控制器可能返回完整的JSON列表：
@RestControllerpublic class AdventureApiController { @Autowired private AdventureHolidaysService adventureHolidaysService; @GetMapping("/getRandomSummerCamps") public List getRandomSummerCamps() { return adventureHolidaysService.getRandomSummerCamps(); }}
当访问/getRandomSummerCamps时，会得到类似以下包含所有字段的JSON响应：
[{"id":"123","title":"Raquette Lake Camp","description":"Founded in 1916...","typeOfAdventureHolidays":"summerCamps"}]
而我们的目标是，在HTML页面中只显示title和description。
立即学习“前端免费学习笔记（深入）”；
2. 核心策略：数据传输对象 (DTO)
数据传输对象（DTO）是解决此类问题的最佳实践。DTO是一个简单的Java对象，其主要目的是在应用程序的不同层之间传输数据。它只包含前端或特定服务所需的数据字段，从而将领域模型与表示层解耦。
DTO的优势：
解耦: 将领域实体与视图层分离，防止不必要的字段暴露。安全性: 避免敏感数据（如数据库ID、内部状态）泄露到客户端。性能: 减少传输的数据量，提高网络效率。灵活性: 可以为不同的视图或API设计不同的DTO，满足多样化的需求。
2.1 创建DTO
针对我们的需求，创建一个只包含title和description的AdventureSummaryDTO：
// src/main/java/com/example/demo/dto/AdventureSummaryDTO.javapackage com.example.demo.dto;public class AdventureSummaryDTO { private String title; private String description; // 构造函数 public AdventureSummaryDTO(String title, String description) { this.title = title; this.description = description; } // Getter 方法 public String getTitle() { return title; } public String getDescription() { return description; } // Setter 方法 (如果需要，但对于DTO通常不需要) public void setTitle(String title) { this.title = title; } public void setDescription(String description) { this.description = description; }}
2.2 改造Spring Boot控制器以返回HTML
为了返回HTML页面，我们需要将控制器类型从@RestController改为@Controller，并使用Spring MVC的Model对象将数据传递给视图模板。
// src/main/java/com/example/demo/controller/AdventureWebController.javapackage com.example.demo.controller;import com.example.demo.dto.AdventureSummaryDTO;import com.example.demo.model.AdventureHolidays;import com.example.demo.service.AdventureHolidaysService;import org.springframework.beans.factory.annotation.Autowired;import org.springframework.stereotype.Controller;import org.springframework.ui.Model;import org.springframework.web.bind.annotation.GetMapping;import java.util.List;import java.util.stream.Collectors;@Controller // 注意这里是 @Controller，用于返回视图public class AdventureWebController { @Autowired private AdventureHolidaysService adventureHolidaysService; @GetMapping("/summerCampsHtml") // 定义一个新的URL路径用于HTML页面 public String getSummerCampsHtml(Model model) { // 1. 从服务层获取完整的实体列表 List summerCamps = adventureHolidaysService.getRandomSummerCamps(); // 2. 将实体列表转换为DTO列表 List summaryCamps = summerCamps.stream() .map(camp -> new AdventureSummaryDTO(camp.getTitle(), camp.getDescription())) .collect(Collectors.toList()); // 3. 将DTO列表添加到Model中，以便在HTML模板中使用 model.addAttribute("camps", summaryCamps); // 4. 返回视图名称。Spring Boot将根据配置查找对应的HTML模板 return "summerCampsView"; // 假设存在一个名为 summerCampsView.html 的模板 }}
说明：
@Controller 注解表明这是一个处理Web请求并返回视图的控制器。Model 对象用于在控制器和视图之间传递数据。stream().map().collect() 是Java 8的流式API，用于高效地将AdventureHolidays列表转换为AdventureSummaryDTO列表。return “summerCampsView”; 告诉Spring MVC去渲染名为summerCampsView的视图。如果使用Thymeleaf，它会默认在src/main/resources/templates/目录下查找summerCampsView.html文件。
2.3 创建HTML视图模板 (以Thymeleaf为例)
在src/main/resources/templates/目录下创建summerCampsView.html文件：
夏令营列表 body { font-family: Arial, sans-serif; margin: 20px; } .camp-item { border: 1px solid #ddd; padding: 15px; margin-bottom: 10px; border-radius: 5px; } h2 { color: #333; margin-top: 0; } p { color: #666; }随机夏令营
没有找到任何夏令营信息。
营地标题占位符
营地描述占位符
说明：
xmlns:th=”http://www.thymeleaf.org” 声明了Thymeleaf命名空间。th:each=”camp : ${camps}” 迭代控制器中通过model.addAttribute(“camps”, summaryCamps);传递过来的camps列表。th:text=”${camp.title}” 和 th:text=”${camp.description}” 将每个AdventureSummaryDTO对象的title和description属性值渲染到HTML元素中。
3. 其他序列化控制策略
虽然DTO是处理特定字段展示的最佳实践，但在某些情况下，Spring Boot也提供了其他控制JSON序列化的方法。
3.1 @JsonIgnore 注解
@JsonIgnore 是Jackson库提供的注解，用于在对象序列化为JSON时忽略某个字段。
示例：如果你希望AdventureHolidays实体在任何JSON输出中都忽略typeOfAdventureHolidays字段，可以在该字段上添加@JsonIgnore：
import com.fasterxml.jackson.annotation.JsonIgnore;import org.springframework.data.annotation.Id;import org.springframework.data.mongodb.core.mapping.Document;@Document("adventureholidays")public class AdventureHolidays { @Id private String id; private String title; private String description; @JsonIgnore // 该字段在JSON序列化时将被忽略 private String typeOfAdventureHolidays; // Getter/Setter...}
注意事项：
全局性忽略: 一旦添加，该字段在所有返回AdventureHolidays对象的JSON响应中都会被忽略。仅影响JSON: 它只控制JSON序列化，不会直接影响HTML模板渲染。如果控制器返回的是AdventureHolidays对象给HTML模板，模板仍然可以访问被@JsonIgnore标记的字段（因为它仍在Java对象中）。不适用于动态需求: 如果某些API需要该字段，而另一些不需要，@JsonIgnore就不适用了。
3.2 @JsonView 注解
@JsonView 允许你定义不同的“视图”，并根据请求选择性地序列化实体字段。这适用于同一个实体需要在不同场景下暴露不同字段集合的情况。
示例 (简要介绍):
定义视图接口：
public class Views { public static class Public {} public static class Internal extends Public {}}
在实体字段上标记视图：
public class AdventureHolidays { @JsonView(Views.Public.class) private String title; @JsonView(Views.Public.class) private String description; @JsonView(Views.Internal.class) // 只有Internal视图才能看到 private String typeOfAdventureHolidays; // ...}
在控制器方法上指定视图：
@RestControllerpublic class AdventureApiController { @GetMapping("/publicCamps") @JsonView(Views.Public.class) public List getPublicCamps() { return adventureHolidaysService.getRandomSummerCamps(); } @GetMapping("/internalCamps") @JsonView(Views.Internal.class) public List getInternalCamps() { return adventureHolidaysService.getRandomSummerCamps(); }}
注意事项：
@JsonView 主要用于JSON序列化，对于HTML模板渲染同样不直接适用。它提供了比@JsonIgnore更细粒度的控制，但配置相对复杂。
4. 总结
在Spring Boot中，当需要将后端实体中的特定字段渲染到HTML页面时，使用DTO（数据传输对象）是推荐的最佳实践。它通过将数据模型与视图表示分离，提供了清晰的结构、增强了安全性，并提高了代码的可维护性。
关键步骤：
创建DTO: 定义一个只包含所需字段的DTO。改造控制器:使用@Controller注解。从服务层获取完整实体。将实体映射到DTO。使用Model对象将DTO列表添加到视图。返回视图名称。创建HTML模板: 使用Thymeleaf等模板引擎迭代DTO列表并显示字段。
对于JSON序列化场景，@JsonIgnore适用于永久性地排除字段，而@JsonView则提供了更灵活的视图管理功能，但它们都与直接渲染HTML页面的需求有所不同。理解这些工具的用途和局限性，有助于开发者根据具体业务需求选择最合适的解决方案。
以上就是Spring Boot中将特定字段映射到HTML页面：DTO与视图渲染实践的详细内容，更多请关注创想鸟其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1579239.html
微信扫一扫 
支付宝扫一扫 
