綠野仙棕

JSF login例子

Core的作者說你可以把JavaServer Faces(JSF)看成“swing for server-side applications”，我想這是因為：
1、JSF里面定義了很多可用的UI部件（用戶可自定義）。
2、JSF有消息驅動機制。

要用JSF，除了JDK和Tomcat（servlet container）之外，還要下載一個JavaServer Faces reference implementation，要用到里面的lib，現在sun網站上有1.1的版本。

一個簡單的開發例子：
1、建立一個目錄，這個目錄是部署這個應用的單元（打包成.war)，比如testJSF。
2、在這個目錄下放置jsp頁面。
3、在此目錄下建立WEB-INF目錄，在其中放置faces-config.xml和web.xml。
4、在WEB-INF目錄下建立class和lib目錄。
5、將bean的java code以包的形式放在class目錄下（并且將它們編譯）。
6、將必要的.jar放在lib目錄下。
7、制作.war: jar cvf sample.war。
8、將.war放到tomcat/webapps下

接著就可以用http://localhost:8080/testJSF來訪問了。

再分別把具體的東西解釋下：

1、必要的jar有六個，你可以像上面那樣放到.war里，也可以直接將他們放到tomcat/common/lib中，而且這樣的話，你就不必在每個.war中包含它們 :
jsf/lib/jsf-api.jar
jsf/lib/jsf-impl.jar:jsf/lib/jsf-impl.jar
tomcat/server/lib/commons-digester.jar
tomcat/server/lib/commons-beanutils.jar
tomcat/webapps/jsp-examples/WEB-INF/lib/jstl.jar
tomcat/webapps/jsp-examples/WEB-INF/lib/standard.jar

2、bean class里面的getter和setter是前端和后端的管道，沒什么好說的。

3、配置jsf國際化消息資源文件MessageBundle.properties（名字可以任意）

????? login_username_lable=userName:
????? login_password_lable=password:
??????login_button_lable = login

????? 加載資源文件：

1 < f:loadBundle? basename ="com.jsfdemo.rocket.MessageBundle" ?var ="bundle" />

????? jsf頁面中需要國際化的文字都可以在這里面配置，并用key值讀取
????? 下面是在頁面中使用的例子：

1 < h:outputLabel? value ="#{bundle.login_username_lable}" ></ h:outputLabel >
2 < h:outputLabel? value ="#{bundle.login_password_lable}" ></ h:outputLabel >
3 < h:commandButton? value ="#{bundle.login_button_lable}" ?rendered ="true" ?action ="#{UserBean.loginUser}" ?id ="submit" ? />

4、jsf的頁面要包含兩個標簽的定義：
<%@ taglib uri="http://java.sun.com/jsf/core" prefix="f" %>
<%@ taglib uri="http://java.sun.com/jsf/html" prefix="h" %>
（f: core tags; h: HTML tags.）

頁面上似乎和struts差不多，看個例子：

?1 <% @?page?language = " java " ??pageEncoding = " utf-8 " %>
?2 <% @taglib?uri = " http://java.sun.com/jsf/core " ?prefix = " f " %>
?3 <% @taglib?uri = " http://java.sun.com/jsf/html " ?prefix = " h " %>
?4 < html >
?5 ?? < head >
?6 ???? < title > userLogin.jsp </ title >
?7 ?? </ head >
?8 < body >
?9 < f:view >
10 <!-- 加載配置文件，?var?為配置文件的別名 -->
11 < f:loadBundle? basename ="com.jsfdemo.rocket.MessageBundle" ?var ="bundle" />
12 < h:form? id ="loginForm" ?rendered ="true" ? >
13 ? <!-- ?輸入用戶名 -->
14 < h:outputLabel? value ="#{bundle.login_username_lable}" ></ h:outputLabel >
15 < h:inputText? value ="#{UserBean.userName}" ?rendered ="true" ?required ="true" ?id ="userName" ? />
16 < h:outputText? value ="#{UserBean.userName}" > ? </ h:outputText >
17 ? <!-- 輸入密碼 -->
18 < h:outputLabel? value ="#{bundle.login_password_lable}" ></ h:outputLabel >
19 < h:inputSecret? value ="#{UserBean.password}" ?rendered ="true" ?required ="true" ?redisplay ="false" ?id ="password" ? /> ?
20 < h:outputText? value ="#{UserBean.password}" > ? </ h:outputText >
21 ?? <!-- Submit按鈕，指定action -->
22 < h:commandButton? value ="#{bundle.login_button_lable}" ?rendered ="true" ?action ="#{UserBean.loginUser}" ?id ="submit" ? />
23 <!-- message?消息處理 -->
24 < h:message? for ="loginForm" ></ h:message >
25 ??? </ h:form >
26 ?? </ f:view >
27 ? </ body >
28 </ html >

接受用戶輸入用戶名和密碼，里面是普通的html標簽和jsf的標簽，沒什么太多東西。如果用戶名，密碼錯誤則message標簽
返回錯誤信息。

?1 <! DOCTYPE?HTML?PUBLIC?"-//W3C//DTD?HTML?4.01?Transitional//EN" >
?2 < html >
?3 ?? < head > ???
?4 ???? < title > userLoginSuccess.jsp </ title >
?5
?6 ?? </ head >
?7 ??
?8 ?? < body >
?9 ?? < f:view >
10 ?? < h:outputText? value ="#{UserBean.userName}" ></ h:outputText > ,you?success!!!
11 ?? </ f:view >
12 ?? </ body >
13 </ html >
14

輸出UserBean的一個值（userName)。

5、兩個xml的配置文件：

faces-config.xml的內容：

?1 <? xml?version="1.0"?encoding="UTF-8" ?>
?2 <! DOCTYPE?faces-config?PUBLIC?"-//Sun?Microsystems,?Inc.//DTD?JavaServer?Faces?Config?1.1//EN"?"http://java.sun.com/dtd/web-facesconfig_1_1.dtd" >
?3
?4 < faces-config? >
?5 ???? < managed-bean >
?6 ???????? < managed-bean-name > UserBean </ managed-bean-name >
?7 ???????? < managed-bean-class >
?8 ????????????com.jsfdemo.rocket.UserBean
?9 ???????? </ managed-bean-class >
10 ???????? < managed-bean-scope > session </ managed-bean-scope >
11 ???????? < managed-property >
12 ???????????? < property-name > userName </ property-name >
13 ???????????? < property-class > java.lang.String </ property-class >
14 ???????????? < value > donglei </ value >
15 ???????? </ managed-property >
16 ??????? < managed-property >
17 ???????????? < property-name > password </ property-name >
18 ???????????? < property-class > java.lang.String </ property-class >
19 ???????????? < value > 123456 </ value >
20 ???????? </ managed-property >
21 ???? </ managed-bean >
22 ???? < navigation-rule >
23 ???????? < from-view-id > /userLoginSuccess.jsp </ from-view-id > ????
24 ???? </ navigation-rule >
25 ???? < navigation-rule >
26 ???????? < from-view-id > /userLogin.jsp </ from-view-id >
27 ???? </ navigation-rule >
28 ???? < navigation-rule >
29 ???????? < from-view-id > /userLogin.jsp </ from-view-id >
30 ???????? < navigation-case >
31 ???????????? < from-outcome > success </ from-outcome >
32 ???????????? < to-view-id > /userLoginSuccess.jsp </ to-view-id >
33 ???????? </ navigation-case >
34 ???? </ navigation-rule >
35 ???? < navigation-rule >
36 ???????? < from-view-id > /userLogin.jsp </ from-view-id >
37 ???????? < navigation-case >
38 ???????????? < from-outcome > fail </ from-outcome >
39 ???????????? < to-view-id > /userLogin.jsp </ to-view-id >
40 ???????? </ navigation-case >
41 ???? </ navigation-rule >
42 </ faces-config >
43
44

再看web.xml：


€

?1 <? xml?version="1.0"?encoding="UTF-8" ?>
?2 < web-app? xmlns ="http://java.sun.com/xml/ns/j2ee" ?xmlns:xsi ="http://www.w3.org/2001/XMLSchema-instance" ?version ="2.4" ?xsi:schemaLocation ="http://java.sun.com/xml/ns/j2ee???http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd" >
?3 ?? < context-param >
?4 ???? < param-name > javax.faces.CONFIG_FILES </ param-name >
?5 ???? < param-value > /WEB-INF/faces-config.xml </ param-value >
?6 ?? </ context-param >
?7 ?? < servlet >
?8 ???? < servlet-name > Faces?Servlet </ servlet-name >
?9 ???? < servlet-class > javax.faces.webapp.FacesServlet </ servlet-class >
10 ???? < load-on-startup > 0 </ load-on-startup >
11 ?? </ servlet >
12 ?? < servlet-mapping >
13 ???? < servlet-name > Faces?Servlet </ servlet-name >
14 ???? < url-pattern > *.faces </ url-pattern >
15 ?? </ servlet-mapping >
16 ????? < welcome-file-list >
17 ?????? < welcome-file > index.html </ welcome-file >
18 ??? </ welcome-file-list >
19 </ web-app >
20
21

servlet-mapping指定了url的后綴，welcome-file-list指定初識頁（可以用這個頁面前進到某個其他頁面）。

例子講完了，再講下jsf的處理周期：jsf頁面有encoding和decoding的過程，前者將jsf的元素樹變換成html頁面，后者將頁面的內容(form的數據等）變回jsf的元素，并由這些元素執行它們自己所定義的動作。?
6 UserName.java

?1 /**?*/ /**
?2 ?*?
?3 ? */
?4 package ?com.jsfdemo.rocket;
?5
?6 import ?javax.faces.application.FacesMessage;
?7 import ?javax.faces.context.FacesContext;
?8
?9 /**?*/ /**
10 ?*? @author ?rocket
11 ?*
12 ? */
13 public ? final ? class ?UserBean? extends ?Object? {
14
15 ???? /**?*/ /**
16 ?????*?
17 ????? */
18 ???? private ?String?userName;
19 ????
20 ???? private ?String?password;
21 ????
22 ???? public ?String?getPassword()? {
23 ???????? return ?password;
24 ????}
25
26 ???? public ? void ?setPassword(String?password)? {
27 ???????? this .password? = ?password;
28 ????}
29
30 ???? /**?*/ /**
31 ?????*? @return ?the?username
32 ????? */
33 ???? public ?String?getUserName()? {
34 ???????? return ?userName;
35 ????}
36
37 ???? /**?*/ /**
38 ?????*? @param ?username?the?username?to?set
39 ????? */
40 ???? public ? void ?setUserName(String?userName)? {
41 ???????? this .userName? = ?userName;
42 ????}
43 ????
44 ???? public ?String?loginUser()? {
45 ???????? if ( " myeclipse " .equals(getUserName())? && ? " myeclipse " .equals(getPassword()))
46 ???????? return ? " success " ;
47 ????????FacesContext?facesContext? = ?FacesContext.getCurrentInstance();
48 ????????FacesMessage?facesMessage? = ? new ?FacesMessage(
49 ???????? " You?have?entered?an?invalid?user?name?and/or?password " );
50 ????????facesContext.addMessage( " loginForm " ,?facesMessage);
51 ???????? return ? " fail " ;
52 ????????}
53
54 }
55

posted on 2006-09-27 16:07 土牛小屋 閱讀(3055) 評論(4)  編輯  收藏