【java】springboot注解关键字

@Value

@Value 是 Spring Boot 中用于注入外部配置的注解，它允许你将配置文件（如 application.properties 或 application.yml）中的值注入到 Bean 的字段、方法参数或构造函数参数中。这个注解是实现外部化配置的核心工具之一，有助于将代码与配置解耦。

@Service
public class MyService {
    @Value("${app.name}")
    private String appName;  // 从配置文件中读取 app.name 的值
    
    @Value("${server.port}")
    private int serverPort;  // 自动转换为 int 类型
    
    // 使用默认值（如果配置文件中未定义）
    @Value("${app.timeout:3000}")
    private long timeout;  // 如果 app.timeout 未定义，则使用 3000
}

@Service

在 Spring Boot 中，@Service 是一个重要的注解，它用于标记一个类作为业务逻辑层（Service Layer）的组件。这个注解是 Spring 框架的核心注解之一，属于 @Component 的特殊化形式，用于表示该类是一个服务组件。
核心作用
声明组件：告诉 Spring 这个类是一个服务组件，应该被自动扫描并注册为 Spring Bean。
业务逻辑封装：作为业务逻辑层，处理业务规则、事务管理、数据处理等核心功能。
依赖注入：允许其他组件（如 Controller）通过依赖注入使用该服务。

package com.example.productplatform.service;

import com.example.productplatform.entity.Product;
import com.example.productplatform.repository.ProductRepository;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
import org.springframework.transaction.annotation.Transactional;

import java.util.List;

@Service  // 声明为服务组件
@Transactional  // 开启事务管理（可选）
public class ProductService {
    
    private final ProductRepository productRepository;
    
    @Autowired  // 构造函数注入（推荐）
    public ProductService(ProductRepository productRepository) {
        this.productRepository = productRepository;
    }
    
    // 业务逻辑方法
    public List<Product> getAllProducts() {
        return productRepository.findAll();
    }
    
    public Product getProductById(Long id) {
        return productRepository.findById(id)
               .orElseThrow(() -> new IllegalArgumentException("Product not found"));
    }
    
    public Product saveProduct(Product product) {
        return productRepository.save(product);
    }
    
    public void deleteProduct(Long id) {
        productRepository.deleteById(id);
    }
}

@Repository

在 Spring Boot 中，@Repository 是一个关键注解，用于标记数据访问层（DAO，Data Access Object）的组件。它是 Spring 框架的核心注解之一，属于 @Component 的特殊化形式，专门用于数据库访问类。
核心作用
声明组件：告诉 Spring 这个类是一个数据访问组件，应被自动扫描并注册为 Spring Bean。
数据访问封装：作为数据访问层，处理与数据库的交互（如查询、插入、更新等）。
异常转换：自动将特定的数据库异常（如 SQL 异常）转换为 Spring 的 DataAccessException 体系，提供更统一的异常处理。

package com.example.productplatform.repository;

import com.example.productplatform.entity.Product;
import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.stereotype.Repository;

import java.util.List;

@Repository  // 声明为数据访问组件
public interface ProductRepository extends JpaRepository<Product, Long> {
    // Spring Data JPA 会自动实现基本的 CRUD 方法
    
    // 自定义查询方法（根据方法名自动生成 SQL）
    List<Product> findByNameContaining(String name);
    
    // 使用 @Query 注解定义复杂查询
    @Query("SELECT p FROM Product p WHERE p.price > :minPrice")
    List<Product> findByPriceGreaterThan(double minPrice);
}

配合 @Query注解，实现复杂查询。
注解原理
@Repository 是 @Component 的派生注解，具有相同的功能。
Spring 会在启动时扫描带有 @Repository 的类，并将它们注册为单例 Bean。
当使用 Spring Data JPA 时，接口会被自动代理实现，无需手动编写实现类。

@Configuration

在 Spring Boot 中，@Configuration 是一个核心注解，用于定义配置类。它允许你使用 Java 代码替代传统的 XML 配置文件，通过 Bean 方法来定义和组织应用组件。这个注解是 Spring 框架中基于 Java 的配置方式的基础。
核心作用
声明配置类：告诉 Spring 这个类是一个配置类，类似于 XML 中的 标签。
定义 Bean：通过 @Bean 注解在方法上定义应用所需的组件。
管理 Bean 依赖：在配置类中可以注入其他 Bean，定义它们之间的依赖关系。
支持组件扫描：通常与 @ComponentScan 配合，自动发现和注册组件。

package com.example.productplatform.config;

import com.example.productplatform.service.MyService;
import com.example.productplatform.service.MyServiceImpl;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration  // 声明为配置类
public class AppConfig {
    
    @Bean  // 定义一个 Bean
    public MyService myService() {
        return new MyServiceImpl();  // 返回 Bean 实例
    }
    
    @Bean
    public AnotherBean anotherBean() {
        // Bean 方法可以依赖其他 Bean
        return new AnotherBean(myService());
    }
}

@Controller

在 Spring Boot 中，@Controller 是一个核心注解，用于标记一个类作为 Web 控制器组件。它是 Spring MVC 框架的基础，负责处理 HTTP 请求并返回响应，是客户端与服务端交互的入口点。
核心作用
声明控制器：告诉 Spring 这个类是一个控制器组件，应被自动扫描并注册为 Spring Bean。
处理 HTTP 请求：通过 @RequestMapping 或其派生注解（如 @GetMapping、@PostMapping）映射 HTTP 请求到具体方法。
请求参数解析：自动解析请求参数、路径变量、请求体等数据。
视图渲染或 RESTful 响应：支持返回视图名称（用于页面渲染）或直接返回数据（RESTful API）。

package com.example.productplatform.controller;

import com.example.productplatform.entity.Product;
import com.example.productplatform.service.ProductService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.*;

@Controller  // 声明为控制器
@RequestMapping("/products")  // 根路径
public class ProductController {
    
    private final ProductService productService;
    
    @Autowired  // 构造函数注入
    public ProductController(ProductService productService) {
        this.productService = productService;
    }
    
    // 处理 GET 请求：/products
    @GetMapping
    public String listProducts(Model model) {
        model.addAttribute("products", productService.getAllProducts());
        return "product-list";  // 返回视图名称
    }
    
    // 处理 GET 请求：/products/{id}
    @GetMapping("/{id}")
    public String getProduct(@PathVariable Long id, Model model) {
        model.addAttribute("product", productService.getProductById(id));
        return "product-detail";  // 返回视图名称
    }
    
    // 处理 POST 请求：/products
    @PostMapping
    public String addProduct(@ModelAttribute Product product) {
        productService.saveProduct(product);
        return "redirect:/products";  // 重定向
    }
}

注解原理
@Controller 是 @Component 的派生注解，具有相同的功能。
Spring 会在启动时扫描带有 @Controller 的类，并将它们注册为单例 Bean。
控制器中的方法通过 @RequestMapping 或其派生注解映射到 HTTP 请求路径。

@Component

在 Spring Boot 中，@Component 是一个基础注解，用于标记一个类作为 Spring 容器管理的组件。它是所有组件注解（如 @Service、@Repository、@Controller）的父注解，主要用于自动扫描和注册 Bean。
核心作用
声明组件：告诉 Spring 这个类是一个组件，应被自动扫描并注册为 Spring Bean。
组件扫描：配合 @ComponentScan 或 @SpringBootApplication（默认包含 @ComponentScan），Spring 会自动发现并注册所有带有 @Component 或其派生注解的类。
依赖注入：允许其他组件通过依赖注入使用该组件。

package com.example.productplatform.component;

import org.springframework.stereotype.Component;

@Component  // 声明为 Spring 组件
public class MyComponent {
    
    public String doSomething() {
        return "Component is working!";
    }
}

最佳实践
组件单一职责：每个组件专注于特定功能。
避免过度使用：优先使用 @Service、@Repository、@Controller 等语义化注解，仅在没有更合适的注解时使用 @Component。
组件扫描路径：确保组件位于 @ComponentScan 指定的包路径下（默认是主应用类所在包及其子包）。
依赖注入方式：优先使用构造函数注入，提高代码可测试性。