Spring使用（一）注解

Spring使用

资源

Spring 框架内部使用 Resource 接口作为所有资源的抽象和访问接口，在上一篇文章的示例代码中的配置文件是通过ClassPathResource 进行封装的，ClassPathResource 是 Resource 的一个特定类型的实现，代表的是位于 classpath 中的资源。

对不同来源的资源文件 Spring 都提供了相应的实现：文件（FileSystemResource ）、ClassPath资源（ClassPathResource）、URL资源（UrlResource）、InputStream资源（InputStreamResource）、ByteArray资源（ByteArrayResource）等。

注解

宏观：

①Service

@Service 注解是用来声明服务层(Service Layer)组件，通常包含业务逻辑，作为数据访问层(Data Access Layer)和控制器(Controller Layer)之间的桥梁。

• 它是一个立即加载的注解，这意味着当 Spring 应用程序启动时，Spring 容器就会创建标注了 @Service 的类的实例。
• @Service 是一个特殊类型的 @Component 注解。它允许自动检测通过类路径扫描，为其创建 Bean 定义并注册到 Spring 容器中。
• 它有助于区分 Spring 组件的表示层(Controller)、服务层(Service)和数据访问层(Repository)。

②Controller

用于标记一个类作为 Spring MVC 控制器组件。控制器负责处理由 DispatcherServlet 分发的来自浏览器或其他客户端的 HTTP 请求。这个注解会将类识别为一个 Bean，并注册到 Spring 应用上下文中。

• 通常与 @RequestMapping 或其他基于 HTTP 方法的注解(@GetMapping, @PostMapping, @PutMapping, @DeleteMapping, @PatchMapping)配合使用，以定义访问该控制器方法的 URL 模式和请求类型。
• 允许通过依赖注入引入其他层级的服务或组件，比如服务层 (@Service) 或数据访问层 (@Repository)。
• 与视图技术（如 Thymeleaf、JSP 等）协同工作，可以返回 String 类型的视图名，由视图解析器进一步处理。
• 当使用 Spring Boot 和 RESTful Web 服务时，通常会结合 @RestController 注解来使用，它是 @Controller 和 @ResponseBody 的组合体，这意味着控制器的所有响应默认都会转换成 JSON 或 XML 格式返回给客户端。

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.ui.Model;@Controller
public class MyController {@RequestMapping("/greet")public String greet(Model model) {model.addAttribute("message", "Hello, World!");return "greeting"; // 返回视图名称，通常是一个 HTML 页面}
}

③Repository

用于标识持久层组件（如DAO组件）的特殊化 @Component 注解。当你在类上使用 @Repository 注解时，它会告知 Spring 容器该类是一个 Bean，并且用于封装数据访问异常，将底层数据访问技术抛出的异常转换为 Spring 的 DataAccessException。

// 告诉Spring，让Spring创建一个名字叫“userDao”的UserDaoImpl实例。
@Repository(value="userDao")
public class UserDaoImpl extends BaseDaoImpl<User> {
………
}// 注入userDao，从数据库中根据用户Id取出指定用户时需要用到
@Resource(name = "userDao")
private BaseDao<User> userDao;

④Configuration

@Configuration 是表明某个类是用来作为 bean 定义的源的。被 @Configuration 注解的类通常包含了一个或多个标记有 @Bean 注解的方法。Spring 容器会在运行时自动调用这些方法，将返回对象注册为容器中的 bean。

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;@Configuration
public class AppConfig {@Beanpublic MyService myService() {return new MyServiceImpl();}
}
// AppConfig 类被标注为 @Configuration，这意味着它可以包含 bean 定义。myService 方法上的 @Bean 注解告诉 Spring，这个方法将返回一个对象，该对象需要被注册为应用程序上下文中的一个 bean。默认情况下，bean 的名称与方法名相同，但可以通过 @Bean 注解的 name 属性来自定义。// 这种配置方式实现了代码的模块化，并且取代了传统的 XML 配置文件，使得配置更加清晰和类型安全

⑤Resource

• @Resource 默认按照 by-name 自动装配，即根据 bean 的名称进行匹配；如果没有找到与名称匹配的 bean，则会退回到 by-type 自动装配（首先尝试依据属性名作为 bean 名称查找，如果失败则按类型装配）。而 @Autowired 默认按照 by-type 自动装配。
• @Resource 所标注的自动装配过程是在 bean 属性设置完成之后、初始化方法（如 @PostConstruct 注解的方法）之前进行的，而 @Autowired 则是在构造器、字段、setter 方法或其他任意带有参数的方法上使用。

import javax.annotation.Resource;
@Component
public class MyComponent {// By name@Resource(name = "myBean")private MyBean myBeanByName;// By type (当存在多个相同类型的 bean 时，可能需要指定 name 来避免冲突)@Resourceprivate MyBean myBeanByType;public void doSomething() {// 使用 myBeanByName 和 myBeanByType 完成一些操作...}
}
// @Resource 注解有两个重要的属性：name 和 type：
name: 指定要注入的 bean 的名称。
type: 指定要注入的 bean 的类型。

微观

① Async：将方法标注为异步执行

在一个普通的方法或者类中调用了由 @Async 注解标记的方法，那么当前线程会立即返回，而实际执行的过程会在另外的线程中进行，当前线程将继续执行自身的任务。

@Service
public class MyService {@Autowiredprivate EmailService emailService;@Asyncpublic void sendEmails(List<String> recipients, String content) {for (String recipient : recipients) {emailService.sendEmail(recipient, content);}System.out.println("All emails sent!");}
}

②Autowired：自动装配依赖的 bean。

@Autowired 注解是 Spring Framework 中的一个依赖注入注解，它可以自动将容器中已经创建好的 bean 对象装配到需要他们的类或者方法中。默认先按byType进行匹配，如果发现找到多个bean，则又按照byName方式进行匹配，如果还有多个，则报出异常

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Component;@Component
public class MyComponent {private final Dependency dependency;// 构造器注入，如果容器中不存在Dependency类型的Bean，应用将无法启动@Autowired(required = true)public MyComponent(Dependency dependency) {this.dependency = dependency;}// 如果容器中不存在OptionalDependency类型的Bean，则dependency字段将为null，但应用依旧会启动@Autowired(required = false)private OptionalDependency optionalDependency;
}

③Bean：声明一个需要被 Spring 管理的 bean

@Configuration // 添加了 @Configuration 注解来标识这是一个配置类，因此 Spring 容器在扫描时会识别并加载该类。
public class MyConfiguration {@Beanpublic UserDao userDao() {return new JdbcUserDao(dataSource());}@@Bean(“myBean”) // 这样可以在装配其他依赖项时方便地引用该 bean 对象。public DataSource dataSource() {// 创建并配置数据源对象return new HikariDataSource(config);}
}

在上面的代码中，我们定义了一个配置类 MyConfiguration，并在其中定义了两个 bean 对象：userDao() 和 dataSource()。其中 userDao() 方法返回 JdbcUserDao 对象，而 dataSource() 方法返回一个 Hikari 数据源对象。这两个方法都标记了 @Bean 注解，这意味着它们会被 Spring 容器扫描到并将创建的对象注册到容器中。

④Cacheable：增加缓存支持

@Cacheable 是 Spring Framework 中的一个注解，用于实现方法级别的缓存。使用 @Cacheable 注解的方法在调用时，将会检查缓存中是否存在与该方法所需参数相对应的缓存项。如果存在，则直接返回缓存结果，不再执行被注解的方法；如果不存在，则执行该方法，并将方法的返回结果添加到缓存中。

@Service
public class UserService {private final UserMapper userMapper;public UserService(UserMapper userMapper) {this.userMapper = userMapper;}@Cacheable(value = "users", key = "#userId")public User getUserById(int userId) {return userMapper.getUserById(userId);}}

⑤ Conditional

Conditional用于根据特定条件动态决定是否创建某个 Bean 实例，Spring 还提供了一些预定义的条件注解，如 @Profile、@ConditionalOnMissingClass、@ConditionalOnProperty 等，它们可以方便地满足一些常见的判断场景，减少了编写自定义条件类的工作量。

@Configuration
public class MyConfiguration {@Bean@Conditional(MyCondition.class)public MyBean myBean() {return new MyBean();}
}public class MyCondition implements Condition {@Overridepublic boolean matches(ConditionContext context, AnnotatedTypeMetadata metadata) {// TODO: 自定义条件判断逻辑return true; // 当结果为 true 时，表示条件成立，按照要求创建 Bean；否则，则不会创建这个 Bean。}
}

使用 @Profile 注解可以确保只有相关的 beans 在特定的环境配置下被创建，这样可以避免在不适合的环境中运行可能引起冲突或异常的 beans，并有助于维护清晰的环境特定配置。
@Profile("development")
@Profile("production")根据设置系统属性: -Dspring.profiles.active=development
或者使用环境变量设置 SPRING_PROFILES_ACTIVE=development等来切换profile

⑥ConstructorBinding

用于表示在使用基于构造器的依赖注入时，应该将配置属性绑定到构造器参数上

import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.boot.context.properties.ConstructorBinding;@ConstructorBinding
@ConfigurationProperties(prefix = "app") //指定哪个前缀的配置属性应被绑定到该类的字段上,Spring Boot 将会查找 app.name 和 app.threadPoolSize 配置项，并通过构造器自动注入相应的值。
public class AppConfigProperties {private final String name;private final int threadPoolSize;public AppConfigProperties(String name, int threadPoolSize) {this.name = name;this.threadPoolSize = threadPoolSize;}// Getters for the fieldspublic String getName() {return name;}public int getThreadPoolSize() {return threadPoolSize;}
}

⑦ControllerAdvice

@ControllerAdvice 是 Spring MVC 框架中的注解，用于定义一个全局性的异常处理器类。可以对 Controller 层面和全局异常进行统一的处理。

@ControllerAdvice
public class GlobalExceptionHandler {@ExceptionHandler({NullPointerException.class, IllegalArgumentException.class}) //当捕获到空指针异常或者非法参数异常时，会执行这个方法，将异常信息添加到 request 中，并返回 “error” 视图。public String handleException(Exception e, HttpServletRequest request) {request.setAttribute("error", e);return "error";}
}

⑧CrossOrigin

同源策略阻止一个域下的文档或脚本与另一个域下的资源进行交互。这有助于保护用户免受恶意网站的攻击，但也限制了合法的跨源请求。

例如，如果你的页面在 https://www.example.com 上运行，而尝试通过 AJAX 请求从 https://api.another-site.com 获取数据，这将被默认视为跨域请求，并可能遭到浏览器的阻止，除非目标服务器明确允许来自原始域的请求。

@RestController
@RequestMapping("/api")
public class ApiController {@CrossOrigin(origins = "http://localhost:8080")@GetMapping("/users/{id}")public User getUserById(@PathVariable Long id) {// ...}
}

⑨EnableAsync

在处理一些 IO 密集型操作时，非常有用

@Configuration
@EnableAsync // @EnableAsync 注解需要与异步方法搭配使用，异步方法需要用 @Async 标记。
public class AppConfig {@Beanpublic Executor taskExecutor() {ThreadPoolTaskExecutor executor = new ThreadPoolTaskExecutor();executor.setCorePoolSize(10);executor.setMaxPoolSize(20);executor.setQueueCapacity(30);executor.initialize();return executor;}
}

⑩RequestMapping

@RequestMapping 的专门化版本提供了更简洁的语法。这些包括 @GetMapping, @PostMapping, @PutMapping, @DeleteMapping, @PatchMapping。每个都对应于一个 HTTP 方法，使得代码更加简洁易读。

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.ResponseBody;@Controller
@RequestMapping("/api")
public class MyController {@GetMapping("/hello") // 等同于 @RequestMapping(value = "/hello", method = GET)@ResponseBodypublic String helloWorld() {return "Hello, World!";}@PostMapping("/submit") // 等同于 @RequestMapping(value = "/submit", method = POST)@ResponseBodypublic String submitForm() {// 方法实现return "Form submitted";}
}

其他

①lazy

@Lazy 是 Spring 框架中的注解之一，它用于控制 Bean 的实例化时间。通过在容器中标记一个 Bean 为 @Lazy，可以让 Spring 容器在第一次使用这个 Bean 时再进行实例化。相对应的，如果不加 @Lazy 注解，则默认情况下 Spring 容器会在启动时就实例化该 Bean。

@Service
@Lazy // 使用 @Lazy 注解，Spring 容器将在第一次使用 UserService 的实例时才进行实例化而不是在启动时就实例化
public class UserService {// ...
}

②Import

允许我们在一个配置类中引入其他配置类或普通的 Java 类

@Configuration
@Import({DataSourceConfig.class, RedisConfig.class, ServiceUtils.class})
public class AppConfig {// ...
}
// 在创建 Spring ApplicationContext 时，这三个配置类都会被加载并注册为 Spring 的 bean。
// 可以在 AppConfig 中使用 ServiceUtils 类中的方法或属性

③元注解

• @Target：指定注解可以应用于 Java 的哪些元素（如类、方法、字段等）。
• @Retention：指定注解在什么级别可用（源码、类文件或运行时）。
• @Documented：指定注解是否应该被 javadoc 工具记录。
• @Inherited：指定注解是否可以被子类继承。
• @Component：Spring 特有的元注解，用于声明一个类是 Spring 组件。其它注解如 @Service, @Repository, @Controller 都是用 @Component 注解的例子。

④Valid

在控制器方法的参数列表中使用 @Valid （ @NotNull、@Min、@Max、@Size、@Email…）注解来实现请求参数的校验。

@RestController
@RequestMapping("/users")
public class UserController {@PostMappingpublic User createUser(@Valid @RequestBody User user) {// 保存用户信息到数据库}// ...
}// 校验的规则通常定义在 User 类的属性上
public class User {@NotBlankprivate String username;@Pattern(regexp = "^[a-zA-Z0-9]+@[a-zA-Z0-9]+\\.[a-zA-Z]{2,}$", message = "Email 格式错误")private String email;
}

第三方

1. @Data

   @Data注解是Lombok库的一部分，非Spring框架本身的一部分。当你在一个类上使用@Data注解，Lombok会自动生成以下代码：

   • 所有字段的getter方法
   • 所有非最终字段的setter方法
   • toString()方法
   • equals()和hashCode()方法
   • 一个包含所有非静态、非瞬态字段的构造函数

   这大大减少了样板代码的数量，使得类的定义更加简洁

2. @Mapper

   @Mapper注解是MyBatis框架的一部分，它主要用于标记一个接口作为数据库操作的映射接口。MyBatis通过这个接口关联XML配置文件或者注解中定义的数据库操作。

   @Mapper
   public interface UserMapper {User selectUserById(Long id);
   }// 在Spring Boot项目中，通常还会配合使用@MapperScan注解来指定需要扫描的@Mapper接口所在的包路径。
   @SpringBootApplication
   @MapperScan("com.example.project.mapper")
   public class Application {public static void main(String[] args) {SpringApplication.run(Application.class, args);}
   }