【快速上手系列】使用七牛云+webuploader实现对象云存储（OSS）

步骤

一、七牛云配置

1、新建存储空间

进入七牛云，注册登录，进入控制台，选择对象存储 Kodo

选择空间管理——新建空间（免费30天）

写好了之后点击确定

2、获取 AccessKey、SecretKey

点击右上角的账户，点击密钥管理

可以看到自己的ak和sk，保存下来（一对即可）

除此之外，还需要保存一下自己的空间名和域名（注意域名有过期时间）

域名如图：

二、使用webuploader组件

1、下载

在webuploader官网下载组件：http://fex.baidu.com/webuploader/

直接下载最新版本即可

2、使用：两种方式

项目结构：将下载的webuploader组件按下图放入（还有jquery）

分为前后端不分离和前后端分离两种方式，一会会分别细说两种方式

接下来先进行后端测试

首先写入index.html代码（路径都改好）

	
选择图片
开始上传图片正在上传，请稍作等待...

这页面整好了之后长这样

后端代码

进行后端测试

后端项目所需maven依赖：

pom.xml

com.qiniuqiniu-java-sdk7.11.0







com.squareup.okhttp3okhttp3.11.0
com.qiniuhappy-dns-java0.1.6test

com.google.code.gsongson2.8.5compile

org.springframework.bootspring-boot-starter-web

org.springframework.bootspring-boot-starter-testtest


org.projectlomboklombok


com.baomidoumybatis-plus-boot-starter3.5.0


mysqlmysql-connector-javaruntime

项目结构（前后端分离的没有webapp）

七牛云工具类QiniuCloudUtil.java

tips：把上面保存的四个参数放到相应的XXXXXXXXXX上即可

package com.example.util;import com.google.gson.Gson;
import com.qiniu.common.QiniuException;
import com.qiniu.http.Response;
import com.qiniu.storage.BucketManager;
import com.qiniu.storage.Configuration;
import com.qiniu.storage.Region;
import com.qiniu.storage.UploadManager;
import com.qiniu.storage.model.DefaultPutRet;
import com.qiniu.storage.model.FileInfo;
import com.qiniu.util.Auth;
import com.qiniu.util.StringMap;import java.io.IOException;
import java.net.URLEncoder;
import java.util.ArrayList;
import java.util.List;/*** 七牛云上传文件工具类* 官方*/
public class QiniuCloudUtil {// 设置需要操作的账号的AK和SK					（AK和SK均在七牛云中获得，以下会说明）private static final String ACCESS_KEY = "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";private static final String SECRET_KEY = "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";// 要上传的空间								（刚刚新建空间的名称）private static final String bucketname = "XXXXXXXXXXXXXXXXXXXXXX";// 密钥private static final Auth auth = Auth.create(ACCESS_KEY, SECRET_KEY);//地区分布实例化private static final Configuration cfg = new Configuration(Region.huadongZheJiang2());//新建空间时，七牛云分配出的域名 （自己可在万网购买域名解析后，绑定到加速域名）private static final String DOMAIN = "XXXXXXXXXXXXXXXXXXXXXXXXXXXXX";public static String getUpToken() {//如果希望只能上传指定key的文件，并且不允许修改，那么可以将下面的 insertOnly 属性值设为 1。return auth.uploadToken(bucketname, null, 3600, new StringMap().put("insertOnly", 1));}/*** 上传文件使用** @return*/public static UploadManager init() {//构造一个带指定 Region 对象的配置类cfg.resumableUploadAPIVersion = Configuration.ResumableUploadAPIVersion.V2;// 指定分片上传版本UploadManager uploadManager = new UploadManager(cfg);return uploadManager;}/*** 本地上传*/public static void addLocalImage() {//如果是Windows情况下，格式是 D:\\qiniu\\test.pngString localFilePath = "E:\\imgs\\logo1.jpg";//默认不指定key的情况下，以文件内容的hash值作为文件名String key = null;Auth auth = Auth.create(ACCESS_KEY, SECRET_KEY);String upToken = auth.uploadToken(bucketname);try {UploadManager uploadManager = init();Response response = uploadManager.put(localFilePath, key, upToken);//解析上传成功的结果DefaultPutRet putRet = new Gson().fromJson(response.bodyString(), DefaultPutRet.class);System.out.println(putRet.key);System.out.println(putRet.hash);} catch (QiniuException ex) {Response r = ex.response;System.err.println(r.toString());try {System.err.println(r.bodyString());} catch (QiniuException ex2) {//ignore}}}/*** 通过字节数组传播*/public static DefaultPutRet addByBytesImage(byte[] bytes) {DefaultPutRet putRet = null;try {
//            byte[] uploadBytes = "hello qiniu cloud".getBytes("utf-8");Auth auth = Auth.create(ACCESS_KEY, SECRET_KEY);String upToken = auth.uploadToken(bucketname);//默认不指定key的情况下，以文件内容的hash值作为文件名String key = null;UploadManager uploadManager = init();try {Response response = uploadManager.put(bytes, key, upToken);//解析上传成功的结果putRet = new Gson().fromJson(response.bodyString(), DefaultPutRet.class);return putRet;} catch (QiniuException ex) {Response r = ex.response;System.err.println(r.toString());try {System.err.println(r.bodyString());} catch (QiniuException ex2) {//ignore}}} catch (Exception e) {//ignore}return putRet;}/*** @param key 图片的文件名* @Explain 删除空间中的图片*/public static void delete(String key) {BucketManager bucketManager = new BucketManager(auth, cfg);try {bucketManager.delete(bucketname, key);} catch (Exception e) {e.printStackTrace();}}/*** 查找指定文件信息** @param key* @return*/public static FileInfo getFile(String key) {BucketManager bucketManager = new BucketManager(auth, cfg);FileInfo fileInfo = null;try {fileInfo = bucketManager.stat(bucketname, key);} catch (QiniuException ex) {System.err.println(ex.response.toString());}return fileInfo;}/*** 查找所有文件信息** @param* @return*/public static BucketManager.FileListIterator getAllFile() {//文件名前缀String prefix = "";//每次迭代的长度限制，最大1000，推荐值 1000int limit = 1000;//指定目录分隔符，列出所有公共前缀（模拟列出目录效果）。缺省值为空字符串String delimiter = "";BucketManager bucketManager = new BucketManager(auth, cfg);//列举空间文件列表BucketManager.FileListIterator fileListIterator = bucketManager.createFileListIterator(bucketname, prefix, limit, delimiter);return fileListIterator;}/*** 下载* fileName 七牛云上存储文件生成的文件名* @throws IOException*/public static List download(String fileName[]) throws IOException {List list=new ArrayList<>();for (int i = 0; i < fileName.length; i++) {String encodedFileName = URLEncoder.encode(fileName[i], "utf-8").replace("+", "%20");String finalUrl = String.format("%s/%s", DOMAIN, encodedFileName);list.add(finalUrl);}return list;}}

测试类Test01.java（写好四个参数加图片路径即可）

package com.example.Test;import com.google.gson.Gson;
import com.qiniu.common.QiniuException;
import com.qiniu.http.Response;
import com.qiniu.storage.Configuration;
import com.qiniu.storage.Region;
import com.qiniu.storage.UploadManager;
import com.qiniu.storage.model.DefaultPutRet;
import com.qiniu.util.Auth;public class Test01 {public static void main(String[] args) {//构造一个带指定Region对象的配置类Configuration cfg = new Configuration(Region.huadongZheJiang2());cfg.resumableUploadAPIVersion = Configuration.ResumableUploadAPIVersion.V2;// 指定分片上传版本//...其他参数参考类注释UploadManager uploadManager = new UploadManager(cfg);//...生成上传凭证，然后准备上传String accessKey = "XXXXXXXXXXXXXXXXXXXXX";String secretKey = "XXXXXXXXXXXXXXXXXXXXXXXXX";//空间名称String bucket = "XXXXX";
//如果是Windows情况下，格式是 D:\\qiniu\\test.pngString localFilePath = "e:\\11.jpg";
//默认不指定key的情况下，以文件内容的hash值作为文件名String key = null;Auth auth = Auth.create(accessKey, secretKey);String upToken = auth.uploadToken(bucket);try {Response response = uploadManager.put(localFilePath, key, upToken);//解析上传成功的结果DefaultPutRet putRet = new Gson().fromJson(response.bodyString(), DefaultPutRet.class);System.out.println(putRet.key);System.out.println(putRet.hash);} catch (QiniuException ex) {Response r = ex.response;System.err.println(r.toString());try {System.err.println(r.bodyString());} catch (QiniuException ex2) {//ignore}}}}

运行，可以看到控制台返回key和hash值（也就是在七牛云中看见上传的文件名），像这样

然后回到七牛云，查看自己创建的空间文件，可以看到文件被上传进来了

这样就成功了

使用webuploader上传文件

Controller层

WebController.java类

package com.example.Controller;import com.example.util.QiniuCloudUtil;
import com.qiniu.storage.BucketManager;
import com.qiniu.storage.model.DefaultPutRet;
import com.qiniu.storage.model.FileInfo;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.multipart.MultipartFile;import java.io.*;
import java.util.HashMap;
import java.util.Map;@RestController
public class WebController {//    @Autowired
//    private QiNiuService qiNiuService;/*** 上传图片的方法* @param files* @return* @throws IOException*/@PostMapping("/addResource")public Map test(@RequestParam(name = "file", required = true) MultipartFile[] files) throws IOException {Map map = new HashMap<>();byte b[] = new byte[1024];for (MultipartFile file : files) {byte[] bytes = file.getBytes();DefaultPutRet putRet = QiniuCloudUtil.addByBytesImage(bytes);if (putRet != null) {//                //向数据库中添加信息
//                QiNiu qn = new QingNiu();String key = putRet.key;String hash = putRet.hash;
//                qn.setId(key);
//                qn.setCodeid(hash);
//                qiNiuService.save(qn);System.out.println("key:" + key);System.out.println("hash:" + hash);} else {System.out.println("上传失败");map.put("status",0);return map;}}System.out.println("上传成功");map.put("status",1);return map;}@PostMapping ("/delResource")public void delect(){QiniuCloudUtil.delete("xxxxxxxxxxxxxxxxxxxx");}@GetMapping("/getResource")public void getFile(){FileInfo file = QiniuCloudUtil.getFile("xxxxxxxxxxxxxxxxxxxxx");System.out.println(file.hash);System.out.println(file.fsize);System.out.println(file.mimeType);System.out.println(file.putTime);}@GetMapping("/getAllResource")public void getAllFile(){BucketManager.FileListIterator fileListIterator = QiniuCloudUtil.getAllFile();while (fileListIterator.hasNext()) {//处理获取的file list结果FileInfo[] items = fileListIterator.next();for (FileInfo item : items) {System.out.println("=========================");System.out.println(item.key);System.out.println(item.hash);System.out.println(item.fsize);System.out.println(item.mimeType);System.out.println(item.putTime);System.out.println(item.endUser);}}}}

这里有一个上传图片的方法

将前端js改成controller访问的路径

用tomcat启动项目

打开前端页面

前后端不分离

前后端都使用idea写，新建一个springboot项目，在webapp设置结构如图（和上面没差）

输入本项目的index.html路径访问浏览器，直接进行使用即可

效果：

回到七牛云查看文件可以发现文件都上传成功了

前后端分离

使用HBuilder写前端，新建一个web项目，将下载的webuploader组件按下图放入（还有jquery）

这个与前后端分离不同的区别在于不是一个端口上的进程，存在跨域问题，所以需要解决跨域问题

需要在后端写一个拦截器

拦截器类Filter.java

package com.example.util;import javax.servlet.*;
import javax.servlet.annotation.WebFilter;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;@WebFilter(filterName = "requestFilter", urlPatterns = {"/*"})
public class Filter implements javax.servlet.Filter {@Overridepublic void init(FilterConfig filterConfig) throws ServletException {}@Overridepublic void doFilter(ServletRequest servletRequest, ServletResponse servletResponse, FilterChain filterChain) throws IOException, ServletException {HttpServletResponse response = (HttpServletResponse) servletResponse;HttpServletRequest request = (HttpServletRequest) servletRequest;// 此处 setHeader、addHeader 方法都可用。但 addHeader时写多个会报错：“...,but only one is allowed”response.setHeader("Access-Control-Allow-Origin", "*");//response.addHeader("Access-Control-Allow-Origin", request.getHeader("origin"));// 解决预请求（发送2次请求），此问题也可在 nginx 中作相似设置解决。response.setHeader("Access-Control-Allow-Headers", "x-requested-with,Cache-Control,Pragma,Content-Type,Token, Content-Type");response.setHeader("Access-Control-Allow-Methods", "POST, GET, OPTIONS, DELETE");response.setHeader("Access-Control-Max-Age", "3600");response.setHeader("Access-Control-Allow-Credentials", "true");String method = request.getMethod();if (method.equalsIgnoreCase("OPTIONS")) {servletResponse.getOutputStream().write("Success".getBytes("utf-8"));} else {filterChain.doFilter(servletRequest, servletResponse);}}@Overridepublic void destroy() {}
}

然后在springboot启动类中加入注解

//添加过滤器
@ServletComponentScan

这样就可以正常使用了

在HBuilder中打开index.html，然后直接进行使用，结果和上面的是一样的

上传信息到数据库的话可以自己写