销售公司做网站,商城网站建站系统源码,做网站增加流量,房产网租房前面我们已经实现了员工信息的条件分页查询以及删除操作。 关于员工管理的功能#xff0c;还有两个需要实现#xff1a; 新增员工 修改员工
首先我们先完成新增员工的功能开发#xff0c;再完成修改员工的功能开发。而在新增员工中…前面我们已经实现了员工信息的条件分页查询以及删除操作。 关于员工管理的功能还有两个需要实现 新增员工 修改员工
首先我们先完成新增员工的功能开发再完成修改员工的功能开发。而在新增员工中需要添加头像而头像需要用到文件上传技术。 当整个员工管理功能全部开发完成之后我们再通过配置文件来优化一些内容。
综上所述我们今天的课程内容包含以下四个部分 新增员工 文件上传 修改员工 配置文件 1. 新增员工
1.1 需求 在新增用户时我们需要保存用户的基本信息并且还需要上传的员工的图片目前我们先完成第一步操作保存用户的基本信息。 1.2 接口文档
我们参照接口文档来开发新增员工功能 基本信息 请求路径/emps
请求方式POST
接口描述该接口用于添加员工的信息 请求参数 参数格式application/json 参数说明 名称类型是否必须备注usernamestring必须用户名namestring必须姓名gendernumber必须性别, 说明: 1 男, 2 女imagestring非必须图像deptIdnumber非必须部门identrydatestring非必须入职日期jobnumber非必须职位, 说明: 1 班主任,2 讲师, 3 学工主管, 4 教研主管, 5 咨询师 请求数据样例 {image: https://web-framework.oss-cn-hangzhou.aliyuncs.com/2022-09-03-07-37-38222.jpg,username: linpingzhi,name: 林平之,gender: 1,job: 1,entrydate: 2022-09-18,deptId: 1
} 响应数据 参数格式application/json 参数说明 参数名类型是否必须备注codenumber必须响应码1 代表成功0 代表失败msgstring非必须提示信息dataobject非必须返回的数据 响应数据样例 {code:1,msg:success,data:null
}
1.3 思路分析
新增员工的具体的流程 接口文档规定 请求路径/emps 请求方式POST 请求参数Json格式数据 响应数据Json格式数据 问题1如何限定请求方式是POST PostMapping 问题2怎么在controller中接收json格式的请求参数 RequestBody //把前端传递的json数据填充到实体类中 1.4 功能开发
EmpController
Slf4j
RestController
RequestMapping(/emps)
public class EmpController {Autowiredprivate EmpService empService;//新增PostMappingpublic Result save(RequestBody Emp emp){//记录日志log.info(新增员工, emp:{},emp);//调用业务层新增功能empService.save(emp);//响应return Result.success();}//省略...
}
EmpService
public interface EmpService {/*** 保存员工信息* param emp*/void save(Emp emp);//省略...
}
EmpServiceImpl
Slf4j
Service
public class EmpServiceImpl implements EmpService {Autowiredprivate EmpMapper empMapper;Overridepublic void save(Emp emp) {//补全数据emp.setCreateTime(LocalDateTime.now());emp.setUpdateTime(LocalDateTime.now());//调用添加方法empMapper.insert(emp);}//省略...
}
EmpMapper
Mapper
public interface EmpMapper {//新增员工Insert(insert into emp (username, name, gender, image, job, entrydate, dept_id, create_time, update_time) values (#{username}, #{name}, #{gender}, #{image}, #{job}, #{entrydate}, #{deptId}, #{createTime}, #{updateTime});)void insert(Emp emp);//省略...
}1.5 功能测试
代码开发完成后重启服务器打开Postman发送 POST 请求请求路径http://localhost:8080/emps 1.6 前后端联调
功能测试通过后我们再进行通过打开浏览器测试后端功能接口 2. 文件上传
在我们完成的新增员工功能中还存在一个问题没有头像(图片缺失) 上述问题需要我们通过文件上传技术来解决。下面我们就进入到文件上传技术的学习。
文件上传技术这块我们主要讲解三个方面首先我们先对文件上传做一个整体的介绍接着再学习文件上传的本地存储方式最后学习云存储方式。
接下来我们就先来学习下什么是文件上传。 2.1 简介
文件上传是指将本地图片、视频、音频等文件上传到服务器供其他用户浏览或下载的过程。
文件上传在项目中应用非常广泛我们经常发微博、发微信朋友圈都用到了文件上传功能。 在我们的案例中在新增员工的时候要上传员工的头像此时就会涉及到文件上传的功能。在进行文件上传时我们点击加号或者是点击图片就可以选择手机或者是电脑本地的图片文件了。当我们选择了某一个图片文件之后这个文件就会上传到服务器从而完成文件上传的操作。 想要完成文件上传这个功能需要涉及到两个部分 前端程序 服务端程序
我们先来看看在前端程序中要完成哪些代码
form action/upload methodpost enctypemultipart/form-data姓名: input typetext nameusernamebr年龄: input typetext nameagebr头像: input typefile nameimagebrinput typesubmit value提交
/form
上传文件的原始form表单要求表单必须具备以下三点上传文件页面三要素 表单必须有file域用于选择要上传的文件 input typefile nameimage/ 表单提交方式必须为POST 通常上传的文件会比较大所以需要使用 POST 提交方式 表单的编码类型enctype必须要设置为multipart/form-data 普通默认的编码格式是不适合传输大型的二进制数据的所以在文件上传时表单的编码格式必须设置为multipart/form-data 前端页面的3要素我们了解后接下来我们就来验证下所讲解的文件上传3要素。
在提供的课程资料中有一个名叫文件上传的文件夹直接将里的upload.html文件复制到springboot项目工程下的static目录里面。 下面我们来验证删除form表单中enctype属性值会是什么情况 在IDEA中直接使用浏览器打开upload.html页面 选择要上传的本地文件 点击提交按钮进入到开发者模式观察 我们再来验证设置form表单中enctype属性值为multipart/form-data会是什么情况 form action/upload methodpost enctypemultipart/form-data姓名: input typetext nameusernamebr年龄: input typetext nameagebr头像: input typefile nameimagebrinput typesubmit value提交/form 知道了前端程序中需要设置上传文件页面三要素那我们的后端程序又是如何实现的呢 首先在服务端定义这么一个controller用来进行文件上传然后在controller当中定义一个方法来处理/upload 请求 在定义的方法中接收提交过来的数据 方法中的形参名和请求参数的名字保持一致 用户名String name 年龄 Integer age 文件 MultipartFile image Spring中提供了一个APIMultipartFile使用这个API就可以来接收到上传的文件 问题如果表单项的名字和方法中形参名不一致该怎么办 public Result upload(String username,Integer age, MultipartFile file) //file形参名和请求参数名image不一致 解决使用RequestParam注解进行参数绑定 public Result upload(String username,Integer age, RequestParam(image) MultipartFile file) UploadController代码
Slf4j
RestController
public class UploadController {PostMapping(/upload)public Result upload(String username, Integer age, MultipartFile image) {log.info(文件上传{},{},{},username,age,image);return Result.success();}} 后端程序编写完成之后打个断点以debug方式启动SpringBoot项目 打开浏览器输入http://localhost:8080/upload.html 录入数据并提交 通过后端程序控制台可以看到上传的文件是存放在一个临时目录 打开临时目录可以看到以下内容 表单提交的三项数据(姓名、年龄、文件)分别存储在不同的临时文件中 当我们程序运行完毕之后这个临时文件会自动删除。 所以我们如果想要实现文件上传需要将这个临时文件要转存到我们的磁盘目录中。 2.2 本地存储
前面我们已分析了文件上传功能前端和后端的基础代码实现文件上传时在服务端会产生一个临时文件请求响应完成之后这个临时文件被自动删除并没有进行保存。下面呢我们就需要完成将上传的文件保存在服务器的本地磁盘上。
代码实现 在服务器本地磁盘上创建images目录用来存储上传的文件例E盘创建images目录 使用MultipartFile类提供的API方法把临时文件转存到本地磁盘目录下 MultipartFile 常见方法 String getOriginalFilename(); //获取原始文件名 void transferTo(File dest); //将接收的文件转存到磁盘文件中 long getSize(); //获取文件的大小单位字节 byte[] getBytes(); //获取文件内容的字节数组 InputStream getInputStream(); //获取接收到的文件内容的输入流 Slf4j
RestController
public class UploadController {PostMapping(/upload)public Result upload(String username, Integer age, MultipartFile image) throws IOException {log.info(文件上传{},{},{},username,age,image);//获取原始文件名String originalFilename image.getOriginalFilename();//将文件存储在服务器的磁盘目录image.transferTo(new File(E:/images/originalFilename));return Result.success();}}
利用postman测试 注意请求参数名和controller方法形参名保持一致 通过postman测试我们发现文件上传是没有问题的。但是由于我们是使用原始文件名作为所上传文件的存储名字当我们再次上传一个名为1.jpg文件时发现会把之前已经上传成功的文件覆盖掉。 解决方案保证每次上传文件时文件名都唯一的使用UUID获取随机文件名
Slf4j
RestController
public class UploadController {PostMapping(/upload)public Result upload(String username, Integer age, MultipartFile image) throws IOException {log.info(文件上传{},{},{},username,age,image);//获取原始文件名String originalFilename image.getOriginalFilename();//构建新的文件名String extname originalFilename.substring(originalFilename.lastIndexOf(.));//文件扩展名String newFileName UUID.randomUUID().toString()extname;//随机名文件扩展名//将文件存储在服务器的磁盘目录image.transferTo(new File(E:/images/newFileName));return Result.success();}} 在解决了文件名唯一性的问题后我们再次上传一个较大的文件(超出1M)时发现后端程序报错 报错原因呢是因为在SpringBoot中文件上传时默认单个文件最大大小为1M
那么如果需要上传大文件可以在application.properties进行如下配置
#配置单个文件最大上传大小
spring.servlet.multipart.max-file-size10MB#配置单个请求最大上传大小(一次请求可以上传多个文件)
spring.servlet.multipart.max-request-size100MB 到时此我们文件上传的本地存储方式已完成了。但是这种本地存储方式还存在一问题 如果直接存储在服务器的磁盘目录中存在以下缺点 不安全磁盘如果损坏所有的文件就会丢失 容量有限如果存储大量的图片磁盘空间有限(磁盘不可能无限制扩容) 无法直接访问
为了解决上述问题呢通常有两种解决方案 自己搭建存储服务器如fastDFS 、MinIO 使用现成的云服务如阿里云腾讯云华为云 2.3 阿里云OSS
2.3.1 准备
阿里云是阿里巴巴集团旗下全球领先的云计算公司也是国内最大的云服务提供商 。 云服务指的就是通过互联网对外提供的各种各样的服务比如像语音服务、短信服务、邮件服务、视频直播服务、文字识别服务、对象存储服务等等。 当我们在项目开发时需要用到某个或某些服务就不需要自己来开发了可以直接使用阿里云提供好的这些现成服务就可以了。比如在项目开发当中我们要实现一个短信发送的功能如果我们项目组自己实现将会非常繁琐因为你需要和各个运营商进行对接。而此时阿里云完成了和三大运营商对接并对外提供了一个短信服务。我们项目组只需要调用阿里云提供的短信服务就可以很方便的来发送短信了。这样就降低了我们项目的开发难度同时也提高了项目的开发效率。大白话别人帮我们实现好了功能我们只要调用即可 云服务提供商给我们提供的软件服务通常是需要收取一部分费用的。 阿里云对象存储OSSObject Storage Service是一款海量、安全、低成本、高可靠的云存储服务。使用OSS您可以通过网络随时存储和调用包括文本、图片、音频和视频等在内的各种文件。 在我们使用了阿里云OSS对象存储服务之后我们的项目当中如果涉及到文件上传这样的业务在前端进行文件上传并请求到服务端时在服务器本地磁盘当中就不需要再来存储文件了。我们直接将接收到的文件上传到oss由 oss帮我们存储和管理同时阿里云的oss存储服务还保障了我们所存储内容的安全可靠。 那我们学习使用这类云服务我们主要学习什么呢其实我们主要学习的是如何在项目当中来使用云服务完成具体的业务功能。而无论使用什么样的云服务阿里云也好腾讯云、华为云也罢在使用第三方的服务时操作的思路都是一样的。 SDKSoftware Development Kit 的缩写软件开发工具包包括辅助软件开发的依赖jar包、代码示例等都可以叫做SDK。 简单说sdk中包含了我们使用第三方云服务时所需要的依赖以及一些示例代码。我们可以参照sdk所提供的示例代码就可以完成入门程序。 第三方服务使用的通用思路我们做一个简单介绍之后接下来我们就来介绍一下我们当前要使用的阿里云oss对象存储服务具体的使用步骤。 Bucket存储空间是用户用于存储对象Object就是文件的容器所有的对象都必须隶属于某个存储空间。 下面我们根据之前介绍的使用步骤完成准备工作 注册阿里云账户注册完成后需要实名认证 注册完账号之后就可以登录阿里云 通过控制台找到对象存储OSS服务 如果是第一次访问还需要开通对象存储服务OSS 开通OSS服务之后就可以进入到阿里云对象存储的控制台 点击左侧的 Bucket列表创建一个Bucket 大家可以参照云存储解决方案-阿里云OSS-CSDN博客 2.3.2 入门
阿里云oss 对象存储服务的准备工作我们已经完成了接下来我们就来完成第二步操作参照官方所提供的sdk示例来编写入门程序。
首先我们需要来打开阿里云OSS的官方文档在官方文档中找到 SDK 的示例代码 如果是在实际开发当中我们是需要从前往后仔细的去阅读这一份文档的但是由于现在是教学我们就只挑重点的去看。有兴趣的同学大家下来也可以自己去看一下这份官方文档。 参照官方提供的SDK改造一下即可实现文件上传功能
import com.aliyun.oss.ClientException;
import com.aliyun.oss.OSS;
import com.aliyun.oss.OSSClientBuilder;
import com.aliyun.oss.OSSException;
import com.aliyun.oss.model.PutObjectRequest;
import com.aliyun.oss.model.PutObjectResult;import java.io.FileInputStream;
import java.io.InputStream;public class AliOssTest {public static void main(String[] args) throws Exception {// Endpoint以华东1杭州为例其它Region请按实际情况填写。String endpoint oss-cn-shanghai.aliyuncs.com;// 阿里云账号AccessKey拥有所有API的访问权限风险很高。强烈建议您创建并使用RAM用户进行API访问或日常运维请登录RAM控制台创建RAM用户。String accessKeyId LTAI5t9MZK8iq5T2Av5GLDxX;String accessKeySecret C0IrHzKZGKqU8S7YQcevcotD3Zd5Tc;// 填写Bucket名称例如examplebucket。String bucketName web-framework01;// 填写Object完整路径完整路径中不能包含Bucket名称例如exampledir/exampleobject.txt。String objectName 1.jpg;// 填写本地文件的完整路径例如D:\\localpath\\examplefile.txt。// 如果未指定本地路径则默认从示例程序所属项目对应本地路径中上传文件流。String filePath C:\\Users\\Administrator\\Pictures\\1.jpg;// 创建OSSClient实例。OSS ossClient new OSSClientBuilder().build(endpoint, accessKeyId, accessKeySecret);try {InputStream inputStream new FileInputStream(filePath);// 创建PutObjectRequest对象。PutObjectRequest putObjectRequest new PutObjectRequest(bucketName, objectName, inputStream);// 设置该属性可以返回response。如果不设置则返回的response为空。putObjectRequest.setProcess(true);// 创建PutObject请求。PutObjectResult result ossClient.putObject(putObjectRequest);// 如果上传成功则返回200。System.out.println(result.getResponse().getStatusCode());} catch (OSSException oe) {System.out.println(Caught an OSSException, which means your request made it to OSS, but was rejected with an error response for some reason.);System.out.println(Error Message: oe.getErrorMessage());System.out.println(Error Code: oe.getErrorCode());System.out.println(Request ID: oe.getRequestId());System.out.println(Host ID: oe.getHostId());} catch (ClientException ce) {System.out.println(Caught an ClientException, which means the client encountered a serious internal problem while trying to communicate with OSS, such as not being able to access the network.);System.out.println(Error Message: ce.getMessage());} finally {if (ossClient ! null) {ossClient.shutdown();}}}
}在以上代码中需要替换的内容为 accessKeyId阿里云账号AccessKey accessKeySecret阿里云账号AccessKey对应的秘钥 bucketNameBucket名称 objectName对象名称在Bucket中存储的对象的名称 filePath文件路径 AccessKey 运行以上程序后会把本地的文件上传到阿里云OSS服务器上 2.3.3 集成
阿里云oss对象存储服务的准备工作以及入门程序我们都已经完成了接下来我们就需要在案例当中集成oss对象存储服务来存储和管理案例中上传的图片。 在新增员工的时候上传员工的图像而之所以需要上传员工的图像是因为将来我们需要在系统页面当中访问并展示员工的图像。而要想完成这个操作需要做两件事 需要上传员工的图像并把图像保存起来存储到阿里云OSS 访问员工图像通过图像在阿里云OSS的存储地址访问图像 OSS中的每一个文件都会分配一个访问的url通过这个url就可以访问到存储在阿里云上的图片。所以需要把url返回给前端这样前端就可以通过url获取到图像。 我们参照接口文档来开发文件上传功能 基本信息 请求路径/upload
请求方式POST
接口描述上传图片接口 请求参数 参数格式multipart/form-data 参数说明 参数名称参数类型是否必须示例备注imagefile是 响应数据 参数格式application/json 参数说明 参数名类型是否必须备注codenumber必须响应码1 代表成功0 代表失败msgstring非必须提示信息dataobject非必须返回的数据上传图片的访问路径 响应数据样例 {code: 1,msg: success,data: https://web-framework.oss-cn-hangzhou.aliyuncs.com/2022-09-02-00-27-0400.jpg
}
引入阿里云OSS上传文件工具类由官方的示例代码改造而来
import com.aliyun.oss.OSS;
import com.aliyun.oss.OSSClientBuilder;
import org.springframework.stereotype.Component;
import org.springframework.web.multipart.MultipartFile;import java.io.IOException;
import java.io.InputStream;
import java.util.UUID;Component
public class AliOSSUtils {private String endpoint https://oss-cn-shanghai.aliyuncs.com;private String accessKeyId LTAI5t9MZK8iq5T2Av5GLDxX;private String accessKeySecret C0IrHzKZGKqU8S7YQcevcotD3Zd5Tc;private String bucketName web-framework01;/*** 实现上传图片到OSS*/public String upload(MultipartFile multipartFile) throws IOException {// 获取上传的文件的输入流InputStream inputStream multipartFile.getInputStream();// 避免文件覆盖String originalFilename multipartFile.getOriginalFilename();String fileName UUID.randomUUID().toString() originalFilename.substring(originalFilename.lastIndexOf(.));//上传文件到 OSSOSS ossClient new OSSClientBuilder().build(endpoint, accessKeyId, accessKeySecret);ossClient.putObject(bucketName, fileName, inputStream);//文件访问路径String url endpoint.split(//)[0] // bucketName . endpoint.split(//)[1] / fileName;// 关闭ossClientossClient.shutdown();return url;// 把上传到oss的路径返回}
}
修改UploadController代码
import com.itheima.pojo.Result;
import com.itheima.utils.AliOSSUtils;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.multipart.MultipartFile;
import java.io.IOException;Slf4j
RestController
public class UploadController {Autowiredprivate AliOSSUtils aliOSSUtils;PostMapping(/upload)public Result upload(MultipartFile image) throws IOException {//调用阿里云OSS工具类将上传上来的文件存入阿里云String url aliOSSUtils.upload(image);//将图片上传完成后的url返回用于浏览器回显展示return Result.success(url);}}
使用postman测试 注意如果创建bucket是私有的是访问不了图片的 不要开启 3. 修改员工
需求修改员工信息 在进行修改员工信息的时候我们首先先要根据员工的ID查询员工的信息用于页面回显展示然后用户修改员工数据之后点击保存按钮就可以将修改的数据提交到服务端保存到数据库。 具体操作为 根据ID查询员工信息 保存修改的员工信息
3.1 查询回显
3.1.1 接口文档
根据ID查询员工数据 基本信息 请求路径/emps/{id}
请求方式GET
接口描述该接口用于根据主键ID查询员工的信息 请求参数 参数格式路径参数 参数说明 参数名类型是否必须备注idnumber必须员工ID 请求参数样例 /emps/1 响应数据 参数格式application/json 参数说明 名称类型是否必须默认值备注codenumber必须响应码, 1 成功 , 0 失败msgstring非必须提示信息dataobject必须返回的数据|- idnumber非必须id|- usernamestring非必须用户名|- namestring非必须姓名|- passwordstring非必须密码|- entrydatestring非必须入职日期|- gendernumber非必须性别 , 1 男 ; 2 女|- imagestring非必须图像|- jobnumber非必须职位, 说明: 1 班主任,2 讲师, 3 学工主管, 4 教研主管, 5 咨询师|- deptIdnumber非必须部门id|- createTimestring非必须创建时间|- updateTimestring非必须更新时间 响应数据样例 {code: 1,msg: success,data: {id: 2,username: zhangwuji,password: 123456,name: 张无忌,gender: 1,image: https://web-framework.oss-cn-hangzhou.aliyuncs.com/2022-09-02-00-27-53B.jpg,job: 2,entrydate: 2015-01-01,deptId: 2,createTime: 2022-09-01T23:06:30,updateTime: 2022-09-02T00:29:04}
}
3.1.2 实现思路 3.1.3 代码实现 EmpMapper
Mapper
public interface EmpMapper {//根据ID查询员工信息Select(select id, username, password, name, gender, image, job, entrydate, dept_id, create_time, update_time from emp where id #{id})public Emp findById(Integer id);//省略...
} EmpService
public interface EmpService {/*** 根据ID查询员工* param id* return*/public Emp getById(Integer id);//省略...
} EmpServiceImpl
Slf4j
Service
public class EmpServiceImpl implements EmpService {Autowiredprivate EmpMapper empMapper;Overridepublic Emp getById(Integer id) {return empMapper.findById(id);}//省略...
} EmpController
Slf4j
RestController
RequestMapping(/emps)
public class EmpController {Autowiredprivate EmpService empService;//根据id查询GetMapping(/{id})public Result getById(PathVariable Integer id){Emp emp empService.getById(id);return Result.success(emp);}//省略...
} 3.1.4 postman测试 3.2 修改员工 当用户修改完数据之后点击保存按钮就需要将数据提交到服务端然后服务端需要将修改后的数据更新到数据库中。 3.2.1 接口文档 基本信息 请求路径/emps请求方式PUT接口描述该接口用于修改员工的数据信息 请求参数 参数格式application/json 参数说明 名称类型是否必须备注idnumber必须idusernamestring必须用户名namestring必须姓名gendernumber必须性别, 说明: 1 男, 2 女imagestring非必须图像deptIdnumber非必须部门identrydatestring非必须入职日期jobnumber非必须职位, 说明: 1 班主任,2 讲师, 3 学工主管, 4 教研主管, 5 咨询师 请求数据样例 {id: 1,image: https://web-framework.oss-cn-hangzhou.aliyuncs.com/2022-09-03-07-37-38222.jpg,username: linpingzhi,name: 林平之,gender: 1,job: 1,entrydate: 2022-09-18,deptId: 1
} 响应数据 参数格式application/json 参数说明 参数名类型是否必须备注codenumber必须响应码1 代表成功0 代表失败msgstring非必须提示信息dataobject非必须返回的数据 响应数据样例 {code:1,msg:success,data:null
}
3.2.2 实现思路 3.2.3 代码实现 EmpMapper
Mapper
public interface EmpMapper {//修改员工信息public void update(Emp emp);//省略...
} EmpMapper.xml
?xml version1.0 encodingUTF-8 ?
!DOCTYPE mapperPUBLIC -//mybatis.org//DTD Mapper 3.0//ENhttp://mybatis.org/dtd/mybatis-3-mapper.dtd
mapper namespacecom.itheima.mapper.EmpMapper!--更新员工信息--update idupdateupdate empsetif testusername ! null and username ! username #{username},/ifif testpassword ! null and password ! password #{password},/ifif testname ! null and name ! name #{name},/ifif testgender ! nullgender #{gender},/ifif testimage ! null and image ! image #{image},/ifif testjob ! nulljob #{job},/ifif testentrydate ! nullentrydate #{entrydate},/ifif testdeptId ! nulldept_id #{deptId},/ifif testupdateTime ! nullupdate_time #{updateTime}/if/setwhere id #{id}/update!-- 省略... --/mapper EmpService
public interface EmpService {/*** 更新员工* param emp*/public void update(Emp emp);//省略...
} EmpServiceImpl
Slf4j
Service
public class EmpServiceImpl implements EmpService {Autowiredprivate EmpMapper empMapper;Overridepublic void update(Emp emp) {emp.setUpdateTime(LocalDateTime.now()); //更新修改时间为当前时间empMapper.update(emp);}//省略...
} EmpController
Slf4j
RestController
RequestMapping(/emps)
public class EmpController {Autowiredprivate EmpService empService;//修改员工PutMappingpublic Result update(RequestBody Emp emp){empService.update(emp);return Result.success();}//省略...
} 3.2.4 postman测试 3.2.5 前后端联调测试 4. 配置文件
员工管理的增删改查功能我们已开发完成但在我们所开发的程序中还一些小问题下面我们就来分析一下当前案例中存在的问题以及如何优化解决。
4.1 参数配置化 在我们之前编写的程序中进行文件上传时需要调用AliOSSUtils工具类将文件上传到阿里云OSS对象存储服务当中。而在调用工具类进行文件上传时需要一些参数 endpoint //阿里云OSS域名 accessKeyID //用户身份ID accessKeySecret //用户密钥 bucketName //存储空间的名字
关于以上的这些阿里云相关配置信息我们是直接写死在java代码中了(硬编码)如果我们在做项目时每涉及到一个第三方技术服务就将其参数硬编码那么在Java程序中会存在两个问题 如果这些参数发生变化了就必须在源程序代码中改动这些参数然后需要重新进行代码的编译将Java代码编译成class字节码文件再重新运行程序。比较繁琐 如果我们开发的是一个真实的企业级项目 Java类可能会有很多如果将这些参数分散的定义在各个Java类当中我们要修改一个参数值我们就需要在众多的Java代码当中来定位到对应的位置再来修改参数修改完毕之后再重新编译再运行。参数配置过于分散是不方便集中的管理和维护
为了解决以上分析的问题我们可以将参数配置在配置文件中。如下
#自定义的阿里云OSS配置信息
aliyun.oss.endpointhttps://oss-cn-hangzhou.aliyuncs.com
aliyun.oss.accessKeyIdLTAI4GCH1vX6DKqJWxd6nEuW
aliyun.oss.accessKeySecretyBshYweHOpqDuhCArrVHwIiBKpyqSL
aliyun.oss.bucketNameweb-tlias 在将阿里云OSS配置参数交给properties配置文件来管理之后我们的AliOSSUtils工具类就变为以下形式
Component
public class AliOSSUtils {/*以下4个参数没有指定值默认值null*/private String endpoint;private String accessKeyId;private String accessKeySecret;private String bucketName;//省略其他代码...
} 而此时如果直接调用AliOSSUtils类当中的upload方法进行文件上传时这4项参数全部为null原因是因为并没有给它赋值。 此时我们是不是需要将配置文件当中所配置的属性值读取出来并分别赋值给AliOSSUtils工具类当中的各个属性呢那应该怎么做呢 因为application.properties是springboot项目默认的配置文件所以springboot程序在启动时会默认读取application.properties配置文件而我们可以使用一个现成的注解Value获取配置文件中的数据。
Value 注解通常用于外部配置的属性注入具体用法为 Value(${配置文件中的key})
import org.springframework.beans.factory.annotation.Value; Component
public class AliOSSUtils {Value(${aliyun.oss.endpoint})private String endpoint;Value(${aliyun.oss.accessKeyId})private String accessKeyId;Value(${aliyun.oss.accessKeySecret})private String accessKeySecret;Value(${aliyun.oss.bucketName})private String bucketName;//省略其他代码...} 使用postman测试 4.2 yml配置文件
前面我们一直使用springboot项目创建完毕后自带的application.properties进行属性的配置那其实呢在springboot项目当中是支持多种配置方式的除了支持properties配置文件以外还支持另外一种类型的配置文件就是我们接下来要讲解的yml格式的配置文件。 application.properties server.port8080
server.address127.0.0.1 application.yml server:port: 8080address: 127.0.0.1 application.yaml server:port: 8080address: 127.0.0.1 yml 格式的配置文件后缀名有两种 yml 推荐 yaml 常见配置文件格式对比 我们可以看到配置同样的数据信息yml格式的数据有以下特点 容易阅读 容易与脚本语言交互 以数据为核心重数据轻格式
简单的了解过springboot所支持的配置文件以及不同类型配置文件之间的优缺点之后接下来我们就来了解下yml配置文件的基本语法 大小写敏感【Hello 和 hello 被认为是两个不同的字符串。】 数值前边必须有空格作为分隔符 使用缩进表示层级关系缩进时不允许使用Tab键只能用空格idea中会自动将Tab转换为空格 缩进的空格数目不重要只要相同层级的元素左侧对齐即可 #表示注释从这个字符一直到行尾都会被解析器忽略 了解完yml格式配置文件的基本语法之后接下来
hobby: - java- game- sport
我们再来看下yml文件中常见的数据格式。在这里我们主要介绍最为常见的两类 定义对象或Map集合 定义数组、list或set集合
对象/Map集合
user:name: zhangsanage: 18password: 123456
数组/List/Set集合
hobby: - java- game- sport 熟悉完了yml文件的基本语法后我们修改下之前案例中使用的配置文件变更为application.yml配置方式 修改application.properties名字为_application.properties名字随便更换只要加载不到即可 创建新的配置文件 application.yml
原有application.properties文件 新建的application.yml文件
spring:datasource:driver-class-name: com.mysql.cj.jdbc.Driverurl: jdbc:mysql://localhost:3306/tliasusername: rootpassword: 1234servlet:multipart:max-file-size: 10MBmax-request-size: 100MBmybatis:configuration:log-impl: org.apache.ibatis.logging.stdout.StdOutImplmap-underscore-to-camel-case: truealiyun:oss:endpoint: https://oss-cn-hangzhou.aliyuncs.comaccessKeyId: LTAI4GCH1vX6DKqJWxd6nEuWaccessKeySecret: yBshYweHOpqDuhCArrVHwIiBKpyqSLbucketName: web-397 4.3 ConfigurationProperties
讲解完了yml配置文件之后最后再来介绍一个注解ConfigurationProperties。在介绍注解之前我们先来看一个场景分析下代码当中可能存在的问题 我们在application.properties或者application.yml中配置了阿里云OSS的四项参数之后如果java程序中需要这四项参数数据我们直接通过Value注解来进行注入。这种方式本身没有什么问题问题但是如果说需要注入的属性较多(例需要20多个参数数据)我们写起来就会比较繁琐。
那么有没有一种方式可以简化这些配置参数的注入呢答案是肯定有在Spring中给我们提供了一种简化方式可以直接将配置文件中配置项的值自动的注入到对象的属性中。 Spring提供的简化方式套路 需要创建一个实现类且实体类中的属性名和配置文件当中key的名字必须要一致 比如配置文件当中叫endpoints实体类当中的属性也得叫endpoints另外实体类当中的属性还需要提供 getter / setter方法 需要将实体类交给Spring的IOC容器管理成为IOC容器当中的bean对象 在实体类上添加ConfigurationProperties注解并通过perfect属性来指定配置参数项的前缀 实体类AliOSSProperties
import lombok.Data;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.stereotype.Component;/*阿里云OSS相关配置*/
Data
Component
ConfigurationProperties(prefix aliyun.oss)
public class AliOSSProperties {//区域private String endpoint;//身份IDprivate String accessKeyId ;//身份密钥private String accessKeySecret ;//存储空间private String bucketName;
} AliOSSUtils工具类
import com.aliyun.oss.OSS;
import com.aliyun.oss.OSSClientBuilder;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Component;
import org.springframework.web.multipart.MultipartFile;
import java.io.IOException;
import java.io.InputStream;
import java.util.UUID;Component //当前类对象由Spring创建和管理
public class AliOSSUtils {//注入配置参数实体类对象Autowiredprivate AliOSSProperties aliOSSProperties;/*** 实现上传图片到OSS*/public String upload(MultipartFile multipartFile) throws IOException {// 获取上传的文件的输入流InputStream inputStream multipartFile.getInputStream();// 避免文件覆盖String originalFilename multipartFile.getOriginalFilename();String fileName UUID.randomUUID().toString() originalFilename.substring(originalFilename.lastIndexOf(.));//上传文件到 OSSOSS ossClient new OSSClientBuilder().build(aliOSSProperties.getEndpoint(),aliOSSProperties.getAccessKeyId(), aliOSSProperties.getAccessKeySecret());ossClient.putObject(aliOSSProperties.getBucketName(), fileName, inputStream);//文件访问路径String url aliOSSProperties.getEndpoint().split(//)[0] // aliOSSProperties.getBucketName() . aliOSSProperties.getEndpoint().split(//)[1] / fileName;// 关闭ossClientossClient.shutdown();return url;// 把上传到oss的路径返回}
}在我们添加上注解后会发现idea窗口上面出现一个红色警告 这个警告提示是告知我们还需要引入一个依赖
dependencygroupIdorg.springframework.boot/groupIdartifactIdspring-boot-configuration-processor/artifactId
/dependency
当我们在pom.xml文件当中配置了这项依赖之后我们重新启动服务大家就会看到在properties或者是yml配置文件当中就会提示阿里云 OSS 相关的配置项。所以这项依赖它的作用就是会自动的识别被Configuration Properties注解标识的bean对象。 刚才的红色警告已经变成了一个灰色的提示提示我们需要重新运行springboot服务 ConfigurationProperties注解我们已经介绍完了接下来我们就来区分一下ConfigurationProperties注解以及我们前面所介绍的另外一个Value注解
相同点都是用来注入外部配置的属性的。
不同点 Value注解只能一个一个的进行外部属性的注入。 ConfigurationProperties可以批量的将外部的属性配置注入到bean对象的属性中。
如果要注入的属性非常的多并且还想做到复用就可以定义这么一个bean对象。通过 configuration properties 批量的将外部的属性配置直接注入到 bin 对象的属性当中。在其他的类当中我要想获取到注入进来的属性我直接注入 bin 对象然后调用 get 方法就可以获取到对应的属性值了
