在前面课程中,咱们学习了 Spring Boot Web 开发、JPA 数据库操做、Thymeleaf 和页面交互技术,这节课综合这些内容作一个用户管理功能,包括展现用户列表(分页)、添加用户、修改用户和删除用户。有人说程序员的一辈子都是在增、删、改、查,这句话不必定全对,但也有必定的道理,相比于这句话,我更认同的是这句:程序员的技术学习都是从增、删、改、查开始的。css
这节课将介绍如何使用 JPA 和 Thymeleaf 作一个用户管理功能。html
pom 包里面添加 JPA 和 Thymeleaf 的相关包引用。前端
<dependency>
<groupId></groupId> org.springframework.boot
<artifactId></artifactId> spring-boot-starter-web
</dependency>
<dependency>
<groupId></groupId> org.springframework.boot
<artifactId></artifactId> spring-boot-starter-Thymeleaf
</dependency>
<dependency>
<groupId></groupId> org.springframework.boot
<artifactId></artifactId> spring-boot-starter-data-Jpa
</dependency>
<dependency>
<groupId></groupId> mysql
<artifactId></artifactId> mysql-connector-java
</dependency>
在 application.properties 中添加配置:java
testtruetruespring.datasource.url=jdbc:mysql://localhost:3306/?serverTimezone=UTC&useUnicode=&characterEncoding=utf-8&useSSL=
spring.datasource.username=root
spring.datasource.password=root
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
spring.jpa.properties.hibernate.hbm2ddl.auto=create
spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.MySQL5InnoDBDialect
truespring.jpa.show-sql=
falsespring.thymeleaf.cache=
其中,spring.Thymeleaf.cache=false 是关闭 Thymeleaf 的缓存,否则在开发过程当中修改页面不会马上生效须要重启,生产可配置为 true。mysql
在项目 resources 目录下会有两个文件夹:static 目录用于放置网站的静态内容如 css、js、图片;templates 目录用于放置项目使用的页面模板。git
启动类须要添加 Servlet 的支持:程序员
@SpringBootApplication
publicclass JpaThymeleafApplication extends SpringBootServletInitializer {
@Override
protected SpringApplicationBuilder configure(SpringApplicationBuilder application) {
return application.sources(JpaThymeleafApplication.class);
}
public static void main(String[] args) throws Exception {
SpringApplication.run(JpaThymeleafApplication.class, args);
}
}
添加 SpringBootServletInitializer 是为了支持将项目打包成独立的 war 在 Tomcat 中运行的状况。github
实体类映射数据库表:web
@Entity
publicclass User {
@Id
@GeneratedValue
privatelong id;
@Columnfalsetrue (nullable =, unique =)
private String userName;
@Columnfalse (nullable =)
private String passWord;
@Columnfalse (nullable =)
privateint age;
@Columnfalse (nullable =)
private Date regTime;
//省略getter settet方法
}
继承 JpaRepository 类会自动实现不少内置的方法,包括增、删、改、查,也能够根据方法名来自动生成相关 SQL。spring
publicinterface UserRepository extends JpaRepository<User, Long> {
@Query"select u from User u" ()
Page<User> findList(Pageable pageable) ;
User findById(long id) ;
User findByUserName(String userName) ;
void deleteById(Long id) ;
}
Repository 内编写咱们须要的 SQL 和分页查询。
在处理前端业务的时候通常是使用 param 结尾的参数来处理,在项目下新建 param 包,在 param 包下建立 UserParam 类接收添加用户的请求参数。另外,须要对接收的参数作校验,按照前面课程的内容,引入 hibernate-validator 作校验。
publicclass UserParam {
privatelong id;
@NotEmpty"姓名不能为空" (message=)
private String userName;
@NotEmpty"密码不能为空" (message=)
@Length6"密码长度不能小于6位" (min=,message=)
private String passWord;
@Max100"年龄不能大于100岁" (value =, message =)
@Min18"必须年满18岁!" (value=,message=)
privateint age;
//省略getter settet方法
}
Controller 负责接收请求,首先判断参数是否正确,若是有错误直接返回页面,将错误信息展现给用户,再判断用户是否存在,若是用户已经存在一样返回页面给出提示。验证经过后,将 UserParam 属性复制到 User 并添加用户注册时间,最后将用户信息保存到数据库中。
"/add"@RequestMapping()
publicString add(@Valid UserParam userParam,BindingResult result, Model model) {
"" String errorMsg=;
// 参数校验
if (result.hasErrors()) {
Listlist <ObjectError>= result.getAllErrors();
forlist (ObjectError error :) {
"-"";" errorMsg=errorMsg + error.getCode() ++ error.getDefaultMessage() +;
}
"errorMsg" model.addAttribute(,errorMsg);
return"user/userAdd" ;
}
//判断是否重复添加
User u= userRepository.findByUserName(userParam.getUserName());
ifnull (u!=){
"errorMsg""用户已存在!" model.addAttribute(,);
return"user/userAdd" ;
}
new User user=User();
BeanUtils.copyProperties(userParam,user);
new user.setRegTime(Date());
//保存
userRepository.save(user);
return"redirect:/list" ;
}
添加用户部分页面(userAdd.html)
前端页面引入了 Bootstrap 前端框架,如下表单按照 Bootstrap 的格式进行设计。
<form class="form-horizontal" th:action="@{/add}" method="post">
<!-- 表单内容-->
<div class="form-group">
<label for="userName" class="col-sm-2 control-label"></label> userName
<div class="col-sm-10">
<input type="text" class="form-control" name="userName" id="userName" placeholder="userName"/>
</div>
</div>
<div class="form-group">
<label for="password" class="col-sm-2 control-label" ></label> passWord
<div class="col-sm-10">
<input type="password" class="form-control" name="passWord" id="passWord" placeholder="passWord"/>
</div>
</div>
....
<!-- 错误信息展现区-->
<div class="form-group">
<label class="col-sm-2 control-label"></label>
<div class="col-sm-10">
<div th:if="${errorMsg != null}" class="alert alert-danger" role="alert" th:text="${errorMsg}">
</div>
</div>
</div>
<!-- 按钮区-->
<div class="form-group">
<div class="col-sm-offset-2 col-sm-10">
<input type="submit" value="Submit" class="btn btn-info" />
<input type="reset" value="Reset" class="btn btn-info" />
<a href="/toAdd" th:href="@{/list}" class="btn btn-info"></a> Back
</div>
</div>
</form>
效果图:
参考前面课程,JPA 依赖 Pageable 为用户列表页作分页,默认每页展现 6 个用户,而且按照用户注册的倒序来排列,具体信息以下:
"/list"@RequestMapping()
"page""0"public String list(Model model,@RequestParam(value =, defaultValue =) Integer page,
"size""6" @RequestParam(value =, defaultValue =) Integer size) {
new"id" Sort sort =Sort(Sort.Direction.DESC,);
of Pageable pageable = PageRequest.(page, size, sort);
Page<User> users=userRepository.findList(pageable);
"users" model.addAttribute(, users);
return"user/list" ;
}
前端页抽取一个公共的分页信息——page.html,页面部分信息以下:
<div th:if="${(users.totalPages le 10) and (users.totalPages gt 0)}" th:remove="tag">
<div th:each="pg : ${#numbers.sequence(0, users.totalPages - 1)}" th:remove="tag">
<span th:if="${pg eq users.getNumber()}" th:remove="tag">
<li class="active"><span class="current_page line_height" th:text="${pg+1}"></span></li> ${pageNumber}
</span>
<span th:unless="${pg eq users.getNumber()}" th:remove="tag">
<li><a href="#" th:href="@{${pageUrl}(page=${pg})}" th:text="${pg+1}"></a></li>
</span>
</div>
</div>
<li th:if="${users.hasNext()}"><a href="#" th:href="@{${pageUrl}(page=${users.number+1})}"></a></li>下一页
<li><a href="#" th:href="${users.totalPages le 0 ? pageUrl+'page=0':pageUrl+'&page='+(users.totalPages-1)}"></a></li>尾页
<li><span th:utext="'共'+${users.totalPages}+'页 / '+${users.totalElements}+' 条'"></span></li>
page.html 页面的做用是显示主页的页码,包括首页、末页、第几页,共几页这类信息,须要根据页码的数据进行动态调整。页面中使用了 Thymeleaf 大量语法:th:if 判断、th:each 循环、th:href 连接等,分页信息主要从后端传递的 Page 对象获取。
而后在 list.html 页面中引入 page.html 页面分页信息。
<h1></h1>用户列表
<br/><br/>
<div class="with:80%">
<table class="table table-hover">
<thead>
<!-- 表头信息-->
<tr>
<th></th> #
<th></th> User Name
<th></th> Password
<th></th> Age
<th></th> Reg Time
<th></th> Edit
<th></th> Delete
</tr>
</thead>
<tbody>
<!-- 表循环展现用户信息-->
<tr th:each="user : ${users}">
<th scope="row" th:text="${user.id}"></th> 1
<td th:text="${user.userName}"></td> neo
<td th:text="${user.passWord}"></td> Otto
<td th:text="${user.age}"></td> 6
<td th:text="${#dates.format(user.regTime, 'yyyy/MMM/dd HH:mm:ss')}"></td>
<td><a th:href="@{/toEdit(id=${user.id})}"></a></td> edit
<td><a th:href="@{/delete(id=${user.id})}" onclick="return confirm('确认是否删除此用户?')" ></a></td> delete
</tr>
</tbody>
</table>
<!-- 引入分页内容-->
<div th:include="page :: pager" th:remove="tag"></div>
</div>
<div class="form-group">
<div class="col-sm-2 control-label">
<a href="/toAdd" th:href="@{/toAdd}" class="btn btn-info"></a> add
</div>
</div>
<tr th:each="user : ${users}">
这里会从 Controler 层 model set 的对象去获取相关的内容,th:each 表示会循环遍历对象内容。
效果图以下:
点击修改功能的时候,须要带上用户的 ID 信息:
<a th:href="@{/toEdit(id=${user.id})}">edit</a></td><td>
后端根据用户 ID 获取用户信息,并放入 Model 中。
@RequestMapping"/toEdit"()
public String toEdit(Model model,Long id) {
User user=userRepository.findById(id);
"user" model.addAttribute(, user);
return"user/userEdit" ;
}
修改页面展现用户信息,如下为 userEdit.html 页面部份内容:
<form class="form-horizontal" th:action="@{/edit}" th:object="${user}" method="post">
<!--隐藏用户 ID-->
<input type="hidden" name="id" th:value="*{id}" />
<div class="form-group">
<label for="userName" class="col-sm-2 control-label"></label> userName
<div class="col-sm-10">
<input type="text" class="form-control" name="userName" id="userName" th:value="*{userName}" placeholder="userName"/>
</div>
</div>
<div class="form-group">
<label for="password" class="col-sm-2 control-label" ></label> passWord
<div class="col-sm-10">
<input type="password" class="form-control" name="passWord" id="passWord" th:value="*{passWord}" placeholder="passWord"/>
</div>
</div>
<!--错误信息-->
<div class="form-group">
<label class="col-sm-2 control-label"></label>
<div class="col-sm-10">
<div th:if="${errorMsg != null}" class="alert alert-danger" role="alert" th:text="${errorMsg}">
</div>
</div>
</div>
<!--按钮区-->
<div class="form-group">
<div class="col-sm-offset-2 col-sm-10">
<input type="submit" value="Submit" class="btn btn-info" />
<a th:href="@{/list}" class="btn btn-info"></a> Back
</div>
</div>
</form>
修改完成后提交到后台:
"/edit"@RequestMapping()
public String edit(@Valid UserParam userParam, BindingResult result,Model model) {
"" String errorMsg=;
//参数校验
if (result.hasErrors()) {
list List<ObjectError>= result.getAllErrors();
forlist (ObjectError error :) {
"-"";" errorMsg=errorMsg + error.getCode() ++ error.getDefaultMessage() +;
}
"errorMsg" model.addAttribute(,errorMsg);
"user" model.addAttribute(, userParam);
return"user/userEdit" ;
}
//复制属性保持修改后数据
new User user=User();
BeanUtils.copyProperties(userParam,user);
new user.setRegTime(Date());
userRepository.save(user);
return"redirect:/list" ;
}
后台一样须要进行参数验证,无误后修改对应的用户信息。
效果图:
单击删除按钮的时候须要用户再次确认,确认后才能删除。
<a th:href="@{/delete(id=${user.id})}" onclick="return confirm('确认是否删除此用户?')" >delete</a></td><td>
效果以下:
后端根据用户 ID 进行删除便可。
"/delete"@RequestMapping()
deletepublic String(Long id) {
delete userRepository.(id);
return"redirect:/list" ;
}
删除完成以后,再跳转到用户列表页。
用户管理功能包含了用户的增长、修改、删除、展现等功能,也是咱们平常开发中最经常使用的四个功能。在实现用户管理功能的过程当中使用了 JPA 的增长、修改、删除、查询、分页查询功能;使用了 Thymeleaf 展现用户信息,在 list 页面引入分页模板,使用了 Thymeleaf 内嵌的 dates 对日期进行了格式化;通过今天的学习较全面演练了前期的学习内容。