then you don't need the Extensions Filter.
However, if you use some of the MyFaces' extended components like t:inputFileUpload, t:inputHTtml, t:inputCalendar, ...
then you most likely need to have this filter configured in your webapp.
大概意思是Q如果你在项目中没有使用到Myfaces的扩展组Ӟt:开头的Q，则你不需要配|这个Filter.
可是Q如果你用了Myfaces的扩展组Ӟ你必Mؓ(f)你的webE序配置q个Filter.
配置如下Q?BR>
<filter> <filter-name>MyFacesExtensionsFilter</filter-name> <filter-class>org.apache.myfaces.component.html.util.ExtensionsFilter</filter-class> <init-param> <param-name>maxFileSize</param-name> <param-value>20m</param-value> <description>Set the size limit for uploaded files. Format: 10 - 10 bytes 10k - 10 KB 10m - 10 MB 1g - 1 GB </description> </init-param></filter><!-- extension mapping for adding <script/>, <link/>, and other resource tags to JSF-pages --><filter-mapping> <filter-name>MyFacesExtensionsFilter</filter-name> <!-- servlet-name must match the name of your javax.faces.webapp.FacesServlet entry --> <servlet-name>Faces Servlet</servlet-name></filter-mapping><!-- extension mapping for serving page-independent resources (javascript, stylesheets, images, etc.) --><filter-mapping> <filter-name>MyFacesExtensionsFilter</filter-name> <url-pattern>/faces/myFacesExtensionResource/*</ url-pattern></filter-mapping>要用MyFaces的tomahawk控gQ要在页面引?lt;%@ taglib uri="在页面中dtree2的标{：(x)
<t:tree2 id="sortTree" var="node" varNodeToggler="t" showRootNode="false" value="#{tree.treeData}">
</t:tree2>public class TreeBacker implements Serializable
{
public TreeNode getTreeData ( )
{ TreeNode treeData = new TreeNodeBase ( "foo-folder" , "Inbox" , false ) ; TreeNodeBase personNode = new TreeNodeBase("person", "Eddie L", false); //personNode.getChildren().add(new TreeNodeBase("document","Eddie doc one", true)); TreeNodeBase doc = new TreeNodeBase("document","Eddie doc one", true); doc.setIdentifier("No.1"); personNode.getChildren().add(doc); treeData.getChildren().add(personNode); System.out.println ( "Create Tree ..ok" ) ; return treeData ;
}
}其中TreeNodeBase personNode = new TreeNodeBase("person", "Eddie L", false);中的"person"的作用是表示渲染得时候显CZ么样式，
跟页面中<f:facet name="person"></f:facet>相对应?BR>在页面中
<f:facet name="person"> <h:panelGroup> <f:facet name="expand"> <t:graphicImage value="../images/person.png" rendered="#{t.nodeExpanded}" border="0" /> </f:facet> <f:facet name="collapse"> <t:graphicImage value="../images/person.png" rendered="#{!t.nodeExpanded}" border="0" /> </f:facet> <h:outputText value="#{node.description}" styleClass="nodeFolder" /> </h:panelGroup></f:facet><t:graphicImage value="../images/person.png" rendered="#{t.nodeExpanded}" border="0" />昄Tree每一个节点的囄。rendered属性的意思是是否渲染的意思，
jsf中渲染的意思是把jsflg?wi)当前的状态{换成html。在jsf的生命周期里Q渲染响应在最后一个周期，renderedgؓ(f)false在渲染相应这个周期就不运行?BR>在处理叶子节点上Q需要特D的注意。因为对叶子节点是需要操作的。可能需要点d子节点连接到一个页面，或者执行某些action{?BR>
<f:facet name="document"> <h:panelGroup> <h:commandLink immediate="true" styleClass="#{t.nodeSelected ? 'documentSelected':'document'}" actionListener="#{t.setNodeSelected}" action="#{tree.okListener}" id="clickbutton"> <t:graphicImage value="../images/document.png" border="0" /> <h:outputText value="#{node.description}" /> <f:param name="docNum" value="#{node.identifier}" /> </h:commandLink> </h:panelGroup></f:facet>FacesContext context = FacesContext.getCurrentInstance ( ) ;//取得上下?/SPAN>String a = context.getExternalContext ( ).getRequestParameterMap ( ) .get ( "docNum" ).toString ( ) ;a的值就是docNum的倹{?BR>identifier的值在创徏?wi)的时候一起加q去的：(x)
TreeNodeBase doc = new TreeNodeBase("document","Eddie doc one", true);
doc.setIdentifier("No.1");
q样。一个tree2的应用基本就ok了?/P>
在托Bean里初始化q个标签的时候，可以使用SelectItem[] 数组cdQ也可以使用List 、Map{类型?BR>
具体做法如下Q?BR>
private List<SelectItem> okItems = null; /** *//** * @return Returns the okItems. */public List < SelectItem > getOkItems ( ) { this.okItems = new LinkedList< SelectItem >(); this.okItems.add(new SelectItem("a","aaa")); this.okItems.add(new SelectItem("b","bbb")); return okItems ; }然后在jsp面中：(x)
<h:selectOneMenu id="sortpid" value="#{booksort.sortPid}"> <f:selectItems value="#{booksort.okItems}" /></h:selectOneMenu>selectItems他拥有一个valueq个属性，赋gؓ(f)托管Bean里的初始化下拉框的那个属性，也就是okItems?img src ="http://www.aygfsteel.com/lmseeyou/aggbug/25811.html" width = "1" height = "1" />
]]>
首先Q一?JSF 应用是一?servlet/JSP 应用。它有一个配|描q符Q有 JSP 面、客户定制标{、静态资源等{。不同的是，JSF 应用是事仉动的。你通过写一个事件侦听类来决定应用程序的行ؓ(f)。以下徏立一?JSF 应用所需要的几个步骤Q?BR>1、徏?JSP 面Q用 JSF lg包装 HTML 元素?BR>2、写一?JavaBean 用来保持用户输入与组件数据的状态?BR>3、写一个事件侦听器来决定当某事件发生时应该有什么反映，比如用户点击了一个按钮或者提交了表单。JSF 支持两个事gQActionEvent ?ValueChangeEvent 。ActionEvent 是针对用h交表单与点击按钮的，?ValueChangeEvent 是当一?JSF lg改变了时触发?BR>
现在Q让我们来看一?JSF 动作的细节?BR>
JSF 怎样工作
JSP 面?JSF 应用的用h口。每个页面包括一?JSF lg用来描述 WEB 控gQ如表单、输入框、按钮等{。组件可以嵌入另一个组件中Q正如输入框可以在表单中。每?JSP 面p栯CZؓ(f)lg?wi)。JaveBeans 从用L(fng)h中获取数据ƈ存储?BR>
q是有意思的部分Q每当用户做M事情Q如点击按钮或者提交表单，都有事g产生。然后事件消息通过 HTTP 传到服务器。在服务器端Q是一个配|了叫做 Faces servlet 的特D?servlet ?WEB 容器。Faces servlet(javax.faces.webapp.FacesServlet)是所?JSF 应用的引擎。每?JSF 应用?WEB 容器中都有独立的 Faces servlet 。另一个重要的对象?javax.faces.context.FacesContext , 它包括了所有关于当前用戯求的必要信息?BR>
Faces servlet 的后台处理是相当复杂的。然而你没有必要了解q些l节Q只需要记住：(x)Faces servlet ?JSP 面创徏了组件树(wi)Q对lg?wi)的控制又对应着事g。Faces servlet 知道怎么d建组件树(wi)Q因为它已经讉K了当前应用中所有的 JSP 面。Faces servlet q会(x)创徏一?Event 对象Qƈ把它传递给所有注册过的侦听器。你可以通过与当前请求相对应?FacesContext 得到q个面的组件树(wi)?BR>
客户端浏览器?WEB 控g产生的事Ӟ被包含在一?HTTP h中，攑֜一赯有如览器类型、请求地址{其它信息。因此，所有需?Faces servlet 处理的请求必L向这?servlet 。那你怎样通过调用 Faces servelt 来处理每?HTTP h呢？很容易，只需要在配置描述W里用一?servlet-mapping 元素把一个特D的 URL 式样映射?Faces servlet。通常Q你?x)用?/faces/* 样式Q如下所C：(x)
<!-- Faces Servlet -->
<servlet>
<servlet-name>Faces Servlet</servlet-name>
<servlet-class>javax.faces.webapp.FacesServlet</servlet-class>
<load-on-startup>1</load-on-startup>
</servlet>
<!-- Faces Servlet Mapping -->
<servlet-mapping>
<servlet-name>Faces Servlet</servlet-name>
<url-pattern>/faces/*</url-pattern>
</servlet-mapping>
h地址必须包含有在 <url-pattern> 元素中描q的样式。这个要求不Ҏ(gu)辑ֈ。另外也需要注意的?<servlet> 元素Q它包含 Faces servlet Q有一?<load-on-startup> 元素Q用来确是否应用E序W一ơ启动时 servlet 是否加蝲?BR> Z捕获lg产生的事Ӟ你需要ؓ(f)q个lg写一个侦听器Qƈ把它注册l这个组件。通过在表C组件的客户端标{中嵌入 <action_listener> 元素能做到这一炏V例如，Z让一个名?jsfApp.MyActionListener 的事件侦听器Q来捕获一个名?submitButton 的命令按钮生的事gQ在你的 JSP 面中写如下的代码即可：(x)
<h:command_button id="submitButton" label="Add" commandName="submit" >
<f:action_listener type="jsfApp.MyActionListener" />
</h:command_button>
一?action listener 必须实现 javax.faces.event.ActionListener 接口Q而一?value-changed listener 必须实现 java.faces.event.ValueChangedLister 接口。下面让我们来创Z个简单的 JSF 应用Q以展现 JSF 是怎么样事仉动的?BR>
一个简单的 JSF 应用
我们创Z个简单的应用Q它可以实现对二个数字相加。ؓ(f)了运行这个应用，你需要准?TOMCAT5 ?JSF v1.0 EA4(包含?Java Web Services Developer Pack (JWSDP) 1.2?。这个应用程序包括：(x)
adder.jsp JSP 面?BR>NumberBean 存放用户数据?JavaBean
MyActionListener 事g侦听?BR>web.xml 配置描述文g
Z使这个应用能正常工作Q还需要几?jar 文gQ包?JSF 标准实现与其它类库。如果你安装?JWSDP 1.2Q你可以在 jsflib 目录下找到所需要的q些文g。把q些 .jar 文g拯?WEB-INF/lib 目录下。下面是整个?.jar ?.tld 文g列表Q?BR>jsf-api.jar 包含?Faces servlet 与其它相?javax.faces 包下面的c?BR>jfs-ri.jar ?JSF 的参考实?BR>jstl_el.jar
standard.jar
此外Q一?JSF 的应用还需要如下的cdQ它们是 Apache Jakarta 目的一部分Q?BR>commons-beanutils.jar
commons-digester.jar
commons-logging.jar is
以下的几段讨论q个 JSF CZ的每个部分。最后的一段Q“编译与q行”，解释 JSF 应用怎么栯行?BR>
创徏目录l构
首先Z?JSF 应用创徏一个目录结构。在 TOMCAT 中，它在 webapps 目录下。“图1”描qC叫做 myJSFApp 的应用程序的目录l构?BR>
写配|描q符
与其它的 servlet/JSP 应用一Pq个应用E序也需要一个配|描q文件。如“清?”表C?BR>
Listing 1. The deployment descriptor (the web.xml file)
<?xml version="1.0"?>
<!DOCTYPE web-app PUBLIC
"-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
"http://java.sun.com/dtd/web-app_2_3.dtd">
<web-app>
<!-- Faces Servlet -->
<servlet>
<servlet-name>Faces Servlet</servlet-name>
<servlet-class>javax.faces.webapp.FacesServlet</servlet-class>
<load-on-startup> 1 </load-on-startup>
</servlet>
<!-- Faces Servlet Mapping -->
<servlet-mapping>
<servlet-name>Faces Servlet</servlet-name>
<url-pattern>/faces/*</url-pattern>
</servlet-mapping>
</web-app>
在这个配|描q文件中有二个部分?<servlet> 元素注册 Faces servlet Q?<servlet-mapping> 元素声明M包含?/faces/ 式样的请求地址Q必M递给 Faces servlet ?BR>
创徏 JSP 面
一个叫?adder.jsp ?JSP 面提供用户接口Q如“清?”所C：(x)
Listing 2. The adder.jsp page
<%@ taglib uri="http://java.sun.com/jsf/html" prefix="h" %>
<%@ taglib uri="http://java.sun.com/jsf/core" prefix="f" %>
<html>
<head>
<title>Add 2 numbers</title>
</head>
<body>
<jsp:useBean id="NumberBean" class="jsfApp.NumberBean" scope="session" />
<f:use_faces><br />
<h:form id="addForm" formName="addForm" ><br />
First Number:<br />
<h:input_number id="firstNumber" valueRef="NumberBean.firstNumber" /><br />
Second Number:
<h:input_number id="secondNumber" valueRef="NumberBean.secondNumber" /><br />
Result:
<h:output_number id="output" valueRef="NumberBean.result"/><br>
<h:command_button id="submitButton" label="Add" commandName="submit" >
<f:action_listener type="jsfApp.MyActionListener" />
</h:command_button>
</h:form>
</f:use_faces>
</body>
</html>
我们首先定义了俩个标{，它用?JSF 的两个标{ֺQhtml ?core 。这俩个标签库的定义可以?jsf-ri.jar 文g中找刎ͼ所以你不用为它担心。它们的前缀分别?h / f ?BR><%@ taglib uri="http://java.sun.com/jsf/html" prefix="h" %>
<%@ taglib uri="http://java.sun.com/jsf/core" prefix="f" %>
<jsp:useBean> q个动作元素定义 NumberBean JavaBean ?session scope ?BR> <jsp:useBean id="NumberBean" class="jsfApp.NumberBean" scope="session" />
接着?JSF 控g了。注?JSF 控g需要嵌入到 <f:use_faces> 标签中：(x)
<f:use_faces>
...
</f:use_faces>
在这里面Q有一个表单?BR><h:form id="addForm" formName="addForm">
...
</h:form>
内嵌在这个表单里的是二个 input_numbers, 一?output_number, 与一?command_button ?BR>W一个数?
<h:input_number id="firstNumber" valueRef="NumberBean.firstNumber" /><br />
W二个数?
<h:input_number id="secondNumber" valueRef="NumberBean.secondNumber" /><br />
l果:
<h:output_number id="output" valueRef="NumberBean.result" /><br />
<h:command_button id="submitButton" label="Add" commandName="submit">
<f:action_listener type="jsfApp.MyActionListener" />
</h:command_button>
注意命o(h)按钮的事件侦听器。“图2”描qCq个 JSP 面的组件树(wi)(?wi)根省??BR>
ȝ件是表单Q它有四个子lg?BR>
写对象模?/B>
在这个应用中Q你需要用一?JavaBean 来存二个数字与相加的l果。“清?”是q个 JavaBean 的内容：(x)NumberBean
Listing 3. The NumberBean JavaBean
package jsfApp;
public class NumberBean {
int firstNumber = 0;
int secondNumber = 0;
public NumberBean () {
System.out.println("Creating model object");
}
public void setFirstNumber(int number) {
firstNumber = number;
System.out.println("Set firstNumber " + number);
}
public int getFirstNumber() {
System.out.println("get firstNumber " + firstNumber);
return firstNumber;
}
public void setSecondNumber(int number) {
secondNumber = number;
System.out.println("Set secondNumber " + number);
}
public int getSecondNumber() {
System.out.println("get secondNumber " + secondNumber);
return secondNumber;
}
public int getResult() {
System.out.println("get result " + (firstNumber + secondNumber));
return firstNumber + secondNumber;
}
}
写事件侦听器
命o(h)按钮的事件侦听器是这?JSF 应用的最有趣的部分。它表述一个事件怎么样引起一个侦听器M听。侦听器单地只是输出信息到控制台。然而，它显CZ重要的信息，?JSP 面lg?wi)的层次l构Q正是这些组件触发了事g。“清?”展CZ件侦听器Q?BR>
Listing 4. The action listener for the command button (MyActionListener.java)
package jsfApp;
import java.util.Iterator;
import javax.faces.component.UIComponent;
import javax.faces.context.FacesContext;
import javax.faces.event.ActionEvent;
import javax.faces.event.ActionListener;
import javax.faces.event.PhaseId;
import javax.faces.tree.Tree;
public class MyActionListener implements ActionListener {
public PhaseId getPhaseId() {
System.out.println("getPhaseId called");
return PhaseId.APPLY_REQUEST_VALUES;
}
public void processAction(ActionEvent event) {
System.out.println("processAction called");
// the component that triggered the action event
UIComponent component = event.getComponent();
System.out.println("The id of the component that fired the action event: "
+ component.getComponentId());
// the action command
String actionCommand = event.getActionCommand();
System.out.println("Action command: " + actionCommand);
FacesContext facesContext = FacesContext.getCurrentInstance();
Tree tree = facesContext.getTree();
UIComponent root = tree.getRoot();
System.out.println("----------- Component Tree -------------");
navigateComponentTree(root, 0);
System.out.println("----------------------------------------");
}
private void navigateComponentTree(UIComponent component, int level) {
Iterator children = component.getChildren();
// indent
for (int i=0; i<level; i++)
System.out.print(" ");
// print component id
System.out.println(component.getComponentId());
// navigate children
while (children.hasNext()) {
UIComponent child = (UIComponent) children.next();
navigateComponentTree(child, level + 1);
}
}
}
~译与运?/B>
Z~译q个应用Q我们{?myJSFApp/WEB-INF/classes q个目录。如果你用的?windows pȝQ打出如下命令：(x)
javac -classpath ../lib/jsf-api.jar;../lib/jsf-ri.jar;../../../../common/lib/servlet.jar jsfApp/*.java
注意你必ȝ?lib 目录下的cd?servlet.jar 库?BR>
然后q行 Tomcat Q在地址栏输入如下地址Q?BR>http://localhost:8080/myJSFApp/faces/adder.jsp
注意你在 JPS 面文g名前用了 /faces/ 式样。然后可以在览器中看到”如?“所C：(x)
在控制台Q你可以看到如下信息Q?BR>Model Object Created
get firstNumber 0
get secondNumber 0
get result 0
getPhaseId called
现在在二个输入框中分别输入二个数字，然后点击 ADD 按钮。浏览器显C结果“如?”：(x)
更重要的Q再查一下控制台Q看到如下信息：(x)
get firstNumber 0
get secondNumber 0
processAction called
The id of the component that fired the action event: submitButton
Action command: submit
----------- Component Tree -------------
null
addForm
firstNumber
secondNumber
output
submitButton
----------------------------------------
Set firstNumber 10
Set secondNumber 20
get firstNumber 10
get secondNumber 20
get result 30
ȝ
在这文章中Q你学到?JSF 区别于其?servlet/JSP 应用的最重要的特点：(x)事g驱动。你也创Z一个包含一?JSP 面的简单应用。更重要的，你写了能响应事g的侦听器?BR> 实际应用中的 JSF 应用复杂得多Q通常是很?JSP 面。这h况下Q你需要从一个页面导航到另一个页面。然而这应是另一文章的主题?img src ="http://www.aygfsteel.com/lmseeyou/aggbug/24118.html" width = "1" height = "1" />
]]>
Resources.properties文g存放在carstore.bundles包里?BR>Resources.properties里内容片断：(x)
thanksLabel=Thanks, {0} , for ....
右侧的信息和左侧的键值是兌的?lt;outputMessage>标记是用来昄消息的，例子Q?BR><h:outputMessage value="#{bundle.thankslabel}">
<f:prameter value="#{xxx.firstname}"/>
</h:outputMessage>
]]>