Flash Doctors Syringe User Guide

<value>Here is a string.</value>

<value>123</value>
<value>-123.456</value>

<value>2006-07-18</value>
<value>14:23:17-06:00</value>
<value>2006-07-18T14:23:17-06:00</value>  

<value>1</value>
<value>false</value>

<ref bean="bean2"/>

<map>
  <entry>
    <key>something1</key>
    <value>value for something 1</value>
  </entry>
  <entry>
    <key>something2</key>
    <value type="Number">123</value>
  </entry>
</map>

<map>
  <entry>
    <key>pointer_a</key>
    <ref bean="bean1"/>
  </entry>
  <entry>
    <key type="Number">1</key>
    <ref bean="bean2"/>
  </entry>
</map>

<map>
  <entry>
    <key><ref bean="beanA"/></key>
    <ref bean="bean1"/>
  </entry>
  <entry>
    <key><ref bean="beanB"/></key>
    <ref bean="bean2"/>
  </entry>
</map>

<map>

  <entry key="k" value="abc, 123"/>

  <entry key="t" value="124" value-type="Number"/>

  <!-- key-ref points at another bean as the key value -->
  <entry key-ref="bean1" value="2352345"/>

  <!-- value-ref points at another bean as the value -->
  <entry key="j" value-ref="bean2"/>
  
  <!-- objects as key and value -->
  <entry key-ref="bean1" value-ref="bean2"/>

</map>

<list>
  <value>123</value>
  <ref bean="bean1"/>
  <value>My description</value>
  <value>2006-07-09</value>
</list>

<bean id="randomNumber" class="com.flashdoctors.util.RandomNumber"/>

<bean id="bean1" class="com.flashdoctors.test.RandomizedBean">
  <property name="myRandomNumber"><ref bean="randomNumber"/></property>
</bean>
<bean id="bean2" class="com.flashdoctors.test.RandomizedBean">
  <property name="myRandomNumber"><ref bean="randomNumber"/></property>
</bean>

In this example, if the RandomNumber class generated a unqiue random number every time it was created (accessable by calling toNumber() on it ), and the setMyRandomNumber method on the RandomizedBean objects took those RandomNumber instances. Each one would have a different random number to work with.

In this example, 2 beans could be created, bean1, and bean2. Both would be of type SimpleObject, and both would have title values of "Default Title", but bean1 would have and id value of 1, and bean2 would have an id value of 2.

<bean id="templateA" abstract="true" class="com.flashdoctors.test.SimpleObject">
  <property name="title"><value>Default Title</value></property>
</bean>

<bean id="bean1" parent="templateA">
  <property name="id"><value>1</value></property>
</bean>
<bean id="bean2" parent="templateA">
  <property name="id"><value>2</value></property>
</bean>

In this example, bean1 and bean2 would both have "5" as their second constructor arg, but each would have a unique first constructor-arg.

<bean id="templateA" abstract="true" class="com.flashdoctors.test.SimpleObject">
  <constructor-arg><value>Default Title</value></constructor-arg>
  <constructor-arg type="Number"><value>5</value></constructor-arg>
</bean>

<bean id="bean1" parent="templateA">
  <constructor-arg><value>Bean 1 Title</value></constructor-arg>
</bean>

<bean id="bean2" parent="templateA">
  <constructor-arg><value>Bean 2 Title</value></constructor-arg>
</bean>

When inheriting with constructor args, it's done by order of the constructor args. This is where the index attribute comes in handy, as it allows you to override certain constructor args.

In this example, bean1 and bean2 would both have "Default Title" as their first constructor arg, but each would have a unique 2nd and 3rd constructor-arg.

<bean id="templateA" abstract="true" class="com.flashdoctors.test.SimpleObject">
  <constructor-arg><value>Default Title</value></constructor-arg>
  <constructor-arg type="Number"><value>5</value></constructor-arg>
  <constructor-arg><value>Category</value></constructor-arg>
</bean>

<bean id="bean1" parent="templateA">
  <constructor-arg index="2" type="Number"><value>7</value></constructor-arg>
  <constructor-arg index="3" ><value>Category A</value></constructor-arg>
</bean>

<bean id="bean2" parent="templateA">
  <constructor-arg index="2" type="Number"><value>8</value></constructor-arg>
  <constructor-arg index="3" ><value>Category B</value></constructor-arg>
</bean>

<?xml version="1.0" charset="UTF-8"?>
<beans xmlns="http://www.flashdoctors.com/2006/07/Syringe">
  
  <bean id="bean1" "com.flashdoctors.test.SimpleObject" depends-on="bean2,bean3">
    <constructor-arg><value>Bean 1 Title</value></constructor-arg>
    <constructor-arg type="Number"><value>1</value></constructor-arg>
  </bean>

  <bean id="bean2" "com.flashdoctors.test.SimpleObject">
    <constructor-arg><value>Bean 2 Title</value></constructor-arg>
    <constructor-arg type="Number"><value>2</value></constructor-arg>
  </bean>

  <bean id="bean3" "com.flashdoctors.test.SimpleObject">
    <constructor-arg><value>Bean 2 Title</value></constructor-arg>
    <constructor-arg type="Number"><value>2</value></constructor-arg>
  </bean>
  
</beans>

<?xml version="1.0" charset="UTF-8"?>
<beans xmlns="http://www.flashdoctors.com/2006/07/Syringe">
  
  <bean id="bean1" "com.flashdoctors.test.SimpleObject" depends-on="bean2,bean3">
    <constructor-arg><value>Bean 1 Title</value></constructor-arg>
    <constructor-arg type="Number"><value>1</value></constructor-arg>
  </bean>

  <bean id="bean2" "com.flashdoctors.test.SimpleObject">
    <constructor-arg><value>Bean 2 Title</value></constructor-arg>
    <constructor-arg type="Number"><value>2</value></constructor-arg>
  </bean>

  <bean id="bean3" "com.flashdoctors.test.SimpleObject">
    <constructor-arg><value>Bean 2 Title</value></constructor-arg>
    <constructor-arg type="Number"><value>2</value></constructor-arg>
  </bean>

  <bean
    id="randomNumber"
    singleton="false"
    "com.flashdoctors.util.RandomNumber"/>
  
  <!-- the depends-on in this bean is actually not required, as the beans it includes are already directly referenced and would be created anyway -->
  <bean id="container1" "com.flashdoctors.test.ContentList" depends-on="randomNumber,bean1,bean2">
    <constructor-arg>
      <value>my_content</value>
    </constructor-arg>
    <property name="currentItemNumber">
      <ref bean="randomNumber"/>
    </property>
    <property name="items">
      <list>
        <ref bean="bean1"/>
        <ref bean="bean2"/>
      </list>
    </property>
  </bean>
  
</beans>

<?xml version="1.0" charset="UTF-8"?>
<beans xmlns="http://www.flashdoctors.com/2006/07/Syringe">

  <bean id="bean1" class="BasePathSetter">
    <property name="basePath" value="http://www.example.com/images/project1/"/>
  </bean>
  
  <bean id="image1" class="Image">
    <property name="location" value="test.jpg"/>
  </bean>
  <bean id="xml1" class="XMLFile">
    <property name="location" value="test.xml"/>
  </bean>
  <bean id="movie1" class="Movie">
    <property name="location" value="test.swf"/>
  </bean>

  
</beans>

interface ILocatable {
  public function setLocation( loc:String ):Void;
  public function getLocation():String;
}

class Image implements ILocatable, IInitilizingBean {
  // define Image class here...
  // including setLocation and getLocation methods

  public function afterPropertiesSet(){
    // actually load the image here...
  }
}
class XMLFile implements ILocatable, IInitilizingBean {
  // define XMLFile class here...
  // including setLocation and getLocation methods

  public function afterPropertiesSet(){
    // actually load the xml here...
  }
}
class Movie implements ILocatable, IInitilizingBean {
  // define Movie class here...
  // including setLocation and getLocation methods

  public function afterPropertiesSet(){
    // actually load the SWF here...
  }

}

import com.flashdoctors.syringe.bean.IBeanPostProcessor;

class BasePathSetter implements IBeanPostProcessor {
  private basePath:String;
  public function BasePathSetter(){
  }  
  public function setBasePath( bp:String ){
    this.basePath = bp;
  }

  public function postProcessBeforeInitialization( bean:Object, beanName:String ):Object{
     var loc:ILocatable = ILocatable(bean);
     if( loc != null ){
       // we have something that is locatable, go ahead and process it
       // in this case, we're going to add a URL prefix to the location
       loc.setLocation( this.basePath + loc.getLocation() );
     } else {
       // this object is not locatable, so don't do anything, just return it
       return bean;
     }
  }
  
  public function postProcessAfterInitialization( bean:Object, beanName:String ):Object{
    // we've already done our thing in postProcessBeforeInitialization, so just return the bean...
    return bean;
  }
}