S04L04 - 添加登录用户表单

html

使用Spring Security添加登录功能：全面指南
目录

介绍 - 第1页
设置登录功能 - 第2页

创建登录控制器
设计登录视图


集成Spring Security - 第4页

添加依赖
配置Spring Security


处理登录请求 - 第6页

登录逻辑
表单验证


测试登录功能 - 第8页

运行应用程序
验证登录


结论 - 第10页
附加资源 - 第11页

---
介绍
在当今的网络应用中，安全的用户认证至关重要。实现健全的登录功能确保只有授权用户才能访问应用程序的特定部分。本指南深入探讨了如何使用Spring Security添加登录功能，Spring Security是一个强大且可定制的Java应用程序认证和访问控制框架。
登录功能的重要性

安全性：通过确保只有经过身份验证的用户可以访问某些资源来保护敏感数据。
用户管理：允许区分不同的用户角色和权限。
数据完整性：防止未经授权的修改应用程序数据。

优缺点


优点
缺点


增强的安全性
初始设置复杂性


可定制的认证
Spring Security的学习曲线


适用于大型应用的可扩展性
潜在的配置挑战


何时何地使用

网络应用：任何需要用户认证和授权的应用。
APIs：保护端点，确保只有有效用户可以访问某些数据。
企业解决方案：管理复杂的用户角色和权限。

---
设置登录功能
实现登录功能涉及后端和前端的设置。我们将从创建必要的控制器和视图开始。
创建登录控制器
控制器处理与登录功能相关的HTTP请求。




		
		
			
			
Java
			
			// AccountController.java

package org.studyeasy.SpringStarter.Controller;

import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.GetMapping;

@Controller
public class AccountController {

    @GetMapping("/login")
    public String login(Model model) {
        return "login";
    }
}
			
				
					
				
					1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
				
						// AccountController.java
 
package org.studyeasy.SpringStarter.Controller;
 
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.GetMapping;
 
@Controller
public class AccountController {
 
    @GetMapping("/login")
    public String login(Model model) {
        return "login";
    }
}
					
				
			
		


解释：

@Controller：表示此类在MVC模式中作为控制器。
@GetMapping("/login")：将HTTP GET请求映射到/login URL。
Model model：允许向视图传递数据，尽管在这个简单的例子中未被使用。
return "login"：指示Spring渲染login.html模板。

设计登录视图
登录视图向用户展示登录表单。




		
		
			
			
Java
			
			<!-- login.html -->

<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
    <title>登录</title>
    <link rel="stylesheet" th:href="@{/css/style.css}">
</head>
<body>
    <h2>登录</h2>
    <form th:action="@{/login}" method="post">
        <div>
            <label for="username">邮箱：</label>
            <input type="email" id="username" name="username" required>
        </div>
        <div>
            <label for="password">密码：</label>
            <input type="password" id="password" name="password" required>
        </div>
        <button type="submit">登录</button>
    </form>
</body>
</html>
			
				
					
				
					1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
				
						<!-- login.html -->
 
<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
    <title>登录</title>
    <link rel="stylesheet" th:href="@{/css/style.css}">
</head>
<body>
    <h2>登录</h2>
    <form th:action="@{/login}" method="post">
        <div>
            <label for="username">邮箱：</label>
            <input type="email" id="username" name="username" required>
        </div>
        <div>
            <label for="password">密码：</label>
            <input type="password" id="password" name="password" required>
        </div>
        <button type="submit">登录</button>
    </form>
</body>
</html>
					
				
			
		


解释：

th:action="@{/login}"：指定表单提交URL，与Spring Security集成。
输入字段：收集用户的邮箱和密码。

---
集成Spring Security
Spring Security处理认证过程，管理用户会话，并保护端点。
添加依赖
要集成Spring Security，请在pom.xml中添加必要的依赖。




		
		
			
			
Java
			
			<!-- pom.xml -->

<dependencies>
    <!-- Spring Boot Starter Security -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-security</artifactId>
    </dependency>
    
    <!-- Thymeleaf Spring Security Integration -->
    <dependency>
        <groupId>org.thymeleaf.extras</groupId>
        <artifactId>thymeleaf-extras-springsecurity5</artifactId>
    </dependency>
    
    <!-- 其他依赖 -->
    <!-- ... -->
</dependencies>
			
				
					
				
					1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
				
						<!-- pom.xml -->
 
<dependencies>
    <!-- Spring Boot Starter Security -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-security</artifactId>
    </dependency>
    
    <!-- Thymeleaf Spring Security Integration -->
    <dependency>
        <groupId>org.thymeleaf.extras</groupId>
        <artifactId>thymeleaf-extras-springsecurity5</artifactId>
    </dependency>
    
    <!-- 其他依赖 -->
    <!-- ... -->
</dependencies>
					
				
			
		


解释：

spring-boot-starter-security：提供基本的Spring Security功能。
thymeleaf-extras-springsecurity5：将Spring Security与Thymeleaf模板集成。

配置Spring Security
创建一个安全配置类以定义安全设置。




		
		
			
			
Java
			
			// SecurityConfig.java

package org.studyeasy.SpringStarter.config;

import org.springframework.context.annotation.Configuration;
import org.springframework.security.config.annotation.authentication.builders.AuthenticationManagerBuilder;
import org.springframework.security.config.annotation.web.builders.HttpSecurity;
import org.springframework.security.config.annotation.web.configuration.*;

@Configuration
@EnableWebSecurity
public class SecurityConfig extends WebSecurityConfigurerAdapter {

    @Override
    protected void configure(HttpSecurity http) throws Exception {
        http
            .authorizeRequests()
                // 允许未认证访问注册页面
                .antMatchers("/register", "/css/**", "/js/**", "/images/**").permitAll()
                .anyRequest().authenticated()
                .and()
            .formLogin()
                .loginPage("/login") // 指定自定义登录页面
                .defaultSuccessUrl("/home") // 成功登录后重定向到主页
                .permitAll()
                .and()
            .logout()
                .permitAll();
    }

    @Override
    protected void configure(AuthenticationManagerBuilder auth) throws Exception {
        // 为简单起见使用内存中认证
        auth.inMemoryAuthentication()
            .withUser("user@example.com")
            .password("{noop}password") // {noop}表示无密码编码
            .roles("USER");
    }
}
			
				
					
				
					1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
				
						// SecurityConfig.java
 
package org.studyeasy.SpringStarter.config;
 
import org.springframework.context.annotation.Configuration;
import org.springframework.security.config.annotation.authentication.builders.AuthenticationManagerBuilder;
import org.springframework.security.config.annotation.web.builders.HttpSecurity;
import org.springframework.security.config.annotation.web.configuration.*;
 
@Configuration
@EnableWebSecurity
public class SecurityConfig extends WebSecurityConfigurerAdapter {
 
    @Override
    protected void configure(HttpSecurity http) throws Exception {
        http
            .authorizeRequests()
                // 允许未认证访问注册页面
                .antMatchers("/register", "/css/**", "/js/**", "/images/**").permitAll()
                .anyRequest().authenticated()
                .and()
            .formLogin()
                .loginPage("/login") // 指定自定义登录页面
                .defaultSuccessUrl("/home") // 成功登录后重定向到主页
                .permitAll()
                .and()
            .logout()
                .permitAll();
    }
 
    @Override
    protected void configure(AuthenticationManagerBuilder auth) throws Exception {
        // 为简单起见使用内存中认证
        auth.inMemoryAuthentication()
            .withUser("[email protected]")
            .password("{noop}password") // {noop}表示无密码编码
            .roles("USER");
    }
}
					
				
			
		


解释：

@EnableWebSecurity：启用Spring Security的Web安全支持。
configure(HttpSecurity http)：定义安全规则。

antMatchers()：指定应公开访问的URL。
anyRequest().authenticated()：保护所有其他URL。
formLogin()：配置基于表单的认证。
logout()：启用登出功能。


configure(AuthenticationManagerBuilder auth)：设置内存中认证，使用示例用户。

---
处理登录请求
一旦配置了Spring Security，它就会管理登录过程，包括表单提交和用户认证。
登录逻辑
Spring Security会自动处理对/login的POST请求。当用户提交登录表单时，Spring Security会验证凭据。
示例用户凭据：

邮箱：[email protected]
密码：password

表单验证
确保登录表单字段正确映射并进行验证。




		
		
			
			
Java
			
			<!-- login.html -->

<form th:action="@{/login}" method="post">
    <div>
        <label for="username">邮箱：</label>
        <input type="email" id="username" name="username" required>
    </div>
    <div>
        <label for="password">密码：</label>
        <input type="password" id="password" name="password" required>
    </div>
    <button type="submit">登录</button>
</form>
			
				
					
				
					1
2
3
4
5
6
7
8
9
10
11
12
13
				
						<!-- login.html -->
 
<form th:action="@{/login}" method="post">
    <div>
        <label for="username">邮箱：</label>
        <input type="email" id="username" name="username" required>
    </div>
    <div>
        <label for="password">密码：</label>
        <input type="password" id="password" name="password" required>
    </div>
    <button type="submit">登录</button>
</form>
					
				
			
		


解释：

name="username"：对应Spring Security默认期望的用户名字段。
name="password"：对应密码字段。

---
测试登录功能
在设置登录功能后，必须测试其功能性以确保一切按预期工作。
运行应用程序

构建项目：使用Maven构建项目。





		
		
			
			
Java
			
			./mvnw clean install
			
				
					
				
					1
				
						./mvnw clean install
					
				
			
		



运行应用程序：启动Spring Boot应用程序。





		
		
			
			
Java
			
			./mvnw spring-boot:run
			
				
					
				
					1
				
						./mvnw spring-boot:run
					
				
			
		


验证登录

访问登录页面：导航到 http://localhost:8080/login。
输入凭据：

邮箱：[email protected]
密码：password


提交表单：点击“登录”按钮。
登录后重定向：成功登录后，应重定向到 /home 页面。
登出：使用登出选项结束会话。

输出解释：

成功登录：重定向到主页，表示认证成功。
登录失败：停留在登录页面并显示错误消息。

---
结论
实现安全的登录功能是保护网络应用的基础。通过利用Spring Security，开发人员可以轻松集成强大的认证机制，确保只有授权用户才能访问应用程序的敏感部分。本指南提供了从设置控制器和视图到配置安全性和测试功能的逐步方法，以添加登录功能。
关键要点

Spring Security 简化了保护网络应用的过程。
自定义登录页面 在保持安全标准的同时提升用户体验。
配置灵活性 允许开发人员根据特定应用需求定制安全设置。

---
附加资源

Spring Security官方文档
Thymeleaf文档
Spring Boot指南
使用Spring Security的内存认证
自定义Spring Security配置

注意：本文是AI生成的。
优点	缺点
增强的安全性	初始设置复杂性
可定制的认证	Spring Security的学习曲线
适用于大型应用的可扩展性	潜在的配置挑战