S2Container标签参考

S2Container标签参考
DOCTYPE

DOCTYPE要在XML声明之后指定。请象下面那样指定。

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE components PUBLIC "-//SEASAR//DTD S2Container 2.3//EN"
"http://www.seasar.org/dtd/components23.dtd">
<components>
<component name="hello" class="examples.dicon.HelloConstructorInjection">
<arg>"Hello World!"</arg>
</component>
</components>

components标签(必须)

成为了根标签。
namespace属性(任意)

可以指定命名空间。做为Java的标识语来使用

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE components PUBLIC "-//SEASAR//DTD S2Container 2.3//EN"
"http://www.seasar.org/dtd/components23.dtd">
<components namespace="hoge">
...
</components>

include标签(任意)

将被分割的S2Container的定义读入的情况下使用。
path属性(必须)

可以指定定义文件的路径。相对于CLASSPATH所指定的路径为根的绝对路径。例如，WEB-INF/classes/aaa.dicon的情况下就指定为aaa.dicon 、WEB-INF/classes/aaa/bbb/ccc.dicon 的情况下就指定为 aaa/bbb/ccc.dicon 路径分隔符在Windows下Unix下都是/。

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE components PUBLIC "-//SEASAR//DTD S2Container 2.3//EN"
"http://www.seasar.org/dtd/components23.dtd">
<components>
<include path="aaa/bbb/ccc.dicon" />
</components>

component标签(任意)

定义组件。
class属性(任意)

指定类的完整合法名。在正文中，是用了OGNL式来指定组件的场合下，class的属性可以被省略。使用OGNL式来指定类的属性的时候，需要进行类型检查。
name属性(任意)

指定名称也可以。将做为Java的标示语来使用。详细情况请参照组件的取得。
instance属性(任意)

可以指定让S2Container对组件的实例如进行管理。可以指定singleton(默认)、prototype、outer、request、session几种类型。更详细的请参照实例管理。
autoBinding属性(任意)

S2Container可以指定如何解决组件之间的依存关系。有auto(默认)、constructor、property、none几种类型。详细，请参照自动绑定。
arg标签(任意)

做为component标签的子标签来使用的场合下，就成了构造函数的参数。根据记述的顺序传给构造函数。 做为initMethod标签、destroyMethod标签的子标签被使用的场合下，就成了方法函数的参数。按照记述的顺序传给方法函数。 做为参数被传递的实际值，要么在正文中使用OGNL式指定，要么在子标签中使用component标签指定。
property标签(任意)

做为component标签的子标签来使用。做为属性变量被设定的实际值，要么在正文中使用OGNL式指定，要么在子标签中使用component标签指定。
name属性(必须)

指定属性变量名。
bindingType属性(任意)

可以根据每一个属性变量进行细致的自动绑定控制。must、should(默认)、may、none几个类型可以用来指定。详细请参照自动绑定。
meta标签(任意)

做为components标签、component标签、arg标签、property标签的子标签来使用。META数据的值，要么在正文中使用OGNL式指定，要么在子标签中使用component标签指定。
name属性(任意)

指定META名。
initMethod标签(任意)

做为component标签的子标签使用。参数，在子标签中，使用arg标签指定。无须写出name属性，使用OGNL式也可以调用组件的方法。定义了initMethod标签的组件将做为表示组件自身#self、表示System.out#out、表示System.err#err等仅在initMethod标签内部有效的对象来使用。
name属性(任意)

指定方法名。

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE components PUBLIC "-//SEASAR//DTD S2Container 2.3//EN"
"http://www.seasar.org/dtd/components23.dtd">
<components>
<component class="java.util.HashMap">
<initMethod name="put">
<arg>"aaa"</arg>
<arg>111</arg>
</initMethod>
<initMethod>#self.put("aaa", 111)</initMethod>
<initMethod>#out.println("Hello")</initMethod>
</component>
</components>

destroyMethod标签(任意)

和initMethod标签一样。
aspect标签(任意)

将AOP组入到组件的定义中。详细请参照S2AOP的aspect标签的说明。
interType标签(任意)

象组件中组入interType。详请请参照S2AOP的interType标签的说明。
description标签(任意)

做为components标签、component标签、arg标签、property标签的子标签可以使用description标签。可以自由地记述说明。