AJAX SpringBoot 前後端數據交互的項目實現

Posted on 2022-03-01 by WalkonNet

1. Ajax 概述

Ajax 的英文全稱是 ”Asynchronous JavaScript and XML“，即 ”異步的 JavaScript 和 XML“。其核心是通過 JavaScript 的 XMLHttpRequest 對象，以一種異步的方式，向服務器發送數據請求，並且通過該對象接收請求返回的數據，從而實現客戶端與服務器端的數據交互。

優點：Ajax 能夠刷新指定的頁面區域（局部刷新），而不是刷新整個頁面，從而減少客戶端和服務器端之間的數據交互傳輸，提高頁面速度，使得用戶體驗更好。

初體驗：基於 jQuery 方式動態綁定事件提交

給【獲取驗證碼】按鈕綁定點擊事件，當用戶點擊該按鈕時，向後臺服務器發送 AJAX 請求獲取一個隨機驗證碼，登錄頁面的整體不重新加載，僅做局部的頁面刷新。

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>異步請求</title>
    <script type="text/javascript" src="/static/js/jquery-2.0.0.min.js"></script>
    <script type="text/javascript">
        $(function () {
            var btn = $("#flush");
            btn.click(function () {
                $.ajax({
                    url: '/getCode',
                    type:'get',
                    data:'id=1',  //字符串
                    dataType:'text',
                    success:function (data) {
                        console.log(data);
                        alert("後臺驗證碼：" + data);
                    }
                })
            })
        })
    </script>
</head>
<body>
    <div style="text-align: center;">
        <h2>用戶登錄</h2>
        <form>
            用戶名：<input type="text" name="username"><br>
            密&emsp;碼：<input type="password" name="password"><br>
            驗證碼：<input type="text" name="code"><br><br>
            <input type="button" value="登錄">&emsp;<input type="button" id="flush" value="獲取驗證碼">
        </form>
    </div>
</body>
</html>

SpringBoot 後臺接收 AJAX 請求，首先要獲取該請求攜帶的參數 id=1（該參數沒有實際意義，僅做演示使用），然後根據請求業務，對該結果進行響應。success 回調函數對響應結果進行展示。

import javax.servlet.http.HttpServletRequest;
import java.util.Random;

@Controller
public class TestController {

    @GetMapping("/ajax")
    public String index(){
        return "form";
    }

    //SpringBoot接收ajax請求的方式
    //方式一：使用HttpServletRequest request接收請求參數
    @GetMapping("/getCode")
    @ResponseBody
    public String getCode(HttpServletRequest request){
        String id = request.getParameter("id");
        System.out.println("AJAX傳遞的參數：" + id);
        //獲取5位驗證碼
        return randomCodes();
    }

    //方式二：用@Param映射單個值
    @GetMapping("/getCode1")
    @ResponseBody
    public String getCode1(@Param("id") Integer id){
        System.out.println(id);
        //獲取5位驗證碼
        return randomCodes();
    }

    public String randomCodes(){
        String str="ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";
        StringBuilder code=new StringBuilder(5);
        for(int i=0;i<5;i++)
        {
            char ch=str.charAt(new Random().nextInt(str.length()));
            code.append(ch);
        }
        return code.toString();
    }
}

上面介紹瞭兩種 SpringBoot 接收請求參數的方式：

public String getCode(HttpServletRequest request)：使用 HttpServletRequest request 接收請求參數；
public String getCode1(@Param("id") Integer id)：用 @Param 映射單個值；

Ajax 異步請求一個典型的應用就是用戶表單輸入時，局部刷新驗證碼，而不會影響其他表單項已輸入的信息。

傳統的 WEB 數據交互與 AJAX 數據交互比較：

客戶端請求的方式不同：傳統的 WEB 是用瀏覽器發送同步數據請求(form表單、a鏈接)，AJAX 是異步引擎對象發送異步請求；
服務器響應的方式不同：傳統的 WEB 每次響應的是一個完整的 HTML 頁面即視圖，AJAX 是局部刷新，返回響應需要的 JSON 數據；
客戶端處理方式不同：傳統的 WEB 需要等待服務器完成響應並且重新加載整個頁面之後，用戶才能進行後續操作，AJAX 動態更新頁面中的局部內容，不影響用戶的其他操作；

2. 基於 JQuery 的 AJAX 語法

$.ajax({屬性}) 常用的屬性參數：

參數	描述
url	請求後端服務器的地址
type	請求方式，默認為 get 類型
data	請求參數
dataType	服務器返回的數據類型，比如：text/json/xml 等
success	請求成功的回調函數
error	請求失敗的回調函數
complete	請求完成的回調函數(無論成功還是失敗，都會被調用)

用法示例（服務器與客戶端之間的數據交互類型是JSON）：

$.ajax({
	url:'/search',
	type:'post',
	data:{
		'id':$("#sid").val(),
		'username':$("#uname").val(),
		'password':$("#pwd").val()
	},
	dataType:'json',
	success:function (data) {
		console.log(data);
		$("#sid").val(data.id);
		$("#uname").val(data.name);
		$("#score").val(data.score);
	}
})

JSON(JavaScript Object Notation)，一種輕量級數據交互格式，完成 js 與 Java/Python/PHP 等後端開發語言對象數據之間的轉換。客戶端與服務器之間傳遞對象數據時，需要使用 JSON 格式。

案例：使用 AJAX 校驗用戶輸入的信息，編寫一個 2022 年碩士研究生招生考試成績查詢系統；

1、創建空白的 SpringBoot 項目，並在 pom.xml 導入相關依賴；

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-thymeleaf</artifactId>
</dependency>
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
    <groupId>com.baomidou</groupId>
    <artifactId>mybatis-plus-boot-starter</artifactId>
    <version>3.4.2</version>
</dependency>

<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <version>5.1.46</version>
</dependency>

2、在 MySQL 數據庫中創建一張考研成績數據表(stu_score)，並錄入若幹條測試數據；

3、在全局配置文件 resources/application.yml 中配置數據源信息、視圖解析器以及端口號等相關配置等；

spring:
  thymeleaf:
    prefix: classpath:/templates/
    suffix: .html
    mode: HTML5
    encoding: UTF-8
  datasource:
    url: jdbc:mysql://localhost:3306/user?useUnicode=true&characterEncoding=UTF-8
    username: root
    password: 123456
    driver-class-name: com.mysql.jdbc.Driver
  mvc:
    static-path-pattern: /static/**
server:
  port: 8181
# 配置SQL日志
mybatis-plus:
  configuration:
    log-impl: org.apache.ibatis.logging.stdout.StdOutImpl

4、創建數據表對應的實體類 Student；

package com.trainingl.entity;

import com.baomidou.mybatisplus.annotation.TableName;
import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;

@Data
@NoArgsConstructor
@AllArgsConstructor
@TableName(value = "stu_score")
public class Student {
    @TableId(type = IdType.ASSIGN_ID)
    private Long sid;
    private String sname;
    private String card;
    private Integer politics;
    private Integer english;
    private Integer math;
    private Integer computer;
}

5、在路徑 com > trainingl > mapper 下創建接口 StudentMapper；

package com.trainingl.mapper;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.trainingl.entity.Student;
import org.springframework.stereotype.Repository;

@Repository
public interface StudentMapper extends BaseMapper<Student> {
    //所有的CRUD操作都已經編寫好瞭
}

說明：由於系統規模較小，所以這裡省略瞭 Service 服務層。

6、創建 SearchController 控制器，主要負責接收客戶端瀏覽器的 AJAX 請求與響應。

package com.trainingl.controller;

import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
import com.trainingl.entity.Student;
import com.trainingl.mapper.StudentMapper;
import org.apache.ibatis.annotations.Param;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.*;
import org.springframework.web.servlet.ModelAndView;

import javax.servlet.http.HttpServletRequest;
import java.util.HashMap;
import java.util.Map;

@Controller
@RequestMapping("/suda")
public class SearchController {
    @Autowired
    private StudentMapper studentMapper;

    @GetMapping("/search")
    public String home(){
        return "login";
    }

    @PostMapping("/login")
    @ResponseBody
    public Map<String,String> login(HttpServletRequest request){
        String id = request.getParameter("id");
        String username = request.getParameter("username");
        String card = request.getParameter("password");
        //查詢判斷
        QueryWrapper<Student> wrapper = new QueryWrapper<>();
        wrapper
                .eq("sid",id)
                .eq("sname", username)
                .eq("card", card);
        Integer count = studentMapper.selectCount(wrapper);
        //返回值
        HashMap<String, String> map = new HashMap<>();
        if (count == 1){
            //登錄驗證成功，通過id查詢該考生的成績（id具有唯一性）
            map.put("result", id);
            map.put("code","100");
        }else {
            map.put("result","登錄失敗！輸入信息有誤！");
            map.put("code","200");
        }
        return map;
    }

    @GetMapping("/searchById/{id}")
    public ModelAndView searchById(@PathVariable Long id){
        ModelAndView modelAndView = new ModelAndView();
        modelAndView.setViewName("person");
        Student student = studentMapper.selectById(id);
        System.out.println(student);
        Integer total = student.getPolitics() + student.getEnglish() + student.getMath() + student.getComputer();
        modelAndView.addObject("student", student);
        modelAndView.addObject("totalScore", total);
        return modelAndView;
    }
}

7、視圖層（系統登錄頁面、成績查詢頁面）

7.1 系統登錄頁面（客戶端與服務器之間的數據交互格式是JSON，請求方式是AJAX，而不是通過form表單完成）

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>系統登錄</title>
    <script type="text/javascript" src="/static/js/jquery-2.0.0.min.js"></script>
    <script type="text/javascript">
        $(function () {
            var btn = $("#btn");
            // 點擊事件
            btn.click(function () {
                $.ajax({
                    url:'/suda/login',
                    type:'post',
                    data:{
                        'id':$("#sid").val(),
                        'username':$("#uname").val(),
                        'password':$("#pwd").val()
                    },
                    dataType:'json',
                    success:function (data) {
                        if(data.code == "100"){
                            //登錄成功，則跳轉到成績查詢頁面
                            window.location.href = "/suda/searchById/" + data.result;
                        }else{
                            //登錄失敗，則給出提示信息
                            var msg = $("#btn");
                            msg.after("<br><br><span style='color:red;'>提示："+data.result+"</span>")
                        }
                    }
                })
            })
        })
    </script>
</head>
<body>
    <div style="text-align:center;">
        <img src="/static/img/brand.png" style="width: 280px;height: 100px;"/>
        <h3>2022年碩士研究生招生考試成績查詢系統</h3>
        <img src="/static/img/logo.jpeg" style="width: 500px;height: 300px;"/>
        <!--這裡不通過form表單提交客戶端請求-->
        <form>
            準考證號：<input type="text" name="id" id="sid"><br>
            考生姓名：<input type="text" name="username" id="uname"><br>
            身份證號：<input type="text" name="password" id="pwd"><br/>
            <br/>
            <input type="button" value="查詢" id="btn">
        </form>
    </div>
</body>
</html>

註：如果輸入的信息校驗失敗，則通過紅色字體給出提示，若信息校驗成功，則會跳轉到初試成績的詳細界面。

7.2 成績詳細頁面（通過 thymeleaf 模板渲染數據）

<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.w3.org/1999/xhtml">
<html xmlns:th="http://www.thymeleaf.org"></html>
<head>
    <meta charset="UTF-8">
    <title>研究生初試成績查詢</title>
</head>
<body>
    <div style="text-align: center;">
        <div style="border: 1px solid;">
            <h3>2022年研究生考試初始成績查詢</h3>
            <br>
            準考證號：<span th:text="${student.sid}"></span><br>
            姓名：<span th:text="${student.sname}"></span><br>
            身份證號：<span th:text="${student.card}"></span><br>
            <hr/>
            思想政治理論：<span th:text="${student.politics}"></span><br>
            英語(一)：<span th:text="${student.english}"></span><br>
            數學(一)：<span th:text="${student.math}"></span><br>
            計算機科學專業基礎(408)：<span th:text="${student.computer}"></span><br>
            總分：<span th:text="${totalScore}"></span><br>
        </div>
        <p>說明：若查詢的成績為負值,表示有缺考、違紀等情況。若仍對查詢結果有疑問,請咨詢相應的招生單位。
        </p>
    </div>
</body>
</html>

總結：本項目用於演示 AJAX 與 SpringBoot 項目前後端數據交互，以案例+項目驅動的方式介紹瞭在 SpringBoot 項目開發中異步請求前後端數據的傳遞方式。

到此這篇關於AJAX SpringBoot 前後端數據交互的項目實現的文章就介紹到這瞭,更多相關AJAX SpringBoot 數據交互內容請搜索WalkonNet以前的文章或繼續瀏覽下面的相關文章希望大傢以後多多支持WalkonNet！

AJAX SpringBoot 前後端數據交互的項目實現

目錄

1. Ajax 概述

2. 基於 JQuery 的 AJAX 語法

推薦閱讀：

發佈留言取消回覆

近期文章

目錄

1. Ajax 概述

2. 基於 JQuery 的 AJAX 語法

推薦閱讀：

發佈留言 取消回覆

近期文章

標籤

發佈留言取消回覆