UML软件工程组织

 
更多技术资源 文章，讲座 ,培训，咨询 请访问 www.uml.org.cn

 
用JBuilder2007开发扩展JSF标签的插件
 
作者： atomic_age 　　出处： 天极开发
 

本文将编写一个基于JSF标签的名为"locallyDefinedBean"插件。JSF标签可以在运行时将Bean变量加到JSP-JSF而中，在这里，我们将通过使用JSF EL（所谓JSF EL就是JSF EXPRESSION LANGUAGE）来模拟在设计时向JSP-JSF添加变量的过程。下面是具体的实现过程。

1. 首先，使用File-＞New-＞Project-＞Plug-in Project来建立一个空的插件工程，这个工程使用JBuilder2007提供的默认值，并在工程名中输入myplugin。如图1所示：


　图1

2. 打开工程浏览器，切换到dependencies标签。并加入如图2所示的依赖库。


　图2 dependencies标签

3. 通过File-＞New-＞Class建立一个Java类： LocallyDeclaredBeanFactory.，并使这个类从org.eclipse.jst.jsf.context.symbol.internal.provisional.source.AbstractContextSymbolFactory继承。如图3所示。


　图3

4. 打开Java源码编辑器。你将看到两个根据抽象类自动产生的方法。然后将supports方法替换为我们自己的supports方法。代码如下：

public boolean supports(IAdaptable context)
{
　return context.getAdapter(IStructuredDocumentContext.class) != null;
}

上面的代码表示只能调用IstructuredDocumentContext工厂。

5. 使用如下的代码替换internalCreate中的代码

protected ISymbol internalCreate(String symbolName, int scope, IAdaptable context, List problems)
{
　//得到上下文
　final IStructuredDocumentContext sContext =(IStructuredDocumentContext)
context.getAdapter(IstructuredDocumentContext.class);
　// 为上下文建立一个DOM上下文
　final IDOMContextResolver domResolver =
IStructuredDocumentContextResolverFactory.INSTANCE.getDOMContextResolver(sContext);

　if (domResolver != null)
　{
　　final Node curNode = domResolver.getNode();

　　// node必须是XML属性
　　if (curNode instanceof Attr)
　　{
　　　final Attr attr = (Attr) curNode;
　　　final Node owningElement = attr.getOwnerElement();
　　　if (owningElement != null)
　　　{
　　　　IProject iProject = workspaceResolver.getProject();
　　　　if (iProject != null)
　　　　{
　　　　　return handleSymbolCreation(symbolName, sContext, attr, owningElement, iProject);
　　　　}
　　　}
　　}
　}
　return null;
}

6. 下面让我们加一个private方法来建立符号(Symbol)。

private ISymbol handleSymbolCreation(final String symbolName,
final IStructuredDocumentContext context,
final Attr attr,
final Node owningElement,
final IProject project)
{
　// 建立Tab库
　final ITaglibContextResolver resolver =IStructuredDocumentContextResolverFactory.INSTANCE
.getTaglibContextResolver(context);

　if (resolver == null || !resolver.canResolveContext(context))
　{
　　return null;
　}
　final String uri = resolver.getTagURIForNodeName(owningElement);
　IBeanInstanceSymbol beanSymbol = null;
　// 处理核心标签库
　if ("http://oracle.com/tutorial/fake/taglib".equals(uri))
　{
　　final String elementName = owningElement.getLocalName();
　　final String attrName = attr.getName();
　　if ("locallyDeclaredBean".equals(elementName))
　　{
　　　if ("var".equals(attrName))
　　　{
　　　　final NamedNodeMap attrMap = owningElement.getAttributes();
　　　　final Node baseNameNode = attrMap.getNamedItem("classname");

　　　　if (baseNameNode instanceof Attr)
　　　　{
　　　　　// 得到bean的名字
　　　　　final String className = ((Attr)baseNameNode).getValue();
　　　　　// 建立一个新的空Bean实例符号
　　　　　beanSymbol = SymbolFactory.eINSTANCE.createIBeanInstanceSymbol();
　　　　　beanSymbol.setName(attr.getValue());
　　　　　try
　　　　　{
　　　　　　IJavaProject javaProject = JavaCore.create(project);
　　　　　　IType type = javaProject.findType(className);

　　　　　　if (type != null)
　　　　　　{
　　　　　　　IJavaTypeDescriptor2 javaTypeDescriptor = SymbolFactory.eINSTANCE.createIJavaTypeDescriptor2();
　　　　　　　javaTypeDescriptor.setType(type);
　　　　　　　beanSymbol.setJavaTypeDescriptor(javaTypeDescriptor);
　　　　　　}
　　　　　}
　　　　　catch (JavaModelException jme)
　　　　　{
　　　　　}
　　　　}
　　　}
　　}
　}
　return beanSymbol;
}

7. 加入注释(annotations)元数据

我们的最终目标是加入如下的标签：

＜t:locallyDeclaredBean var="x" classname="beans.MyBean"/＞

声明一个变量"x"来处理"beans.MyBean"。为了通过框架，我们必须使用无数据来注释t::locallyDeclaredBean。

首先让我们在工程中建立一个metadata文件夹。在通过File-＞New-＞File来建立一个metadata.xml文件，如图4如示。


　图4

打开这个文件，在其中输入如下的内容。

＜?xml version="1.0" encoding="UTF-8"?＞
＜grammar-annotation xmlns="http://org.eclipse.jsf.core/grammarAnnotationSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://org.eclipse.jsf.core/grammarAnnotationSchema D:\\EclipseWTPLatest\\WTPWorkspace\\org.eclipse.jst.jsf.core\\schema\\grammar-annotations.xsd "＞
　＜cm-element name="locallyDeclaredBean"＞
　　＜cm-attribute name="var"＞
　　　＜property name="contributes-value-binding"＞
　　　　＜ value＞true＜/value＞
　　　＜/property＞
　　　＜property name="value-binding-scope"＞
　　　　＜value＞request＜/value＞
　　　＜/property＞
　　　＜property name="value-binding-symbol-factory"＞ ＜value＞tutorial.locallyDeclaredBean＜/value＞
　　　＜/property＞
　　＜/cm-attribute＞
　＜/cm-element＞
＜/grammar-annotation＞

8. 实现扩展

为了声明我们的标签工厂，需要使用两个扩展点。首先我们需要扩展注释扩展点，这个扩展点用于声明我们刚才定义框架的元数据。其次，我们将注册这个工厂的ID。

打开plugin.xml，并且选择Extensions标签，单击"Add"按钮，选择org.eclipse.jst.jsf.contentmodel.annotations.annotationFile扩展点。选择这个扩展点后，通过右键菜单New-＞annotationFile加入一个注释文件。并输入相应的uri和location。如图5所示。


　图5

这个扩展点可以通知这个框架当一个标签库使用uri：http://oracle.com/tutorial/fake/taglib查询元数据时查看metadata.xml文件。接下来，我们需要声明一个扩展点：org.eclipse.jst.jsf.context.symbol.contextSymbolFactory，这个扩展点声明了我们的工厂，并且给它一个唯一的ID。如图6所示。


　图6

我们要注意的是在factory属性中的值要匹配"value-binding-symbol-factory"属性的值。否则这个框架不能发现我们的工厂类。

我们现在已经完成了标签的定义。但我们还需要构造一个动态的Web工程，以便测试我们的作品。

为了建立一个动态的Web工程，我们首先为这个插件建立一个新的运行时工作台。我们可以通过Run-＞Run…来建立这个工作台。如图7所示。


　图7

一但这个工作台被装载，就可以使用New-＞Project-＞Other来建立一个Dynamic Web 工程了。

在建立完动态Web工程后，在META-INF文件夹上通过右键菜单中的New-＞File新键一个叫tutorial.tld的文件。它的内容如下：

＜?xml version="1.0" encoding="GB2312" ?＞

＜!DOCTYPE taglib
PUBLIC "-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.2//EN"
"http://java.sun.com/dtd/web-jsptaglibrary_1_2.dtd"＞
＜taglib＞
　＜tlib-version＞1.0＜/tlib-version＞
　＜jsp-version＞1.2＜/jsp-version＞
　＜short-name＞tutorial＜/short-name＞
　＜uri＞http://oracle.com/tutorial/fake/taglib＜/uri＞
　＜tag＞
　　＜name＞locallyDeclaredBean＜/name＞
　　＜tag-class＞foo＜/tag-class＞
　　＜tei-class＞foo＜/tei-class＞
　　＜body-content＞empty＜/body-content＞
　　＜attribute＞
　　　＜name＞var＜/name＞
　　　＜required＞true＜/required＞
　　　＜rtexprvalue＞false＜/rtexprvalue＞
　　＜/attribute＞
　　＜attribute＞
　　　＜name＞classname＜/name＞
　　　＜required＞true＜/required＞
　　　＜rtexprvalue＞false＜/rtexprvalue＞
　　＜/attribute＞
　＜/tag＞
＜/taglib＞

最后，在src目录中建立一个叫beans.MyBean的文件，它的内容如下：

package beans;public class MyBean
{
　public String getFooProperty()
　{
　　return "foo!";
　}
}

建立一个测试JSP

现在让我们在WebContent目录中建立一个用于测试的JSP文件。然后在这个JSP文件中输入如下的内容：

＜%@page contentType="text/html"%＞
＜%@page pageEncoding="GB2312"%＞
＜%@taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c"%＞
＜%@taglib uri="http://java.sun.com/jsf/core" prefix="f"%＞
＜%@taglib uri="http://java.sun.com/jsf/html" prefix="h"%＞
＜%@taglib uri="http://oracle.com/tutorial/fake/taglib" prefix="t" %＞

＜!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd"＞
＜html＞
＜head＞
　＜meta http-equiv="Content-Type" content="text/html; charset=GB2312"＞
　＜title＞JSP 页＜/title＞
＜/head＞
＜body＞
　＜f:view＞
　　＜h1＞JSP 页＜/h1＞
　　＜t:locallyDeclaredBean var="x" classname="beans.MyBean"/＞
　　＜h:outputText value="#{}"/＞
　＜/f:view＞
＜/body＞
＜/html＞

现在让我们注意几点。首先，我们有一个前缀为"t"的标签库。其次，我们已经使用被定义为"x"的locallyDeclaredBean标签声明了一个Bean。这就是我们上面所描述的"beans.MyBean"。

现在让我们测试它。将你的光标放到outputText标签的空"{}"中，然后按Ctrl-Space调用内容助手。你将看到如图8所示的界面。


　图8

你可以在Bean的属性中在x后加一个"."，如图9所界面将被显示。


　图9

 

组织简介 | 联系我们 |   Copyright 2002 ®  UML软件工程组织 京ICP备10020922号

京公海网安备110108001071号