Spring系列框架常用注解详解

金州小铁匠

已于 2025-02-24 23:12:15 修改

阅读量823

点赞数 17

文章标签： spring java 后端

于 2025-02-11 23:44:13 首次发布

本文链接：https://blog.youkuaiyun.com/weixin_44343004/article/details/145582123

版权

Spring系列框架常用注解详解（Spring/Spring Boot/Spring Cloud）

一、Spring核心注解

1. @Component

作用：标记类为Spring组件，会被自动扫描到IoC容器
适用场景：通用组件类

@Component
public class UserService {
    // 业务逻辑
}

常见异常：
NoSuchBeanDefinitionException（未扫描到组件）
处理：检查包路径是否在@ComponentScan范围内

2. @Autowired

作用：自动注入依赖
适用场景：需要依赖注入的字段/构造器/方法

@Service
public class OrderService {
    @Autowired
    private UserService userService;
}

常见异常：
NoSuchBeanDefinitionException（未找到对应Bean）
NoUniqueBeanDefinitionException（存在多个同类型Bean）
处理：结合@Qualifier指定Bean名称

3. @Controller/@Service/@Repository

作用：组件分类注解（语义化标记）

@Controller：Web层组件
@Service：业务层组件
@Repository：数据访问层组件

@Controller
public class UserController {
    // 处理HTTP请求
}

4. @Configuration + @Bean

作用：声明配置类和Bean定义
适用场景：第三方库集成、复杂对象创建

@Configuration
public class AppConfig {
    @Bean
    public DataSource dataSource() {
        return new HikariDataSource();
    }
}

常见问题：
Bean名称冲突（默认使用方法名作为Bean名称）

二、Spring Boot核心注解

1. @SpringBootApplication

作用：启动类注解（组合注解，包含@Configuration、@ComponentScan等）

@SpringBootApplication
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

2. @RestController

作用：组合@Controller和@ResponseBody，直接返回JSON

@RestController
@RequestMapping("/api/users")
public class UserController {
    @GetMapping("/{id}")
    public User getUser(@PathVariable Long id) {
        return userService.findUser(id);
    }
}

3. @Value

作用：注入配置文件中的值
application.properties：

app.max-size=100

使用示例：

@Service
public class FileService {
    @Value("${app.max-size}")
    private int maxSize;
}

常见问题：
IllegalArgumentException（值不存在或类型不匹配）
处理：添加默认值：@Value("${app.max-size:50}")

三、Spring Cloud常用注解

1. @EnableEurekaServer

作用：启用Eureka注册中心

@SpringBootApplication
@EnableEurekaServer
public class EurekaServerApplication {
    public static void main(String[] args) {
        SpringApplication.run(EurekaServerApplication.class, args);
    }
}

2. @EnableDiscoveryClient

作用：启用服务发现（注册到注册中心）

@SpringBootApplication
@EnableDiscoveryClient
public class UserServiceApplication {
    public static void main(String[] args) {
        SpringApplication.run(UserServiceApplication.class, args);
    }
}

3. @FeignClient

作用：声明Feign客户端（服务间调用）

@FeignClient(name = "order-service")
public interface OrderClient {
    @GetMapping("/orders/{userId}")
    List<Order> getOrders(@PathVariable Long userId);
}