Package groovy.util

Class FactoryBuilderSupport

  • All Implemented Interfaces:
    GroovyObject
    Direct Known Subclasses:
    ObjectGraphBuilder

    public abstract class FactoryBuilderSupport
    extends Binding
    Mix of BuilderSupport and SwingBuilder's factory support. Warning: this implementation is not thread safe and should not be used across threads in a multi-threaded environment. A locking mechanism should be implemented by the subclass if use is expected across multiple threads.
    • Constructor Detail

      • FactoryBuilderSupport

        public FactoryBuilderSupport()
      • FactoryBuilderSupport

        public FactoryBuilderSupport​(boolean init)
    • Method Detail

      • checkValueIsNull

        public static void checkValueIsNull​(Object value,
                                            Object name)
        Throws an exception if value is null.
        Parameters:
        value - the node's value
        name - the node's name
      • checkValueIsType

        public static boolean checkValueIsType​(Object value,
                                               Object name,
                                               Class type)
        Checks type of value against builder type
        Parameters:
        value - the node's value
        name - the node's name
        type - a Class that may be assignable to the value's class
        Returns:
        true if type is assignable to the value's class, false if value is null.
      • checkValueIsTypeNotString

        public static boolean checkValueIsTypeNotString​(Object value,
                                                        Object name,
                                                        Class type)
        Checks values against factory's type
        Parameters:
        value - the node's value
        name - the node's name
        type - a Class that may be assignable to the value's class
        Returns:
        Returns true if type is assignable to the value's class, false if value is null or a String.
      • autoRegisterNodes

        public void autoRegisterNodes()
        Ask the nodes to be registered
      • getVariable

        public Object getVariable​(String name)
        Overrides:
        getVariable in class Binding
        Parameters:
        name - the name of the variable to lookup
        Returns:
        the variable value
      • setVariable

        public void setVariable​(String name,
                                Object value)
        Sets the value of the given variable
        Overrides:
        setVariable in class Binding
        Parameters:
        name - the name of the variable to set
        value - the new value for the given variable
      • getProperty

        public Object getProperty​(String property)
        Overloaded to make variables appear as bean properties or via the subscript operator
        Specified by:
        getProperty in interface GroovyObject
        Overrides:
        getProperty in class Binding
        Parameters:
        property - the name of the property of interest
        Returns:
        the given property
      • setProperty

        public void setProperty​(String property,
                                Object newValue)
        Overloaded to make variables appear as bean properties or via the subscript operator
        Specified by:
        setProperty in interface GroovyObject
        Overrides:
        setProperty in class Binding
        Parameters:
        property - the name of the property of interest
        newValue - the new value for the property
      • getFactories

        public Map<String,​Factory> getFactories()
        Returns:
        the factory map (Unmodifiable Map).
      • getExplicitMethods

        public Map<String,​Closure> getExplicitMethods()
        Returns:
        the explicit methods map (Unmodifiable Map).
      • getExplicitProperties

        public Map<String,​Closure[]> getExplicitProperties()
        Returns:
        the explicit properties map (Unmodifiable Map).
      • getLocalFactories

        public Map<String,​Factory> getLocalFactories()
        Returns:
        the factory map (Unmodifiable Map).
      • getLocalExplicitMethods

        public Map<String,​Closure> getLocalExplicitMethods()
        Returns:
        the explicit methods map (Unmodifiable Map).
      • getLocalExplicitProperties

        public Map<String,​Closure[]> getLocalExplicitProperties()
        Returns:
        the explicit properties map (Unmodifiable Map).
      • getRegistrationGroups

        public Set<String> getRegistrationGroups()
      • getRegistrationGroupItems

        public Set<String> getRegistrationGroupItems​(String group)
      • getAttributeDelegates

        public List<Closure> getAttributeDelegates()
      • getPreInstantiateDelegates

        public List<Closure> getPreInstantiateDelegates()
      • getPostInstantiateDelegates

        public List<Closure> getPostInstantiateDelegates()
      • getPostNodeCompletionDelegates

        public List<Closure> getPostNodeCompletionDelegates()
      • getMethodMissingDelegate

        public Closure getMethodMissingDelegate()
      • setMethodMissingDelegate

        public void setMethodMissingDelegate​(Closure delegate)
      • getPropertyMissingDelegate

        public Closure getPropertyMissingDelegate()
      • setPropertyMissingDelegate

        public void setPropertyMissingDelegate​(Closure delegate)
      • getContext

        public Map<String,​Object> getContext()
        Returns:
        the context of the current node.
      • getCurrent

        public Object getCurrent()
        Returns:
        the current node being built.
      • getCurrentFactory

        public Factory getCurrentFactory()
        Returns:
        the factory that built the current node.
      • getCurrentName

        public String getCurrentName()
        Returns:
        the factory of the parent of the current node.
      • getCurrentBuilder

        public FactoryBuilderSupport getCurrentBuilder()
        Returns:
        the builder that built the current node.
      • getParentNode

        public Object getParentNode()
        Returns:
        the node of the parent of the current node.
      • getParentFactory

        public Factory getParentFactory()
        Returns:
        the factory of the parent of the current node.
      • getParentContext

        public Map getParentContext()
        Returns:
        the context of the parent of the current node.
      • getParentName

        public String getParentName()
        Returns:
        the name of the parent of the current node.
      • getContextAttribute

        public Object getContextAttribute​(String key)
      • invokeMethod

        public Object invokeMethod​(String methodName)
        Convenience method when no arguments are required
        Parameters:
        methodName - the name of the method to invoke
        Returns:
        the result of the call
      • invokeMethod

        public Object invokeMethod​(String methodName,
                                   Object args)
        Description copied from interface: GroovyObject
        Invokes the given method.
        Parameters:
        methodName - the name of the method to call
        args - the arguments to use for the method call
        Returns:
        the result of invoking the method
      • addAttributeDelegate

        public Closure addAttributeDelegate​(Closure attrDelegate)
        Add an attribute delegate so it can intercept attributes being set. Attribute delegates are fired in a FILO pattern, so that nested delegates get first crack.
        Parameters:
        attrDelegate - the closure to be called
        Returns:
        attrDelegate
      • removeAttributeDelegate

        public void removeAttributeDelegate​(Closure attrDelegate)
        Remove the most recently added instance of the attribute delegate.
        Parameters:
        attrDelegate - the instance of the closure to be removed
      • addPreInstantiateDelegate

        public Closure addPreInstantiateDelegate​(Closure delegate)
        Add a preInstantiate delegate so it can intercept nodes before they are created. PreInstantiate delegates are fired in a FILO pattern, so that nested delegates get first crack.
        Parameters:
        delegate - the closure to invoke
        Returns:
        delegate
      • removePreInstantiateDelegate

        public void removePreInstantiateDelegate​(Closure delegate)
        Remove the most recently added instance of the preInstantiate delegate.
        Parameters:
        delegate - the closure to invoke
      • addPostInstantiateDelegate

        public Closure addPostInstantiateDelegate​(Closure delegate)
        Add a postInstantiate delegate so it can intercept nodes after they are created. PostInstantiate delegates are fired in a FILO pattern, so that nested delegates get first crack.
        Parameters:
        delegate - the closure to invoke
        Returns:
        delegate
      • removePostInstantiateDelegate

        public void removePostInstantiateDelegate​(Closure delegate)
        Remove the most recently added instance of the postInstantiate delegate.
        Parameters:
        delegate - the closure to invoke
      • addPostNodeCompletionDelegate

        public Closure addPostNodeCompletionDelegate​(Closure delegate)
        Add a nodeCompletion delegate so it can intercept nodes after they done with building. NodeCompletion delegates are fired in a FILO pattern, so that nested delegates get first crack.
        Parameters:
        delegate - the closure to invoke
        Returns:
        delegate
      • removePostNodeCompletionDelegate

        public void removePostNodeCompletionDelegate​(Closure delegate)
        Remove the most recently added instance of the nodeCompletion delegate.
        Parameters:
        delegate - the closure to be removed
      • registerExplicitProperty

        public void registerExplicitProperty​(String name,
                                             Closure getter,
                                             Closure setter)
      • registerExplicitProperty

        public void registerExplicitProperty​(String name,
                                             String groupName,
                                             Closure getter,
                                             Closure setter)
      • registerExplicitMethod

        public void registerExplicitMethod​(String name,
                                           Closure closure)
      • registerExplicitMethod

        public void registerExplicitMethod​(String name,
                                           String groupName,
                                           Closure closure)
      • registerBeanFactory

        public void registerBeanFactory​(String theName,
                                        Class beanClass)
        Registers a factory for a JavaBean.
        The JavaBean class should have a no-args constructor.
        Parameters:
        theName - name of the node
        beanClass - the factory to handle the name
      • registerBeanFactory

        public void registerBeanFactory​(String theName,
                                        String groupName,
                                        Class beanClass)
        Registers a factory for a JavaBean.
        The JavaBean class should have a no-args constructor.
        Parameters:
        theName - name of the node
        groupName - thr group to register this node in
        beanClass - the factory to handle the name
      • registerFactory

        public void registerFactory​(String name,
                                    Factory factory)
        Registers a factory for a node name.
        Parameters:
        name - the name of the node
        factory - the factory to return the values
      • registerFactory

        public void registerFactory​(String name,
                                    String groupName,
                                    Factory factory)
        Registers a factory for a node name.
        Parameters:
        name - the name of the node
        groupName - thr group to register this node in
        factory - the factory to return the values
      • createNode

        protected Object createNode​(Object name,
                                    Map attributes,
                                    Object value)
        This method is responsible for instantiating a node and configure its properties.
        Parameters:
        name - the name of the node
        attributes - the attributes for the node
        value - the value arguments for the node
        Returns:
        the object return from the factory
      • resolveFactory

        protected Factory resolveFactory​(Object name,
                                         Map attributes,
                                         Object value)
        This is a hook for subclasses to plugin a custom strategy for mapping names to factories.
        Parameters:
        name - the name of the factory
        attributes - the attributes from the node
        value - value arguments from te node
        Returns:
        the Factory associated with name.
      • resolveExplicitMethod

        protected Closure resolveExplicitMethod​(String methodName,
                                                Object args)
        This is a hook for subclasses to plugin a custom strategy for mapping names to explicit methods.
        Parameters:
        methodName - the name of the explicit method
        args - the arguments for the method
        Returns:
        the closure for the matched explicit method.
      • resolveExplicitProperty

        protected Closure[] resolveExplicitProperty​(String propertyName)
        This is a hook for subclasses to plugin a custom strategy for mapping names to property methods.
        Parameters:
        propertyName - the name of the explicit method
        Returns:
        the get and set closures (in that order) for the matched explicit property.
      • checkExplicitMethod

        protected boolean checkExplicitMethod​(String methodName,
                                              Object args,
                                              Reference result)
      • getName

        public Object getName​(String methodName)
        A hook to allow names to be converted into some other object such as a QName in XML or ObjectName in JMX.
        Parameters:
        methodName - the name of the desired method
        Returns:
        the object representing the name
      • getProxyBuilder

        protected FactoryBuilderSupport getProxyBuilder()
        Proxy builders are useful for changing the building context, thus enabling mix & match builders.
        Returns:
        the current builder that serves as a proxy.
      • setProxyBuilder

        protected void setProxyBuilder​(FactoryBuilderSupport proxyBuilder)
        Sets the builder to be used as a proxy.
        Parameters:
        proxyBuilder - the new proxy
      • getNameMappingClosure

        public Closure getNameMappingClosure()
      • setNameMappingClosure

        public void setNameMappingClosure​(Closure nameMappingClosure)
      • handleNodeAttributes

        protected void handleNodeAttributes​(Object node,
                                            Map attributes)
        Assigns any existing properties to the node.
        It will call attributeDelegates before passing control to the factory that built the node.
        Parameters:
        node - the object returned by tne node factory
        attributes - the attributes for the node
      • newContext

        protected void newContext()
        Pushes a new context on the stack.
      • nodeCompleted

        protected void nodeCompleted​(Object parent,
                                     Object node)
        A hook to allow nodes to be processed once they have had all of their children applied.
        Parameters:
        node - the current node being processed
        parent - the parent of the node being processed
      • popContext

        protected Map<String,​Object> popContext()
        Removes the last context from the stack.
        Returns:
        the content just removed
      • postInstantiate

        protected void postInstantiate​(Object name,
                                       Map attributes,
                                       Object node)
        A hook after the factory creates the node and before attributes are set.
        It will call any registered postInstantiateDelegates, if you override this method be sure to call this impl somewhere in your code.
        Parameters:
        name - the name of the node
        attributes - the attributes for the node
        node - the object created by the node factory
      • postNodeCompletion

        protected Object postNodeCompletion​(Object parent,
                                            Object node)
        A hook to allow nodes to be processed once they have had all of their children applied and allows the actual node object that represents the Markup element to be changed.
        It will call any registered postNodeCompletionDelegates, if you override this method be sure to call this impl at the end of your code.
        Parameters:
        node - the current node being processed
        parent - the parent of the node being processed
        Returns:
        the node, possibly new, that represents the markup element
      • preInstantiate

        protected void preInstantiate​(Object name,
                                      Map attributes,
                                      Object value)
        A hook before the factory creates the node.
        It will call any registered preInstantiateDelegates, if you override this method be sure to call this impl somewhere in your code.
        Parameters:
        name - the name of the node
        attributes - the attributes of the node
        value - the value argument(s) of the node
      • reset

        protected void reset()
        Clears the context stack.
      • setClosureDelegate

        protected void setClosureDelegate​(Closure closure,
                                          Object node)
        A strategy method to allow derived builders to use builder-trees and switch in different kinds of builders. This method should call the setDelegate() method on the closure which by default passes in this but if node is-a builder we could pass that in instead (or do something wacky too)
        Parameters:
        closure - the closure on which to call setDelegate()
        node - the node value that we've just created, which could be a builder
      • setNodeAttributes

        protected void setNodeAttributes​(Object node,
                                         Map attributes)
        Maps attributes key/values to properties on node.
        Parameters:
        node - the object from the node
        attributes - the attributes to be set
      • setParent

        protected void setParent​(Object parent,
                                 Object child)
        Strategy method to establish parent/child relationships.
        Parameters:
        parent - the object from the parent node
        child - the object from the child node
      • getContinuationData

        protected Map<String,​Object> getContinuationData()
        Stores the thread local states in a Map that can be passed across threads
        Returns:
        the map
      • restoreFromContinuationData

        protected void restoreFromContinuationData​(Map<String,​Object> data)
        Restores the state of the current builder to the same state as an older build. Caution, this will destroy rather than merge the current build context if there is any,
        Parameters:
        data - the data retrieved from a compatible getContinuationData call
      • withBuilder

        public Object withBuilder​(FactoryBuilderSupport builder,
                                  Closure closure)
        Switches the builder's proxyBuilder during the execution of a closure.
        This is useful to temporary change the building context to another builder without the need for a contrived setup. It will also take care of restoring the previous proxyBuilder when the execution finishes, even if an exception was thrown from inside the closure.
        Parameters:
        builder - the temporary builder to switch to as proxyBuilder.
        closure - the closure to be executed under the temporary builder.
        Returns:
        the execution result of the closure.
        Throws:
        RuntimeException - - any exception the closure might have thrown during execution.
      • withBuilder

        public Object withBuilder​(FactoryBuilderSupport builder,
                                  String name,
                                  Closure closure)
        Switches the builder's proxyBuilder during the execution of a closure.
        This is useful to temporary change the building context to another builder without the need for a contrived setup. It will also take care of restoring the previous proxyBuilder when the execution finishes, even if an exception was thrown from inside the closure. Additionally it will use the closure's result as the value for the node identified by 'name'.
        Parameters:
        builder - the temporary builder to switch to as proxyBuilder.
        name - the node to build on the 'parent' builder.
        closure - the closure to be executed under the temporary builder.
        Returns:
        a node that responds to value of name with the closure's result as its value.
        Throws:
        RuntimeException - - any exception the closure might have thrown during execution.
      • withBuilder

        public Object withBuilder​(Map attributes,
                                  FactoryBuilderSupport builder,
                                  String name,
                                  Closure closure)
        Switches the builder's proxyBuilder during the execution of a closure.
        This is useful to temporary change the building context to another builder without the need for a contrived setup. It will also take care of restoring the previous proxyBuilder when the execution finishes, even if an exception was thrown from inside the closure. Additionally it will use the closure's result as the value for the node identified by 'name' and assign any attributes that might have been set.
        Parameters:
        attributes - additional properties for the node on the parent builder.
        builder - the temporary builder to switch to as proxyBuilder.
        name - the node to build on the 'parent' builder.
        closure - the closure to be executed under the temporary builder.
        Returns:
        a node that responds to value of name with the closure's result as its value.
        Throws:
        RuntimeException - - any exception the closure might have thrown during execution.
      • addDisposalClosure

        public void addDisposalClosure​(Closure closure)
      • getDisposalClosures

        public List<Closure> getDisposalClosures()
      • dispose

        public void dispose()