17 Configuration Tag Reference

This chapter serves as a pure reference for all configuration tags, listing all their attributes. For examples or more detailed explanations we will link to the corresponding chapters.

The reference covers Metadata, MXML and XML tags. Many of the tags are available for all three configuration modes. Some only for one or two of them. The corresponding section will list which of these options are available.

17.1 Dependency Injection

17.1.1 Inject for Properties

Metadata Tag	`[Inject]`
may be placed on	property declaration
MXML and XML Namespace	N/A
MXML Tag	N/A
XML Tag	N/A
Detailed Explanation	4.3 Property Injection by Type and 4.4 Property Injection by Id
Comment	For MXML or XML see 17.9.7 Property

Attributes

`id`	optional	Specifies the id of the object to inject, if omitted injection by type is performed.
`required`	optional	Indicates whether the dependency is required, default if omitted: `true`.

17.1.2 Inject for Methods

Metadata Tag	`[Inject]`
may be placed on	method declaration
MXML and XML Namespace	N/A
MXML Tag	N/A
XML Tag	N/A
Detailed Explanation	4.2 Method Injection

Attributes

None

17.1.3 InjectConstructor

Metadata Tag	`[InjectConstructor]`
may be placed on	class declaration
MXML and XML Namespace	N/A
MXML Tag	N/A
XML Tag	N/A
Detailed Explanation	4.1 Constructor Injection
Comment	For MXML or XML see 17.9.6 ConstructorArgs

Attributes

None

17.2 Decoupled Bindings

17.2.1 Publish

Metadata Tag	`[Publish]`
may be placed on	property declaration
MXML and XML Namespace	`http://www.spicefactory.org/parsley`
MXML Tag	<Publish/>
XML Tag	<publish/>
Detailed Explanation	5 Decoupled Bindings

Attributes

`objectId`	optional	The id the property value is published with.
`scope`	optional	The scope the property value is published to.
`managed`	optional	Indicates whether the value published by this property should be added to the Context (turned into a managed object) while being published.
`changeEvent`	optional (Flash only)	The event that signals that the property value has changed. Default is `change`. Not needed in Flex applications where this feature relies on the Flex Binding facility.
`property`	required for MXML/XML	The name of the property that holds the value to publish. Will be automatically set when used as a Metadata Tag.

17.2.2 PublishSubscribe

Metadata Tag	`[PublishSubscribe]`
may be placed on	property declaration
MXML and XML Namespace	`http://www.spicefactory.org/parsley`
MXML Tag	<PublishSubscribe/>
XML Tag	<publish-subscribe/>
Detailed Explanation	5 Decoupled Bindings

Attributes

`objectId`	optional	The id the property value is published with.
`scope`	optional	The scope the property value is published to.
`managed`	optional	Indicates whether the value published by this property should be added to the Context (turned into a managed object) while being published.
`persistent`	optional	Indicates whether the value published by this property should be persisted and automatically retrieved back when the application starts the next time. The default implementation is based on Local SharedObjects, but can be swapped.
`changeEvent`	optional (Flash only)	The event that signals that the property value has changed. Default is `change`. Not needed in Flex applications where this feature relies on the Flex Binding facility.
`property`	required for MXML/XML	The name of the property that holds the value to publish. Will be automatically set when used as a Metadata Tag.

17.2.3 Subscribe

Metadata Tag	`[Subscribe]`
may be placed on	property declaration
MXML and XML Namespace	`http://www.spicefactory.org/parsley`
MXML Tag	<Subscribe/>
XML Tag	<subscribe/>
Detailed Explanation	5 Decoupled Bindings

Attributes

`objectId`	optional	The id the source is published with.
`scope`	optional	The scope the binding listens to.
`property`	required for MXML/XML	The name of the property that binds to the subscribed value. Will be automatically set when used as a Metadata Tag.

17.3 Messaging

17.3.1 MessageDispatcher

Metadata Tag	`[MessageDispatcher]`
may be placed on	property declaration
MXML and XML Namespace	`http://www.spicefactory.org/parsley`
MXML Tag	`<MessageDispatcher/>`
XML Tag	`<message-dispatcher/>`
Detailed Explanation	6.4 Injected MessageDispatchers

Attributes

`property`	required for MXML/XML	The property the injected dispatcher function should be injected into. Will be automatically set when used as a Metadata Tag.
`scope`	optional	The scope through which the message should be dispatched. If this attribute is omitted the message will be dispatched through all scopes associated with the Context the dispatching object lives in.

17.3.2 ManagedEvents

Metadata Tag	`[ManagedEvents]`
may be placed on	class declaration
MXML and XML Namespace	`http://www.spicefactory.org/parsley`
MXML Tag	`<ManagedEvents/>`
XML Tag	`<managed-events/>`
Detailed Explanation	6.3 Managed Events

Attributes

`names`	required	The names (types) of the events dispatched from the annotated object that the container should manage.
`scope`	optional	The scope through which the event should be dispatched. If this attribute is omitted the event will be dispatched through all scopes associated with the Context the dispatching object lives in.

17.3.3 MessageHandler

Metadata Tag	`[MessageHandler]`
may be placed on	method declaration
MXML and XML Namespace	`http://www.spicefactory.org/parsley`
MXML Tag	`<MessageHandler/>`
XML Tag	`<message-handler/>`
Detailed Explanation	6.5 MessageHandlers

Attributes

`type`	optional	The type (class) of the message that the annotated method wishes to receive. If omitted all messages will be received (rarely useful).
`messageProperties`	optional	If specified not the message itself will be passed to the method, but instead the listed properties of the message as method parameters.
`selector`	optional	An selector value for filtering in addition to message selection by type. See 6.9 Using Selectors.
`scope`	optional	The scope from which the message should be received. The default is the global scope.
`order`	optional	The order in which handlers should be invoked. The default value is `int.MAX_VALUE`.
`method`	required for MXML/XML	The method the message instance should be passed to. Will be automatically set when used as a Metadata Tag.

17.3.4 MessageBinding

Metadata Tag	`[MessageBinding]`
may be placed on	property declaration
MXML and XML Namespace	`http://www.spicefactory.org/parsley`
MXML Tag	`<MessageBinding/>`
XML Tag	`<message-binding/>`
Detailed Explanation	6.6 MessageBindings

Attributes

`type`	required	The type (class) of the message that the annotated property should be bound to.
`messageProperty`	required	The name of the property of the message class whose value should be bound to the targetProperty.
`selector`	optional	An selector value for filtering in addition to message selection by type. See 6.9 Using Selectors.
`scope`	optional	The scope from which the message should be received. The default is the global scope.
`order`	optional	The order in which bindings should be executed. The default value is `int.MAX_VALUE`.
`targetProperty`	required for MXML/XML	The name of the property that the message property value should be bound to. Will be automatically set when used as a Metadata Tag.

17.3.5 MessageError

Metadata Tag	`[MessageError]`
may be placed on	method declaration
MXML and XML Namespace	`http://www.spicefactory.org/parsley`
MXML Tag	`<MessageError/>`
XML Tag	`<message-error/>`
Detailed Explanation	6.8 Error Handlers

Attributes

`type`	optional	The type (class) of the message that was passed to the handler or interceptor that threw an Error. If omitted the error handler applies to all message types.
`selector`	optional	An selector value for filtering in addition to message selection by type. See 6.9 Using Selectors.
`scope`	optional	The scope from which the message was dispatched to the handler or interceptor that threw an Error. The default is the global scope.
`order`	optional	The order in which error handlers should be invoked. The default value is `int.MAX_VALUE`.
`method`	required for MXML/XML	The interceptor method. Will be automatically set when used as a Metadata Tag.

17.3.6 MessageConfirmation

Metadata Tag	`N/A`
MXML and XML Namespace	`http://www.spicefactory.org/parsley`
MXML Tag	`<MessageConfirmation/>`
XML Tag	`<message-confirmation/>`
Detailed Explanation	Simple utility tag that opens an Alert for matching messages and only continues with message processing if the user clicks OK. This is a Flex-only feature.

Attributes

`type`	optional	The type (class) of the message that the alert should be shown for.
`selector`	optional	An selector value for filtering in addition to message selection by type. See 6.9 Using Selectors.
`scope`	optional	The scope from which the message should be received. The default is the global scope.
`text`	required	The text to display in the Alert.
`title`	required	The title to display in the Alert.

17.3.7 Selector

Metadata Tag	`[Selector]`
may be placed on	property declaration
MXML and XML Namespace	N/A
MXML Tag	`N/A`
XML Tag	`N/A`
Detailed Explanation	6.9 Using Selectors

Attributes

None

17.4 Messaging

17.4.1 CommandComplete

Metadata Tag	`[CommandComplete]`
may be placed on	method declaration
MXML and XML Namespace	`http://www.spicefactory.org/parsley`
MXML Tag	`<CommandComplete/>`
XML Tag	`<command-complete/>`
Detailed Explanation	7.6 Handling Results and Observing Commands

Attributes

`type`	optional	The type (class) of the message that the annotated method wishes to receive. If omitted the type will be deduced from the method parameter (if available).
`selector`	optional	An selector value for filtering in addition to message selection by type. See 6.9 Using Selectors.
`scope`	optional	The scope from which the message should be received. The default is the global scope.
`order`	optional	The order in which complete handlers should be invoked. The default value is `int.MAX_VALUE`.
`method`	required for MXML/XML	The method the result should be passed to. Will be automatically set when used as a Metadata Tag.

17.4.2 CommandResult

Metadata Tag	`[CommandResult]`
may be placed on	method declaration
MXML and XML Namespace	`http://www.spicefactory.org/parsley`
MXML Tag	`<CommandResult/>`
XML Tag	`<command-result/>`
Detailed Explanation	7.6 Handling Results and Observing Commands

Attributes

`type`	optional	The type (class) of the message that the annotated method wishes to receive. If omitted the type will be deduced from the second method parameter (if available).
`selector`	optional	An selector value for filtering in addition to message selection by type. See 6.9 Using Selectors.
`scope`	optional	The scope from which the message should be received. The default is the global scope.
`order`	optional	The order in which result handlers should be invoked. The default value is `int.MAX_VALUE`.
`immediate`	optional	Indicates whether the result handler should get invoked immediately after the result is available when the result is produced by a command in a sequence or flow. The default is false which means the result handler will get invoked when the entire sequence completed. Has no effect on a single command.
`method`	required for MXML/XML	The method the result should be passed to. Will be automatically set when used as a Metadata Tag.

17.4.3 CommandError

Metadata Tag	`[CommandError]`
may be placed on	method declaration
MXML and XML Namespace	`http://www.spicefactory.org/parsley`
MXML Tag	`<CommandError/>`
XML Tag	`<command-error/>`
Detailed Explanation	7.6 Handling Results and Observing Commands

Attributes

`type`	optional	The type (class) of the message that the annotated method wishes to receive. If omitted the type will be deduced from the second method parameter (if available).
`selector`	optional	An selector value for filtering in addition to message selection by type. See 6.9 Using Selectors.
`scope`	optional	The scope from which the message should be received. The default is the global scope.
`order`	optional	The order in which error handlers should be invoked. The default value is `int.MAX_VALUE`.
`method`	required for MXML/XML	The method the error should be passed to. Will be automatically set when used as a Metadata Tag.

17.4.4 CommandStatus

Metadata Tag	`[CommandStatus]`
may be placed on	Boolean property declaration
MXML and XML Namespace	`http://www.spicefactory.org/parsley`
MXML Tag	`<CommandStatus/>`
XML Tag	`<command-status/>`
Detailed Explanation	7.6 Handling Results and Observing Commands

Attributes

`type`	optional	The type (class) of the message that the annotated method wishes to receive. If omitted the type will be deduced from the second method parameter (if available).
`selector`	optional	An selector value for filtering in addition to message selection by type. See 6.9 Using Selectors.
`scope`	optional	The scope from which the message should be received. The default is the global scope.
`property`	required for MXML/XML	The property which will act as a boolean flag for the matching command type. Will be automatically set when used as a Metadata Tag.

17.4.5 MapCommand

Metadata Tag	`N/A`
MXML and XML Namespace	`http://www.spicefactory.org/parsley`
MXML Tag	`<MapCommand/>`
XML Tag	`<map-command/>`
Detailed Explanation	7.2 Mapping Commands to Messages

Attributes

`type`	required	The type (class) of the command to create.
`messageType`	optional	The type (class) of the message that the command wishes to receive. If omitted the type will be deduced from the method parameter (if available).
`selector`	optional	An selector value for filtering in addition to message selection by type. See 6.9 Using Selectors.
`scope`	optional	The scope from which the message should be received. The default is the global scope.
`order`	optional	The order in which commands should be invoked. The default value is `int.MAX_VALUE`.

Child Elements

Any tag listed in 14.1 through 14.5, ConstructorArgs, Property, All Custom Configuration Tags that implement the ObjectDefinitionDecorator interface.

17.5 Object Lifecycle

17.5.1 AsyncInit

Metadata Tag	`[AsyncInit]`
may be placed on	class declaration
MXML and XML Namespace	`http://www.spicefactory.org/parsley`
MXML Tag	`<AsyncInit/>`
XML Tag	`<async-init/>`
Detailed Explanation	8.3 Asynchronous Object Initialization

Attributes

`completeEvent`	optional	The event type signalling that the object is fully initialized. Default `Event.COMPLETE`.
`errorEvent`	optional	The event type signalling that the object failed to initialize correctly. Default `ErrorEvent.ERROR`.

17.5.2 Init

Metadata Tag	`[Init]`
may be placed on	method declaration
MXML and XML Namespace	`http://www.spicefactory.org/parsley`
MXML Tag	`<Init/>`
XML Tag	`<init/>`
Detailed Explanation	8.5 Object Lifecycle Methods
Note	The old name of this tag (PostConstruct) has been deprecated.

Attributes

method required for MXML/XML The name of the method to invoke when the object is fully initialized. Will be automatically set when used as a Metadata Tag.

17.5.3 Destroy

Metadata Tag	`[Destroy]`
may be placed on	method declaration
MXML and XML Namespace	`http://www.spicefactory.org/parsley`
MXML Tag	`<Destroy/>`
XML Tag	`<destroy/>`
Detailed Explanation	8.5 Object Lifecycle Methods
Note	The old name of this tag (PreDestroy) has been deprecated.

Attributes

method required for MXML/XML The name of the method to invoke when the object is fully initialized. Will be automatically set when used as a Metadata Tag.

17.5.4 Observe

Metadata Tag	`[Observe]`
may be placed on	method declaration
MXML and XML Namespace	`http://www.spicefactory.org/parsley`
MXML Tag	`<Observe/>`
XML Tag	`<observe/>`
Detailed Explanation	8.6 Lifecycle Observer Methods

Attributes

`phase`	optional	The lifecycle phase to observe. The default is `postInit`. The other permitted values are `preConfigure`, `preInit`, `preDestroy` and `postDestroy`.
`objectId`	optional	The id of the object to observe. If omitted the observer method will be invoked for all matching types (polymorphically).
`method`	required for MXML/XML	The name of the method to invoke when the object is fully initialized. Will be automatically set when used as a Metadata Tag.

17.6 Localization

17.6.1 ResourceBinding

Metadata Tag	`[ResourceBinding]`
may be placed on	property declaration
MXML and XML Namespace	`http://www.spicefactory.org/parsley`
MXML Tag	`<ResourceBinding/>`
XML Tag	`<resource-binding/>`
Detailed Explanation	12.1 ResourceBindings

Attributes

`bundle`	required	The bundle name of the resource.
`key`	required	The resource key.
`property`	required for MXML/XML	The name of the property that the resource should be bound to. Will be automatically set when used as a Metadata Tag.

17.7 Extensibility

17.7.1 Factory

Metadata Tag	`[Factory]`
may be placed on	method declaration
MXML and XML Namespace	`http://www.spicefactory.org/parsley`
MXML Tag	`<Factory/>`
XML Tag	`<factory/>`
Detailed Explanation	8.2 Using Factories

Attributes

method required for MXML/XML The name of the method that produces the obejcts. Will be automatically set when used as a Metadata Tag.

17.7.2 Target

Metadata Tag	`[Target]`
may be placed on	property declaration
MXML and XML Namespace	N/A
MXML Tag	N/A
XML Tag	N/A
Detailed Explanation	13.2 Custom Metadata Tags in Creating Custom Configuration Tags (final section titled "Metadata on Properties or Methods")

Attributes

None

17.8 ActionScript Configuration

17.8.1 ObjectDefinition

Metadata Tag	`[ObjectDefinition]`
may be placed on	property declaration
MXML and XML Namespace	N/A
MXML Tag	`N/A`
XML Tag	`N/A`
Detailed Explanation	3.6 ActionScript Configuration

Attributes

`lazy`	optional	When set to false (default) the object will be instantiated when the container initializes. When set to true the object will be instantiated on demand.
`id`	optional	The id the object should be registered with. If omitted the name of the property that produces (or holds) the object will be used as the id.
`order`	optional	The initialization order. Only considered for non-lazy objects, processed in ascending order. Default `int.MAX_VALUE`.

17.8.2 DynamicObject

Metadata Tag	`[DynamicObject]`
may be placed on	property declaration
MXML and XML Namespace	N/A
MXML Tag	`N/A`
XML Tag	`N/A`
Detailed Explanation	3.6 ActionScript Configuration

Attributes

id optional The id the object should be registered with. If omitted the name of the property that produces (or holds) the object will be used as the id.

17.8.3 Internal

Metadata Tag	`[Internal]`
may be placed on	property declaration
MXML and XML Namespace	N/A
MXML Tag	`N/A`
XML Tag	`N/A`
Detailed Explanation	May be placed on properties in an AS3 Configuration Class that should not be included in the IOC Container.

Attributes

None

17.9 MXML and XML Configuration

17.9.1 Variants of Metadata Tags

This section lists tags that can only be used in MXML and XML configuration and not as Metadata in classes. Nevertheless most of the other tags documented in previous sections can be used as MXML or XML tags, too (their tag names are listed if this is the case). But for the tags in previous sections the most common use case is to use them as Metadata.

17.9.2 Object

Metadata Tag	N/A
MXML and XML Namespace	`http://www.spicefactory.org/parsley`
MXML Tag	`<Object/>`
XML Tag	`<object/>`
Detailed Explanation	3.2 MXML Configuration and 3.3 XML Configuration Files

Attributes

`type`	required	The type of the object to create.
`lazy`	optional	When set to false (default) the object will be instantiated when the container initializes (but only if the singleton attribute keeps the default value (true). When set to true the object will be instantiated on demand. Can only be used in root object definitions, not in inline definitions.
`id`	optional	The id the object should be registered with. If omitted the name of the property that produces (or holds) the object will be used as the id. Can only be used in root object definitions, not in inline definitions.
`order`	optional	The initialization order. Only considered for non-lazy singletons, processed in ascending order. Default `int.MAX_VALUE`.

Child Elements

Any tag listed in 14.1 through 14.5, ConstructorArgs, Property, All Custom Configuration Tags that implement the ObjectDefinitionDecorator interface.

17.9.3 DynamicObject

Metadata Tag	N/A
MXML and XML Namespace	`http://www.spicefactory.org/parsley`
MXML Tag	`<DynamicObject/>`
XML Tag	`<dynamic-object/>`
Detailed Explanation	8.7 Dynamic Objects

Attributes

`type`	required	The type of the object to create.
`id`	optional	The id the object should be registered with. If omitted the name of the property that produces (or holds) the object will be used as the id. Can only be used in root object definitions, not in inline definitions.

Child Elements

Any tag listed in 14.1 through 14.5, ConstructorArgs, Property, All Custom Configuration Tags that implement the ObjectDefinitionDecorator interface.

17.9.4 NestedObject

Metadata Tag	N/A
MXML Namespace	`http://www.spicefactory.org/parsley`
MXML Tag	`<NestedObject/>`
XML Tag	`N/A (simply use <object>)`
Detailed Explanation	Needed in MXML for inline object definitions.

Attributes

type required The type of the object to create.

Child Elements

Any tag listed in 14.1 through 14.5, ConstructorArgs, Property, All Custom Configuration Tags that implement the ObjectDefinitionDecorator interface.

17.9.5 View

Metadata Tag	N/A
MXML Namespace	`http://www.spicefactory.org/parsley`
MXML Tag	`<View/>`
XML Tag	`<view>`
Detailed Explanation	9.6 MXML and XML Configuration

Attributes

`type`	required	The type of the view that should be configured.
`id`	optional	The id of the view that should be configured.

Child Elements

Any tag listed in 14.1 through 14.5, all Custom Configuration Tags that implement the ObjectDefinitionDecorator interface except those that deal with object creation as the View tag configures objects which already have been created by the Flex framework.

17.9.6 ConstructorArgs

Metadata Tag	N/A
MXML and XML Namespace	`http://www.spicefactory.org/parsley`
MXML Tag	`<ConstructorArgs/>`
XML Tag	`<constructor-args/>`
Description	May be used to explicitly specify the constructor arguments in MXML or XML as a list of child tags

Attributes

None

Child Elements

Any tag listed in 17.9.12 Simple Values, Object, Array, StaticPropertyRef or any tag that is mapped to a simple object or a tag that implements NestedConfigurationElement.

17.9.7 Property

Metadata Tag	N/A
MXML and XML Namespace	`http://www.spicefactory.org/parsley`
MXML Tag	`<Property/>`
XML Tag	`<property/>`
Description	May be used to explicitly specify a property value in MXML or XML. The value may be a simple value or a dependency injected by type or by id.

Attributes

`name`	required	The name of the property.
`value`	optional	May be used for simple values (instead of a nested child node specifying the value).
`idRef`	optional	Specifies a dependency for this property, referring to another object in the container by id.
`typeRef`	optional	Specifies a dependency for this property, referring to another object in the container by type.
`required`	optional	Indicates whether the dependency is required (only applied if idRef or typeRef is set).

The attributes value, idRef and typeRef are mutually exclusive.

Child Elements

A single Child Elements may be used to specify the value for the property if neither value, idRef nor typeRef have been set as an attribute. Allowed are the same tags that are allowed as children of the ConstructorArgs tag: Any tag listed in 17.9.12 Simple Values, Object, Array, StaticPropertyRef or any tag that is mapped to a simple object or a tag that implements NestedConfigurationElement.

17.9.8 DynamicProperty

Metadata Tag	N/A
MXML and XML Namespace	`http://www.spicefactory.org/parsley`
MXML Tag	`<DynamicProperty/>`
XML Tag	`<dynamic-property/>`
Description	May be used to explicitly specify a property value for a dynamic class in MXML or XML. The value may be a simple value or a dependency injected by type or by id. This tag is useful for configuring generic Objects or a Dictionary for example.

Attributes

`name`	required	The name of the property.
`value`	optional	May be used for simple values (instead of a nested child node specifying the value).
`idRef`	optional	Specifies a dependency for this property, referring to another object in the container by id.
`typeRef`	optional	Specifies a dependency for this property, referring to another object in the container by type.
`required`	optional	Indicates whether the dependency is required (only applied if idRef or typeRef is set).

The attributes value, idRef and typeRef are mutually exclusive.

Child Elements

17.9.9 ObjectRef

Metadata Tag	N/A
MXML and XML Namespace	`http://www.spicefactory.org/parsley`
MXML Tag	`<ObjectRef/>`
XML Tag	`<object-ref/>`
Description	May be used to specify a reference to another object in the container by id or by type.

Attributes

`idRef`	optional	Specifies a dependency for this property, referring to another object in the container by id.
`typeRef`	optional	Specifies a dependency for this property, referring to another object in the container by type.
`required`	optional	Indicates whether the dependency is required (only applied if idRef or typeRef is set).

The attributes idRef and typeRef are mutually exclusive.

Child Elements

None.

17.9.10 Array

Metadata Tag	N/A
MXML and XML Namespace	`http://www.spicefactory.org/parsley`
MXML Tag	`<Array/>`
XML Tag	`<array/>`
Description	May be used to specify Array values in MXML or XML, specifying the elements as a list of child tags. Should be preferred over fx:Array if it contains special Parsley tags as children (they won't be processed within a regular fx:Array tag).

Attributes

None

Child Elements

Any tag listed in 17.9.12 Simple Values, Object, Array, StaticPropertyRef or any tag that is mapped to a simple object or a tag that implements NestedConfigurationElement.

17.9.11 StaticPropertyRef

Metadata Tag	N/A
MXML Tag	`N/A`
XML Namespace	`http://www.spicefactory.org/parsley`
XML Tag	`<static-property-ref/>`
Description	May be used to refer to a static property in XML configuration files. Not necessary in MXML configuration, use normal binding syntax in MXML (e.g. value="{Environment.CONSTANT}").

Attributes

`type`	required	The class the static property value should be fetched from.
`property`	required	The name of the static property.

Child Elements

None

17.9.12 Simple Values

For MXML configuration you can use the builtin tags to specify simple values like fx:String or fx:int. For XML configuration Parsley includes a number of tags that can be used for simple values:

string
boolean
int
uint
number
date
class
null

Example:

<object type="com.example.FooManager">
    <constructor-args>
        <string>Hello</string>
        <int>7</int>
        <boolean>true</boolean>
        <object-ref id-ref="barManager"/>
    </constructor-args>
</object>

17.9.13 Include

Metadata Tag	N/A
MXML Tag	`N/A`
XML Namespace	`http://www.spicefactory.org/parsley`
XML Tag	`<include/>`
Description	May be used to include additional XML configuration files. You can place any number of include tags in XML configuration files.

Attributes

filename required The name of the file to include.

Child Elements

None

17.9.14 Variable

Metadata Tag	N/A
MXML Tag	`N/A`
XML Namespace	`http://www.spicefactory.org/parsley`
XML Tag	`<variable/>`
Description	May be used to declare variables which may be used in XML attributes or text nodes with the notation `${variableName}`.

Attributes

`name`	required	The name of the variable.
`value`	required	The value of the variable.

Child Elements

None

17.10 Flex Component Wiring

17.10.1 Configure

Metadata Tag	N/A
MXML Namespace	`http://www.spicefactory.org/parsley`
MXML Tag	`<Configure/>`
XML Tag	N/A
Detailed Explanation	9.2 Explicit Component Wiring

Attributes

`targets`	optional	The objects that should be wired to the Context. If omitted only the document object the tag was placed in will be wired.
`reuse`	optional	Indicates whether the wiring should happen repeatedly whenever the object is added to the stage. When set to false it is only wired once. The default is true.
`autoremove`	optional	Indicates whether the wired objects should be removed from the Context when the view containing the Configure tag is removed from stage. The default is true.

17.11 Flex Logging

17.11.1 Target

Metadata Tag	N/A
MXML Tag	N/A (the builtin MXML tags for LogTargets can be used instead)
XML Namespace	`http://www.spicefactory.org/parsley/flex/logging`
XML Tag	`<target/>`
Required Initialization	`FlexLoggingXmlSupport.initialize()`
Detailed Explanation	15.1 Logging Configuration for Flex

Attributes

`id`	optional	The id of the `LogTarget`, usually not needed.
`type`	optional	The type (class) of the `LogTarget`, defaults to `TraceTarget` if omitted.
`level`	optional	The minimum level that this target should log.
attributes of `LineFormattedTarget`	optional	If the specified type extends `LineFormattedTarget` all properties of that class can be set: `field-separator`, `include-category`, `include-level`, `include-date`, `include-time`.

17.12 Flash Logging

17.12.1 LogFactory

Metadata Tag	N/A
MXML Tag	N/A
XML Namespace	`http://www.spicefactory.org/parsley/flash/logging`
XML Tag	`<factory/>`
Required Initialization	`FlashLoggingXmlSupport.initialize()`
Detailed Explanation	15.2 Logging Configuration for Flash

Attributes

`id`	optional	The id of the `LogFactory`, usually not needed.
`type`	optional	The type (class) of the `LogFactory`, defaults to `DefaultLogFactory` which is usually sufficient.
`context`	optional	Boolean attribute (defaults to `true`). Indicates whether this factory should be set as the factory for the `LogContext` class. Should only be set to `false` for special requirements.
`root-level`	optional	The default log level for loggers for which no level has been specified explicitly. Defaults to `LogLevel.TRACE`.

Child Elements

`appender`	optional	One or more Appenders that handle the log output. Usually at least one is required to see any output.
`logger`	optional	Configuration for individual loggers. Only required for loggers which should not use the `root-level`.

17.12.2 Logger

Metadata Tag	N/A
MXML Tag	N/A
XML Namespace	`http://www.spicefactory.org/parsley/flash/logging`
XML Tag	`<logger/>`
Required Initialization	`FlashLoggingXmlSupport.initialize()`
Detailed Explanation	15.2 Logging Configuration for Flash

Attributes

`name`	required	The name of the Logger.
`level`	required	The minum level this Logger should log. Valid values are `trace`, `debug`, `info`, `warn`, `error` and `fatal`.

Child Elements

None

17.12.3 Appender

Metadata Tag	N/A
MXML Tag	N/A
XML Namespace	`http://www.spicefactory.org/parsley/flash/logging`
XML Tag	`<appender/>`
Required Initialization	`FlashLoggingXmlSupport.initialize()`
Detailed Explanation	15.2 Logging Configuration for Flash

Attributes

`ref`	required	The id of the `Appender` class configured in the Parsley Context. For configuring the `Appender` itself you can use regular Parsley `<object>` tags.
`threshold`	required	The minum level this Appender should log. May be used as an additional filter mechanism in addition to the level settings for individual loggers. Valid values are `trace`, `debug`, `info`, `warn`, `error` and `fatal`.

Child Elements

None

17.13 Flash Localization

17.13.1 ResourceManager

Metadata Tag	N/A
MXML Tag	N/A
XML Namespace	`http://www.spicefactory.org/parsley/flash/resources`
XML Tag	`<resource-manager/>`
Required Initialization	`FlashResourceXmlSupport.initialize()`
Detailed Explanation	12.3 Localized Flash Applications

Attributes

`id`	optional	The id of the `ResourceManager`, usually not needed as you should only configure one `ResourceManager` instance and thus are able to inject it by type.
`type`	optional	The type (class) of the `ResourceManager`, defaults to `DefaultResourceManager` which is usually sufficient.
`cacheable`	optional	Boolean attribute (defaults to `false`). Indicates whether the ResourceManager should cache loaded bundles.
`persistent`	optional	Boolean attribute (defaults to `false`). Indicates whether the ResourceManager should store the last active locale in a Local Shared Object and restore it on the next application start.

Child Elements

locale optional The locales supported by this ResourceManager.

17.13.2 Locale

Metadata Tag	N/A
MXML Tag	N/A
XML Namespace	`http://www.spicefactory.org/parsley/flash/resources`
XML Tag	`<locale/>`
Required Initialization	`FlashResourceXmlSupport.initialize()`
Detailed Explanation	12.3 Localized Flash Applications

Attributes

`language`	optional	The language code for this locale, a lowercase ISO 639 code (e.g. `en` or `fr`).
`country`	optional	The country/region code for this locale, an uppercase ISO 3166 2-letter code (e.g. `US` or `FR`).

Child Elements

None

17.13.3 ResourceBundle

Metadata Tag	N/A
MXML Tag	N/A
XML Namespace	`http://www.spicefactory.org/parsley/flash/resources`
XML Tag	`<resource-bundle/>`
Required Initialization	`FlashResourceXmlSupport.initialize()`
Detailed Explanation	12.3 Localized Flash Applications

Attributes

`id`	required	The id of the bundle.
`basename`	required	The basename of files containing messages for this bundle. For the locale `en_US` for example the basename messages/tooltips will instruct Parsley to load the following files: `messages/tooltips_en_US.xml`, `messages/tooltips_en.xml` and `messages/tooltips.xml`.
`type`	optional	The type (class) of the `ResourceBundle`, defaults to `DefaultResourceBundle` which is usually sufficient.
`loader-factory`	optional	The type (class) of the `BundleLoaderFactory`, responsible for loading the bundle files. Defaults to `DefaultResourceBundle` which is usually sufficient.
`localized`	optional	Boolean attribute (defaults to `true`). If set to false the framework will only load the resources for the basename like `messages/tooltips.xml` and not look for files with localized messages.
`ignore-country`	optional	Boolean attribute (defaults to `false`). If set to true the framework will ignore the country code of the active locale for this bundle.

Child Elements

None

17.14 Pimento Data Services

17.14.1 Config

Metadata Tag	N/A
MXML and XML Namespace	`http://www.spicefactory.org/parsley/pimento`
MXML Tag	<Config/>
XML Tag	`<config/>`
Required Initialization for XML	`PimentoXmlSupport.initialize()`
Detailed Explanation	14.2 Pimento Data Services

Attributes

`id`	optional	The id of the configuration instance.
`url`	required	The URL that Pimento should connect to.
`timeout`	optional	Specifies the request timeout in milliseconds.

Child Elements

None

17.14.2 Service

Metadata Tag	N/A
MXML and XML Namespace	`http://www.spicefactory.org/parsley/pimento`
MXML Tag	<Service/>
XML Tag	`<service/>`
Required Initialization for XML	`PimentoXmlSupport.initialize()`
Detailed Explanation	14.2 Pimento Data Services

Attributes

`id`	optional	The id that this service will be registered with in the Parsley IOC Container.
`name`	required	The name of the service as registered on the server-side.
`type`	required	The AS3 service implementation (usually generated with Pimentos Ant Task).
`config`	optional	The id of the `PimentoConfig` instance to use for this service. Only required if you have more than one `config` tag in your Context. If there is only one (like in most use cases) it will be automatically detected.
`timeout`	optional	Specifies the request timeout in milliseconds.

17.15 Cinnamon Remoting

17.15.1 Channel

Metadata Tag	N/A
MXML and XML Namespace	`http://www.spicefactory.org/parsley/cinnamon`
MXML Tag	<Channel/>
XML Tag	`<channel/>`
Required Initialization for XML	`CinnamonXmlSupport.initialize()`
Detailed Explanation	14.3 Cinnamon Remoting

Attributes

`id`	optional	The id of the channel instance.
`url`	required	The URL that the channel should connect to.
`type`	optional	The type (class) of the channel, defaults to `NetConnectionServiceChannel`.
`timeout`	optional	Specifies the request timeout in milliseconds.

Child Elements

None

17.15.2 Service

Metadata Tag	N/A
MXML and XML Namespace	`http://www.spicefactory.org/parsley/cinnamon`
MXML Tag	<Service/>
XML Tag	`<service/>`
Required Initialization for XML	`CinnamonXmlSupport.initialize()`
Detailed Explanation	14.3 Cinnamon Remoting

Attributes

`id`	optional	The id that this service will be registered with in the Parsley IOC Container.
`name`	required	The name of the service as registered on the server-side.
`type`	required	The AS3 service implementation (usually generated with Pimentos Ant Task).
`channel`	optional	Reference to the id of the `ServiceChannel` instance. Only required if you have more than one `channel` tag in your Context. If there is only one (like in most use cases) it will be automatically detected.
`timeout`	optional	Specifies the request timeout in milliseconds.