Spring Boot 与 Vue.js 整合流程

 更新时间:2018年09月17日 17:05:23   作者:临江听雨客  
本文重点介绍我在Spring Boot 与 Vue.js 整合实践过程中的基本流程,以及遇到的问题,感兴趣的朋友跟随小编一起看看吧

一直都想尝试做前后端分离,我之前一直是学 Java 的,所以后端选择了 Spring Boot;前端选择了 Vue.js 这个轻量、易上手的框架。网上其实已经有了不少 Spring Boot 和 Vue.js 整合的资料,Github 上就有好多 repo,但是每当我指望按图索骥的时候就会出现各种各样奇怪的 bug,上 Stack Overflow 问了也没人搭理。前前后后研究了差不多三个星期,现在总算是理清楚了。

本文重点介绍我在实践过程中的基本流程,以及我遇到的一个困扰了我好久的问题,就是如何 CORS。

框架版本

  • Spring Boot: 2.0.4.RELEASE(JDK 是1.8)
  • Vue.js: 2.x

基本流程

前端:编写 Vue 组件

首先用 vue-cli 搭好脚手架,我这个 Demo 用到的第三方库有:

  • axios:负责 HTTP 请求
  • bootstrap-vue:Bootstrap 和 Vue.js 的整合,方便设计页面
  • vue-router:管理路由
  • qs:实现 CORS

然后写一个登录组件:

<!-- 下面是我直接从 bootstrap-vue 文档抄下来的模板 -->
<template>
 <div>
 <b-form @submit="onSubmit" @reset="onReset" v-if="show">
  <b-form-group id="exampleInputGroup1"
     label="Username:"
     label-for="exampleInput1">
  <b-form-input id="exampleInput1"
      type="text"
      v-model="form.username"
      required
      placeholder="Enter username">
  </b-form-input>
  </b-form-group>
  <b-form-group id="exampleInputGroup2"
     label="Password:"
     label-for="exampleInput2">
  <b-form-input id="exampleInput2"
      type="text"
      v-model="form.password"
      required
      placeholder="Enter password">
  </b-form-input>
  </b-form-group>
  <b-form-group id="exampleGroup4">
  <b-form-checkbox-group v-model="form.checked" id="exampleChecks">
   <b-form-checkbox value="me">Check me out</b-form-checkbox>
   <b-form-checkbox value="that">Check that out</b-form-checkbox>
  </b-form-checkbox-group>
  </b-form-group>
  <b-button type="submit" variant="primary">Submit</b-button>
  <b-button type="reset" variant="danger">Reset</b-button>
 </b-form>
 </div>
</template>
<script>
//...
</script>

我现在想实现的就是用户登录成功之后导航到另一个组件,所以我就又写了一个欢迎组件:

<template>
 <div>
  <h1>Welcome!</h1>
 </div>
</template>

记得配置路由:

// src/router/index.js

import Vue from 'vue'
import Router from 'vue-router'
import Login from '@/components/Login.vue'
import Information from '@/components/Information.vue'
Vue.use(Router)
export default new Router({
 routes: [
 {
  path: '/',
  name: 'Login',
  component: Login
 },
 {
  path: '/information',
  name: 'Information',
  component: Information
 }
 ]
})

后端:提供 RESTful API

因为只有后端提供了接口,前端才能调用,所以现在要进行后端开发。RESTful 是现在很流行的 API 设计风格,所以我这里也实践了一下。下面是 controller 的代码,完整源码地址附在文末。

@RestController
@RequestMapping("/api")
public class LoginController {
 @RequestMapping(path = "/login", method = RequestMethod.POST)
 @ResponseBody
 public String login(@RequestParam String username,
      @RequestParam String password) {
  // 简单处理一下,实际开发中肯定是要用到数据库的
  if (username.equals("123") && password.equals("123")) {
   return "successful";
  } else {
   return "failed";
  }
 }
}

后端的 API 现在有了,就差前端调用了。但是没这么简单,接下来就要解决我前面提到的问题。

实现 CORS

在这个 Demo 中前端占用的端口是8080,后端是 8088。这就存在跨域的问题,如果不解决的话后端就没法接收前端的请求。

我参考了 这个例子 ,通过配置 Spring MVC 实现了 CORS:

@Configuration
public class CORSConfig implements WebMvcConfigurer {
 @Override
 public void addCorsMappings(CorsRegistry registry) {
  registry.addMapping("/**")
    .allowedOrigins(ALL)
    .allowedMethods(ALL)
    .allowedHeaders(ALL)
    .allowCredentials(true);
 }
}

后端配置好了还不行,前端也要有一些配置,要用 axios 顺利地发送请求并保证后端能接收到,需要对请求参数做处理。我参考 这个回答 用 qs 库对请求参数做了处理:

qs.stringify({
  'username': this.form.username,
  'password': this.form.password
  })

现在只需完善前端调用后端 API 的代码:

// Login.vue
<script>
export default {
 data () {
 return {
  form: {
  username: '',
  password: '',
  checked: []
  },
  show: true
 }
 },
 methods: {
 onSubmit (evt) {
  evt.preventDefault();
  
  // 关键就在于要对参数进行处理
  axios.post('http://localhost:8088/api/login',qs.stringify({
  'username': this.form.username,
  'password': this.form.password
  })).then((response) => {
  var status = response.data;
  if(status === 'successful') {
   this.$router.push('/information');
  } else {
   alert(response.data.message);
  }
  console.log(response);
  }).catch((error) => {
  console.log(response);
  });
 }
 }
}
</script>

至此,终于实现了前后端的分离,并且保证前后端能够顺利交互。

题外话

让 controller 能获取请求参数

  controller 可能无法获取请求参数, 这篇文章 提供了一种解决方案。我这个 Demo 中并没有出现 controller 收不到请求参数的问题,但也把这个问题记录下来,以后可能遇上也说不准。

axios 方法中的 this

我这个 Demo 中还试着用 axios 发 GET 请求,然后获取后端响应的 JSON 数据。

// Information.vue
<template>
 <div>
  <h1>Welcome!</h1>
  <div>
   <b-button @click="getInfo()">Get your information</b-button>
   <h2 v-if="username !== ''">Your username is: {{ username }}</h2>
   <h2 v-if="email !== ''">Your email is: {{ email }}</h2>
  </div>
 </div>
</template>
<script>
import axios from 'axios'

export default {
 data () {
  return {
   username: '',
   email: ''
  };
 },
 methods: {
  getInfo () {
   axios.get('http://localhost:8088/api/information')
   .then(function(response) {
    this.username = response.data['username'];
    this.email = response.data['email'];
    console.log(response);
   }).catch(function(error) {
    console.log(error);
   });
  }
 }
}
</script>

一开始我是这么写的,乍一看没什么问题,但是 JavaScript 就一直报错:

typeError: Cannot set property 'username' of undefined

搞了很久都没有解决,直到看到 这篇文章 ,才明白原来是 this 作用域的问题(JavaScript 的 this 是真的复杂啊!!!)。改成下面这样就没问题了:

axios.get('http://localhost:8088/api/information')
   .then((response) => {
    this.username = response.data['username'];
    this.email = response.data['email'];
    console.log(response);
   }).catch((error) => {
    console.log(error);
   });

后来 Stack Overflow 上有人说不用箭头函数也行,只需提前把指向 Vue 实例的 this 保存在一个变量就行了:

var vue = this;
   axios.get('http://localhost:8088/api/information')
   .then(function (response) {
    vue.username = response.data['username'];
    vue.email = response.data['email'];
    console.log(response);
   }).catch((error) => {
    console.log(error);
   });

经实践,这样也是可以的。

Demo 完整源码

总结

以上所述是小编给大家介绍的Spring Boot 与 Vue.js 整合流程,希望对大家有所帮助,如果大家有任何疑问请给我留言,小编会及时回复大家的。在此也非常感谢大家对脚本之家网站的支持!

相关文章

  • Java桥梁设计模式优雅地将抽象与实现分离

    Java桥梁设计模式优雅地将抽象与实现分离

    Java桥接设计模式通过将抽象和实现分离,使得它们可以独立地变化,从而实现更灵活的代码结构。它是一种优雅的设计模式,适用于需要处理多个变化因素的复杂应用程序
    2023-04-04
  • Java中自定义类的实现详解

    Java中自定义类的实现详解

    自定义类是Java中最基本、也是最重要的组成部分之一,使用者可以根据需求创建自己的数据类型,从而更加高效地构建程序,本文就来为大家详细讲讲Java中自定义类的实现与使用吧
    2023-05-05
  • IDEA不能生成SerialVersionUID,alt+enter不提示没有效果问题

    IDEA不能生成SerialVersionUID,alt+enter不提示没有效果问题

    文章介绍了在使用IntelliJ IDEA时,通过安装AutoFillingJavaCallArguments插件并导入Serializable接口后,遇到无法自动生成序列ID的问题,解决方法是在设置中搜索serial,勾选“不带'serialVersionUID'的可序列化类”选项
    2025-01-01
  • jenkins如何通过pipeline部署springboot项目

    jenkins如何通过pipeline部署springboot项目

    为了提高SpringBoot项目的部署效率和规范性,建议将项目代码和部署脚本分离,项目代码仓库专注业务逻辑,构建为jar包;另外设立独立代码仓库存放Jenkinsfile等部署配置文件,在Jenkins中配置pipeline,自动拉取项目代码进行构建和部署
    2024-09-09
  • 详解Java中类与对象的关系

    详解Java中类与对象的关系

    这篇文章主要介绍了详解Java中类与对象的关系,类的关键字是class,在Java编程里,类的作用相当于机械师手中的构造图,如果没有构造图,就无法打造武器,同样如果没有类,就无法实例化,需要的朋友可以参考下
    2023-05-05
  • Java 添加、修改、读取、复制、删除Excel批注的实现

    Java 添加、修改、读取、复制、删除Excel批注的实现

    这篇文章主要介绍了Java 添加、修改、读取、复制、删除Excel批注的实现,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2020-02-02
  • Java基础之初识Maven

    Java基础之初识Maven

    这篇文章主要介绍了Java基础之初识Maven,文中有非常详细的代码示例,对正在学习java基础的小伙伴们有非常好的帮助,需要的朋友可以参考下
    2021-05-05
  • 使用Java实现PDF文字识别的方法详解

    使用Java实现PDF文字识别的方法详解

    在现代信息化的社会中,PDF文件已经成为一种非常常见的文档格式,本文将详细介绍如何使用Java实现PDF文字识别,包括所需的工具、库、代码实现以及实际应用中的注意事项,需要的朋友可以参考下
    2025-02-02
  • Java基础-Java编程语言发展史

    Java基础-Java编程语言发展史

    这篇文章主要介绍了Java基础-Java编程语言发展简史,Java源自Sun公司的一个叫Green的项目,其原先的目的是为家用电子消费产品开发一个分布式代码系统,这样就可以将通信和控制信息发给电冰箱、电视机、烤面包机等家用电器,对它们进行控制和信息交流,需要的朋友可以参考一下
    2022-01-01
  • Java中优先队列PriorityQueue常用方法示例

    Java中优先队列PriorityQueue常用方法示例

    这篇文章主要介绍了Java中优先队列PriorityQueue常用方法示例,PriorityQueue是一种特殊的队列,满足队列的“队尾进、队头出”条件,但是每次插入或删除元素后,都对队列进行调整,使得队列始终构成最小堆(或最大堆),需要的朋友可以参考下
    2023-09-09

最新评论