@PostConstruct 注解详解

目录

• 一、作用
• 二、使用条件
• 三、Spring 框架中的执行时机
• 五、示例代码说明
  • 配置类 AppConfig
  • MyBean 类
  • 执行结果
• 五、实际项目中的应用

一、作用

@PostConstruct注解主要用于指定某个方法在对象完成实例化且所有依赖注入操作结束后、正式投入使用前执行。利用这一特性，开发者能在对象初始化的关键阶段，执行资源初始化、数据加载等必要操作，确保对象在使用时处于完备且可用状态。

二、使用条件

1. 方法限制：被@PostConstruct注解修饰的方法，既不能有任何参数传入，返回值类型也必须设定为void。
2. 方法访问权限：该方法的访问权限不限，public、protected、private等修饰符均可使用。
3. 类的要求：此注解仅适用于实例方法，静态方法与构造函数无法使用。

三、Spring 框架中的执行时机

在 Spring 框架管理 Bean 生命周期的过程中，@PostConstruct注解遵循如下执行顺序：

1. 实例化 Bean：Spring 容器依据配置信息，通过反射机制调用构造函数，创建 Bean 实例。
2. 填充属性：Bean 实例创建完成后，Spring 容器将该 Bean 所依赖的其他 Bean，按配置规则注入到当前 Bean 中，注入方式涵盖构造函数注入、Setter 方法注入等。
3. 调用@PostConstruct方法：若 Bean 中存在被@PostConstruct注解修饰的方法，在属性填充流程结束后，Spring 容器会自动调用该方法。
4. Bean 可用：当@PostConstruct方法执行完毕，Bean 便进入就绪状态，可被应用程序的其他组件调用。

五、示例代码说明

配置类 AppConfig

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class AppConfig {
    @Bean
    public MyBean myBean() {
        MyBean bean = new MyBean();
        bean.setMessage("Hello, Spring!");
        return bean;
    }
}

该配置类通过@Configuration注解标记为配置类，借助@Bean注解定义了一个名为myBean的 Bean，并在方法内部实例化MyBean对象，同时调用setMessage方法为其注入属性值。

MyBean 类

import javax.annotation.PostConstruct;
import org.springframework.stereotype.Component;

public class MyBean {
    private String message;

    // 构造函数
    public MyBean() {
        System.out.println("MyBean实例被创建");
    }

    // Setter方法用于依赖注入
    public void setMessage(String message) {
        this.message = message;
        System.out.println("MyBean的message属性被注入：" + message);
    }

    // 被@PostConstruct注解修饰的方法
    @PostConstruct
    public void init() {
        System.out.println("MyBean的@PostConstruct方法被调用");
        // 可以在这里进行一些初始化操作
    }

    // 业务方法
    public void doSomething() {
        System.out.println("MyBean执行业务方法：" + message);
    }
}

MyBean类包含构造函数、用于依赖注入的 Setter 方法、被@PostConstruct注解修饰的init方法以及业务方法doSomething。构造函数在 Bean 实例化时执行，Setter 方法在属性注入阶段执行，init方法在依赖注入完成后执行，doSomething方法用于展示 Bean 投入使用后的业务逻辑。

执行结果

当 Spring 容器启动并创建MyBean实例时，控制台输出顺序如下：

MyBean实例被创建
MyBean的message属性被注入：Hello, Spring!
MyBean的@PostConstruct方法被调用

这清晰地表明@PostConstruct方法确实在对象实例化与依赖注入完成之后执行，符合其在 Spring Bean 生命周期中的既定执行顺序。

五、实际项目中的应用

缓存预热：在电商项目中，为了提高商品详情页面的访问速度，使用了缓存机制。ProductCacheService类负责管理商品信息的缓存。通过@PostConstruct注解，在该类的warmUpCache方法上进行标注，使其在应用启动时执行。该方法会从数据库中读取热门商品数据，并预先加载到缓存中，这样用户访问商品详情时就能更快地获取数据。

import javax.annotation.PostConstruct;
import org.springframework.stereotype.Service;
import org.springframework.data.redis.core.RedisTemplate;
import org.springframework.beans.factory.annotation.Autowired;

@Service
public class ProductCacheService {
    @Autowired
    private RedisTemplate<String, Object> redisTemplate;

    @PostConstruct
    public void warmUpCache() {
        // 假设从数据库获取热门商品ID列表
        String[] popularProductIds = {"1", "2", "3"};
        for (String id : popularProductIds) {
            // 从数据库读取商品信息（这里省略具体实现）
            Object product = getProductFromDB(id);
            redisTemplate.opsForValue().set("product:" + id, product);
        }
    }

    private Object getProductFromDB(String id) {
        // 实际从数据库查询商品信息逻辑
        return null;
    }
}

资源文件加载：在一个多语言支持的应用中，LanguageResourceService类负责加载不同语言的资源文件。通过@PostConstruct注解修饰loadLanguageResources方法，在应用启动时自动加载所有需要的语言资源文件。这样，当用户切换语言时，系统能快速从已加载的资源中获取对应语言的文本信息。

import javax.annotation.PostConstruct;
import org.springframework.stereotype.Service;
import java.util.Properties;
import java.io.IOException;
import java.io.InputStream;

@Service
public class LanguageResourceService {
    private Properties enProperties;
    private Properties zhProperties;

    @PostConstruct
    public void loadLanguageResources() {
        enProperties = new Properties();
        zhProperties = new Properties();
        try (InputStream enStream = getClass().getResourceAsStream("/lang/en.properties");
             InputStream zhStream = getClass().getResourceAsStream("/lang/zh.properties")) {
            enProperties.load(enStream);
            zhProperties.load(zhStream);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }

    // 根据语言代码获取对应资源的方法（省略具体实现）
}