### MyEclipse JSF 快速入门中文版
#### 1. 前言
本文档旨在指导初学者使用 MyEclipse 开发工具快速入门 JavaServer Faces (JSF) 应用程序。本教程适用于已经安装了 Sun JDK 1.5.0、Eclipse 3.1 和 MyEclipse 4.0 的环境。如果您的环境与此不同，请参考文档末尾的用户反馈部分获取支持。
#### 2. 介绍
本教程将引导您逐步完成一个简单的 JSF 示例程序的开发流程。我们假设读者对 JSF 和 MyEclipse 已经有一定了解，但即使您之前对此并不熟悉，也能顺利完成本教程。对于有 Struts 框架开发经验的读者，我们会适当提及 JSF 和 Struts 之间的相似之处以帮助理解。
#### 3. 系统需求
为了顺利进行本教程，请确保您的系统已安装以下软件：
- **JDK**：1.4+ 版本（推荐 Sun 或 IBM 提供的 JDK）。
- **Eclipse SDK**：3.1 版本。
- **MyEclipse**：4.1 版本。
- **Tomcat**：5.x 版本（推荐使用 5.5.9 或其他符合标准的 Servlet/EJB 容器）。
此外，还需要配置 Tomcat 用户名为 "myeclipse"，密码也为 "myeclipse"。
#### 4. 设置新项目和目录结构
接下来，我们将使用 MyEclipse 创建一个新的 Web 项目，并为其添加 JSF 功能。
1. **创建 Web 项目**：通过菜单 `File > New > Other > Project > J2EE > Web Project` 打开项目创建向导。在向导中，您可以自定义项目设置，例如项目名称、位置等。为确保与 JSF 兼容性良好，建议勾选“JSTL Libraries”选项。
- **图 4.1**：创建新的 web 项目
- **图 4.2**：Web 项目向导对话框
2. **添加 JSF 功能**：项目创建完成后，在 Package Explorer 视图中找到该项目，右键点击项目根节点，选择 `MyEclipse > Add JSF Capabilities`。在弹出的对话框中，默认设置即可，除非您有特别需求想要自定义配置。
- **图 4.3**：向 Web 项目添加 JSF 能力
- **图 4.4**：配置 JSF 能力对话框
完成以上步骤后，项目目录结构将如下所示：
- **src/main/java**：存放 Java 源代码。
- **src/main/webapp**：存放 web 资源，如 HTML、CSS、JavaScript 文件以及 JSP 页面。
- **src/main/webapp/WEB-INF**：存放 web.xml 文件和其他配置文件。
- **src/main/webapp/WEB-INF/classes**：存放编译后的 .class 文件。
#### 5. 创建消息包
在实际开发过程中，我们通常需要处理国际化问题，因此第一步是创建一个用于存储消息的包。这个包将包含各种语言的消息资源文件，以便于在不同的国家和地区使用。
1. **创建消息包**：在 `src/main/java` 目录下创建一个名为 `message` 的包。
2. **创建消息资源文件**：在 `message` 包中创建一个名为 `messages.properties` 的文件，该文件将用于存储默认语言（通常是英语）的消息。例如：
```
welcome.message=Welcome to our application!
```
3. **创建其他语言版本的消息文件**：如果需要支持多种语言，可以为每种语言创建一个特定的资源文件。例如，为中文创建 `messages_zh_CN.properties` 文件，并在其中写入相应的中文消息。
#### 6. 创建受管 Bean
受管 Bean 是 JSF 应用的核心组成部分之一，它们负责处理业务逻辑并与视图交互。接下来，我们将创建一个简单的受管 Bean 示例。
1. **创建受管 Bean 类**：在 `src/main/java` 下的 `com.example.jsf` 包中创建一个名为 `WelcomeBean` 的类，并实现 `javax.faces.bean.ManagedBean` 接口。
```java
package com.example.jsf;
import javax.faces.bean.ManagedBean;
import javax.faces.bean.SessionScoped;
@ManagedBean(name = "welcomeBean")
@SessionScoped
public class WelcomeBean {
private String message;
public String getMessage() {
return message;
}
public void setMessage(String message) {
this.message = message;
}
// 可以在此处添加其他方法，如业务逻辑处理等
}
```
2. **配置受管 Bean**：为了让 JSF 框架能够识别并使用这个受管 Bean，需要在 `src/main/webapp/WEB-INF/faces-config.xml` 文件中进行配置。如果该文件不存在，则需要手动创建。
```xml
<?xml version="1.0" encoding="UTF-8"?>
<faces-config xmlns="http://xmlns.jcp.org/xml/ns/javaee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-facesconfig_2_3.xsd"
version="2.3">
<managed-bean>
<managed-bean-name>welcomeBean</managed-bean-name>
<managed-bean-class>com.example.jsf.WelcomeBean</managed-bean-class>
<managed-bean-scope>session</managed-bean-scope>
</managed-bean>
</faces-config>
```
#### 7. 创建 JSP 页面
接下来，我们将创建一个 JSP 页面来展示欢迎消息。
1. **创建 JSP 页面**：在 `src/main/webapp` 下创建一个名为 `welcome.jsp` 的文件。
```jsp
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml"
xmlns:h="http://xmlns.jcp.org/jsf/html">
<head>
<title>Welcome Page</title>
</head>
<body>
<h:form>
<h:outputText value="#{welcomeBean.message}" />
</h:form>
</body>
</html>
```
2. **配置 JSP 页面**：在 `src/main/webapp/WEB-INF/web.xml` 文件中添加 `<servlet>` 和 `<servlet-mapping>` 配置，确保 JSP 页面能够正确地被处理。
```xml
<servlet>
<servlet-name>Faces Servlet</servlet-name>
<servlet-class>javax.faces.webapp.FacesServlet</servlet-class>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>Faces Servlet</servlet-name>
<url-pattern>/faces/*</url-pattern>
</servlet-mapping>
```
3. **测试 JSP 页面**：部署项目到 Tomcat 服务器，通过浏览器访问 `http://localhost:8080/your-project-name/faces/welcome.jsp` 来测试 JSP 页面是否正常工作。
#### 8. 运行应用程序
完成上述步骤后，您的 JSF 应用程序已准备好运行。请按照以下步骤启动服务器并测试您的应用程序：
1. **启动 Tomcat 服务器**：确保 Tomcat 服务器已正确配置并在 MyEclipse 中启动。
2. **部署项目**：在 MyEclipse 中，右键点击项目，选择 `Run As > Run on Server`，然后选择已配置好的 Tomcat 服务器。
3. **测试应用程序**：在浏览器中访问 `http://localhost:8080/your-project-name/faces/welcome.jsp`，您应该能看到显示的消息。
#### 9. 总结
通过本教程，您不仅学会了如何使用 MyEclipse 创建 JSF 应用程序，还了解了如何管理国际化资源文件、创建受管 Bean 以及构建 JSP 页面。这些基本技能是进一步学习 JSF 的坚实基础。
#### 10. 用户反馈
如果您在使用过程中遇到任何问题或有任何建议，请通过以下方式联系我们：
- **电子邮件**：beansoft@126.com
- **博客**：http://www.blogjava.net/beansoft/
### 结语
通过本教程的学习，您应该已经掌握了使用 MyEclipse 开发 JSF 应用的基本步骤。希望这对您的学习之旅有所帮助！如果您在实践中遇到任何疑问或困难，请随时查阅官方文档或寻求社区的帮助。祝您编程愉快！
