admin/struts2-demo
1
0
Fork 1
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Update: web.xml and generated files

Browse Source
This commit is contained in:
likingcode
2026-03-18 15:18:30 +08:00
parent fb9d2d1206
commit 1f60832445
20 changed files with 2071 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files

101
web/demo/ajax/index.jsp Normal file
View File

@@ -0,0 +1,101 @@
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<title>AJAX + JSON - Struts2 学习</title>
<style>
body { font-family: 'Segoe UI', sans-serif; background: linear-gradient(135deg, #667eea, #764ba2); min-height: 100vh; margin: 0; padding: 20px; }
.container { max-width: 1200px; margin: 0 auto; }
.breadcrumb { background: white; padding: 15px 25px; border-radius: 10px; margin-bottom: 20px; }
.content { background: white; border-radius: 20px; padding: 40px; }
h1 { color: #667eea; border-bottom: 3px solid #667eea; padding-bottom: 15px; }
h2 { color: #764ba2; margin-top: 30px; }
.section { margin: 25px 0; padding: 20px; background: #f8f9fa; border-radius: 10px; }
pre { background: #1e1e1e; color: #d4d4d4; padding: 20px; border-radius: 10px; overflow-x: auto; }
.keyword { color: #569cd6; }
.string { color: #ce9178; }
.comment { color: #6a9955; }
.btn { display: inline-block; padding: 12px 30px; background: #667eea; color: white; text-decoration: none; border-radius: 25px; }
</style>
</head>
<body>
<div class="container">
<div class="breadcrumb">
<a href="/">🏠 首页</a> / AJAX + JSON
</div>
<div class="content">
<h1>⚡ AJAX + JSON</h1>
<h2>1. JSON 结果类型</h2>
<div class="section">
<p>使用 struts2-json-plugin 实现 AJAX 返回 JSON</p>
<pre><span class="comment">// struts.xml 配置</span>
<span class="keyword">&lt;action</span> name=<span class="string">"getUser"</span> class=<span class="string">"com.demo.UserAction"</span><span class="keyword">&gt;</span>
<span class="keyword">&lt;result</span> type=<span class="string">"json"</span><span class="keyword">&gt;</span>
<span class="comment">&lt;!-- 可选: 只包含指定属性 --&gt;</span>
<span class="keyword">&lt;param</span> name=<span class="string">"includeProperties"</span><span class="keyword">&gt;</span>user\..*,success<span class="keyword">&lt;/param&gt;</span>
<span class="keyword">&lt;/result&gt;</span>
<span class="keyword">&lt;/action&gt;</span></pre>
</div>
<h2>2. Action 示例</h2>
<div class="section">
<pre><span class="keyword">public class</span> UserAction <span class="keyword">extends</span> ActionSupport {
<span class="keyword">private</span> User user;
<span class="keyword">private</span> boolean success;
<span class="keyword">private</span> String message;
<span class="comment">// getter 是必须的，JSON 插件只序列化有 getter 的属性</span>
<span class="keyword">public</span> User getUser() { <span class="keyword">return</span> user; }
<span class="keyword">public</span> boolean isSuccess() { <span class="keyword">return</span> success; }
<span class="keyword">public</span> String getMessage() { <span class="keyword">return</span> message; }
<span class="keyword">public</span> String getData() {
user = <span class="keyword">new</span> User(<span class="string">"张三"</span>, <span class="string">"zhangsan@email.com"</span>);
success = <span class="keyword">true</span>;
message = <span class="string">"获取成功"</span>;
<span class="keyword">return</span> SUCCESS;
}
}</pre>
</div>
<h2>3. 前端 AJAX 调用</h2>
<div class="section">
<pre><span class="comment">// 原生 fetch</span>
fetch(<span class="string">'/getUser'</span>)
.then(r =&gt; r.json())
.then(data =&gt; {
console.log(data.user);
console.log(data.success);
});
<span class="comment">// jQuery</span>
$.getJSON(<span class="string">'/getUser'</span>, <span class="keyword">function</span>(data) {
$(<span class="string">'#username'</span>).text(data.user.username);
});</pre>
</div>
<h2>4. 完整示例：实时搜索</h2>
<div class="section">
<pre><span class="comment">// HTML</span>
<span class="keyword">&lt;input</span> type=<span class="string">"text"</span> id=<span class="string">"keyword"</span> onkeyup=<span class="string">"search(this.value)"</span>/&gt;
<span class="keyword">&lt;div</span> id=<span class="string">"results"</span><span class="keyword">&gt;&lt;/div&gt;</span>
<span class="comment">// JS</span>
<span class="keyword">function</span> search(keyword) {
$.getJSON(<span class="string">'/search'</span>, {keyword: keyword}, <span class="keyword">function</span>(data) {
$(<span class="string">'#results'</span>).empty();
data.results.forEach(<span class="keyword">function</span>(item) {
$(<span class="string">'#results'</span>).append(<span class="string">'&lt;div&gt;'</span> + item.name + <span class="string">'&lt;/div&gt;'</span>);
});
});
}</pre>
</div>
<a href="/demo/interceptor" class="btn">下一节：拦截器 →</a>
</div>
</div>
</body>
</html>

168
web/demo/hello/index.jsp Normal file
View File

@@ -0,0 +1,168 @@
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Hello World - Struts2 学习</title>
<style>
body { font-family: 'Segoe UI', 'PingFang SC', sans-serif; background: linear-gradient(135deg, #667eea, #764ba2); min-height: 100vh; margin: 0; padding: 20px; }
.container { max-width: 1200px; margin: 0 auto; }
.breadcrumb { background: white; padding: 15px 25px; border-radius: 10px; margin-bottom: 20px; }
.breadcrumb a { color: #667eea; text-decoration: none; }
.content { background: white; border-radius: 20px; padding: 40px; box-shadow: 0 10px 40px rgba(0,0,0,0.2); }
h1 { color: #667eea; border-bottom: 3px solid #667eea; padding-bottom: 15px; }
h2 { color: #764ba2; margin-top: 30px; }
.section { margin: 25px 0; padding: 20px; background: #f8f9fa; border-radius: 10px; }
code { background: #1e1e1e; color: #d4d4d4; padding: 2px 8px; border-radius: 4px; font-family: Consolas, monospace; }
pre { background: #1e1e1e; color: #d4d4d4; padding: 20px; border-radius: 10px; overflow-x: auto; font-size: 0.9em; }
.keyword { color: #569cd6; }
.string { color: #ce9178; }
.comment { color: #6a9955; }
.btn { display: inline-block; padding: 12px 30px; background: #667eea; color: white; text-decoration: none; border-radius: 25px; margin-right: 10px; }
.btn:hover { background: #764ba2; }
.note { background: #fff3e0; border-left: 4px solid #ff9800; padding: 15px; margin: 20px 0; border-radius: 0 10px 10px 0; }
</style>
</head>
<body>
<div class="container">
<div class="breadcrumb">
<a href="/">🏠 首页</a> / Hello World
</div>
<div class="content">
<h1>👋 Hello World - 第一个 Struts2 应用</h1>
<div class="note">
<strong>📝 本节要点：</strong> 创建最简单的 Struts2 应用，掌握 Action 编写和 struts.xml 配置
</div>
<h2>1. 项目结构</h2>
<pre>
webapp/
├── WEB-INF/
│ ├── web.xml
│ └── lib/
│ └── struts2-core.jar
├── struts.xml ← Action 配置
├── index.jsp
└── hello.jsp ← 结果页面</pre>
<h2>2. web.xml 配置</h2>
<div class="section">
<pre><span class="comment">&lt;?xml version="1.0" encoding="UTF-8"?&gt;</span>
<span class="keyword">&lt;web-app</span> xmlns=<span class="string">"http://xmlns.jcp.org/xml/ns/javaee"</span><span class="keyword">&gt;</span>
<span class="comment">&lt;!-- Struts2 核心过滤器 --&gt;</span>
<span class="keyword">&lt;filter&gt;</span>
<span class="keyword">&lt;filter-name&gt;</span>struts2<span class="keyword">&lt;/filter-name&gt;</span>
<span class="keyword">&lt;filter-class&gt;</span>
org.apache.struts2.dispatcher.filter.StrutsPrepareAndExecuteFilter
<span class="keyword">&lt;/filter-class&gt;</span>
<span class="keyword">&lt;/filter&gt;</span>
<span class="keyword">&lt;filter-mapping&gt;</span>
<span class="keyword">&lt;filter-name&gt;</span>struts2<span class="keyword">&lt;/filter-name&gt;</span>
<span class="keyword">&lt;url-pattern&gt;</span>/*<span class="keyword">&lt;/url-pattern&gt;</span>
<span class="keyword">&lt;/filter-mapping&gt;</span>
<span class="keyword">&lt;/web-app&gt;</span></pre>
</div>
<h2>3. struts.xml 配置</h2>
<div class="section">
<pre><span class="comment">&lt;?xml version="1.0" encoding="UTF-8"?&gt;</span>
<span class="keyword">&lt;!DOCTYPE struts PUBLIC</span>
<span class="string">"-//Apache Software Foundation//DTD Struts Configuration 2.5//EN"</span>
<span class="string">"http://struts.apache.org/dtds/struts-2.5.dtd"</span><span class="keyword">&gt;</span>
<span class="keyword">&lt;struts&gt;</span>
<span class="comment">&lt;!-- 开发模式 --&gt;</span>
<span class="keyword">&lt;constant</span> name=<span class="string">"struts.devMode"</span> value=<span class="string">"true"</span><span class="keyword">/&gt;</span>
<span class="comment">&lt;!-- 定义包 --&gt;</span>
<span class="keyword">&lt;package</span> name=<span class="string">"default"</span> namespace=<span class="string">"/"</span> extends=<span class="string">"struts-default"</span><span class="keyword">&gt;</span>
<span class="comment">&lt;!-- Action 配置 --&gt;</span>
<span class="keyword">&lt;action</span> name=<span class="string">"hello"</span> class=<span class="string">"com.demo.HelloAction"</span><span class="keyword">&gt;</span>
<span class="keyword">&lt;result&gt;</span>/hello.jsp<span class="keyword">&lt;/result&gt;</span>
<span class="keyword">&lt;/action&gt;</span>
<span class="keyword">&lt;/package&gt;</span>
<span class="keyword">&lt;/struts&gt;</span></pre>
</div>
<h2>4. HelloAction.java</h2>
<div class="section">
<pre><span class="keyword">package</span> com.demo;
<span class="keyword">import</span> com.opensymphony.xwork2.ActionSupport;
<span class="comment">/**
* 第一个 Struts2 Action
* 继承 ActionSupport 可以获得验证、国际化的能力
*/</span>
<span class="keyword">public class</span> HelloAction <span class="keyword">extends</span> ActionSupport {
<span class="comment">// 接收参数</span>
<span class="keyword">private</span> String name;
<span class="comment">// 返回给页面的数据</span>
<span class="keyword">private</span> String message;
<span class="comment">/**
* 执行方法，默认调用
*/</span>
<span class="annotation">@Override</span>
<span class="keyword">public</span> String execute() <span class="keyword">throws</span> Exception {
<span class="keyword">if</span> (name == <span class="keyword">null</span> || name.trim().isEmpty()) {
name = <span class="string">"Struts2 学习者"</span>;
}
message = <span class="string">"你好, "</span> + name + <span class="string">"! 欢迎学习 Struts2!"</span>;
<span class="keyword">return</span> SUCCESS; <span class="comment">// 返回 "success"</span>
}
<span class="comment">// Getter/Setter 必须提供，Struts2 通过反射注入参数</span>
<span class="keyword">public</span> String getName() { <span class="keyword">return</span> name; }
<span class="keyword">public void</span> setName(String name) { <span class="keyword">this</span>.name = name; }
<span class="keyword">public</span> String getMessage() { <span class="keyword">return</span> message; }
<span class="keyword">public void</span> setMessage(String message) { <span class="keyword">this</span>.message = message; }
}</pre>
</div>
<h2>5. hello.jsp 结果页面</h2>
<div class="section">
<pre><span class="comment">&lt;%@ page contentType="text/html;charset=UTF-8" language="java" %&gt;</span>
<span class="comment">&lt;%@ taglib prefix="s" uri="/struts-tags" %&gt;</span>
<span class="keyword">&lt;!DOCTYPE html&gt;</span>
<span class="keyword">&lt;html&gt;</span>
<span class="keyword">&lt;body&gt;</span>
<span class="comment">&lt;!-- 使用 Struts2 标签获取 Action 返回的值 --&gt;</span>
<span class="keyword">&lt;h1&gt;&lt;s:property</span> value=<span class="string">"message"</span>/&gt;&lt;/h1&gt;
<span class="keyword">&lt;/body&gt;</span>
<span class="keyword">&lt;/html&gt;</span></pre>
</div>
<h2>6. 访问方式</h2>
<div class="section">
<p>启动应用后，访问：</p>
<code>http://localhost:8080/hello</code> - 默认执行<br>
<code>http://localhost:8080/hello?name=张三</code> - 传递参数
</div>
<h2>执行流程图</h2>
<div class="section">
<pre style="text-align: center;">
浏览器请求 → Struts2 Filter → ActionProxy → HelloAction.execute()
→ 返回 "success" → 配置的 result → hello.jsp → 浏览器</pre>
</div>
<div style="margin-top: 30px;">
<a href="/demo/validation" class="btn">下一节：表单验证 →</a>
<a href="/" class="btn" style="background: #764ba2;">← 返回首页</a>
</div>
</div>
</div>
</body>
</html>

173
web/demo/model/index.jsp Normal file
View File

@@ -0,0 +1,173 @@
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>数据封装 - Struts2 学习</title>
<style>
body { font-family: 'Segoe UI', 'PingFang SC', sans-serif; background: linear-gradient(135deg, #667eea, #764ba2); min-height: 100vh; margin: 0; padding: 20px; }
.container { max-width: 1200px; margin: 0 auto; }
.breadcrumb { background: white; padding: 15px 25px; border-radius: 10px; margin-bottom: 20px; }
.breadcrumb a { color: #667eea; text-decoration: none; }
.content { background: white; border-radius: 20px; padding: 40px; box-shadow: 0 10px 40px rgba(0,0,0,0.2); }
h1 { color: #667eea; border-bottom: 3px solid #667eea; padding-bottom: 15px; }
h2 { color: #764ba2; margin-top: 30px; }
.section { margin: 25px 0; padding: 20px; background: #f8f9fa; border-radius: 10px; }
pre { background: #1e1e1e; color: #d4d4d4; padding: 20px; border-radius: 10px; overflow-x: auto; font-size: 0.9em; }
.keyword { color: #569cd6; }
.string { color: #ce9178; }
.comment { color: #6a9955; }
.btn { display: inline-block; padding: 12px 30px; background: #667eea; color: white; text-decoration: none; border-radius: 25px; margin-right: 10px; }
.note { background: #fff3e0; border-left: 4px solid #ff9800; padding: 15px; margin: 20px 0; border-radius: 0 10px 10px 0; }
</style>
</head>
<body>
<div class="container">
<div class="breadcrumb">
<a href="/">🏠 首页</a> / 数据封装
</div>
<div class="content">
<h1>📦 数据封装 - 属性驱动 vs 模型驱动</h1>
<div class="note">
<strong>📝 本节要点：</strong> 掌握 Struts2 两种数据封装方式，将请求参数封装到 Java 对象
</div>
<h2>1. 两种封装方式对比</h2>
<div class="section">
<table style="width:100%; border-collapse: collapse;">
<tr style="background:#667eea; color:white;">
<th style="padding:10px;">方式</th>
<th style="padding:10px;">实现</th>
<th style="padding:10px;">适用场景</th>
</tr>
<tr style="background:#f8f9fa;">
<td style="padding:10px;"><strong>属性驱动</strong></td>
<td style="padding:10px;">Action 中定义属性 + getter/setter</td>
<td style="padding:10px;">简单场景，属性较少</td>
</tr>
<tr>
<td style="padding:10px;"><strong>模型驱动</strong></td>
<td style="padding:10px;">实现 ModelDriven 接口</td>
<td style="padding:10px;">复杂对象，表单字段多</td>
</tr>
</table>
</div>
<h2>2. 方式一：属性驱动 (Property Driven)</h2>
<h3>2.1 基本属性封装</h3>
<div class="section">
<pre><span class="comment">/**
* 直接在 Action 中定义属性
* 表单: &lt;input name="username"&gt; 会自动调用 setUsername()
*/</span>
<span class="keyword">public class</span> UserAction <span class="keyword">extends</span> ActionSupport {
<span class="comment">// Struts2 自动调用 setter 注入参数</span>
<span class="keyword">private</span> String username;
<span class="keyword">private</span> String email;
<span class="keyword">private</span> Integer age;
<span class="annotation">@Override</span>
<span class="keyword">public</span> String execute() {
System.out.println(username + <span class="string">" - "</span> + email + <span class="string">" - "</span> + age);
<span class="keyword">return</span> SUCCESS;
}
<span class="comment">// 必须提供 setter 和 getter</span>
<span class="keyword">public</span> String getUsername() { <span class="keyword">return</span> username; }
<span class="keyword">public void</span> setUsername(String username) { <span class="keyword">this</span>.username = username; }
<span class="keyword">public</span> String getEmail() { <span class="keyword">return</span> email; }
<span class="keyword">public void</span> setEmail(String email) { <span class="keyword">this</span>.email = email; }
<span class="keyword">public</span> Integer getAge() { <span class="keyword">return</span> age; }
<span class="keyword">public void</span> setAge(Integer age) { <span class="keyword">this</span>.age = age; }
}</pre>
</div>
<h3>2.2 复杂属性 (嵌套对象)</h3>
<div class="section">
<p>表单中的 <code>user.username</code> 会自动调用 setUser(用户对象).setUsername()</p>
<pre><span class="comment">// Action</span>
<span class="keyword">private</span> User user; <span class="comment">// 包含 username, email 属性的对象</span>
<span class="comment">// 表单</span>
<span class="keyword">&lt;input</span> name=<span class="string">"user.username"</span>/&gt;
<span class="keyword">&lt;input</span> name=<span class="string">"user.email"</span>/&gt;</pre>
</div>
<h2>3. 方式二：模型驱动 (ModelDriven)</h2>
<div class="note">
<strong>💡 推荐：</strong> 对于复杂表单，使用模型驱动更清晰，Action 和 Model 分离
</div>
<div class="section">
<pre><span class="keyword">import</span> com.opensymphony.xwork2.ModelDriven;
<span class="comment">/**
* 实现 ModelDriven 接口
* 需要:
* 1. 实现 getModel() 方法
* 2. 泛型指定模型类型
*/</span>
<span class="keyword">public class</span> UserAction <span class="keyword">extends</span> ActionSupport <span class="keyword">implements</span> ModelDriven&lt;User&gt; {
<span class="comment">// 模型对象</span>
<span class="keyword">private</span> User user = <span class="keyword">new</span> User();
<span class="comment">/**
* 返回模型对象
* Struts2 会把参数注入到返回的对象中
*/</span>
<span class="annotation">@Override</span>
<span class="keyword">public</span> User getModel() {
<span class="keyword">return</span> user;
}
<span class="annotation">@Override</span>
<span class="keyword">public</span> String execute() {
<span class="comment">// 直接使用 user 对象</span>
System.out.println(user.getUsername());
<span class="keyword">return</span> SUCCESS;
}
}</pre>
</div>
<h2>4. List/Map 属性封装</h2>
<div class="section">
<pre><span class="comment">// Action - 接收 List</span>
<span class="keyword">private</span> List&lt;User&gt; users;
<span class="keyword">public void</span> setUsers(List&lt;User&gt; users) { <span class="keyword">this</span>.users = users; }
<span class="keyword">public</span> List&lt;User&gt; getUsers() { <span class="keyword">return</span> users; }
<span class="comment">// 页面表单 - users[0].username, users[1].username</span>
<span class="keyword">&lt;input</span> name=<span class="string">"users[0].username"</span> value=<span class="string">"张三"</span>/&gt;
<span class="keyword">&lt;input</span> name=<span class="string">"users[1].username"</span> value=<span class="string">"李四"</span>/&gt;
<span class="comment">// Action - 接收 Map</span>
<span class="keyword">private</span> Map&lt;String, User&gt; userMap;
<span class="keyword">&lt;input</span> name=<span class="string">"userMap['one'].username"</span>/&gt;</pre>
</div>
<h2>5. 封装流程图</h2>
<div class="section">
<pre style="text-align: center; font-size: 1.1em;">
请求参数 → Action setter 方法 → 属性赋值
↓
实现 ModelDriven → getModel() → 模型对象赋值
↓
值栈 (Value Stack)</pre>
</div>
<div style="margin-top: 30px;">
<a href="/demo/upload" class="btn">下一节：文件上传 →</a>
<a href="/" class="btn" style="background: #764ba2;">← 返回首页</a>
</div>
</div>
</div>
</body>
</html>

102
web/demo/upload/index.jsp Normal file
View File

@@ -0,0 +1,102 @@
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<title>文件上传 - Struts2 学习</title>
<style>
body { font-family: 'Segoe UI', sans-serif; background: linear-gradient(135deg, #667eea, #764ba2); min-height: 100vh; margin: 0; padding: 20px; }
.container { max-width: 1200px; margin: 0 auto; }
.breadcrumb { background: white; padding: 15px 25px; border-radius: 10px; margin-bottom: 20px; }
.content { background: white; border-radius: 20px; padding: 40px; }
h1 { color: #667eea; border-bottom: 3px solid #667eea; padding-bottom: 15px; }
h2 { color: #764ba2; margin-top: 30px; }
.section { margin: 25px 0; padding: 20px; background: #f8f9fa; border-radius: 10px; }
pre { background: #1e1e1e; color: #d4d4d4; padding: 20px; border-radius: 10px; overflow-x: auto; }
.keyword { color: #569cd6; }
.string { color: #ce9178; }
.comment { color: #6a9955; }
.btn { display: inline-block; padding: 12px 30px; background: #667eea; color: white; text-decoration: none; border-radius: 25px; }
</style>
</head>
<body>
<div class="container">
<div class="breadcrumb">
<a href="/">🏠 首页</a> / 文件上传
</div>
<div class="content">
<h1>📁 文件上传</h1>
<h2>1. 单文件上传</h2>
<div class="section">
<pre><span class="comment">// Action</span>
<span class="keyword">public class</span> UploadAction <span class="keyword">extends</span> ActionSupport {
<span class="comment">// 文件对象</span>
<span class="keyword">private</span> File upload;
<span class="comment">// 文件名 (格式: 属性名FileName)</span>
<span class="keyword">private</span> String uploadFileName;
<span class="comment">// 文件类型 (格式: 属性名ContentType)</span>
<span class="keyword">private</span> String uploadContentType;
<span class="annotation">@Override</span>
<span class="keyword">public</span> String execute() <span class="keyword">throws</span> Exception {
<span class="comment">// 保存文件</span>
String path = ServletActionContext.getServletContext()
.getRealPath(<span class="string">"/upload"</span>);
<span class="keyword">new</span> File(path, uploadFileName).createNewFile();
<span class="comment">// 复制文件</span>
FileUtils.copyFile(upload, <span class="keyword">new</span> File(path, uploadFileName));
<span class="keyword">return</span> SUCCESS;
}
<span class="comment">// getter/setter</span>
<span class="keyword">public</span> File getUpload() { <span class="keyword">return</span> upload; }
<span class="keyword">public void</span> setUpload(File upload) { <span class="keyword">this</span>.upload = upload; }
<span class="keyword">public</span> String getUploadFileName() { <span class="keyword">return</span> uploadFileName; }
<span class="keyword">public void</span> setUploadFileName(String uploadFileName) { <span class="keyword">this</span>.uploadFileName = uploadFileName; }
<span class="keyword">public</span> String getUploadContentType() { <span class="keyword">return</span> uploadContentType; }
<span class="keyword">public void</span> setUploadContentType(String uploadContentType) { <span class="keyword">this</span>.uploadContentType = uploadContentType; }
}</pre>
</div>
<h2>2. JSP 表单</h2>
<div class="section">
<pre><span class="comment">&lt;%@ taglib prefix="s" uri="/struts-tags" %&gt;</span>
<span class="keyword">&lt;s:form</span> action=<span class="string">"upload"</span> method=<span class="string">"post"</span> enctype=<span class="string">"multipart/form-data"</span><span class="keyword">&gt;</span>
<span class="keyword">&lt;s:file</span> name=<span class="string">"upload"</span> label=<span class="string">"选择文件"</span>/&gt;
<span class="keyword">&lt;s:submit</span> value=<span class="string">"上传"</span>/&gt;
<span class="keyword">&lt;/s:form&gt;</span></pre>
</div>
<h2>3. 多文件上传</h2>
<div class="section">
<pre><span class="comment">// 使用 List 接收多文件</span>
<span class="keyword">private</span> List&lt;File&gt; uploads;
<span class="keyword">private</span> List&lt;String&gt; uploadsFileName;
<span class="comment">// 表单</span>
<span class="keyword">&lt;s:file</span> name=<span class="string">"uploads"</span> multiple=<span class="string">"multiple"</span>/&gt;</pre>
</div>
<h2>4. 限制文件大小和类型</h2>
<div class="section">
<pre><span class="comment">// struts.xml 配置</span>
<span class="keyword">&lt;action</span> name=<span class="string">"upload"</span> class=<span class="string">"com.demo.UploadAction"</span><span class="keyword">&gt;</span>
<span class="keyword">&lt;interceptor-ref</span> name=<span class="string">"fileUpload"</span><span class="keyword">&gt;</span>
<span class="keyword">&lt;param</span> name=<span class="string">"maximumSize"</span><span class="keyword">&gt;</span>10485760<span class="keyword">&lt;/param&gt;</span><span class="comment">&lt;!-- 10MB --&gt;</span>
<span class="keyword">&lt;param</span> name=<span class="string">"allowedTypes"</span><span class="keyword">&gt;</span>image/png,image/jpeg<span class="keyword">&lt;/param&gt;</span>
<span class="keyword">&lt;/interceptor-ref&gt;</span>
<span class="keyword">&lt;result&gt;</span>/upload/success.jsp<span class="keyword">&lt;/result&gt;</span>
<span class="keyword">&lt;/action&gt;</span></pre>
</div>
<a href="/demo/ajax" class="btn">下一节：AJAX →</a>
</div>
</div>
</body>
</html>

227
web/demo/validation/index.jsp Normal file
View File

@@ -0,0 +1,227 @@
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>表单验证 - Struts2 学习</title>
<style>
body { font-family: 'Segoe UI', 'PingFang SC', sans-serif; background: linear-gradient(135deg, #667eea, #764ba2); min-height: 100vh; margin: 0; padding: 20px; }
.container { max-width: 1200px; margin: 0 auto; }
.breadcrumb { background: white; padding: 15px 25px; border-radius: 10px; margin-bottom: 20px; }
.breadcrumb a { color: #667eea; text-decoration: none; }
.content { background: white; border-radius: 20px; padding: 40px; box-shadow: 0 10px 40px rgba(0,0,0,0.2); }
h1 { color: #667eea; border-bottom: 3px solid #667eea; padding-bottom: 15px; }
h2 { color: #764ba2; margin-top: 30px; }
.section { margin: 25px 0; padding: 20px; background: #f8f9fa; border-radius: 10px; }
pre { background: #1e1e1e; color: #d4d4d4; padding: 20px; border-radius: 10px; overflow-x: auto; font-size: 0.9em; }
.keyword { color: #569cd6; }
.string { color: #ce9178; }
.comment { color: #6a9955; }
.btn { display: inline-block; padding: 12px 30px; background: #667eea; color: white; text-decoration: none; border-radius: 25px; margin-right: 10px; }
.note { background: #fff3e0; border-left: 4px solid #ff9800; padding: 15px; margin: 20px 0; border-radius: 0 10px 10px 0; }
.tip { background: #e3f2fd; border-left: 4px solid #2196f3; padding: 15px; margin: 20px 0; border-radius: 0 10px 10px 0; }
</style>
</head>
<body>
<div class="container">
<div class="breadcrumb">
<a href="/">🏠 首页</a> / 表单验证
</div>
<div class="content">
<h1>✅ 表单验证</h1>
<div class="note">
<strong>📝 本节要点：</strong> 掌握 Struts2 的两种验证方式：编程式验证和声明式验证
</div>
<h2>1. 验证方式概览</h2>
<div class="section">
<table style="width:100%; border-collapse: collapse;">
<tr style="background:#667eea; color:white;">
<th style="padding:10px; text-align:left;">方式</th>
<th style="padding:10px; text-align:left;">实现方式</th>
<th style="padding:10px; text-align:left;">适用场景</th>
</tr>
<tr style="background:#f8f9fa;">
<td style="padding:10px;">编程式</td>
<td style="padding:10px;">重写 validate() 方法</td>
<td style="padding:10px;">简单验证，逻辑复杂</td>
</tr>
<tr>
<td style="padding:10px;">声明式 - 方法级</td>
<td style="padding:10px;">validateXxx() 方法</td>
<td style="padding:10px;">特定方法的验证</td>
</tr>
<tr style="background:#f8f9fa;">
<td style="padding:10px;">声明式 - XML</td>
<td style="padding:10px;">XxxAction-validation.xml</td>
<td style="padding:10px;">可复用，团队协作</td>
</tr>
</table>
</div>
<h2>2. 方式一：编程式验证 (validate)</h2>
<div class="section">
<pre><span class="keyword">public class</span> LoginAction <span class="keyword">extends</span> ActionSupport {
<span class="keyword">private</span> String username;
<span class="keyword">private</span> String password;
<span class="annotation">@Override</span>
<span class="keyword">public</span> String execute() {
<span class="comment">// 登录逻辑...</span>
<span class="keyword">return</span> SUCCESS;
}
<span class="comment">/**
* 验证方法 - 对所有 execute 方法都生效
*/</span>
<span class="annotation">@Override</span>
<span class="keyword">public void</span> validate() {
<span class="comment">// 用户名验证</span>
<span class="keyword">if</span> (username == <span class="keyword">null</span> || username.trim().length() < 3) {
addFieldError(<span class="string">"username"</span>, <span class="string">"用户名至少3个字符"</span>);
}
<span class="comment">// 密码验证</span>
<span class="keyword">if</span> (password == <span class="keyword">null</span> || password.length() < 6) {
addFieldError(<span class="string">"password"</span>, <span class="string">"密码至少6个字符"</span>);
}
}
<span class="comment">// getter/setter...</span>
}</pre>
</div>
<h2>3. 方式二：方法级验证 (validateXxx)</h2>
<div class="section">
<pre><span class="comment">/**
* 只验证 register 方法，不验证 login 方法
*/</span>
<span class="keyword">public void</span> validateRegister() {
<span class="keyword">if</span> (email == <span class="keyword">null</span> || !email.contains(<span class="string">"@"</span>)) {
addFieldError(<span class="string">"email"</span>, <span class="string">"邮箱格式不正确"</span>);
}
}</pre>
</div>
<h2>4. 方式三：XML 声明式验证</h2>
<div class="tip">
<strong>优点：</strong> 验证规则与代码分离，团队协作更清晰，可复用
</div>
<h3>4.1 创建验证文件</h3>
<div class="section">
<p>文件名格式：<code>ActionName-validation.xml</code></p>
<p>位置：<code>WEB-INF/classes/com/demo/action/</code></p>
<pre><span class="comment">&lt;?xml version="1.0" encoding="UTF-8"?&gt;</span>
<span class="keyword">&lt;!DOCTYPE validators PUBLIC</span>
<span class="string">"-//OpenSymphony Group//XWork Validator 1.0.3//EN"</span>
<span class="string">"http://www.opensymphony.com/xwork/xwork-validator-1.0.3.dtd"</span><span class="keyword">&gt;</span>
<span class="keyword">&lt;validators&gt;</span>
<span class="comment">&lt;!-- 字段验证 --&gt;</span>
<span class="keyword">&lt;field</span> name=<span class="string">"username"</span><span class="keyword">&gt;</span>
<span class="keyword">&lt;field-validator</span> type=<span class="string">"requiredstring"</span><span class="keyword">&gt;</span>
<span class="keyword">&lt;message&gt;</span>用户名不能为空<span class="keyword">&lt;/message&gt;</span>
<span class="keyword">&lt;/field-validator&gt;</span>
<span class="keyword">&lt;field-validator</span> type=<span class="string">"stringlength"</span><span class="keyword">&gt;</span>
<span class="keyword">&lt;param</span> name=<span class="string">"minLength"</span><span class="keyword">&gt;</span>3<span class="keyword">&lt;/param&gt;</span>
<span class="keyword">&lt;param</span> name=<span class="string">"maxLength"</span><span class="keyword">&gt;</span>20<span class="keyword">&lt;/param&gt;</span>
<span class="keyword">&lt;message&gt;</span>用户名长度3-20字符<span class="keyword">&lt;/message&gt;</span>
<span class="keyword">&lt;/field-validator&gt;</span>
<span class="keyword">&lt;/field&gt;</span>
<span class="comment">&lt;!-- 字段验证：email --&gt;</span>
<span class="keyword">&lt;field</span> name=<span class="string">"email"</span><span class="keyword">&gt;</span>
<span class="keyword">&lt;field-validator</span> type=<span class="string">"email"</span><span class="keyword">&gt;</span>
<span class="keyword">&lt;message&gt;</span>邮箱格式不正确<span class="keyword">&lt;/message&gt;</span>
<span class="keyword">&lt;/field-validator&gt;</span>
<span class="keyword">&lt;/field&gt;</span>
<span class="comment">&lt;!-- 非字段验证 --&gt;</span>
<span class="keyword">&lt;validator</span> type=<span class="string">"expression"</span><span class="keyword">&gt;</span>
<span class="keyword">&lt;param</span> name=<span class="string">"expression"</span><span class="keyword">&gt;</span>password==confirmPassword<span class="keyword">&lt;/param&gt;</span>
<span class="keyword">&lt;message&gt;</span>两次密码不一致<span class="keyword">&lt;/message&gt;</span>
<span class="keyword">&lt;/validator&gt;</span>
<span class="keyword">&lt;/validators&gt;</span></pre>
</div>
<h2>5. 常用验证器类型</h2>
<div class="section">
<table style="width:100%; border-collapse: collapse;">
<tr style="background:#667eea; color:white;">
<th style="padding:10px; text-align:left;">验证器</th>
<th style="padding:10px; text-align:left;">说明</th>
<th style="padding:10px; text-align:left;">示例</th>
</tr>
<tr style="background:#f8f9fa;">
<td style="padding:10px;">required</td>
<td style="padding:10px;">必填</td>
<td style="padding:10px;">username 不能为空</td>
</tr>
<tr>
<td style="padding:10px;">requiredstring</td>
<td style="padding:10px;">字符串必填</td>
<td style="padding:10px;">不能为空字符串</td>
</tr>
<tr style="background:#f8f9fa;">
<td style="padding:10px;">stringlength</td>
<td style="padding:10px;">字符串长度</td>
<td style="padding:10px;">minLength, maxLength</td>
</tr>
<tr>
<td style="padding:10px;">email</td>
<td style="padding:10px;">邮箱格式</td>
<td style="padding:10px;">xxx@xxx.com</td>
</tr>
<tr style="background:#f8f9fa;">
<td style="padding:10px;">regex</td>
<td style="padding:10px;">正则表达式</td>
<td style="padding:10px;">手机号、身份证等</td>
</tr>
<tr>
<td style="padding:10px;">int</td>
<td style="padding:10px;">整数范围</td>
<td style="padding:10px;">min, max</td>
</tr>
<tr style="background:#f8f9fa;">
<td style="padding:10px;">url</td>
<td style="padding:10px;">URL 格式</td>
<td style="padding:10px;">http://xxx.com</td>
</tr>
<tr>
<td style="padding:10px;">date</td>
<td style="padding:10px;">日期范围</td>
<td style="padding:10px;">min, max</td>
</tr>
</table>
</div>
<h2>6. 在 JSP 中显示错误</h2>
<div class="section">
<pre><span class="comment">&lt;%@ taglib prefix="s" uri="/struts-tags" %&gt;</span>
<span class="comment">&lt;!-- 显示特定字段的错误 --&gt;</span>
<span class="keyword">&lt;s:fielderror</span> fieldName=<span class="string">"username"</span>/&gt;
<span class="comment">&lt;!-- 显示所有字段错误 --&gt;</span>
<span class="keyword">&lt;s:fielderror</span>/&gt;
<span class="comment">&lt;!-- 显示 Action 级别错误 --&gt;</span>
<span class="keyword">&lt;s:actionerror</span>/&gt;
<span class="comment">&lt;!-- 显示 Action 级别消息 --&gt;</span>
<span class="keyword">&lt;s:actionmessage</span>/&gt;</pre>
</div>
<div style="margin-top: 30px;">
<a href="/demo/model" class="btn">下一节：数据封装 →</a>
<a href="/" class="btn" style="background: #764ba2;">← 返回首页</a>
</div>
</div>
</div>
</body>
</html>