# Spring Boot 开发技巧该技能为使用自动配置、依赖注入、REST API、Spring Data、Spring Security 和基于官方 Spring Boot 文档的企业 Java 模式构建现代 Spring Boot 应用程序提供了全面的指导。 ## 何时使用此技能在以下情况下使用此技能： * 构建企业 REST API 和微服务 * 使用 Spring MVC 创建 Web 应用程序 * 使用 JPA 和数据库开发数据驱动的应用程序 * 使用Spring Security实现身份验证和授权 * 使用执行器和监控构建生产就绪的应用程序 * 使用 Spring Boot 创建可扩展的后端服务 * 从传统Spring迁移到Spring Boot * 开发云原生应用程序 * 使用消息传递构建事件驱动系统 * 创建批处理应用程序 ## 核心概念 ### 自动配置 Spring Boot 会根据您添加到项目中的依赖项自动配置您的应用程序。这显着减少了样板配置。 **自动配置如何工作：** @SpringBootApplication 公共类我的应用程序{ 公共静态无效主（字符串[] args）{ SpringApplication.run(MyApplication.class, args); } } `@SpringBootApplication` 注解是以下内容的组合： * `@Configuration`：将类标记为 bean 定义的来源 * `@EnableAutoConfiguration`：启用Spring Boot的自动配置机制 * `@ComponentScan`: 启用当前包和子包中的组件扫描 **有条件自动配置：** @配置 @ConditionalOnClass(DataSource.class) @ConditionalOnProperty(name = "spring.datasource.url") 公共类数据源自动配置{ @豆子 @ConditionalOnMissingBean 公共数据源 dataSource() { 返回 DataSourceBuilder.create().build(); } } **自定义自动配置：** // 排除特定的自动配置 @SpringBootApplication（排除= {DataSourceAutoConfiguration.class}）公共类我的应用程序{ // ... } // 或者在 application.properties 中 // spring.autoconfigure.exclude=org.springframework.boot.autoconfigure.jdbc.DataSourceAutoConfiguration ### 依赖注入 Spring 的 IoC（控制反转）容器管理对象创建和依赖注入。 **构造函数注入（推荐）：** @服务公共类用户服务{ 私有最终 UserRepository userRepository; 私人最终电子邮件服务电子邮件服务； // 构造函数注入 - 推荐方法公共 UserService(UserRepository userRepository, EmailService emailService) { this.userRepository = userRepository; this.emailService = emailService; } 公共用户createUser（用户用户）{ 用户已保存 = userRepository.save(user); emailService.sendWelcomeEmail（已保存）；返回已保存； } } **现场注入（不推荐）：** @服务公共类用户服务{ @Autowired // 避免字段注入私有 UserRepository 用户存储库； // 难以测试并造成紧密耦合 } **Setter 注入（可选依赖项）：** @服务公共类用户服务{ 私有 UserRepository 用户存储库；私人电子邮件服务电子邮件服务； @Autowired 公共无效setUserRepository（UserRepository userRepository）{ this.userRepository = userRepository; } @Autowired（必需=假）公共无效setEmailService（EmailService emailService）{ this.emailService = emailService; } } **组件刻板印象：** @Component // 通用组件公共类我的组件{} @Service // 业务逻辑层公共类 MyService { } @Repository // 数据访问层公共类 MyRepository { } @Controller // 表示层（网络）公共类 MyController { } @RestController // REST API控制器公共类 MyRestController { } ### Spring Web（REST API）使用 Spring MVC 注释构建 RESTful Web 服务。 **基本 REST 控制器：** @RestController @RequestMapping("/api/users") 公共类用户控制器{ 私有最终 UserService userService；公共 UserController(UserService userService) { this.userService = userService; } @GetMapping 公共列表<用户> getAllUsers() { 返回 userService.findAll(); } @GetMapping("/{id}") 公共 ResponseEntity getUserById(@PathVariable Long id) { 返回 userService.findById(id) .map(ResponseEntity::ok) .orElse(ResponseEntity.notFound().build()); } @PostMapping 公共 ResponseEntity createUser(@RequestBody @Valid User user) { 创建的用户 = userService.save(user); URI 位置 = ServletUriComponentsBuilder .fromCurrentRequest() .path("/{id}") .buildAndExpand(创建的.getId()) .toUri(); 返回 ResponseEntity.created(location).body(created); } @PutMapping("/{id}") 公共 ResponseEntity<用户> updateUser(@PathVariable Long id, @RequestBody @Valid User user) { 返回 userService.update(id, 用户) .map(ResponseEntity::ok) .orElse(ResponseEntity.notFound().build()); } @DeleteMapping("/{id}") 公共 ResponseEntity deleteUser(@PathVariable Long id) { if (userService.delete(id)) { 返回 ResponseEntity.noContent().build(); } 返回 ResponseEntity.notFound().build(); } } **请求映射变化：** @RestController @RequestMapping(“/api/产品”) 公共类产品控制器{ // 查询参数 @GetMapping("/搜索") 公共列表<产品>搜索（@RequestParam字符串名称， @RequestParam(required = false) 字符串类别) { 返回productService.search（名称，类别）； } // 多个路径变量 @GetMapping("/categories/{categoryId}/products/{productId}") 公共产品 getProductInCategory(@PathVariable LongcategoryId, @PathVariable长productId) { 返回productService.findInCategory（categoryId，productId）； } // 请求头 @GetMapping("/{id}") 公共产品 getProduct(@PathVariable Long id, @RequestHeader("Accept-Language") 字符串语言) { 返回productService.find(id, 语言); } // 矩阵变量 @GetMapping("/{id}") 公共产品 getProductWithMatrix(@PathVariable Long id, @MatrixVariable Map 过滤器) { 返回productService.findWithFilters（id，过滤器）； } } **响应处理：** @RestController @RequestMapping(“/api/订单”) 公共类订单控制器{ // 返回不同的状态码 @PostMapping 公共 ResponseEntity createOrder(@RequestBody Order order) { 创建订单 = orderService.create(order); 返回 ResponseEntity.status(HttpStatus.CREATED).body(已创建); } // 自定义标头 @GetMapping("/{id}") 公共 ResponseEntity getOrder(@PathVariable Long id) { 订单 order = orderService.findById(id); 返回 ResponseEntity.ok() .header("X-Order-Version", order.getVersion().toString()) .body(订单); } // 无内容响应 @DeleteMapping("/{id}") 公共 ResponseEntity deleteOrder(@PathVariable Long id) { orderService.delete(id); 返回 ResponseEntity.noContent().build(); } } ### Spring Data JPA Spring Data JPA 为数据库访问提供存储库抽象。 **实体定义：** @实体 @Table(名称=“用户”) 公共类用户{ @Id @GenerateValue(策略 = GenerationType.IDENTITY) 私人长ID； @Column(nullable = false, unique = true) 私人字符串电子邮件； @Column(可为空 = false) 私有字符串名称； @Column(name = "created_at", nullable = false, updateable = false) 私有 LocalDateTime 创建于； @Column(名称 = "updated_at") 私有 LocalDateTime 更新时间； @OneToMany（mappedBy =“用户”，级联= CascadeType.ALL，orphanRemoval = true） private List orders = new ArrayList<>(); @ManyToOne(fetch = FetchType.LAZY) @JoinColumn(名称 = "部门 ID") 私人部门； @PrePersist 受保护无效 onCreate() { 创建时间 = LocalDateTime.now(); updateAt = LocalDateTime.now(); } @预更新受保护无效 onUpdate() { updateAt = LocalDateTime.now(); } // 获取器和设置器 } **存储库接口：** @存储库公共接口 UserRepository 扩展 JpaRepository { // 查询方法-Spring Data生成实现可选<用户> findByEmail(字符串电子邮件); List<用户> findByNameContaining(字符串名称); List<用户> findByDepartmentId(Long DepartmentId); // 自定义 JPQL 查询 @Query("从用户 u 中选择 u，其中 u.email = ?1") 可选 findByEmailQuery(String email); // 命名参数 @Query("从用户 u 中选择 u，其中 u.name LIKE %:name% AND u.department.id = :deptId") List searchByNameAndDepartment(@Param("name") 字符串名称， @Param("deptId")长deptId); // 原生 SQL 查询 @Query(value = "SELECT * FROM users WHERE email = ?1", nativeQuery = true) 可选 findByEmailNative(String email); // 修改查询 @修改 @Query("更新用户 u SET u.name = :name WHERE u.id = :id") int updateUserName(@Param("id") 长 id, @Param("name") 字符串名称); // 分页和排序 Page findByDepartmentId(Long DepartmentId, Pageable 可分页); List findByNameContaining(字符串名称, 排序排序); } **存储库使用：** @服务公共类用户服务{ 私有最终 UserRepository userRepository; 公共 UserService(UserRepository userRepository) { this.userRepository = userRepository; } 公共可选<用户> findById（长id）{ 返回 userRepository.findById(id); } 公共用户保存（用户用户）{ 返回 userRepository.save(user); } 公共列表 <用户> findAll() { 返回 userRepository.findAll(); } 公共页面 <用户> findAll(int 页面, int 大小) { 可分页可分页 = PageRequest.of(页面, 大小, Sort.by("名称")); return userRepository.findAll(可分页); } 公共布尔删除（长id）{ if (userRepository.existsById(id)) { userRepository.deleteById(id); 返回真； } 返回假； } } **关系：** // 一对多 @实体公开课顺序{ @Id @GenerateValue(策略 = GenerationType.IDENTITY) 私人长ID； @ManyToOne(fetch = FetchType.LAZY) @JoinColumn(名称 = "user_id") 私人用户用户； @OneToMany（mappedBy =“顺序”，级联= CascadeType.ALL，orphanRemoval = true）私有列表 items = new ArrayList<>(); } // 多对多 @实体公开课学生{ @Id @GenerateValue(策略 = GenerationType.IDENTITY) 私人长ID； @ManyToMany @JoinTable( 名称=“学生课程”， joinColumns = @JoinColumn(name = "student_id"), inverseJoinColumns = @JoinColumn(name = "course_id") ）私人 Set<课程> 课程 = new HashSet<>(); } ### 配置 Spring Boot 使用 application.properties 或 application.yml 进行配置。 **应用属性：** # 服务器配置服务器端口=8080 server.servlet.context-path=/api # 数据库配置 spring.datasource.url=jdbc:postgresql://localhost:5432/mydb spring.datasource.username=用户 spring.datasource.password=密码 spring.datasource.driver-class-name=org.postgresql.Driver #JPA配置 spring.jpa.hibernate.ddl-auto=验证 spring.jpa.show-sql=true spring.jpa.properties.hibernate.format_sql=true spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.PostgreSQLDialect # 日志记录 logging.level.root=信息 logging.level.com.example=调试 logging.level.org.springframework.web=调试 logging.pattern.console=%d{yyyy-MM-dd HH:mm:ss} - %msg%n # 自定义属性 app.name=我的应用程序应用程序版本=1.0.0 **应用程序 YAML：** 服务器：端口：8080 小服务程序：上下文路径：/api 春天：数据源：网址：jdbc:postgresql://localhost:5432/mydb 用户名：用户密码：密码驱动程序类名称：org.postgresql.Driver 杰帕：休眠： ddl-auto：验证显示 sql: true 属性：休眠： format_sql: true 方言：org.hibernate.dialect.PostgreSQLDialect 记录：级别：根：信息 com.example：调试 org.springframework.web：调试应用程序：名称：我的申请版本：1.0.0 **配置属性类：** @配置 @ConfigurationProperties（前缀=“应用程序”）公共类AppConfig { 私有字符串名称；私有字符串版本；私有安全安全 = new Security(); 公共静态类安全性{ 私有 int tokenExpiration = 3600; 私有字符串密钥； // 获取器和设置器 } // 获取器和设置器 } // 用法 @服务公共类我的服务{ 私有最终AppConfig appConfig；公共MyService（AppConfig appConfig）{ this.appConfig = appConfig; } 公共无效打印配置（）{ System.out.println("应用程序：" + appConfig.getName()); System.out.println("版本：" + appConfig.getVersion()); } } **特定环境配置：** # application.properties（默认） spring.profiles.active=dev # 应用程序-dev.properties spring.datasource.url=jdbc:postgresql://localhost:5432/mydb_dev logging.level.root=调试 # 应用程序-prod.properties spring.datasource.url=jdbc:postgresql://prod-server:5432/mydb_prod logging.level.root=警告 **特定于配置文件的 Bean：** @配置公共类数据库配置{ @豆子 @个人资料（“开发”）公共数据源 devDataSource() { 返回新的EmbeddedDatabaseBuilder() .setType(嵌入式数据库类型.H2) .build(); } @豆子 @Profile(“产品”) 公共数据源 prodDataSource() { 返回 DataSourceBuilder.create().build(); } } ### 春季安全在您的应用程序中实现身份验证和授权。 **基本安全配置：** @配置 @EnableWebSecurity 公共类安全配置{ @豆子 public SecurityFilterChain filterChain(HttpSecurity http) 抛出异常 { http .csrf().disable() .authorizeHttpRequests(身份验证->身份验证 .requestMatchers("/api/public/**").permitAll() .requestMatchers("/api/admin/**").hasRole("ADMIN") .requestMatchers("/api/users/**").hasAnyRole("USER", "ADMIN") .anyRequest().authenticated() ） .httpBasic(); 返回 http.build(); } @豆子公共密码编码器密码编码器（）{ 返回新的 BCryptPasswordEncoder(); } } **内存中身份验证：** @配置 @EnableWebSecurity 公共类安全配置{ @豆子公共 UserDetailsService userDetailsService(PasswordEncoder 密码编码器) { UserDetails 用户 = User.builder() .用户名(“用户”) .password(passwordEncoder.encode("密码")) .角色（“用户”） .build(); 用户详细信息 admin = User.builder() .用户名(“管理员”) .password(passwordEncoder.encode("admin")) .角色（“管理员”，“用户”） .build(); 返回新的 InMemoryUserDetailsManager(用户, 管理员); } } **数据库验证：** @服务公共类 CustomUserDetailsService 实现 UserDetailsService { 私有最终 UserRepository userRepository; 公共 CustomUserDetailsService(UserRepository userRepository) { this.userRepository = userRepository; } @覆盖公共 UserDetails loadUserByUsername（字符串用户名）抛出 UsernameNotFoundException { 用户 user = userRepository.findByEmail(用户名) .orElseThrow(() -> new UsernameNotFoundException("未找到用户：" + 用户名)); 返回 org.springframework.security.core.userdetails.User.builder() .用户名(user.getEmail()) .password(用户.getPassword()) .roles(user.getRoles().toArray(new String[0])) .build(); } } @配置 @EnableWebSecurity 公共类安全配置{ 私有最终 CustomUserDetailsService userDetailsService；公共 SecurityConfig(CustomUserDetailsService userDetailsService) { this.userDetailsService = userDetailsService; } @豆子公共 DaoAuthenticationProvider 身份验证提供程序（PasswordEncoder 密码编码器）{ DaoAuthenticationProvider 提供者 = new DaoAuthenticationProvider(); 提供者.setUserDetailsService(userDetailsService); 提供者.setPasswordEncoder(passwordEncoder); 退货提供商； } } **JWT 身份验证：** @组件公共类 JwtTokenProvider { @Value("${app.security.jwt.secret}") 私有字符串 jwtSecret； @Value("${app.security.jwt.expiration}") 私有 int jwtExpiration；公共字符串generateToken（身份验证认证）{ UserPrincipal userPrincipal = (UserPrincipal)authentication.getPrincipal(); 现在的日期 = new Date(); 日期 expiryDate = new Date(now.getTime() + jwtExpiration); 返回 Jwts.builder() .setSubject(Long.toString(userPrincipal.getId())) .setIssuedAt(现在) .setExpiration(过期日期) .signWith(SignatureAlgorithm.HS512, jwtSecret) .compact(); } 公共长getUserIdFromJWT（字符串令牌）{ 声明声明 = Jwts.parser() .setSigningKey(jwtSecret) .parseClaimsJws（令牌） .getBody(); return Long.parseLong(claims.getSubject()); } 公共布尔 validateToken(String authToken) { 尝试{ Jwts.parser().setSigningKey(jwtSecret).parseClaimsJws(authToken); 返回真； } catch (SignatureException | MalformedJwtException | ExpiredJwtException | 不支持的JwtException | IllegalArgumentException ex) { 返回假； } } } @组件公共类 JwtAuthenticationFilter 扩展 OncePerRequestFilter { 私有最终 JwtTokenProvider tokenProvider；私人最终 CustomUserDetailsService customUserDetailsService; 公共 JwtAuthenticationFilter(JwtTokenProvider tokenProvider, 自定义用户详细信息服务自定义用户详细信息服务) { this.tokenProvider = tokenProvider; this.customUserDetailsService = customUserDetailsService; } @覆盖受保护的无效 doFilterInternal（HttpServletRequest 请求， HttpServletResponse 响应， FilterChain filterChain) 抛出 ServletException, IOException { 尝试{ 字符串 jwt = getJwtFromRequest(请求); if (jwt != null && tokenProvider.validateToken(jwt)) { 长 userId = tokenProvider.getUserIdFromJWT(jwt); UserDetails userDetails = customUserDetailsService.loadUserById(userId); 用户名密码验证令牌身份验证 = 新的用户名密码验证令牌（ userDetails, null, userDetails.getAuthorities() ）； SecurityContextHolder.getContext().setAuthentication(身份验证); } } catch (异常前) { logger.error("无法设置用户身份验证", ex); } filterChain.doFilter(请求，响应); } 私有字符串 getJwtFromRequest(HttpServletRequest 请求) { String bearerToken = request.getHeader("授权"); if (StringUtils.hasText(bearerToken) && bearerToken.startsWith("Bearer ")) { 返回 bearerToken.substring(7); } 返回空值； } } ## API 参考 ### 常用注解 **核心 Spring 注释：** * `@SpringBootApplication`：主应用程序类 * `@Component`: 通用组件 * `@Service`: 服务层组件 * `@Repository`：数据访问层组件 * `@Configuration`: 配置类 * `@Bean`: Bean定义方法 * `@Autowired`：依赖注入 * `@Value`: 注入属性值 * `@Profile`：基于配置文件的条件bean **网页注释：** * `@RestController`：REST API 控制器 * `@Controller`: MVC 控制器 * `@RequestMapping`: 映射 HTTP 请求 * `@GetMapping`: 映射 GET 请求 * `@PostMapping`: 映射 POST 请求 * `@PutMapping`: 映射 PUT 请求 * `@DeleteMapping`：映射删除请求 * `@PatchMapping`: 映射 PATCH 请求 * `@PathVariable`：提取路径变量 * `@RequestParam`: 提取查询参数 * `@RequestBody`: 提取请求体 * `@RequestHeader`: 提取请求头 * `@ResponseStatus`: 设置响应状态 **数据注释：** * `@Entity`：JPA 实体 * `@Table`: 表映射 * `@Id`: 主键 * `@GenerateValue`：自动生成的值 * `@Column`: 列映射 * `@OneToOne`：一对一关系 * `@OneToMany`：一对多关系 * `@ManyToOne`：多对一关系 * `@ManyToMany`：多对多关系 * `@JoinColumn`: 连接列 * `@JoinTable`: 连接表 **验证注释：** * `@Valid`: 启用验证 * `@NotNull`: 字段不能为空 * `@NotEmpty`: 字段不能为空 * `@NotBlank`: 字段不能为空 * `@Size`: 字符串或集合大小 * `@Min`: 最小值 * `@Max`: 最大值 * `@Email`: 电子邮件格式 * `@Pattern`: 正则表达式模式 **交易注释：** * `@Transactional`: 启用事务管理 * `@Transactional(readOnly = true)`: 只读事务 **安全注释：** * `@EnableWebSecurity`: 启用安全性 * `@PreAuthorize`：方法级授权 * `@PostAuthorize`：方法后授权 * `@Secured`：基于角色的访问 **异步和调度：** * `@EnableAsync`: 启用异步处理 * `@Async`: 异步方法 * `@EnableScheduling`: 启用调度 * `@Scheduled`: 预定方法 ## 工作流程模式 ### REST API 设计模式 **完整的 CRUD REST API：** // 实体 @实体 @Table(名称=“产品”) 公开课产品{ @Id @GenerateValue(策略 = GenerationType.IDENTITY) 私人长ID； @NotBlank(message = "姓名为必填项") 私有字符串名称； @NotBlank(message = "需要描述") 私有字符串描述； @NotNull(message = "价格为必填项") @Min(value = 0, message = "价格必须为正") 私人 BigDecimal 价格； @NotNull(message = "需要库存") @Min(value = 0, message = "库存必须为正") 私人整数股票；私有 LocalDateTime 创建于；私有 LocalDateTime 更新时间； @PrePersist 受保护无效 onCreate() { 创建时间 = LocalDateTime.now(); updateAt = LocalDateTime.now(); } @预更新受保护无效 onUpdate() { updateAt = LocalDateTime.now(); } // 获取器和设置器 } // 存储库 @存储库公共接口 ProductRepository 扩展 JpaRepository { List<产品> findByNameContaining(字符串名称); List<产品> findByPriceBetween(BigDecimal minPrice, BigDecimal maxPrice); } // 服务 @服务 @事务性公共类产品服务{ 私有最终 ProductRepository 产品存储库；公共 ProductService(ProductRepository ProductRepository) { this.productRepository = ProductRepository; } @Transactional(只读 = true) 公共页面 <产品> findAll(可分页可分页) { 返回productRepository.findAll(可分页); } @Transactional(只读 = true) 公共可选<产品> findById（长id）{ 返回productRepository.findById(id); } 公共产品创建（产品产品）{ 返回productRepository.save（产品）； } 公共可选<产品>更新（长id，产品产品详细信息）{ 返回productRepository.findById(id) .map(产品-> { 产品.setName(productDetails.getName()); 产品.setDescription(productDetails.getDescription()); 产品.setPrice(productDetails.getPrice()); 产品.setStock(productDetails.getStock()); 返回productRepository.save（产品）； }); } 公共布尔删除（长id）{ 返回productRepository.findById(id) .map(产品-> { 产品存储库.删除(产品); 返回真； }) .orElse(假); } } // 控制器 @RestController @RequestMapping(“/api/产品”) 公共类产品控制器{ 私有最终 ProductService 产品服务；公共产品控制器（产品服务产品服务）{ this.productService = 产品服务; } @GetMapping 公共页面<产品> getAllProducts( @RequestParam(defaultValue = "0") int 页， @RequestParam(defaultValue = "10") int 大小， @RequestParam(defaultValue = "id") 字符串 sortBy) { 可分页可分页 = PageRequest.of(页面, 大小, Sort.by(sortBy)); 返回productService.findAll(可分页); } @GetMapping("/{id}") 公共 ResponseEntity getProductById(@PathVariable Long id) { 返回productService.findById(id) .map(ResponseEntity::ok) .orElse(ResponseEntity.notFound().build()); } @PostMapping 公共 ResponseEntity createProduct(@Valid @RequestBody Product 产品) { 创建的产品=productService.create(product); URI 位置 = ServletUriComponentsBuilder .fromCurrentRequest() .path("/{id}") .buildAndExpand(创建的.getId()) .toUri(); 返回 ResponseEntity.created(location).body(created); } @PutMapping("/{id}") 公共 ResponseEntity<产品> updateProduct( @PathVariable长id， @Valid @RequestBody 产品产品）{ 返回productService.update（id，产品） .map(ResponseEntity::ok) .orElse(ResponseEntity.notFound().build()); } @DeleteMapping("/{id}") 公共 ResponseEntity deleteProduct(@PathVariable Long id) { if (productService.delete(id)) { 返回 ResponseEntity.noContent().build(); } 返回 ResponseEntity.notFound().build(); } } ### 异常处理模式 **全局异常处理程序：** // 自定义异常公共类 ResourceNotFoundException 扩展 RuntimeException { 公共ResourceNotFoundException（字符串消息）{ 超级（消息）； } } 公共类 BadRequestException 扩展 RuntimeException { 公共 BadRequestException（字符串消息）{ 超级（消息）； } } // 错误响应公共类错误响应{ 私有 LocalDateTime 时间戳；私有 int 状态；私有字符串错误；私有字符串消息；私有字符串路径； // 构造函数、getter、setter } // 全局异常处理程序 @RestControllerAdvice 公共类 GlobalExceptionHandler { @ExceptionHandler(ResourceNotFoundException.class) 公共 ResponseEntity handleResourceNotFound( ResourceNotFoundException 前， WebRequest 请求）{ 错误响应错误=新的错误响应（ LocalDateTime.now(), HttpStatus.NOT_FOUND.value(), “未找到”，例如.getMessage(), request.getDescription(false).replace("uri=", "") ）；返回新的 ResponseEntity<>(错误, HttpStatus.NOT_FOUND); } @ExceptionHandler(BadRequestException.class) 公共 ResponseEntity handleBadRequest( BadRequestException 前， WebRequest 请求）{ 错误响应错误=新的错误响应（ LocalDateTime.now(), HttpStatus.BAD_REQUEST.value(), “错误的请求”，例如.getMessage(), request.getDescription(false).replace("uri=", "") ）；返回新的 ResponseEntity<>(错误, HttpStatus.BAD_REQUEST); } @ExceptionHandler(MethodArgumentNotValidException.class) 公共 ResponseEntity>handleValidationErrors( MethodArgumentNotValidException ex) { Map 错误 = new HashMap<>(); 错误.put("时间戳", LocalDateTime.now()); 错误.put（“状态”，HttpStatus.BAD_REQUEST.value（））; Map fieldErrors = new HashMap<>(); ex.getBindingResult().getFieldErrors().forEach(错误 -> fieldErrors.put(error.getField(), error.getDefaultMessage()) ）；错误.put（“错误”，fieldErrors）; 返回新的 ResponseEntity<>(错误, HttpStatus.BAD_REQUEST); } @ExceptionHandler(Exception.class) 公共 ResponseEntity handleGlobalException( 异常前， WebRequest 请求）{ 错误响应错误=新的错误响应（ LocalDateTime.now(), HttpStatus.INTERNAL_SERVER_ERROR.value(), “内部服务器错误”，例如.getMessage(), request.getDescription(false).replace("uri=", "") ）；返回新的 ResponseEntity<>(错误, HttpStatus.INTERNAL_SERVER_ERROR); } } ### 数据库集成模式 **完整的数据库设置：** // 应用程序.yml /* 春天：数据源：网址：jdbc:postgresql://localhost:5432/mydb 用户名：用户密码：密码杰帕：休眠： ddl-auto：验证显示 sql: true 属性：休眠：方言：org.hibernate.dialect.PostgreSQLDialect */ // Flyway 迁移 (db/migration/V1__Create_users_table.sql) /* 创建表用户（ id BIGSERIAL 主键，电子邮件 VARCHAR(255) NOT NULL UNIQUE, 名称 VARCHAR(255) NOT NULL, 密码 VARCHAR(255) NOT NULL, 创建时间时间戳不为空， update_at 时间戳不为空）；在用户（电子邮件）上创建索引 idx_users_email； */ // 具有审计功能的实体 @实体 @Table(名称=“用户”) @EntityListeners(AuditingEntityListener.class) 公共类用户{ @Id @GenerateValue(策略 = GenerationType.IDENTITY) 私人长ID； @Column(nullable = false, unique = true) 私人字符串电子邮件； @Column(可为空 = false) 私有字符串名称； @Column(可为空 = false) 私有字符串密码； @创建日期 @Column(name = "created_at", nullable = false, updateable = false) 私有 LocalDateTime 创建于； @最后修改日期 @Column(名称 = "updated_at") 私有 LocalDateTime 更新时间； // 获取器和设置器 } // 启用JPA审计 @配置 @EnableJpaAuditing 公共类 JpaConfig { } ### 测试模式 **单元测试：** @SpringBootTest 类 UserServiceTest { @模拟私有 UserRepository 用户存储库； @InjectMocks 私有 UserService 用户服务； @BeforeEach 无效设置（）{ MockitoAnnotations.openMocks(this); } @测试无效testFindById_Success（）{ 用户用户=新用户(); 用户.setId(1L); user.setEmail("test@example.com"); when(userRepository.findById(1L)).thenReturn(Optional.of(user)); 可选<用户> 结果 = userService.findById(1L); 断言True(结果.isPresent()); assertEquals("test@example.com", result.get().getEmail()); 验证(userRepository, times(1)).findById(1L); } @测试无效testFindById_NotFound（）{ when(userRepository.findById(1L)).thenReturn(Optional.empty()); 可选<用户> 结果 = userService.findById(1L); 断言False(结果.isPresent()); } } **集成测试：** @SpringBootTest @AutoConfigureMockMvc @事务性类 UserControllerIntegrationTest { @Autowired 私人 MockMvc 模拟Mvc； @Autowired 私有 ObjectMapper 对象映射器； @Autowired 私有 UserRepository 用户存储库； @测试 void testCreateUser_Success() 抛出异常 { 用户用户=新用户(); user.setEmail("test@example.com"); user.setName("测试用户"); mockMvc.perform(post("/api/users") .contentType(MediaType.APPLICATION_JSON) .content(objectMapper.writeValueAsString(用户))) .andExpect(status().isCreated()) .andExpect(jsonPath("$.email").value("test@example.com")) .andExpect(jsonPath("$.name").value("测试用户")); } @测试 void testGetUser_Success() 抛出异常 { 用户用户=新用户(); user.setEmail("test@example.com"); user.setName("测试用户"); 用户已保存 = userRepository.save(user); mockMvc.perform(get("/api/users/" + saving.getId())) .andExpect(status().isOk()) .andExpect(jsonPath("$.id").value(saved.getId())) .andExpect(jsonPath("$.email").value("test@example.com")); } @测试 void testGetUser_NotFound() 抛出异常 { mockMvc.perform(get("/api/users/999")) .andExpect(status().isNotFound()); } } ## 最佳实践 ### 1\.使用构造函数注入构造函数注入是依赖注入的推荐方法。 // 好 - 构造函数注入 @服务公共类用户服务{ 私有最终 UserRepository userRepository; 私人最终电子邮件服务电子邮件服务；公共 UserService(UserRepository userRepository, EmailService emailService) { this.userRepository = userRepository; this.emailService = emailService; } } // 不好 - 字段注入 @服务公共类用户服务{ @Autowired 私有 UserRepository 用户存储库； } ### 2\.使用 DTO 进行 API 请求/响应不要直接通过 REST API 公开实体。 // 数据传输对象公共类 UserDTO { 私人长ID；私人字符串电子邮件；私有字符串名称； // 没有暴露密码字段 // 获取器和设置器 } // 映射器 @组件公共类用户映射器{ 公共 UserDTO toDTO（用户用户）{ UserDTO dto = new UserDTO(); dto.setId(user.getId()); dto.setEmail(user.getEmail()); dto.setName(user.getName()); 返回 dto； } 公共用户 toEntity(UserDTO dto) { 用户用户=新用户(); user.setEmail(dto.getEmail()); user.setName(dto.getName()); 返回用户； } } // 控制器 @RestController @RequestMapping("/api/users") 公共类用户控制器{ 私有最终 UserService userService；私有最终 UserMapper userMapper； @GetMapping("/{id}") 公共 ResponseEntity getUser(@PathVariable Long id) { 返回 userService.findById(id) .map(userMapper::toDTO) .map(ResponseEntity::ok) .orElse(ResponseEntity.notFound().build()); } } ### 3\.使用验证始终验证输入数据。 // 带有验证的实体 @实体公共类用户{ @NotBlank(message = "电子邮件为必填项") @Email(message = "电子邮件应该有效") 私人字符串电子邮件； @NotBlank(message = "姓名为必填项") @Size(min = 2, max = 100, message = "名称必须介于 2 到 100 个字符之间") 私有字符串名称； @NotBlank(message = "需要密码") @Size(min = 8, message = "密码必须至少为 8 个字符") 私有字符串密码； } // 控制器 @PostMapping 公共 ResponseEntity createUser(@Valid @RequestBody User 用户) { // 验证自动发生返回 ResponseEntity.ok(userService.save(user)); } ### 4\.正确使用交易使用适当的事务设置标记服务方法。 @服务 @事务性公共类 OrderService { @Transactional(只读 = true) 公共列表 <订单> findAll() { 返回 orderRepository.findAll(); } @事务性公共订单createOrder（订单订单）{ // 一个事务中的多个数据库操作订单已保存 = orderRepository.save(order); inventoryService.decreaseStock(order.getItems()); emailService.sendOrderConfirmation（已保存）；返回已保存； } } ### 5\.使用分页始终对大型数据集进行分页。 @GetMapping 公共页面<产品> getProducts( @RequestParam(defaultValue = "0") int 页， @RequestParam(defaultValue = "20") int 大小， @RequestParam(defaultValue = "id") 字符串 sortBy) { 可分页可分页 = PageRequest.of(页面, 大小, Sort.by(sortBy)); 返回productService.findAll(可分页); } ### 6\.全局处理异常使用“@RestControllerAdvice”进行集中异常处理。 @RestControllerAdvice 公共类 GlobalExceptionHandler { @ExceptionHandler(ResourceNotFoundException.class) 公共 ResponseEntity handleNotFound(ResourceNotFoundException ex) { 返回 ResponseEntity.status(HttpStatus.NOT_FOUND) .body(new ErrorResponse(例如.getMessage())); } } ### 7\.使用日志记录在整个应用程序中实施适当的日志记录。 @服务公共类用户服务{ 私有静态最终 Logger logger = LoggerFactory.getLogger(UserService.class); 公共用户createUser（用户用户）{ logger.info("使用电子邮件创建用户：{}", user.getEmail()); 尝试{ 用户已保存 = userRepository.save(user); logger.info("用户创建成功，id: {}", saving.getId()); 返回已保存； } catch (异常 e) { logger.error("创建用户时出错：{}", e.getMessage(), e); 扔 e； } } } ### 8\.保护您的端点实施适当的身份验证和授权。 @配置 @EnableWebSecurity 公共类安全配置{ @豆子 public SecurityFilterChain filterChain(HttpSecurity http) 抛出异常 { http .authorizeHttpRequests(身份验证->身份验证 .requestMatchers("/api/public/**").permitAll() .requestMatchers("/api/admin/**").hasRole("ADMIN") .anyRequest().authenticated() ） .oauth2ResourceServer().jwt(); 返回 http.build(); } } ### 9\.使用数据库迁移使用 Flyway 或 Liquibase 进行数据库版本控制。 -- V1__Create_users_table.sql 创建表用户（ id BIGSERIAL 主键，电子邮件 VARCHAR(255) NOT NULL UNIQUE, 名称 VARCHAR(255) NOT NULL, 创建时间时间戳不为空）； -- V2__Add_password_column.sql ALTER TABLE 用户 ADD COLUMN 密码 VARCHAR(255); ### 10\.监控您的应用程序使用 Spring Boot Actuator 进行监控。 # 应用程序. 属性 management.endpoints.web.exposure.include=健康状况、信息、指标 management.endpoint.health.show-details=始终 ## 示例请参阅 EXAMPLES.md 了解详细的代码示例，包括： * 基本的Spring Boot应用程序 * 具有 CRUD 操作的 REST API * 与 JPA 的数据库集成 * 自定义查询和规范 * 请求验证 * 异常处理 * 使用 JWT 进行身份验证 * 基于角色的授权 * 文件上传/下载 * 使用Redis进行缓存 * 异步处理 * 计划任务 * 多数据库配置 * 执行器和监控 * Docker部署 ## 总结此 Spring Boot 开发技能涵盖： 1. **自动配置** ：根据依赖关系自动配置 2. **依赖注入**：IoC容器、构造函数注入、组件构造型 3. **REST API**：控制器、请求映射、响应处理 4. **Spring Data JPA**：实体、存储库、关系、查询 5. **配置**：属性、YAML、配置文件、自定义属性 6. **安全**：身份验证、授权、JWT、基于角色的访问 7. **异常处理**：全局异常处理、自定义异常 8. **测试**：单元测试、集成测试、MockMvc 9. **最佳实践**：DTO、验证、事务、分页、日志记录 10. **生产就绪**：执行器、监控、数据库迁移、部署这些模式和示例基于官方 Spring Boot 文档（信任评分：7.5），代表现代企业 Java 开发实践。

Spring Boot开发

包含技能