实现vue项目和springboot项目前后端数据交互

1、安装node.js

• 太高版本的win7不支持
  这里安装node-v12.16.2-x64.msi，指定安装位置后直接按下一步就可以。
• npm是node内置的工具
  这里配置npm的镜像cnpm（提高下载速度，以后用到npm的命令都可以用cnpm命令替换）不指定cnpm版本使用如下命令会报错：

npm install -g cnpm --registry=https://registry.npm.taobao.org
1

• 错误信息：

npm WARN notsup Unsupported engine for npm-normalize-package-bin@3.0.1: wanted:{"node":"^14.17.0 || ^16.13.0 || >=18.0.0"} (current: {"node":"12.16.2","npm":"6.14.4"})
npm WARN notsup Not compatible with your version of node/npm: npm-normalize-package-bin@3.0.1
1
2

• 检查错误，参照网上的对应版本图，node12要用cnpm 6版本，输入如下命令：

npm install -g cnpm@6 --registry=https://registry.npm.taobao.org
1

• 查看node和npm版本

node -v
npm -v
1
2

2、安装vue-cli脚手架

• vue-cli是在node基础上构建的工具，而vue-cli又可以快速搭建含vue功能的模块（即模块化开发）。安装vue-cli 3.x脚手架命令如下：

cnpm install @vue/cli -g
1

• 查看版本

vue -V
1

3、创建vue项目

vue-cli脚手架创建的是模块化项目，使用模块化开发（.vue后缀的文件为单文件组件，一个文件里封装了html、js、css代码）。项目属于单页面应用（SPA），通过路由跳转链接，不利于SEO（爬虫抓取不到内容），可以用Nuxt框架解决该问题（这是后话）。所以说vue比较适合做后台管理系统。但前端分离的插拔特性，可以让它方便地切换为移动端浏览器、app或小程序。

• 这里有两种方法创建，第一种是用命令（会在当前文件夹下创建文件夹）：

vue create 项目名 
1

• 第二种用UI可视化界面创建：

vue ui
1

启动vue可视化工具，会在浏览器中打开，创建过项目的需要返回主页：



选手动配置



点创建即可。

这里不保存预设。

等待安装完，来到欢迎界面就可以就可以关闭网页了，后期安装其它插件我们可以通过命令行执行，也很方便。

• 进入项目文件夹下，cmd执行命令启动项目

cd 项目文件夹名
npm run serve
1
2

运行后，显示如下，在浏览器中输入其中一个地址即可看到欢迎界面，说明vue项目成功跑起来了。

4、数据交互的准备工作

这里默认你已经懂得vue编码的一些基础知识，由于缩减篇幅，所以在此只会贴上关键代码。

前后端分离的项目，要进行数据交互，我们使用的是异步请求工具，JS使用的是Ajax，而vue使用的是axios

• 安装axios插件：

cnpm install axios -S
cnpm i vue-axios -S
1
2

5、前后端数据交互之前端

前后端人员协商会有接口文档，我们以登录和注册为例：

• 登录请求

//发送get请求 查询用户（用post更安全，这里只是举例使用方法）
						this.axios.get("http://localhost:80/api/user/login",{
							params:{
								"username":username,
								"password":password
							}
						}).then(resp => { //数据传输成功
							//用户名密码正确
							if(resp.data.data_status === 0){
							//路由跳转
								router.push("/")
							}
							else{
							//显示失败消息，可能是用户名或密码错误
								ElMessage({
									message:resp.data.data.message,
									duration:1000,
									type:"error"
								})
							}							
						}).catch(error => { //数据传输失败
							console.log(error)
						})
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

• 注册

//访问后台保存用户(注册)
					  this.axios.post("http://localhost:80/api/user/register",{
						  "username":username,
						  "email":email,
						  "password":password
					  }).then(function(response){
						  //发送成功，接受返回注册状态信息
						  if(response.data.data_status === 0){
							  //注册成功,路由跳转							
							  router.push("/login")
						  }
						  else{
						  	//显示注册失败，用户已存在
							  ElMessage({
							  	message:response.data.data.message,
							  	duration:1000,
							  	type:"error"
							  })
						  }
					  }).catch(function(response){
						  alert("数据传输失败")
					  })
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

• 注意，这里的data_status、data.message是由后端返回的数据决定的，名称要与后端设定的返回值一致，可以先用console.log(response)查看一下返回的数据。

6、前后端数据交互之后端

• GET提交：请求的数据会附在URL之后，在地址栏显示出来；POST提交：把提交的数据放置在是 HTTP 包的包体（请求体）中。地址栏不会改变。
• 后端Get不要在参数加@RequestBody，因为请求是在url里中传参
  Post要在参数加@RequestBody，因为是在请求体中取值

• 后端登录

	//后端登录
	@GetMapping("/api/user/login")
	@ResponseBody//使用ajax时必须加，会把返回类转化为json  Get不要加@RequestBody，是在url里中传参
	public CommonResult<Message> loginVue(User user){
		
		//注册用户逻辑
		int data_status = userService.loginVue(user);
		if (data_status == 0) {
			return CommonResult.success(Message.createMessage("注册成功"));
		} 
		//实际开发中的状态码举例：   10001 用户已存在  10002 用户名或密码错误  20001 商品已存在 。。。
		else if(data_status == 2){
			return CommonResult.failed(data_status, Message.createMessage("用户名或密码错误！！！"));
		}
		else {
			return null;
		}
		
	}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

• 后端注册

	@PostMapping("/api/user/register")
	@ResponseBody//使用ajax时必须加，会把返回类转化为json  Post要加@RequestBody，是在请求体中取值
	public CommonResult<Message> registerVue(@RequestBody User user){
		
		//System.out.println(username);
//		System.out.println(user);
		//注册用户逻辑
		int data_status = userService.registerVue(user);
		if (data_status == 0) {
			return CommonResult.success(Message.createMessage("注册成功"));			
		} else {
			return CommonResult.failed(data_status, Message.createMessage("用户名或邮箱已存在，请更改信息！！！"));
		}
		
	}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

Get请求不要在参数前加@RequestBody，Post请求要在参数前加@RequestBody。重要的事情说三遍！！！

这样就可以直接使用User user参数来接受值

• 后端登录还是注册都会有返回值，类名可以自定义，但类里的属性名称定义要和接口文档一致，这样前端接收到对应的值。这里我们定义了一个泛型的CommonResult。

package com.zzz.login_demo.utils;

public class CommonResult<T> {

	private Integer data_status;
	private T data;
	
	protected CommonResult() {
	}
	
	protected CommonResult(int data_status, T data){
		this.data_status = data_status;
		this.data = data;
	}
	
	//返回成功（不带data信息）
	public static CommonResult<Object> success() {
		return new CommonResult<Object>(0, null);
	}
	//返回成功（带data信息）
	public static <T> CommonResult<T> success(T data) {
		return new CommonResult<T>(0, data);
	}
	//返回失败（带data信息）
	public static <T> CommonResult<T> failed(int data_status, T data) {
		return new CommonResult<T>(data_status, data);
	}

	//get/set...
}
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

package com.zzz.login_demo.utils;

public class Message {
	
	private String message;

	protected Message() {
	}
	
	public Message(String message) {
		super();
		this.message = message;
	}
	
	public static Message createMessage(String message) {
		return new Message(message);
	}

	//get/set...

}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

• 测试前后端数据交互时报错：Access-Control-Allow-Origin

Access to XMLHttpRequest at 'http://xxx' from origin 'http://localhost:8080' has been blocked by CORS policy: No 'Access-Control-Allow-Origin' header is present on the requested resource.
1

这是跨域请求出错，可以在前端或后端配置跨域请求。
感觉添加后端配置跨域请求比较方便，在每个Controller类的注解@Contoller的下一行添加注解@CrossOrigin即可。

7、扩展

vue项目如何部署到服务器？（Nginx）
前端、后端分开开发时如何模拟用假数据测试？（mockjs、postman）
感兴趣的童靴可以留言给我，我会安排写作。