grails.spring
[Java] Class BeanBuilder

java.lang.Object
  groovy.lang.GroovyObjectSupport
      grails.spring.BeanBuilder

public class BeanBuilder
extends groovy.lang.GroovyObjectSupport

Runtime bean configuration wrapper. Like a Groovy builder, but more of a DSL for Spring configuration. Allows syntax like:

 import org.hibernate.SessionFactory
 import org.apache.commons.dbcp.BasicDataSource
 
 BeanBuilder builder = new BeanBuilder()
 builder.beans {
   dataSource(BasicDataSource) {                  // <--- invokeMethod
      driverClassName = "org.hsqldb.jdbcDriver"
      url = "jdbc:hsqldb:mem:grailsDB"
      username = "sa"                            // <-- setProperty
      password = ""
      settings = [mynew:"setting"]
  } 
  sessionFactory(SessionFactory) {
  	   dataSource = dataSource                 // <-- getProperty for retrieving refs
  }
  myService(MyService) {
      nestedBean = { AnotherBean bean->          // <-- setProperty with closure for nested bean
      		dataSource = dataSource
      }
  }
 }
 

You can also use the Spring IO API to load resources containing beans defined as a Groovy script using either the constructors or the loadBeans(Resource[] resources) method

Authors:

Graeme Rocher

Since:

0.4

BeanBuilder

public BeanBuilder()

BeanBuilder

public BeanBuilder(java.lang.ClassLoader classLoader)

BeanBuilder

public BeanBuilder(ApplicationContext parent)

BeanBuilder

public BeanBuilder(ApplicationContext parent, java.lang.ClassLoader classLoader)

BeanBuilder

public BeanBuilder(ApplicationContext parentCtx, RuntimeSpringConfiguration springConfig, java.lang.ClassLoader classLoader)

addToDeferred

protected boolean addToDeferred(BeanConfiguration beanConfig, java.lang.String property, java.lang.Object newValue)

beans

public BeanBuilder beans(groovy.lang.Closure c)

Defines a set of beans for the given block or closure.

Parameters:

c - The block or closure

Returns:

This BeanBuilder instance

createApplicationContext

public ApplicationContext createApplicationContext()

Creates an ApplicationContext from the current state of the BeanBuilder

Returns:

The ApplicationContext instance

createDynamicElementReader

protected DynamicElementReader createDynamicElementReader(java.lang.String namespace, boolean decorator)

createRuntimeSpringConfiguration

protected RuntimeSpringConfiguration createRuntimeSpringConfiguration(ApplicationContext parent, java.lang.ClassLoader classLoader)

filterGStringReferences

protected void filterGStringReferences(Object[] constructorArgs)

finalizeDeferredProperties

protected void finalizeDeferredProperties()

getBeanDefinition

public BeanDefinition getBeanDefinition(java.lang.String name)

Retrieves a BeanDefinition for the given name

Parameters:

name - The bean definition

Returns:

The BeanDefinition instance

getBeanDefinitions

public java.util.Map getBeanDefinitions()

Retrieves all BeanDefinitions for this BeanBuilder

Returns:

A map of BeanDefinition instances with the bean id as the key

getLog

public Log getLog()

getParentCtx

public ApplicationContext getParentCtx()

Retrieves the parent ApplicationContext

Returns:

The parent ApplicationContext

getProperty

public java.lang.Object getProperty(java.lang.String name)

This method overrides property retrieval in the scope of the BeanBuilder to either: a) Retrieve a variable from the bean builder's binding if it exists b) Retrieve a RuntimeBeanReference for a specific bean if it exists c) Otherwise just delegate to super.getProperty which will resolve properties from the BeanBuilder itself

getSpringConfig

public RuntimeSpringConfiguration getSpringConfig()

Retrieves the RuntimeSpringConfiguration instance used the the BeanBuilder

Returns:

The RuntimeSpringConfiguration instance

importBeans

public void importBeans(java.lang.String resourcePattern)

Imports Spring bean definitions from either XML or Groovy sources into the current bean builder instance

Parameters:

resourcePattern - The resource pattern

initializeBeanBuilderForClassLoader

protected void initializeBeanBuilderForClassLoader(java.lang.ClassLoader classLoader)

initializeSpringConfig

protected void initializeSpringConfig()

invokeBeanDefiningClosure

protected BeanBuilder invokeBeanDefiningClosure(groovy.lang.Closure callable)

When an methods argument is only a closure it is a set of bean definitions

Parameters:

callable - The closure argument

Returns:

This BeanBuilder instance

invokeBeanDefiningMethod

protected BeanConfiguration invokeBeanDefiningMethod(java.lang.String name, Object[] args)

This method is called when a bean definition node is called

Parameters:

name - The name of the bean to define

args - The arguments to the bean. The first argument is the class name, the last argument is sometimes a closure. All the arguments in between are constructor arguments

Returns:

The bean configuration instance

invokeMethod

public java.lang.Object invokeMethod(java.lang.String name, java.lang.Object arg)

This method overrides method invocation to create beans for each method name that takes a class argument

loadBeans

public void loadBeans(java.lang.String resourcePattern)

Takes a resource pattern as (

throws:

IOException When the path cannot be matched

Parameters:

resourcePattern - The resource pattern

See Also:

org.springframework.core.io.support.PathMatchingResourcePatternResolver

loadBeans

public void loadBeans(Resource resource)

Loads a single Resource into the bean builder

throws:

IOException When an error occurs

Parameters:

resource - The resource to load

loadBeans

public void loadBeans(Resource[] resources)

Loads a set of given beans

throws:

IOException Thrown if there is an error reading one of the passes resources

Parameters:

resources - The resources to load

manageListIfNecessary

protected java.lang.Object manageListIfNecessary(java.lang.Object value)

Checks whether there are any runtime refs inside the list and converts it to a ManagedList if necessary

Parameters:

value - The object that represents the list

Returns:

Either a new list or a managed one

manageMapIfNecessary

protected java.lang.Object manageMapIfNecessary(java.lang.Object value)

Checks whether there are any runtime refs inside a Map and converts it to a ManagedMap if necessary

Parameters:

value - The current map

Returns:

A ManagedMap or a normal map

registerBeans

public void registerBeans(BeanDefinitionRegistry registry)

Register a set of beans with the given bean registry. Most application contexts are bean registries.

registerBeans

public void registerBeans(RuntimeSpringConfiguration targetSpringConfig)

Registers bean definitions with another instance of RuntimeSpringConfiguration, overriding any beans in the target.

Parameters:

targetSpringConfig - The RuntimeSpringConfiguration object

resolveConstructorArguments

protected java.util.List resolveConstructorArguments(Object[] args, int start, int end)

setBinding

public void setBinding(groovy.lang.Binding b)

Sets the binding (the variables available in the scope of the BeanBuilder)

Parameters:

b - The Binding instance

setClassLoader

public void setClassLoader(java.lang.ClassLoader classLoader)

setNamespaceHandlerResolver

public void setNamespaceHandlerResolver(NamespaceHandlerResolver namespaceHandlerResolver)

setProperty

public void setProperty(java.lang.String name, java.lang.Object value)

This method overrides property setting in the scope of the BeanBuilder to set properties on the current BeanConfiguration

setPropertyOnBeanConfig

protected void setPropertyOnBeanConfig(java.lang.String name, java.lang.Object value)

setResourcePatternResolver

public void setResourcePatternResolver(ResourcePatternResolver resourcePatternResolver)

setSpringConfig

public void setSpringConfig(RuntimeSpringConfiguration springConfig)

Sets the runtime Spring configuration instance to use. This is not necessary to set and is configured to default value if not, but is useful for integrating with other spring configuration mechanisms

Parameters:

springConfig - The spring config

See Also:

GrailsRuntimeConfigurator

subarray

protected Object[] subarray(Object[] args, int i, int j)

xmlns

public void xmlns(java.util.Map definition)

Defines an Spring namespace definition to use

Parameters:

definition - The definition

Groovy Documentation