扩展seam组件

任何一个框架都必须拥有一个非常重要的功能：可扩展性。JBoss Seam在这个方面得到了最高的分数。理由非常简单。The main goal, to introduce consistent programming model that will make various frameworks to work together, is not just promoted for application developer, but also used through-out Seam itself.所以，通过了解如何使用组件模型并快速深入其内部原理后，你就能便捷地开始扩展内置组件。
首先，你需要了解组件开发的流程。Seam程序由context listener启动，context listener则通过根据配置实例化Initialization对象来生成。而这些配置依次来自于以下几个部分：
1、WEB-INF/components.xml和不建议使用的WEB-INF/events.xml
2、servlet context和classpath根目录下的seam.properties
3、用@Name注解的Seam组件
然后，依赖管理器通过评估组件依赖关系来决定加载哪些组件。
在这里，Seam会用到另外一个注解[email=[ft=#108ac6,2,]——@Install]——@Install[/email]。它并不仅仅指定是否加载某个组件及其依赖的组件（该功能还可以通过配置文件来覆盖），同时还指定了组件的优先权。如果两个组件拥有相同的名称，并且同时存在，依赖管理器就会加载具有更高优先级的那个。
这里的优先级是由预先定义的整型常量指定：
1、BUILT_IN [0]用于内置组件
2、FRAMEWORK [10]用于继承自Seam的框架
3、APPLICATION [20]，默认的优先级，用于程序中的组件
4、DEPLOYMENT [30]用于在particular deployment中复写的组件
5、MOCK [40]用于在测试中使用到的对象
以下两个注解提供了组件在部署过程中的更多控制功能：
1、@BypassInterceptors：让Seam拦截在某个个类或者方法上失效
2、@Startup在相应的scope中初始化组件，让其生效
通过了解以上部分，你就可以扩展任何组件，不管是Seam内置的组件还是第三方提供的框架或程序。
扩展Identity对象
作为示例，我将向你展示，如何扩展内置的Identity对象，让其能够支持自定义的JAAS登录模块...
As example I’ll show you how to extend built-in identity object to support custom JAAS Login Module that requires custom callback handler to be used to obtain/provide further information. This particular implementation adds functionality to support NTLM as other authentication method (together with customized jCIFS library) and NTLM support iself is not part of this code snapshot.


Java代码

@Name(”org.jboss.seam.security.identity”)
@Scope(SESSION)
@Install(precedence = APPLICATION)
@BypassInterceptors
@Startup
public class NTLMIdentity extends Identity {

//
// custom code
//

@Override
public String login() {
try {
retrieveNTLMAuthenticationDetails();
} catch (LoginException le) {
log.error(”Unable to retrieve NTLM authentication details!”, le);
return null;
}
}

@Override
protected CallbackHandler getDefaultCallbackHandler() {
return new CallbackHandler() {
public void handle(Callback[] callbacks)
throws IOException, UnsupportedCallbackException {
for (int i = 0; i < callbacks.length; i++) {
if (callbacks instanceof NameCallback) {
((NameCallback) callbacks).setName(getUsername());
} else if (callbacks instanceof PasswordCallback) {
((PasswordCallback) callbacks).setPassword(getPassword() != null ?
getPassword().toCharArray() : null);
} else if (callbacks instanceof SFSIdentityCallbackHandler) {
processSFSCallbackHandler((SFSIdentityCallbackHandler) callbacks);
} else {
throw new UnsupportedCallbackException(callbacks, “Unsupported callback”);
}
}
}
};
}

//
// custom code
//
}
@Name(”org.jboss.seam.security.identity”)
@Scope(SESSION)@Install(precedence = APPLICATION)@BypassInterceptors@Startuppublic class NTLMIdentity extends Identity { custom code//@Overridepublic String login() { try { retrieveNTLMAuthenticationDetails(); } catch (LoginException le) { log.error(”Unable to retrieve NTLM authentication details!”, le); return null; }}@Overrideprotected CallbackHandler getDefaultCallbackHandler() { return new CallbackHandler() { public void handle(Callback[] callbacks) throws IOException, UnsupportedCallbackException { for (int i = 0; i < callbacks.length; i++) { if (callbacks instanceof NameCallback) { ((NameCallback) callbacks).setName(getUsername()); } else if (callbacks instanceof PasswordCallback) { ((PasswordCallback) callbacks).setPassword(getPassword() != null ? getPassword().toCharArray() : null); } else if (callbacks instanceof SFSIdentityCallbackHandler) { processSFSCallbackHandler((SFSIdentityCallbackHandler) callbacks); } else { throw new UnsupportedCallbackException(callbacks, “Unsupported callback”); } } } }; } // // custom code //}