[Master] HUGE UPDATE

Author: kmsoln

README-CN.md

@@ -1,3 +1,5 @@
+[English](README-EN.md) | 中文 | [Русский](README.md)
+
 ## 使用Java进行Web开发的教程
 
 欢迎使用Spring框架进行Java Web开发的教程！这些结构化的教程旨在提供全面的指导，涵盖Java Web开发的各个方面，侧重于Spring框架。每个教程都精心设计，重点介绍特定的概念和方法，确保对Web开发原理的牢固理解。
@@ -24,6 +26,3 @@
 
    JMeter系列教程提供了使用JMeter进行负载测试和性能分析的完整指南。参与者将学习如何设置JMeter、记录HTTP请求、创建和执行测试场景，以及分析测试结果。
 
----
-
-translate to Chinese language

README-EN.md

@@ -1,3 +1,5 @@
+English | [中文](README-CN.md) | [Русский](README.md)
+
 ## Java Web Development Tutorials
 
 Welcome to the tutorials on Java web development utilizing the Spring framework! These structured tutorials aim to provide comprehensive guidance on various aspects of Java web development through the lens of the Spring framework. Each tutorial is meticulously designed to focus on specific concepts and methodologies, facilitating a robust understanding of web development principles.

README.md

@@ -1,3 +1,5 @@
+[English](README-EN.md) | [中文](README-CN.md) | Русский
+
 ## Учебные пособия по веб-разработке на Java
 
 Добро пожаловать на учебные пособия по веб-разработке на Java с использованием фреймворка Spring! Эти структурированные учебные пособия направлены на предоставление всестороннего руководства по различным аспектам веб-разработки на Java через призму фреймворка Spring. Каждое учебное пособие тщательно разработано для акцентирования на конкретных концепциях и методологиях, обеспечивая крепкое понимание принципов веб-разработки.

docs/cn/jpa/practice/dependencies/jpa.md

@@ -1,12 +1,12 @@
 # JPA：设置依赖项
 
-## 简介
+## 介绍
 
-本指南专注于为具有JPA（Java Persistence API）的Spring Boot项目设置依赖项。它涵盖了包括Spring Boot Starter JDBC和Spring Boot Starter Data JPA依赖项的必要步骤。
+本指南重点介绍了如何为具有JPA（Java持久性API）的Spring Boot项目设置依赖项。它涵盖了包含Spring Boot Starter JDBC和Spring Boot Starter Data JPA依赖项所需的必要步骤。
 
 ## 目标
 
-本指南的目标是提供清晰的说明，以便设置Spring Boot和JPA的必要依赖项，特别关注Spring Boot Starter JDBC和Spring Boot Starter Data JPA依赖项。
+本指南的目标是为Spring Boot和JPA设置必要依赖项，具体重点放在Spring Boot Starter JDBC和Spring Boot Starter Data JPA依赖项上，并提供清晰的说明。
 
 ## 设置依赖项
 
@@ -29,11 +29,11 @@ implementation "org.springframework.boot:spring-boot-starter-jdbc"
 </dependency>
 ```
 
-此依赖项提供了基于JDBC的数据访问的自动配置。
+此依赖项为基于JDBC的数据访问提供了自动配置。
 
 ### Spring Boot Starter Data JPA
 
-要在Spring Boot应用程序中包含对JPA（Java Persistence API）的支持：
+要在Spring Boot应用程序中包含对JPA（Java持久性API）的支持：
 
 #### Gradle
 
@@ -50,8 +50,20 @@ implementation "org.springframework.boot:spring-boot-starter-data-jpa"
 </dependency>
 ```
 
-此依赖项简化了JPA存储库的设置，并为Hibernate提供了默认配置。
+此依赖项简化了设置基于JPA的存储库，并为Hibernate提供了默认配置。
+
+### 为Spring WebMVC进行附加配置
+
+如果您使用Spring WebMVC，则需要添加额外的配置来设置与持久性相关的bean和属性。
+
+#### 创建持久性配置类
+
+在`com.example.config`包中创建一个名为`PersistenceConfig`的新类：
+
+```java
+// 这里是java代码，因此不需要翻译
+```
 
 ---
 
-# [下一步：实体创建](../creation/create-entity.md)
+# [下一步：创建实体](../creation/create-entity.md)

docs/cn/springsecurity/practice/authorize-client-authenticated.md

@@ -0,0 +1,54 @@
+# 客户端授权认证用户（客户端）
+
+这项任务概述了如何使用Thymeleaf在客户端视图中根据用户的认证状态授权用户。通过根据用户是否已经认证来显示或隐藏元素，您可以控制特定功能或操作的可见性。
+
+## 目标
+
+在Thymeleaf视图中根据用户的认证状态控制与添加和删除学生相关的元素的可见性。
+
+## 步骤
+
+1. **更新Thymeleaf模板：**
+
+   修改Thymeleaf模板以根据用户的认证状态有条件地显示元素。
+
+   ```html
+   <!DOCTYPE html>
+   <html xmlns:th="http://www.thymeleaf.org">
+   <head>
+       <title>学生管理</title>
+   </head>
+   <body>
+       <h1>学生管理</h1>
+
+       <!-- 添加学生按钮 -->
+       <div th:if="${#authorization.expression('isAuthenticated()')}">
+           <a href="/addStudent" class="btn btn-primary">添加学生</a>
+       </div>
+
+       <!-- 删除学生按钮 -->
+       <div th:if="${#authorization.expression('isAuthenticated()')}">
+           <a href="/removeStudent" class="btn btn-danger">删除学生</a>
+       </div>
+
+       <!-- 其他内容 -->
+       <div>
+           <p>欢迎使用学生管理系统。在这里您可以管理学生记录。</p>
+       </div>
+   </body>
+   </html>
+   ```
+
+   在此模板中：
+    - 使用`th:if="${#authorization.expression('isAuthenticated()')}"`语句仅在用户已认证时条件显示“添加学生”和“删除学生”按钮。
+
+## 解释
+
+- **Thymeleaf安全方言**：`#authorization`对象是Thymeleaf安全方言的一部分，它将Spring Security与Thymeleaf集成在一起。
+- **条件显示**：使用`th:if`属性根据用户的认证状态有条件地显示或隐藏元素。
+
+通过按照这些步骤，您可以根据用户是否已认证来控制Thymeleaf视图中元素的可见性，确保只有经过认证的用户才能看到和与特定功能进行交互。
+
+---
+
+# [下一个任务：按角色授权](authorize-client-role.md)

docs/cn/springsecurity/practice/authorize-client-authority.md

@@ -0,0 +1,55 @@
+# 根据权限授权用户（客户端）
+
+本任务概述了如何使用Thymeleaf在客户端视图中根据用户的权限授权用户。通过根据用户权限显示或隐藏元素，您可以控制特定功能或操作的可见性。
+
+## 目标
+
+在Thymeleaf视图中根据用户的权限控制与添加和删除学生相关的元素的可见性。
+
+## 步骤
+
+1. **更新Thymeleaf模板：**
+
+   修改Thymeleaf模板以根据用户的权限有条件地显示元素。
+
+   ```html
+   <!DOCTYPE html>
+   <html xmlns:th="http://www.thymeleaf.org">
+   <head>
+       <title>学生管理</title>
+   </head>
+   <body>
+       <h1>学生管理</h1>
+
+       <!-- 添加学生按钮 -->
+       <div th:if="${#authorization.expression('hasAuthority(''WRITE'')')}">
+           <a href="/addStudent" class="btn btn-primary">添加学生</a>
+       </div>
+
+       <!-- 删除学生按钮 -->
+       <div th:if="${#authorization.expression('hasAuthority(''DELETE'')}">
+           <a href="/removeStudent" class="btn btn-danger">删除学生</a>
+       </div>
+
+       <!-- 其他内容 -->
+       <div>
+           <p>欢迎使用学生管理系统。在这里您可以管理学生记录。</p>
+       </div>
+   </body>
+   </html>
+   ```
+
+   在此模板中：
+    - 使用`th:if="${#authorization.expression('hasAuthority(''WRITE'')')}"`语句仅在用户具有`WRITE`权限时条件显示“添加学生”按钮。
+    - 同样，使用`th:if="${#authorization.expression('hasAuthority(''DELETE'')')}"`语句仅在用户具有`DELETE`权限时条件显示“删除学生”按钮。
+
+## 解释
+
+- **Thymeleaf安全方言**：`#authorization`对象是Thymeleaf安全方言的一部分，它将Spring Security与Thymeleaf集成在一起。
+- **条件显示**：使用`th:if`属性根据用户的权限有条件地显示或隐藏元素。
+
+通过按照这些步骤，您可以根据用户的权限控制Thymeleaf视图中元素的可见性，确保只有授权用户才能看到和与特定功能进行交互。
+
+---
+
+# [NEXT TASK: Lab Tasks](../lab-work.md)

docs/cn/springsecurity/practice/authorize-client-role.md

@@ -0,0 +1,55 @@
+# 基于角色授权用户（客户端）
+
+本任务概述了如何在客户端视图中根据用户的角色对用户进行授权，使用Thymeleaf来实现。通过根据用户角色显示或隐藏元素，您可以控制特定功能或操作的可见性。
+
+## 目标
+
+在Thymeleaf视图中根据用户的角色控制与添加和删除学生相关的元素的可见性。
+
+## 步骤
+
+1. **更新Thymeleaf模板：**
+
+   修改Thymeleaf模板以根据用户的角色有条件地显示元素。
+
+   ```html
+   <!DOCTYPE html>
+   <html xmlns:th="http://www.thymeleaf.org">
+   <head>
+       <title>学生管理</title>
+   </head>
+   <body>
+       <h1>学生管理</h1>
+
+       <!-- 添加学生按钮 -->
+       <div th:if="${#authorization.expression('hasRole(''ROLE_ADMIN'')')}">
+           <a href="/addStudent" class="btn btn-primary">添加学生</a>
+       </div>
+
+       <!-- 删除学生按钮 -->
+       <div th:if="${#authorization.expression('hasRole(''ROLE_MANAGER'')')}">
+           <a href="/removeStudent" class="btn btn-danger">删除学生</a>
+       </div>
+
+       <!-- 其他内容 -->
+       <div>
+           <p>欢迎使用学生管理系统。在这里您可以管理学生记录。</p>
+       </div>
+   </body>
+   </html>
+   ```
+
+   在此模板中：
+    - 使用`th:if="${#authorization.expression('hasRole(''ROLE_ADMIN'')')}"`语句仅在用户具有`ROLE_ADMIN`角色时条件显示“添加学生”按钮。
+    - 同样，使用`th:if="${#authorization.expression('hasRole(''ROLE_MANAGER'')')}"`语句仅在用户具有`ROLE_MANAGER`角色时条件显示“删除学生”按钮。
+
+## 解释
+
+- **Thymeleaf安全方言**：`#authorization`对象是Thymeleaf安全方言的一部分，它将Spring Security与Thymeleaf集成在一起。
+- **条件显示**：使用`th:if`属性根据用户的角色有条件地显示或隐藏元素。
+
+通过按照这些步骤，您可以根据用户的角色控制Thymeleaf视图中元素的可见性，确保只有授权用户才能看到和与特定功能进行交互。
+
+---
+
+# [下一个任务：根据权限授权用户](authorize-client-authority.md)

docs/cn/springsecurity/practice/configure-thymeleaf-security.md

@@ -27,4 +27,4 @@
 
 ---
 
-[下一任务：]()
+# [下一个任务：为用户创建基本实现](base-implementation-user.md)

docs/cn/thymeleaf/lab-work.md

@@ -46,7 +46,7 @@
 
    ![login-page.png](../../srcs/thymeleaf/login-page.png)
 
-   ![signup-page.png](../../srcs/thymeleaf/signup-page.png)
+   ![signup.png](../../srcs/thymeleaf/signup.png)
 
 4. **任务 4：验证登录和注册操作**
 

docs/en/jpa/practice/dependencies/jpa.md

@@ -52,6 +52,130 @@ implementation "org.springframework.boot:spring-boot-starter-data-jpa"
 
 This dependency simplifies the setup of JPA-based repositories and provides default configurations for Hibernate.
 
+### Additional Configuration for Spring WebMVC
+
+If you are using Spring WebMVC, you need to add additional configuration to set up persistence-related beans and properties.
+
+#### Create a Persistence Configuration Class
+
+Create a new class named `PersistenceConfig` in the `com.example.config` package:
+
+```java
+package com.example.config;
+
+import org.springframework.beans.factory.annotation.Value;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+import org.springframework.context.annotation.PropertySource;
+import org.springframework.data.jpa.repository.config.EnableJpaRepositories;
+import org.springframework.jdbc.datasource.DriverManagerDataSource;
+import org.springframework.orm.jpa.JpaTransactionManager;
+import org.springframework.orm.jpa.LocalContainerEntityManagerFactoryBean;
+import org.springframework.orm.jpa.vendor.HibernateJpaVendorAdapter;
+import org.springframework.transaction.PlatformTransactionManager;
+import org.springframework.transaction.annotation.EnableTransactionManagement;
+
+import javax.persistence.EntityManagerFactory;
+import javax.sql.DataSource;
+
+/**
+ * Configuration class for setting up persistence-related beans and properties.
+ *
+ * <p>
+ * This class configures the data source, entity manager factory, and transaction manager for JPA.
+ * It reads database connection properties from an external properties file.
+ * </p>
+ */
+@Configuration
+@EnableTransactionManagement
+@EnableJpaRepositories(basePackages = "com.example.repository")
+@PropertySource({"classpath:application.properties"})
+public class PersistenceConfig {
+
+    @Value("${spring.datasource.driver}")
+    private String dbDriver;
+
+    @Value("${spring.datasource.url}")
+    private String dbUrl;
+
+    @Value("${spring.datasource.username}")
+    private String dbUsername;
+
+    @Value("${spring.datasource.password}")
+    private String dbPassword;
+
+    @Value("${spring.jpa.properties.hibernate.dialect}")
+    private String hibernateDialect;
+
+    @Value("${spring.jpa.properties.hibernate.show_sql}")
+    private boolean hibernateShowSql;
+
+    @Value("${spring.jpa.hibernate.ddl-auto}")
+    private String hibernateHbm2ddlAuto;
+
+    /**
+     * Bean definition for the DataSource.
+     *
+     * <p>
+     * This method sets up the data source using the properties defined in the application.properties file.
+     * </p>
+     *
+     * @return DataSource bean
+     */
+    @Bean
+    public DataSource dataSource() {
+        DriverManagerDataSource dataSource = new DriverManagerDataSource();
+        dataSource.setDriverClassName(dbDriver);
+        dataSource.setUrl(dbUrl);
+        dataSource.setUsername(dbUsername);
+        dataSource.setPassword(dbPassword);
+        return dataSource;
+    }
+
+    /**
+     * Bean definition for the EntityManagerFactory.
+     *
+     * <p>
+     * This method sets up the entity manager factory using the configured data source and Hibernate properties.
+     * </p>
+     *
+     * @param dataSource the data source bean
+     * @return EntityManagerFactory bean
+     */
+    @Bean
+    public LocalContainerEntityManagerFactoryBean entityManagerFactory(DataSource dataSource) {
+        LocalContainerEntityManagerFactoryBean em = new LocalContainerEntityManagerFactoryBean();
+        em.setDataSource(dataSource);
+        em.setPackagesToScan("com.example.entity");
+
+        HibernateJpaVendorAdapter vendorAdapter = new HibernateJpaVendorAdapter();
+        vendorAdapter.setDatabasePlatform(hibernateDialect);
+        vendorAdapter.setShowSql(hibernateShowSql);
+        vendorAdapter.setGenerateDdl("update".equalsIgnoreCase(hibernateHbm2ddlAuto));
+        em.setJpaVendorAdapter(vendorAdapter);
+
+        return em;
+    }
+
+    /**
+     * Bean definition for the Spring Transaction Manager.
+     *
+     * <p>
+     * This method sets up the transaction manager for JPA using the configured entity manager factory.
+     * </p>
+     *
+     * @param entityManagerFactory the entity manager factory bean
+     * @return TransactionManager bean
+     */
+    @Bean
+    public PlatformTransactionManager transactionManager(EntityManagerFactory entityManagerFactory) {
+        JpaTransactionManager txManager = new JpaTransactionManager();
+        txManager.setEntityManagerFactory(entityManagerFactory);
+        return txManager;
+    }
+}
+```
+
 ---
 
 # [Next: Entity Creation](../creation/create-entity.md)