一个好老好老的老程序员了。
全部博文（915）
分类： Java
2011-04-09 23:26:27
所谓“Seasar2”就是一个“轻量级容器”，面向无法摆脱“Java 应用开发”之烦恼的所谓“开发者”，它能够保证开发的“高生产率和高品质”。并且同“其它轻量级容器”不同的是，“完全不需要书写设定文件”，“就算是应用程序发生改动也无需再次起动即可直接识别变更，因此具有脚本语言的灵活性”。
为了不用写设定文件也能够运行，Convention over Configuration的思想得以采用。Convention over Configuration就是指，“只要遵守一个适当的规约，即使不用进行非常麻烦的设定，框架结构也可以自动替我们搞定的思想”，这一思想是中所倡导的。Seasar2的Convention over Configuration是从Ruby on Rails 那里得到的提示而产生的。
使用Seasar2的话，对于仅仅需要维护数据表这样简单的应用，可以在不到3分钟的时间里作成。
应用程序发生改动之时也无需启动便可立即识别变更的机能在Seasar2里被称为HOT deploy。
安装：
S2需要安装JDK1.4 or JDK1.5。
将S2xxx.zip解压之后的seasar2目录引入到Eclipse、「文件→导入→既存的工程」。
使用Seasar2基本功能(S2Container, S2AOP)的时候、CLASSPATH的下面必须包含以下文件。
使用Seasar2的扩张机能(S2JTA, S2DBCP, S2JDBC, S2Unit, S2Tx, S2DataSet)的时候必须要将以下文件追加到CLASSPATH里面。
根据应用软件所需的执行环境、选择以下需要引用的文件[geronimo-j2ee_1.4_spec-1.0.jar、geronimo-jta_1.0.1B_spec-1.0.jar、geronimo-ejb_2.1_spec-1.0.jar]
| 环境 | geronimo-j2ee_1.4_spec-1.0.jar | geronimo-jta_1.1_spec-1.0.jar | geronimo-ejb_2.1_spec-1.0.jar |
|---|---|---|---|
| 不完全对应J2EE的Servlet container (Tomcat等) |
不要 | 要 (使用S2JTA,S2Tx的时候) |
要 (使用S2Tiger的时候) |
| 完全对应J2EE的应用服务器 (JBoss, WebSphere, WebLogic等) |
不要 | 不要 | 不要 |
| 独立 | 要 (使用S2JTA,S2Tx时候) |
不要 | 不要 |
为了让大家更简单的体验数据库机能、使用了HSQLDB作为RDBMS。为了能够体验Oracle机能、准备了hsql/sql/demo-oracle.sql。SQL*Plus等执行了之后、请根据环境的需要改写jdbc.dicon的。
。
想使用EJB3anoteshon的情况下、将 S2TigerXXX.zip解压缩后的s2-tiger目录引入Eclipse、「文件→导入→既存的工程」。 在Seasar2的设定基础上、必需要将以下的文件追加到CLASSPATH里面。
想使用Tigeranoteshon的情况、将S2TigerXXX.zip解冻后的s2-tiger目录引入Eclipse、「文件→进口→既存的项目」。 在Seasar2的设定基础上、必需要将以下的文件追加到CLASSPATH里面。
S2Container，就是进行Dependency Injection（注:依赖注入——译者）（以后略称为DI）的一个轻量级容器。DI，就是Interface和实装分离，程序相互之间仅通过Interface来会话的一种思考方式。
让我们赶快试一试吧。登场人物如下。
问侯语的Interface。
package examples.di; public interface Greeting { String greet(); } GreetingImpl.java问候语的实装。
package examples.di.impl; import examples.di.Greeting; public class GreetingImpl implements Greeting { public String greet() { return "Hello World!"; } } GreetingClient.java使用问候语的使用者客户端Interface。
package examples.di; public interface GreetingClient { void execute(); } GreetingClientImpl.java使用问候语的客户端的实装。不是直接使用这个GreetngImpl(实装)，而是通过Greeting（Interface）来实现问候的机能。
package examples.di.impl; import examples.di.Greeting; import examples.di.GreetingClient; public class GreetingClientImpl implements GreetingClient { private Greeting greeting; public void setGreeting(Greeting greeting) { this.greeting = greeting; } public void execute() { System.out.println(greeting.greet()); } }机能提供端和使用端的准备都完成了。下面我们就执行一下试试吧。
GreetingMain.javapackage examples.di.main; import examples.di.Greeting; import examples.di.impl.GreetingClientImpl; import examples.di.impl.GreetingImpl; public class GreetingMain { public static void main(String[] args) { Greeting greeting = new GreetingImpl(); GreetingClientImpl greetingClient = new GreetingClientImpl(); greetingClient.setGreeting(greeting); greetingClient.execute(); } }实行结果如下。
Hello World!象这样机能的使用者(GreetingClientImpl)经由Interface(Greeting)的中介来使用机能，具体的机能对象(既Interface的实装类)在实行的时候由第三者(在这里是GreetingMain)来提供的情况，就是DI的基本思考方法。
但是，如果象GreetingMain中那样实装类的设定内容直接被写出来的话，一旦实装类需要变更的时候源代码也必须跟着修正。为了避免这个麻烦，DIContainer就登场了。把实装设定抽出到一个设定文件中，由DIContainer把这个设定文件读入并组织对象运行。
那么，让我们试着把刚才的提到的那个设定文件的内容写一下。S2Container中，设定文件的后缀是".dicon"。
GreetingMain2.dicon
上文记载的是组件的定义。在这里，相当于如下的Java代码。
Greeting greeting = new GreetingImpl();component标签的name属性指定了组件的名称，class属性指定了组件的Java类文件名。下文就是greetingClient的设定。
property标签的name属性指定了组件Java类中的属性名，标签的定义体则指定了一个组件名称。这个设定相当于如下Java代码。组件名要注意不要用["]括起来。用["]括起来的话就会被当作字符串来处理了。
GreetingClientImpl greetingClient = new GreetingClientImpl(); greetingClient.setGreeting(greeting);利用S2Container的起动类的内容如下。
GreetingMain2.javapackage examples.di.main; import org.seasar.framework.container.S2Container; import org.seasar.framework.container.factory.S2ContainerFactory; import examples.di.GreetingClient; public class GreetingMain2 { private static final String PATH = "examples/di/dicon/GreetingMain2.dicon"; public static void main(String[] args) { S2Container container = S2ContainerFactory.create(PATH); container.init(); GreetingClient greetingClient = (GreetingClient) container.getComponent("greetingClient"); greetingClient.execute(); } }S2Container，是由S2ContainerFactory#create(String path)做成的。更加详细的内容请参照。
组件(greetingClient)，是由S2Container#getComponent(String componentName)的方法取得的。详细内容请参照。
实行结果同先前一样表示如下。
Hello World!经常同DI一起使用的是AOP。AOP是指、将日志等的输出分散到复数个类中的逻辑模块化的一种技术。那么、让我们不修改已经作成的GreetingImpl、GreetingClinetImpl的源代码?试着将日志（追踪）输出。 适用于AOP的设定文件如下。
GreetingMain3.diconSeasar2中，经常使用的AOP模块在aop.dicon中预先定义。 象下面这样、使用include标签。 更加详细的?敬请参照。
对于在组件中适用的AOP来说?我们的字标签 的正文中指定AOP的模块名称。aop.traceInterceptor是AOP模块的名字。
AOP的设定如上所述。那么就让我们执行一下GreetingMain3吧。同GreetingMain2不同的仅仅是设定文件的路径而已。
GreetingMain3.javapackage examples.di.main; import org.seasar.framework.container.S2Container; import org.seasar.framework.container.factory.S2ContainerFactory; import examples.di.GreetingClient; public class GreetingMain3 { private static final String PATH = "examples/di/dicon/GreetingMain3.dicon"; public static void main(String[] args) { S2Container container = S2ContainerFactory.create(PATH); GreetingClient greetingClient = (GreetingClient) container.getComponent("greetingClient"); greetingClient.execute(); } }执行结果如下。可以明白一点，没有修改源代码，日志就被输出了。
DEBUG 2005-10-11 21:01:49,655 [main] BEGIN examples.di.impl.GreetingClientImpl#execute() DEBUG 2005-10-11 21:01:49,665 [main] BEGIN examples.di.impl.GreetingImpl#greet() DEBUG 2005-10-11 21:01:49,665 [main] END examples.di.impl.GreetingImpl#greet() : Hello World! Hello World! DEBUG 2005-10-11 21:01:49,675 [main] END examples.di.impl.GreetingClientImpl#execute() : null这样、S2Container的基本使用方法就被掌握了。
但是，不管怎么说书写设定文件都是一件麻烦的事啊。在S2Container中，为了尽可能的减少设定文件的记述量、采用了如下的概念。
就是说制定一个适当的规约，遵守这个规约的话?无需什么设定也可以运作。比如说，刚才的设定文件中，象下面这样明确地指定属性的部分存在着。
S2Container中、属性的类型是Interface的情形下? 如果要将属性类型的实装组件注册进软件容器中， 不需要什么特殊的设定也可以自动得运作DI的机能。 这就是，如果遵守DI中推荐的所谓“属性类型用Interface定义”的规则，S2Container会自动地处理一切。
虽然一说到规约就容易产生麻烦之类的想法，“推荐而已，如果遵守的话就能使开发愉快”的话，遵守规约的动机就产生了。这才是问题的重点。
如上的设定，可以做如下化简
实际上?刚才的AOP的例子也适用“Convention over Configuration”。 通常在AOP中，AOP的模块在什么地方适用是由pointcut指定的，的情况下? 如果遵守所谓“使用Interface”这个推荐的规约，不指定pointcut，自动的适用于在Interface中定义的所有方法。因为有这个机能，在刚才的那个例子中，就没有必要指定pointcut。
虽然根据“Convention over Configuration”，DI和AOP的设定可以得以简化，需要处理的组件数增加了、仅仅组件的注册也会变成一个非常累的作业。那么这个组件注册自动化就叫做机能。 刚才的GreetingImpl、GreetingClientImpl的注册自动化如下。
FileSystemComponentAutoRegister组件将addClassPattern方法指定的类从文件系统中探寻出来，自动注册到S2Container中。关于initMethod标签，请参照。
addClassPattern方法的第一个参数是想要注册的组件的包的名字。 子包的内容也会用回归的方式检索。第二个参数是类的名字。可以使用正则表达式。也可以用“,”做分隔符指定复数个设定。
根据组件自动注册原则，即使后续追加组件的情况下，也没有必要追加设定，这样手续就大大地简化了。
如果组件的自动化注册可以了，接下来就会想让AOP的注册也自动化了吧。刚才的GreetingImpl、GreetingClientImp的AOP注册自动化的设定如下。
用interceptor属性指定AOP的名称。addClassPattern方法同组件的自动化注册时的用法一样，这里就不做特殊的说明了。 组件自动化注册和AOP自动化注册的例子如下。
GreetingMain4.dicon那么来执行一下GreetingMain4吧。 自动注册的情况下，S2Container#init()和S2Container#destroy()的调用是必要的。
GreetingMain4.javapackage examples.di.main; import org.seasar.framework.container.S2Container; import org.seasar.framework.container.factory.S2ContainerFactory; import examples.di.GreetingClient; public class GreetingMain4 { private static final String PATH = "examples/di/dicon/GreetingMain4.dicon"; public static void main(String[] args) { S2Container container = S2ContainerFactory.create(PATH); container.init(); try { GreetingClient greetingClient = (GreetingClient) container.getComponent("greetingClient"); greetingClient.execute(); } finally { container.destroy(); } } }执行的结果同GreetingMain3一样如下列出。
DEBUG 2005-10-12 16:00:08,093 [main] BEGIN examples.di.impl.GreetingClientImpl#execute() DEBUG 2005-10-12 16:00:08,103 [main] BEGIN examples.di.impl.GreetingImpl#greet() DEBUG 2005-10-12 16:00:08,103 [main] END examples.di.impl.GreetingImpl#greet() : Hello World! Hello World! DEBUG 2005-10-12 16:00:08,103 [main] END examples.di.impl.GreetingClientImpl#execute() : null大多数的情况下?自动注册和自动绑定的组合方式都能顺利的进行下去。不想要自动注册的组件存在的情况下，自动注册组件中准备了addIgnoreClassPattern方法，可以指定自动注册外的组件。
不想要自动绑定的属性存在的情况下，使用，不使用设定文件也可以做细节的调整。
使用的话?应用程序在运行中重新书写更换类文件，马上就能够直接测试结果。不需要一个一个地将应用程序在启动，因此开发的效率能够得到大幅度的提高。
现在，关于S2Container的高级使用方法也可以掌握了。这之后嘛，只要根据需要参照对应的操作手册就可以了。
为了使用S2Container，定义文件的做成是必要的。定义文件就像是为了组织组件而制作的设计书一样的东西。形式为XML，后缀为dicon。
S2Container的定义、象下面这样。
DOCTYPE是不能省略的。dicon做成的时候、请将前述例子拷贝粘贴。根是。每一个组件用定义。用component标签的class属性指定组件的类的全名。在name属性中、指定组件的名称。详细内容请参照。
S2Container的生成方法有两种。
使用SingletonS2ContainerFactory的情况下，使用如下方法。
- org.seasar.framework.container.factory.SingletonS2ContainerFactory#init()
定义文件使用的是CLASSPATH所指定的路径中存在的app.dicon。
做成的S2Container，无论在什么地方都是可以从如下方法中取得。
- org.seasar.framework.container.factory.SingletonS2ContainerFactory#getContainer()
SingletonS2ContainerFactory.init(); ... S2Container container = SingletonS2ContainerFactory.getContainer();定义文件的路径需要被指定的情况下应在调用init()之前执行如下方法。
- org.seasar.framework.container.factory.SingletonS2ContainerFactory#setConfigPath(String Path)
参数path是相对于以CLASSPATH指定的路径为根的定义文件的绝对路径。例如，WEB-INF/classes/aaa.dicon 的情况下就是aaa.dicon，WEB-INF/classes/aaa/bbb/ccc.dicon的情况下就是aaa/bbb/ccc.dicon。分隔符在Windows和Unix下都是/。
private static final String PATH = "aaa/bbb/ccc.dicon"; ... SingletonS2ContainerFactory.setConfigPath(PATH); SingletonS2ContainerFactory.init(); ... S2Container container = SingletonS2ContainerFactory.getContainer();使用S2ContainerFactory的场合下，使用如下方法。
- org.seasar.framework.container.factory.S2ContainerFactory#create(String path)
S2Container生成之后需要许呼叫下一个方法。
- org.seasar.framework.container.S2Container#init()
private static final String PATH = "aaa/bbb/ccc.dicon"; ... S2Container container = S2ContainerFactory.create(PATH); container.init();用这个方法取得的组件的实例，有必要进行在应用中的管理。
从S2Container中将组件取出来，使用下面的方法。
- org.seasar.framework.container.S2Container#getComponent(Object componentKey)
参数中指定的是组件的类或者是组件的名称。详细的请参照。要指定组件的类，只要是 组件 instanceof 类 的操作返回为true的类就能够指定。但是、S2Container中所指定的类对应了好几个实装的组件的时候，S2Container将不能判断返回哪一个组件为好，这样就会发生TooManyRegistrationRuntimeException。请指定实装组件为唯一的类。也可以用组件名称取得组件。这种情况下也是同样，用一个名称的复数个组件被注册的情况下，将发生TooManyRegistrationRuntimeException。指定组件名的场合下，因为也可能发生拼写错误，所以尽可能的指定组件的类为好。
例）通过指定类来取得组件的场合
S2Container container = S2ContainerFactory.create(PATH); Hoge hoge = (Hoge) container.getComponent(Hoge.class);例）通过指定组件名来取得组件场合
S2Container container = S2ContainerFactory.create(PATH); Hoge hoge = (Hoge) container.getComponent("hoge");在Dependency Injection中，组件的构成所必要的值是用构造函数来设定(Constructor Injection)，还是用设定函数来设定(Setter Injection)，或者是用初始化函数来设定(Method Injection)，这样进行分类。Method Injection是S2Container的本源。S2Container支持以上所有类型和混合类型。
对构造函数的参数进行DI，这就是构造函数注入。
S2Container的定义文件中，记述如下内容。
设定函数注入是指对于任意一个属性变量使用设定函数来行使DI。
S2Container的定义文件中作如下内容的记述。
方法函数注入是指，通过任意一个函数的调用来完成DI的功能。
S2Container的定义文件中，记述如下内容。
所有的组件用一个文件来设定的话，很快就会变得臃肿而难以管理。因此，S2Container就具有了将组件的定义进行复数个分割的机能和将多个分割的定义文件引入而组织成一个文件的机能。S2Container定义文件的引入方法如下。
的path属性被用来指定想要引入的S2Container定义文件的路径。详细情况请参照。
组件的检索顺序，先是在自身注册的文件中寻找组件，没有找到所需组件的情况下，将按照include的顺序在子定义文件中查找注册到S2Container中的组件，最先找到的那个组件将被返回。
组件的定义被分割的情况下，为了不让复数个组件的定义名称发生冲突，可以用的namespace属性指定命名空间。
foo.dicon在同一个组件定义文件中可以不需要指定命名空间而调用组件。调用其它S2Container文件中定义的组件时，要在组件名前加上命名空间。foo.aaa 和 bar.aaa 虽然有相同名称的组件，但是因为命名空间的不同，就被认为是不同的组件。
在S2Container中，怎么样对实例进行管理，这个设定是用的instance属性。
| instance属性 | 说明 |
|---|---|
| singleton(default) | 不论S2Container.getComponent()被调用多少次都返回同一个实例。 |
| prototype | S2Container.getComponent()每次被调用的时候都返回一个新的实例。 |
| request | 对应每一个请求(request)做成一个实例。用name属性中指定的名称，组件被容纳在请求中。使用request的场合下需要设定。 |
| session | 对应每一个session做成一个实例。用name属性中指定的名称，组件被容纳在session中。使用session的场合下需要设定。 |
| application | 使用Servlet的场合下，对应每一个ServletContext做成一个实例。用name属性中指定的名称，组件被容纳在ServletContext中。使用application的场合下需要设定。 |
| outer | 组件的实例在S2Container之外作成，从而仅仅行使Dependency Injection的功能。、不能适用。 |
使用initMethod 和 destroyMethod组件的生存周期也可以用容器来管理。在S2Container的开始时用(S2Container.init())调用中指定的方法，S2Container结束时用(S2Container.destroy())调用中指定的方法。initMethod将按照容器中注册的组件的顺序来执行组件，destroyMethod则按照相反的顺序去执行。instance属性是singleton之外的情况下，指定了destroyMethod也会被忽视。java.util.HashMap#put()方法中初始化(给aaa赋值为111)?结束处理(给aaa赋值为null)的设定，向下面那样。
组件间的依存关系，类型是interface的场合时，将由容器来自动解决。这是在S2Container被默认的，指定的autoBinding属性可以进行更加细致的控制。
| autoBinding | 说明 |
|---|---|
| auto(default) | 适用于构造函数和属性变量的自动绑定。 |
| constructor | 适用于构造函数的自动绑定。 |
| property | 适用于属性变量的自动绑定。 |
| none | 只能对构造函数、属性变量进行手动绑定。 |
构造函数的自动绑定规则如下所示。
属性变量的自动绑定规则如下。
用property标签的bindingType属性，可以更加细致的控制属性变量。
| bindingType | 说明 |
|---|---|
| must | 自动绑定不适用的情况下?将会发生例外。 |
| should(default) | 自动绑定不适用的情况下，将发出警告通知。 |
| may | 自动绑定不适用的情况下，什么都不发生。 |
| none | autoBinding的属性虽然是auto、property情况下，自动绑定也不适用。 |
不想让组件依存于S2Container的情况下，根据组件的具体情况，在组件中需要调用S2Container的方法，这样的场合也许会存在。S2Container自身也以container的名称，自我注册了。所以可以在arg,property标签的正文中指定container，从而取得容器的实例。还有，S2Container类型的setter方法定义好了后也可以做自动绑定的设定。用arg,property标签指定container的情况下，向下面这样进行。
到此为止，在Java application中，是用明确表示的方法做成S2Container的，Web application的情况下，由谁来作成S2Container呢？为了达到这个目的，准备了以下的类。
为了使用S2ContainerServlet，在web.xml中记述如下项目。
用configPath来指定作为根的S2Container的定义路径。定义文件将放在WEB-INF/classes中。对于S2ContainerServlet，为了比其它的servlet更早的起动，请做load-on-startup标签的调整。S2ContainerServlet起动之后，可以用如下的方法函数取得S2Container的实例。
另外，S2Container的生命周期和S2ContainerServlet是连动的。debug变量被设为true的话，按照以下的方法，可以将运行中的S2Container再次起动。xxx是Web application的context名。
在使用了S2ContainerServlet的情况下，ServletContext将会作为一个组件可以用servletContext的名字来访问。
根的S2Container的定义文件，按照惯例用app.dicon的名称。通常放在WEB-INF/classes中就好了。
在组件中的适用情况也可以被设定。比如，想要在ArrayList中设定使用的情况下需要象下面这样做。
aspect标签的正文中指定的名字。pointcut的属性中可以用逗号做分隔符指定AOP对象的方法的名字。pointcut的属性没有被指定的情况下，组件将把实装的interface的所有方法函数作为AOP的对象。方法函数的名称指定也可以用正则表达式(JDK1.4のregex)。这样的定义例子如下。
private static final String PATH = "examples/dicon/Aop.dicon"; S2Container container = S2ContainerFactory.create(PATH); List list = (List) container.getComponent(List.class); list.size(); Date date = (Date) container.getComponent(Date.class); date.getTime(); date.hashCode(); date.toString();执行结果。
BEGIN java.util.ArrayList#size() END java.util.ArrayList#size() : 0 BEGIN java.util.Date#getTime() END java.util.Date#getTime() : 0 BEGIN java.util.Date#hashCode() BEGIN java.util.Date#getTime() END java.util.Date#getTime() : 0 END java.util.Date#hashCode() : 0 BEGIN java.util.Date#getTime() END java.util.Date#getTime() : 0组件中也可以设定的适用情况。比如，在Hoge中设定的适用情况如下进行。
在interType标签的正文中指定的名称。
在components、component、arg、property标签中也可以指定Meta数据。meta标签将作为需要指定Meta数据的标签的字标签来指定Meta数据。例如，想要在components标签中指定Meta数据的情况时，象下面一样设定。
对于组件来说，也可以进行HttpServletRequest的自动绑定。为了实现这个目的，在组件中，定义了setRequest(HttpServletRequest request)方法。这样的话，S2Container就自动得设定了request。还有，需要象下面这样在web.xml中进行Filter的定义。
同样地对HttpServletResponse、HttpSession、ServletContext也是只要定义了setter方法，就可以自动绑定了。而且，使用了S2ContainerFilter的话，HttpServletRequest、HttpServletResponse、HttpSession、ServletContext就可以各自用request、response、session、application的名字来做为组件被自由访问了。
根据的原理，DI的设定几乎可以做近乎全部的自动化。 使用就有可能进行更加细致的设定。 更进一步、对组件的注册也进行自动化的话，就可以称为组件的自动注册机能了。
是从文件系统中将类检索出来对组件进行自动注册的组件。
| 属性 | 说明 |
|---|---|
| instanceDef | 在自动注册的组件中指定适用的InstanceDef。用XML指定的场合下， @org.seasar.framework.container.deployer.InstanceDefFactory@REQUEST 这样来指定。 |
| autoBindingDef | 在自动注册的组件中指定适用的AutoBindingDef。用XML指定的场合下， @org.seasar.framework.container.assembler.AutoBindingDefFactory@NONE 这样来指定。 |
| autoNaming | 可以根据类名来自动决定组件名的组件。需要实装 org.seasar.framework.container.autoregister.AutoNaming interface。默认状态下，使用org.seasar.framework.container.autoregister.DefaultAutoNaming类的实例。 |
| 方法 | 说明 |
|---|---|
| addClassPattern | 将想要自动注册的类模式注册。最开始的一个参数是组件所在包的名字。子包也能被以回归的方式进行检索。第二个参数是类的名字。可以使用正则表达式。也可以用“,”分隔做复数个设定。 |
| addIgnoreClassPattern | 将不想自动注册的类模式注册。最开始的一个参数是组件所在包的名字。子包也能被以回归的方式进行检索。第二个参数是类的名字。可以使用正则表达式。也可以用“,”分隔做复数个设定。 |
从Jar文件中检索类自动注册组件的组件。
| 属性 | 说明 |
|---|---|
| jarFileNames | 指定设定对象的jar文件名。可以使用正则表达式。但是能包含后缀。指定复数个对象的场合下，用“,”做分割符。例如，myapp.*, yourapp.*这样。 |
| referenceClass | 用这个属性指定的类所属的jar文件的父路径为基础路径(例如，WEB-INF/lib)。默认的是org.aopalliance.intercept.MethodInterceptor.class。 |
| instanceDef | 适用于自动注册的组件的InstanceDef的指定。在XML中如下， @org.seasar.framework.container.deployer.InstanceDefFactory@REQUEST 这样指定。 |
| autoBindingDef | 适用于自动注册的组件的AutoBindingDef的指定。在XML中如下， @org.seasar.framework.container.assembler.AutoBindingDefFactory@NONE 这样指定。 |
| autoNaming | 根据类名自动决定组件的名称的组件。需要对org.seasar.framework.container.autoregister.AutoNaming interface 进行实装。默认的情况下是org.seasar.framework.container.autoregister.DefaultAutoNaming类的实例。 |
| 方法 | 说明 |
|---|---|
| addClassPattern | 将想要自动注册的类模式注册。最开始的一个参数是组件所在包的名字。子包也能被以回归的方式进行检索。第二个参数是类的名字。可以使用正则表达式。也可以用“,”分隔做复数个设定。 |
| addIgnoreClassPattern | 将不想自动注册的类模式注册。最开始的一个参数是组件所在包的名字。子包也能被以回归的方式进行检索。第二个参数是类的名字。可以使用正则表达式。也可以用“,”分隔做复数个设定。 |
将类从文件系统或者Jar文件中检索出来并将组件自动注册的组件。
| 属性 | 说明 |
|---|---|
| instanceDef | 适用于自动注册的组件的InstanceDef的指定。在XML中如下，@org.seasar.framework.container.deployer.InstanceDefFactory@REQUEST这样指定。 |
| autoBindingDef | 适用于自动注册的组件的AutoBindingDef的指定。在XML中如下， @org.seasar.framework.container.assembler.AutoBindingDefFactory@NONE 这样指定。 |
| autoNaming | 从类的名称来自动决定组件的名称的组件。需要对org.seasar.framework.container.autoregister.AutoNaming instance进行实装。默认的是 org.seasar.framework.container.autoregister.DefaultAutoNaming类的实例。 |
| 方法 | 说明 |
|---|---|
| addReferenceClass | 以这个方法所指定的类所存在的路径或者Jar文件为基点对类进行检索。 |
| addClassPattern | 将想要自动注册的类模式注册。最开始的一个参数是组件所在包的名字。子包也能被以回归的方式进行检索。第二个参数是类的名字。可以使用正则表达式。也可以用“,”分隔做复数个设定。 |
| addIgnoreClassPattern | 将不想 自动注册的类模式注册。最开始的一个参数是组件所在包的名字。子包也能被以回归的方式进行检索。第二个参数是类的名字。可以使用正则表达式。也可以用“,”分隔做复数个设定。 |
根据AutoNaming来控制组件名称。
从类的完整合法名称中将类的包的那部分名称去掉，如果结尾是Impl或者Bean也要去掉，之后将开头的字母变成小写做为组件名称来设定。 例如，aaa.HogeImpl类的情况下，组件的名称就成了hoge。
| 属性 | 说明 |
|---|---|
| decapitalize | 组件名的开头字母为小写的情况下指定为true。默认值是true。 |
| 方法 | 说明 |
|---|---|
| setCustomizedName | 不依从于默认的规则对类进行注册。第一个参数是类的完整合法名。第二个参数是组件的名称。 |
| addIgnoreClassSuffix | 指定从类名的尾端消除的部分。注册默认值为Impl以及Bean。 |
| addReplaceRule | 根据正则表达式追加替换规则。第一个参数为正则表达式。第二个参数为向要替换的字符串。 |
| clearReplaceRule | 用setCustomizedName、addIgnoreClassSuffix、addReplaceRule将注册的变换规则清零。作为默认值被注册的Impl和Bean也被清零。 |
将包的名字或者是一部分类的合法名做为组件名称的设定。从类的完整合法名的最后把Impl或者Bean去掉，开头字母小写，分隔点后紧接着的字母变成大写并取掉分隔点，将这个新的单词设定为组件的名称。
可以将包的开头的不要的部分做消除指定。
例如，aaa.bbb.ccc.ddd.HogeImpl类的情况下，将开头的aaa.bbb做消除指定的情况下组件的名称为，cccDddHogeになります。
| 属性 | 说明 |
|---|---|
| decapitalize | 组件名的开头字母为小写的情况下指定为true。默认值是true。 |
| 方法 | 说明 |
|---|---|
| setCustomizedName | 遵从默认的规则来注册类。第一个参数是类的完整合法名。 第二个参数是组件的名称。 |
| addIgnorePackagePrefix | 从包名称的开头开始指定消除的部分。 |
| addIgnoreClassSuffix | 类名称的最末尾开始指定消除的部分。默认地将Impl和Bean注册。 |
| addReplaceRule | 根据正则表达式追加替换规则。第一个参数为正则表达式。第二个参数是替换的新字符串。 |
| clearReplaceRule | 将setCustomizedName、 addIgnorePackagePrefix、 addIgnoreClassSuffix、 addReplaceRule注册的替换规则清除。默认注册的Impl以及Bean也将被清除。 |
根据规则，组件的注册可以做到自动化。进一步，AOP的注册也可以做到自动化，这就是AOP的自动注册机能。
和组件的自动注册功能组和使用的场合下，必须在组件的自动注册设定之后，作AOP的自动注册的设定。对于适用于使用AOP的组件的记述，必须在AOP的自动注册设定之后进行。
通过指定类名的模式来进行AOP的自动注册的组件。
| 属性 | 说明 |
|---|---|
| interceptor | 指定interceptor。想要指定复数个interceptor的场合下，请使用。 |
| pointcut | 适于使用interceptor的方法用逗号分隔开进行指定。不指定pointcut的情况下，实装组件的interface的所有方法都做为interceptor的对象。对于方法名称也可以使用正则表达式(JDK1.4のregex)来指定。 |
| 方法 | 说明 |
|---|---|
| addClassPattern | 将想要自动注册的类的模式注册。第一个参数是组件的包的名。子包也可以用回归的方法检索。第二个参数是类名。可以使用正则表达式。用“,”分隔可以做复数个记述。 |
| addIgnoreClassPattern | 将不想自动注册的类模式注册。第一个参数是组件的包的名。子包也可以用回归的方法检索。第二个参数是类名。可以使用正则表达式。用“,”分隔可以做复数个记述。 |
针对某个interface的实装类进行AOP的自动注册的组件。
| 属性 | 说明 |
|---|---|
| interceptor | 指定interceptor。想要指定复数个interceptor的场合下，请使用。 |
| targetInterface | 针对某一指定的interface的实装组件，使用AOP。 |
META信息也可以自动注册。
同组件的自动注册相组合使用的场合下，必须在组件的自动注册设定之后，做META的自动注册的设定记述。 调用META信息的组件必须在META自动注册的设定之后记述。
通过指定类名的模式来做META自动注册的组件。
被自动注册的META数据，将做为在这个组件自身的定义中一个叫做autoRegister的META数据的子数据来记述。
| 方法 | 说明 |
|---|---|
| addClassPattern | 将想要自动注册的类模式注册。第一个参数是组件所在包的名字。子包也将被用回归的方式所检索。第二个参数是类名。可以使用正则表达式。用“,”做分隔符号，可以做复数个记述。 |
| addIgnoreClassPattern | 将不想自动注册的类模式注册。第一个参数是组件所在包的名字。子包也将被用回归的方式所检索。第二个参数是类名。可以使用正则表达式。用“,”做分隔符号，可以做复数个记述。 |
本例中、叫做hoge的META数据自动地注册到其它的组件定义中。
一直以来，更改了源代码并重新编译之后的场合，想要测试编译后的机能，必须让应用程序（确切地说是ClassLoader)再起动。在应用程序服务器上，进行程序再起动将非常花时间。 “真烦人”这样想的人很多不是吗。
在Seasar2中，应用程序在运行中，即使类文件替换了，也可以即刻测试的Hotswap机能得以实现。这样就让我们从那种“心情烦躁”中解放出来了。无须花费多余的时间使得出产率得以提高。这样的好东西，不想试一试吗？
Greeting.javapackage examples.hotswap; public interface Greeting { String greet(); } GreetingImpl.javapackage examples.hotswap.impl; import examples.hotswap.Greeting; public class GreetingImpl implements Greeting { public String greet() { return "Hello"; } } hotswap.dicon到此为止，并没有什么特别的变化。关键点从此开始。 使用s2container.dicon，切换成hotswap模式。
s2container.dicon把s2container.dicon根据class path放到根路径下的话，就能被自动识别到。也可以使用S2ContainerFactory#configure()明确地指定。
GreetingMain.diconpackage examples.hotswap.main; import org.seasar.framework.container.S2Container; import org.seasar.framework.container.factory.S2ContainerFactory; import examples.hotswap.Greeting; public class GreetingMain { private static final String CONFIGURE_PATH = "examples/hotswap/dicon/s2container.dicon"; private static final String PATH = "examples/hotswap/dicon/hotswap.dicon"; public static void main(String[] args) throws Exception { S2ContainerFactory.configure(CONFIGURE_PATH); S2Container container = S2ContainerFactory.create(PATH); System.out.println("hotswapMode:" + container.isHotswapMode()); container.init(); try { Greeting greeting = (Greeting) container .getComponent(Greeting.class); System.out.println(greeting.greet()); System.out.println("Let's modify GreetingImpl, then press ENTER."); System.in.read(); System.out.println("after modify"); System.out.println(greeting.greet()); } finally { container.destroy(); } } }为了使用hotswap，有必要调用S2Container#init()。 执行了的话"Hello"表示出来后，程序就停止了，所以将GreetingImpl#greet()修改并编译使之表示"Hello2"。这之后，请将文字终端显示窗口调成聚焦状态并按下ENTER键。虽然是用同一个instance也没有关系，class文件被替换了的事实可以很容易的被测知。这个是为singleton的场合下的例子，为prototype的场合下，类将在调用S2Container#getComponent()的时刻被置换。
执行结果hotswapMode:true Hello Let's modify GreetingImpl, then press ENTER. after modify Hello2为了使用hotswap，组件提供了interface，组件的利用者方面，必须通过interface来利用组件。 为request、session的情况下，对于一个组件不能被其它的组件调用的场合来说，没有interface也可以利用hotswap。
DOCTYPE要在XML声明之后指定。请象下面那样指定。
成为了根标签。
可以指定。做为Java的标识语来使用
将被分割的S2Container的定义的情况下使用。
可以指定定义文件的路径。相对于CLASSPATH所指定的路径为根的绝对路径。例如，WEB-INF/classes/aaa.dicon的情况下就指定为aaa.dicon 、WEB-INF/classes/aaa/bbb/ccc.dicon 的情况下就指定为 aaa/bbb/ccc.dicon 路径分隔符在Windows下Unix下都是/。
定义组件。
指定类的完整合法名。在正文中，是用了来指定组件的场合下，class的属性可以被省略。使用OGNL式来指定类的属性的时候，需要进行类型检查。
指定名称也可以。将做为Java的标示语来使用。详细情况请参照。
可以指定让S2Container对组件的实例如进行管理。可以指定singleton(默认)、prototype、outer、request、session几种类型。更详细的请参照。
S2Container可以指定如何解决组件之间的依存关系。有auto(默认)、constructor、property、none几种类型。详细，请参照。
做为的子标签来使用的场合下，就成了构造函数的参数。根据记述的顺序传给构造函数。 做为、的子标签被使用的场合下，就成了方法函数的参数。按照记述的顺序传给方法函数。 做为参数被传递的实际值，要么在正文中使用指定，要么在子标签中使用指定。
做为的子标签来使用。做为属性变量被设定的实际值，要么在正文中使用指定，要么在子标签中使用指定。
指定属性变量名。
可以根据每一个属性变量进行细致的自动绑定控制。must、should(默认)、may、none几个类型可以用来指定。详细请参照。
做为、、、的子标签来使用。META数据的值，要么在正文中使用指定，要么在子标签中使用指定。
指定META名。
做为的子标签使用。参数，在子标签中，使用指定。无须写出name属性，使用也可以调用组件的方法。定义了initMethod标签的组件将做为表示组件自身#self、表示System.out#out、表示System.err#err等仅在initMethod标签内部有效的对象来使用。
指定方法名。
和initMethod标签一样。
将AOP组入到组件的定义中。详细请参照S2AOP的的说明。
象组件中组入interType。详请请参照S2AOP的的说明。
做为、、、的子标签可以使用description标签。可以自由地记述说明。
在S2Container中，做为表达式语言可以利用。在XML中，将用字符串记述的内容(式)变换成相应的对象为目的的东西，这一观点一定要记住不要搞错了。
详细请参照。
在S2Container中，做为备注码的实装方法，准备了Tiger备注码?backport175备注码?定数备注码共3个种类。一般说起备注码的话，都是指从Java 5导入的Tiger备注码，但是仅仅如此的话，JDK1.4的使用者将不可能利用这一个特性了。
为了尽可能地让更多的人乐意方便地使用备注码，在JDK1.4中，可以使用Tiger风格的备注码(JSR-175) 备注码，是利用public static final这样的常量定义来完成备注码功能的。
的代替方法是Component备注码。
Tiger备注码的利用方式如下。
@Component(name="xxx", instance=InstanceType.PROTOTYPE, autoBinding=AutoBindingType.PROPERTY) public class Xxx { ... }backport175备注码的利用方式如下。
/** * @org.seasar.framework.container.annotation.backport175.Component( * name = "xxx", * instance = "prototype", * autoBinding = "property") */ public class Xxx { ... }常量备注码的利用方式如下。
public static final String COMPONENT = "name = xxx, instance = prototype, autoBinding = property";的替代方法、是Binding备注码。
Tiger方式的备注码如下。
@Binding("aaa2") public void setAaa(String aaa) { ... } @Binding(bindingType=BindingType.NONE) public void setBbb(String bbb) { ... } @Binding public void setCcc(String ccc) { ... }backport175方式的备注码如下。
/** * @org.seasar.framework.container.annotation.backport175.Binding("aaa2") */ public void setAaa(String aaa) { ... } /** * @org.seasar.framework.container.annotation.backport175.Binding(bindingType="none") */ public void setBbb(String bbb) { ... } /** * @org.seasar.framework.container.annotation.backport175.Binding */ public void setCcc(String ccc) { ... }常量备注码要用属性变量名_BINDING这样来指定。
public static final String aaa_BINDING = "aaa2"; public static final String bbb_BINDING = "bindingType=none"; public static final String ccc_BINDING = null; public void setAaa(Aaa aaa) { ... } public void setBbb(Bbb bbb) { ... } public void setCcc(Ccc ccc) { ... }的替代使用方法是、Aspect备注码。与aspect标签不同，因为可以定义复数个定义? 想要适用于复数个intercepter的情况下?请使用。想要指定pointcut的时候?请指定pointcut属性。对于类中的备注码来说，不指定pointcut是?那个类中的所有实装自interface的方法都将被指定。
Tiger方式的备注码如下。
@Aspect("aop.traceInterceptor") public class Xxx { ... } public class Xxx { ... @Aspect("aop.traceInterceptor") public void hoge() { ... } }backport175方式的备注码如下。
/** * @org.seasar.framework.container.annotation.backport175.Aspect( * "aop.traceInterceptor") */ public class Xxx { ... } public class Xxx { ... /** * @org.seasar.framework.container.annotation.backport175.Aspect( * "aop.traceInterceptor") */ public void hoge() { ... } }常量备注码的形式如下。想要指定复数个pointcut的情况下，请象pointcut= get.*\nexecute.*这样用\n做分隔。 不能使用\n之外的其它分隔文字。
public static final String ASPECT = "value=aop.traceInterceptor, pointcut=getAaa";的替代使用方法是InterType备注码。
Tiger方式的备注码如下。
@InterType({"aop.propertyInterType", "aop.someInterType"}) public class Xxx { ... }backport175方式的备注码如下。
/** * @org.seasar.framework.container.annotation.backport175.InterType( * {"aop.propertyInterType", "aop.someInterType"}) */ public class Xxx { ... }常量方式的备注码如下。
public static final String INTER_TYPE = "aop.propertyInterType, aop.someInterType";的代替使用方法是InitMethod备注码。 与initMethod标签不同，OGNL式的使用和参数的设定都不可以。
Tiger方式的备注码如下。
public class Xxx { ... @InitMethod public void init() { ... } }backport175方式的备注码如下。
public class Xxx { ... /** * @org.seasar.framework.container.annotation.backport175.InitMethod */ public void init() { ... } }常量方式的备注码如下。想要指定复数个初始化方法的情况下，请用逗号(,)做分隔符。
public static final String INIT_METHOD = "init";的替代使用方式是DestroyMethod备注码。 与destroyMethod标签不同，OGNL式的使用，参数的设定都不可以。
Tiger方式的备注码如下。
public class Xxx { ... @DestroyMethod public void destroy() { ... } }backport175方式的备注码如下。
public class Xxx { ... /** * @org.seasar.framework.container.annotation.backport175.DestroyMethod */ public void destroy() { ... } }常量备注码如下。想要指定复数个初始化方法的情况下，请用逗号(,)做分隔符。
public static final String DESTROY_METHOD = "destroy";