Spring 通过 factory-method 实例化 Bean 详解

Spring 通过 factory-method 实例化 Bean 详解一、为什么需要 factory-method默认情况下Spring 通过反射调用类的无参构造方法来创建 Bean。但有些类不适合这样做单例类构造方法私有只能通过静态方法获取实例如Calendar.getInstance()工厂类对象创建逻辑复杂由专门的工厂方法负责如DriverManager.getConnection()第三方类没有公开的构造方法只能通过静态工厂方法创建需要统一控制的类如连接池、线程池等创建过程需要特殊处理factory-method属性就是让 Spring 调用指定的工厂方法来创建 Bean而不是调用构造方法。二、静态工厂方法静态工厂方法是指类中定义的static方法通过类名直接调用不需要实例化工厂类。2.1 Java 类publicclassCarFactory{// 静态工厂方法publicstaticCarcreateCar(){CarcarnewCar();car.setBrand(宝马);car.setPrice(30.0);returncar;}// 带参数的静态工厂方法publicstaticCarcreateCar(Stringbrand,doubleprice){CarcarnewCar();car.setBrand(brand);car.setPrice(price);returncar;}}publicclassCar{privateStringbrand;privatedoubleprice;// getter/setter/toString}2.2 XML 配置!-- 无参静态工厂方法 --beanidcarclasscom.example.CarFactoryfactory-methodcreateCar/!-- 带参静态工厂方法 --beanidcar2classcom.example.CarFactoryfactory-methodcreateCarconstructor-argnamebrandvalue奔驰/constructor-argnamepricevalue45.0//bean关键点class属性指向工厂类不是目标类factory-method指定静态工厂方法名方法参数用constructor-arg传入注意这里虽然叫 constructor-arg但实际是传给工厂方法的参数2.3 调用验证ApplicationContextcontextnewClassPathXmlApplicationContext(beans.xml);Carcarcontext.getBean(car,Car.class);System.out.println(car);// Car{brand宝马, price30.0}三、实例工厂方法实例工厂方法是指工厂类本身也需要被 Spring 管理通过工厂实例调用非静态方法创建目标对象。3.1 Java 类publicclassCarFactory{privateStringdefaultBrand;publicvoidsetDefaultBrand(StringdefaultBrand){this.defaultBranddefaultBrand;}// 实例工厂方法非静态publicCarcreateCar(){CarcarnewCar();car.setBrand(defaultBrand);car.setPrice(30.0);returncar;}}3.2 XML 配置!-- 第一步定义工厂 Bean --beanidcarFactoryclasscom.example.CarFactorypropertynamedefaultBrandvalue宝马//bean!-- 第二步通过工厂 Bean 创建目标对象 --beanidcarfactory-beancarFactoryfactory-methodcreateCar/关键点工厂本身也要注册为 BeancarFactoryfactory-bean指定工厂 Bean 的 idfactory-method指定工厂方法名不能再使用class属性四、两种方式对比对比维度静态工厂方法实例工厂方法工厂方法类型static非静态XML 配置classfactory-methodfactory-beanfactory-method工厂是否需要实例化不需要需要且由 Spring 管理工厂能否注入依赖不能可以通过property注入适用场景工具类、单例类工厂需要配置或依赖其他 Bean典型示例Calendar.getInstance()SqlSessionFactoryBean五、实际应用案例5.1 JDK 的 Calendarbeanidcalendarclassjava.util.Calendarfactory-methodgetInstance/Calendar的构造方法是protected不能直接new只能通过getInstance()获取。5.2 数据库连接publicclassConnectionFactory{publicstaticConnectioncreateConnection()throwsSQLException{returnDriverManager.getConnection(jdbc:mysql://localhost:3306/mydb,root,123456);}}beanidconnectionclasscom.example.ConnectionFactoryfactory-methodcreateConnection/5.3 Spring 自己的 SqlSessionFactoryBeanMyBatis 集成 Spring 时SqlSessionFactoryBean实现了FactoryBean接口通过getObject()方法创建SqlSessionFactorybeanidsqlSessionFactoryclassorg.mybatis.spring.SqlSessionFactoryBeanpropertynamedataSourcerefdataSource/propertynamemapperLocationsvalueclasspath:mapper/*.xml//bean这是实例工厂方法的一种高级形式——工厂本身是FactoryBean由 Spring 管理。六、底层原理Spring 在AbstractAutowireCapableBeanFactory.createBeanInstance()中判断使用哪种实例化策略protectedBeanWrappercreateBeanInstance(StringbeanName,RootBeanDefinitionmbd,Object[]args){// 1. 如果有 factory-method使用工厂方法实例化if(mbd.getFactoryMethodName()!null){returninstantiateUsingFactoryMethod(beanName,mbd,args);}// 2. 否则使用构造方法实例化returnautowireConstructor(beanName,mbd,null,args);}instantiateUsingFactoryMethod()的核心逻辑判断是静态工厂还是实例工厂如果是静态工厂通过class获取工厂类反射调用factory-method如果是实例工厂先从容器中获取factory-bean实例再调用其factory-method解析constructor-arg作为工厂方法的参数返回创建的对象关键类ConstructorResolver.instantiateUsingFactoryMethod()SimpleInstantiationStrategy.instantiate(RootBeanDefinition, String, BeanFactory, Object, Method, Object[])七、常见问题7.1 静态工厂方法与实例工厂方法的混淆!-- ❌ 错误实例工厂方法不能写 class --beanidcarclasscom.example.CarFactoryfactory-methodcreateCar/!-- ✅ 正确静态工厂方法用 class --beanidcarclasscom.example.CarFactoryfactory-methodcreateCar/区分方式factory-method方法是static的吗是则用class否则用factory-bean。7.2 参数传递错误工厂方法的参数用constructor-arg传递而不是propertybeanidcarclasscom.example.CarFactoryfactory-methodcreateCar!-- ✅ 正确constructor-arg --constructor-argnamebrandvalue宝马/!-- ❌ 错误property 用于 setter 注入不是工厂方法参数 --propertynamebrandvalue宝马//bean7.3 返回类型不是目标类型工厂方法返回的类型必须与目标 Bean 的类型兼容。如果getBean(car, Car.class)报类型不匹配检查工厂方法的返回类型。7.4 工厂类不是 Spring 管理的实例工厂方法要求工厂本身是 Spring Bean必须有对应的bean定义。如果忘记定义工厂 Bean会报NoSuchBeanDefinitionException。八、factory-method vs FactoryBean对比维度factory-methodFactoryBean配置方式XML 属性实现接口使用范围单个 Bean一类对象的创建是否侵入代码不侵入需要实现接口获取方式getBean(id)getBean(id)返回产品getBean(id)返回自身适用场景简单工厂方法复杂对象创建、框架集成factory-method更轻量适合简单的工厂方法。FactoryBean更强大适合复杂的创建逻辑且与 Spring 容器深度集成。九、最佳实践优先使用构造方法实例化。如果类有无参构造方法直接用默认方式不需要factory-method。需要工厂方法时优先用静态工厂。静态工厂更简单不需要工厂 Bean 的额外配置。工厂方法参数用 constructor-arg。这是 Spring 的规定不要混淆。复杂对象创建用 FactoryBean。当创建逻辑涉及多个步骤、依赖多个 Bean 时FactoryBean比factory-method更合适。在 Spring Boot 中优先用 Bean。Bean方法本质上就是工厂方法的现代替代方案ConfigurationpublicclassAppConfig{BeanpublicCarcar(){CarcarnewCar();car.setBrand(宝马);returncar;}}十、总结维度核心要点作用让 Spring 通过工厂方法创建 Bean而非构造方法静态工厂classfactory-method方法为static实例工厂factory-beanfactory-method工厂本身是 Bean参数传递用constructor-arg不是property底层createBeanInstance()→instantiateUsingFactoryMethod()典型应用Calendar.getInstance()、DriverManager.getConnection()现代替代Bean方法、FactoryBean接口面试考点静态与实例工厂的区别、与 FactoryBean 的关系factory-method是 Spring XML 配置时代创建复杂对象的标准手段。虽然 Spring Boot 中更多使用Bean方法但理解factory-method的工作机制有助于读懂老项目配置也能更深入理解 Spring 容器如何管理 Bean 的创建过程。