使用JAXB和ICEfaces创建一个Tree
JAXB表示Java Architecture for XML Binding。它允许把Java和XML绑定在一起。这意味着你可以在Java程序中访问XML文档的数据。这对创建schema驱动的用户界面特别便利。它允许你在XML文档内设置所有的界面(UI)信息,改变内容更方便。
在ICEfaces中,tree组件是经常用到的组件之一。本文将说明怎样通过源自XML文档中的数据来建立tree组件作为菜单。我们不但要使用XML文档中的信息创建tree,还要使用tree来展示XML文档所包含的信息。
1)供访问和显示的数据文件为:treeDocument.xml。其包含的信息大致有:name,registry,crew size,ship type等。
2)Schema
首先要有一个一致的schema。一个xml schema是以.xsd形式的文档,也是一个xml规范,管理一个XML文档内的各组件是否允许。基本上,它是一个元素大纲,指示xml文档中的元素,如出现次序、带什么属性、其子元素又是什么等。JAXB需要用W3C Schema语法写的schema文档。这个schema将是treeDocument.xsd。它定义了<Fleet>元素作为一个复杂类型,子元素为<ship>,每一个<ship>还有<shipType>子元素,<shipType>又有子元素<name>,<registry>,<crewSize>。
3)绑定Schema
绑定schema包括一系列表示schema的java类。所有的JAXB实现都提供了一个绑定schema的工具。这个工具能调用大量依赖雨其实现的不同的方法。这里,我们使用命令行来执行jar方法(其它的方法可以参考JAXB的帮助文件)。这里可以有不同的方法来完成绑定处理,你可以复制整个JAXB目录到你的项目目录下,否则我们将复制你的schema文件到JABX/lib目录下,运行下面的命令行:
4)非编组(Unmarshalling)文档
非编组(Unmarshalling)文档意味着创建一个树状内容的对象来表示文档的组织。
要unmarshal一个文档:
(1)创建一个JAXBContext对象。它提供了JAXB API的入口点。
Import javax.xml.bind.JAXBContext;
JAXBContext jc=JAXBContext.newInstance(?com.icesoft.icefaces.resource.tutorial.component.jaxb?);
(2)建立Unmarshaller对象。
import javax.sml.bind.Unmarshaller;
Unmarshaller unmarshaller=jc.createUnmarshaller();
(3)调用unmarshal()方法。
Fleet fleet=(Fleet)unmarshaller.unmarshal(new File(?treeDocument.xml?));
(4)你可以选择使用一个单独的类用于JAXB管理器,也可以直接写代码到应用程序的bean中。这里把它写入treeBean类作为一个静态的模块。
static{
try{
jc=JAXBContext.newInstance("com.icesoft.icefaces.resource.tutorial.component.jaxb");
unmarshaller=(Unmarshaller)jc.createUnmarshaller();
fleet=(Fleet)unmarshaller.unmarshal(new File("treeDocument.xml"));
} catch(JAXBException ex){
ex.printStackTrace();
}
}
5)Backing Bean和Tree设置
一旦unmarshalling完成,就可以使用编译器创建的标准getters访问数据了。
public treeBean(){
Fleet.Ships shipTpe=fleet.getShips();
ArrayList shipList=(ArrayList)shipType.getShip();
ship1=(shipType)shipList.get(0);
ship2=(shipType)shipList.get(1);
...
}
一旦创建了Ship对象,就到把它们放入tree节点的时候了。
public treeBean(){
...
// create root node with its children expanded
rootTreeNode=new DefaultMutableTreeNode();
UrlNodeUserObject rootObject=new UrlNodeObject(rootTreeNode);
rootObject.setText("Fleet");
rootObject.setUrl("");
rootObject.setExpanded(true);
rootTreeNode.setUserObject(rootObject);
...
}
然后,增加每一个ship作为一个新节点。
public treeBean(){
...
// model is accessed by the ice:tree component
model=new DefaultTreeModel(rootTreeNode);
// add Ship1 child node
DefaultMutableTreeNode branchNode=new DefaultMutableTreeNode();
UrlNodeUserObject branchObject=new UrlNodeUserObject(branchNode);
branchObject.setText(ship1.getName());
branchNode.setUserObject(branchObject);
rootTreeNode.add(branchNode);
// add Ship2 child node
branchNode=new DefaultMutableTreeNode();
branchObject=new UrlNodeUserObject(branchNode);
branchObject.setText(ship2.getName());
branchNode.setUserObject(branchObject);
rootTreeNode.add(branchNode);
...
}
6)JSP页面和tree设置
现在该创建含tree的JSP页面了。由于我们的tree用panelStack来控制,我们将使用commandLink作为节点,并插入参数param。
<ice:panelGroup styleClass="treeContainer">
<ice:tree id="tree" value="#{treeBean.model}" var="item" hideRootNode="false"
hideNavigation="false" imageDir="./xmlhttp/css/xp/css-images/">
<ice:treeNode>
<f:facet name="content">
<ice:panelGroup style="display: inline">
<ice:commandLink value="#{item.userObject.text}" actionListener="#{panelStack.selectedPanelChangedAction}"
style="font-weight:bold; border:1px solid black; padding-right:2px; padding-left:2px; background-color:#ccd269">
</ice:commandLink>
</ice:panelGroup>
</f:facet>
</ice:treeNode>
</ice:tree>
</ice:panelGroup>
现在还需实现panelStack backing bean的selectedPanelChangedAction() 方法:
public void selectedPanelChangedAction(ActionEvent event){
FacesContext context=FacesContext.getCurrentInstance();
Map map=context.getExternalContext().getRequestParameterMap();
selectedPanel=(String)map.get("ships");
}
下一步是创建panel stack。
<ice:panelStack selectedPanel="#{panelStack.selectedPanel}" >
<ice:panelGroup id="Fleet">
<ice:outputText value="The 31st Exploratory Fleet" style="font-weight:bold; border:1px solid black;
background-color:#a4bdd2; padding-right:2px; padding-left:2px"/>
<br/><br/>
<ice:panelGroup style=" border:1px solid black; background-color:#a6a7a9; padding-right:2px; padding-left:2px">
<ice:outputText value="This Fleet contains 2 ships: the USS-JAXB and the USS-ICE.
Both are highly advanced and useful in many different scenarios. Use the tree links on the left to
see the details of the different ships." />
</ice:panelGroup>
</ice:panelGroup>
<ice:panelGroup id="USS-JAXB">
<ice:outputText value="Name:" style="font-weight:bold; border:1px solid black; background-color:#a4bdd2;
padding-right:2px; padding-left:2px"/>
<ice:outputText value="#{treeBean.ship1.name}" style="border:1px solid black; background-color:#a6a7a9;
padding-right:2px; padding-left:2px"/>
<br/><br/>
<ice:outputText value="Registry:" style="font-weight:bold; border:1px solid black; background-color:#a4bdd2; padding-right:2px;
padding-left:2px"/>
<ice:outputText value="#{treeBean.ship1.registry}" style="border:1px solid black; background-color:#a6a7a9;
padding-right:2px; padding-left:2px"/>
<br/><br/>
<ice:outputText value="Crew Size:" style="font-weight:bold; border:1px solid black; background-color:#a4bdd2; padding-right:2px;
padding-left:2px"/>
<ice:outputText value="#{treeBean.ship1.crewSize}" style="border:1px solid black; background-color:#a6a7a9;
padding-right:2px; padding-left:2px"/>
<br/><br/>
<ice:outputText value="Description:" style="font-weight:bold; border:1px solid black; background-color:#a4bdd2; padding-right:2px;
padding-left:2px"/>
<ice:outputText value="#{treeBean.ship1.description}" style="border:1px solid black; background-color:#a6a7a9;
padding-right:2px; padding-left:2px"/>
<br/><br/>
<ice:outputText value="Ship Type:" style="font-weight:bold; border:1px solid black; background-color:#a4bdd2; padding-right:2px;
padding-left:2px"/>
<ice:outputText value="#{treeBean.ship1.shipFleetType}" style="border:1px solid black; background-color:#a6a7a9;
padding-right:2px; padding-left:2px"/>
</ice:panelGroup>
7)结论
JAXB通过创建用户界面的schema为我们提供了一个极好的桥梁。
确定treeDocument.xml在指定路径中:
fleet=(Fleet)unmarshaller.unmarshal(new File("treeDocument.xml"));