com.opensymphony.xwork2.spring

## Class SpringObjectFactory

- java.lang.Object
- - com.opensymphony.xwork2.ObjectFactory
  - - com.opensymphony.xwork2.spring.SpringObjectFactory

- All Implemented Interfaces:
    Serializable, org.springframework.beans.factory.Aware, org.springframework.context.ApplicationContextAware
  Direct Known Subclasses:
    SpringProxyableObjectFactory

      public class SpringObjectFactory
      extends ObjectFactory
      implements org.springframework.context.ApplicationContextAware

  Simple implementation of the ObjectFactory that makes use of Spring's application context if one has been configured, before falling back on the default mechanism of instantiating a new class using the class name.

  In order to use this class in your application, you will need to instantiate a copy of this class and set it as XWork's ObjectFactory before the xwork.xml file is parsed. In a servlet environment, this could be done using a ServletContextListener.

  Author:
    Simon Stewart (sms@lateral.net)
  See Also:
    Serialized Form

- - ### Field Summary

    Fields
    Modifier and Type | Field and Description
    --- | ---
    `protected org.springframework.context.ApplicationContext` | `appContext`
    `protected int` | `autowireStrategy`
    `protected org.springframework.beans.factory.config.AutowireCapableBeanFactory` | `autoWiringFactory`

  - ### Constructor Summary

    Constructors
    Constructor and Description
    `SpringObjectFactory()`

  - ### Method Summary

    Methods
    Modifier and Type | Method and Description
    --- | ---
    `Object` | `autoWireBean(Object bean)`
    `Object` | `autoWireBean(Object bean, org.springframework.beans.factory.config.AutowireCapableBeanFactory autoWiringFactory)`
    `Object` | `buildBean(Class clazz, Map<String,Object> extraContext)` Build a generic Java object of the given type.
    `Object` | `buildBean(String beanName, Map<String,Object> extraContext, boolean injectInternal)` Looks up beans using Spring's application context before falling back to the method defined in the `ObjectFactory`.
    `protected org.springframework.beans.factory.config.AutowireCapableBeanFactory` | `findAutoWiringBeanFactory(org.springframework.context.ApplicationContext context)` If the given context is assignable to AutowireCapbleBeanFactory or contains a parent or a factory that is, then set the autoWiringFactory appropriately.
    `int` | `getAutowireStrategy()`
    `Class` | `getClassInstance(String className)` Utility method to obtain the class matched to className.
    `boolean` | `isNoArgConstructorRequired()` Allows for ObjectFactory implementations that support Actions without no-arg constructors.
    `void` | `setAlwaysRespectAutowireStrategy(boolean alwaysRespectAutowireStrategy)` Determines if the autowire strategy is always followed when creating beans
    `void` | `setApplicationContext(org.springframework.context.ApplicationContext appContext)` Set the Spring ApplicationContext that should be used to look beans up with.
    `void` | `setApplicationContextPath(String ctx)`
    `void` | `setAutowireStrategy(int autowireStrategy)` Sets the autowiring strategy
    `void` | `setEnableAopSupport(String enableAopSupport)`
    `void` | `setUseClassCache(boolean useClassCache)` Enable / disable caching of classes loaded by Spring.

    - ### Methods inherited from class com.opensymphony.xwork2.ObjectFactory

      `buildAction, buildBean, buildConverter, buildInterceptor, buildResult, buildUnknownHandler, buildValidator, injectInternalBeans, setActionFactory, setClassLoader, setContainer, setConverterFactory, setInterceptorFactory, setResultFactory, setUnknownHandlerFactory, setValidatorFactory`

    - ### Methods inherited from class java.lang.Object

      `clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

- - ### Field Detail

    - #### appContext

          protected org.springframework.context.ApplicationContext appContext

    - #### autoWiringFactory

          protected org.springframework.beans.factory.config.AutowireCapableBeanFactory autoWiringFactory

    - #### autowireStrategy

          protected int autowireStrategy

  - ### Constructor Detail

    - #### SpringObjectFactory

          public SpringObjectFactory()

  - ### Method Detail

    - #### setApplicationContextPath

          public void setApplicationContextPath(String ctx)

    - #### setEnableAopSupport

          public void setEnableAopSupport(String enableAopSupport)

    - #### setApplicationContext

          public void setApplicationContext(org.springframework.context.ApplicationContext appContext)
                                     throws org.springframework.beans.BeansException

      Set the Spring ApplicationContext that should be used to look beans up with.
      Specified by:
        `setApplicationContext` in interface `org.springframework.context.ApplicationContextAware`
      Parameters:
        `appContext` - The Spring ApplicationContext that should be used to look beans up with.
      Throws:
        `org.springframework.beans.BeansException`

    - #### setAutowireStrategy

          public void setAutowireStrategy(int autowireStrategy)

      Sets the autowiring strategy
      Parameters:
        `autowireStrategy` - the autowire strategy

    - #### getAutowireStrategy

          public int getAutowireStrategy()

    - #### findAutoWiringBeanFactory

          protected org.springframework.beans.factory.config.AutowireCapableBeanFactory findAutoWiringBeanFactory(org.springframework.context.ApplicationContext context)

      If the given context is assignable to AutowireCapbleBeanFactory or contains a parent or a factory that is, then set the autoWiringFactory appropriately.
      Parameters:
        `context` - the application context
      Returns:
        the bean factory

    - #### buildBean

          public Object buildBean(String beanName,
                         Map<String,Object> extraContext,
                         boolean injectInternal)
                           throws Exception

      Looks up beans using Spring's application context before falling back to the method defined in the `ObjectFactory`.
      Overrides:
        `buildBean` in class `ObjectFactory`
      Parameters:
        `beanName` - The name of the bean to look up in the application context
        `extraContext` - additional context parameters
        `injectInternal` - true if inject internal beans
      Returns:
        A bean from Spring or the result of calling the overridden method.
      Throws:
        `Exception` - in case of any errors

    - #### buildBean

          public Object buildBean(Class clazz,
                         Map<String,Object> extraContext)
                           throws Exception

      Description copied from class: `ObjectFactory`
      Build a generic Java object of the given type.
      Overrides:
        `buildBean` in class `ObjectFactory`
      Parameters:
        `clazz` - class of bean
        `extraContext` - additional context parameters
      Returns:
        bean
      Throws:
        `Exception` - in case of any errors

    - #### autoWireBean

          public Object autoWireBean(Object bean)

    - #### autoWireBean

          public Object autoWireBean(Object bean,
                            org.springframework.beans.factory.config.AutowireCapableBeanFactory autoWiringFactory)

      Parameters:
        `bean` - the bean to be autowired
        `autoWiringFactory` - the autowiring factory
      Returns:
        bean

    - #### getClassInstance

          public Class getClassInstance(String className)
                                 throws ClassNotFoundException

      Description copied from class: `ObjectFactory`
      Utility method to obtain the class matched to className. Caches look ups so that subsequent lookups will be faster.
      Overrides:
        `getClassInstance` in class `ObjectFactory`
      Parameters:
        `className` - The fully qualified name of the class to return
      Returns:
        The class itself
      Throws:
        `ClassNotFoundException` - if class not found in classpath

    - #### isNoArgConstructorRequired

          public boolean isNoArgConstructorRequired()

      Allows for ObjectFactory implementations that support Actions without no-arg constructors.
      Overrides:
        `isNoArgConstructorRequired` in class `ObjectFactory`
      Returns:
        false

    - #### setUseClassCache

          public void setUseClassCache(boolean useClassCache)

      Enable / disable caching of classes loaded by Spring.
      Parameters:
        `useClassCache` - enable / disable class cache

    - #### setAlwaysRespectAutowireStrategy

          public void setAlwaysRespectAutowireStrategy(boolean alwaysRespectAutowireStrategy)

      Determines if the autowire strategy is always followed when creating beans
      Parameters:
        `alwaysRespectAutowireStrategy` - True if the strategy is always used

Copyright © 2000–2018 Apache Software Foundation. All rights reserved.