利用水墨映客图床作为COS服务器

利用水墨映客作为COS服务器

文章类网站项目的图片存储都是一个很重要的问题,一般都是使用云服务厂商的COS对象存储服务(参考前文:使用腾讯云对象存储搭建图床) ,虽然小网站的需求不大,购买也不贵,但是还是想能不能找个免费的,毕竟能省就省嘛。

平常有些博客或者笔记的都是用markdown编辑,图片一般都是上传图床,但是很多图床都没有开放接口。最近用路过图床的时候网站没打开,咨询管理说有DNS污染,便又搜索有没有好用一些的图床,就发现了水墨映客图床,虽然容量有限,但是他每天签到都可以扩充容量,并且最最重要的我发现水墨映客开放上传接口,于是就开始鼓捣想着利用水墨映客作为COS服务器。

水墨图床地址:图片映客--水墨图床,免费专业的高速外链图床

image-20240428131922417

image-20240428130441660

分为两种,一种还是利用picGo配合typora,另一种是在SpringBoot中开发为工具类专门用作图片上传。

利用picGo配合typora上传图片

安装PicGo(以Windows为例)

先下载PicGo的客户端安装包,找到对应的平台安装包然后下载。

下载链接:

(我的电脑:Windows11,64位,故下载PicGo-Setup-2.3.1-x64.exe)

image-20240428131055904

下载之后正常安装就可以了。

640

安装lankong插件

这是一个为 兰空图床适配开发的 PicGo 图片上传插件。同样适用于水墨映客图床

在picGo的插件设置中搜索lankong,然后安装。

image-20240428131511419

安装后配置

image-20240428131607818

image-20240428131701803

  • Lsky Pro Version 在下拉菜单中选择 Lsky Pro 版本,V1 还是 V2,默认 V1

  • 填写图床的 server url,注意不要以 / 结束

    • https://image.example.com ✅️
    • https://image.example.com/ ❌️
  • 填写 Auth Token 使用 Bearer 拼接,token在水墨映客的设置中获取,注意在配置时候需要前面拼接Bearer

    image-20240428132004523

  • Strategy ID,存储策略 ID,如果是 V1 或 V2 使用默认存储策略的用户,请留空;除非你知道具体 ID,否则请留空

  • Album ID,相册 ID,只针对 V2 有效

  • Permission,图片权限,公开还是私有,默认是私有

  • Sync Delete 同步删除选项,只支持 V2,开启后在 PicGo 相册中删除图片可同步删除图床上的文件,默认关闭

  • Ignore certificate error 开关,默认关闭,请保持关闭,除非你遇到 certificate has expired 等证书报错才需要考虑将其开启。由于有些站点使用 Let's Encrypt 颁发的免费证书,有效期只有 90 天,在测试上传中遇到了 certificate has expired 错误,打开开关 Ignore certificate error 即可成功上传

配置完毕保存即可,然后再typora里配置图片上传服务即可。

image-20240428132124664

在SpringBoot中开发图片上传工具类

该工具类的方法有两个参数一个是文件名(fileName),另一个是文件的输入流。

在Spring Boot中一般使用MultipartFile类来处理文件相关,在此处可以通过getInputStream()方法获取文件的输入流

主要的步骤分为:

  • 设置图片上传请求的参数
  • 设置图片的参数
  • 读取图片内容并写入请求
  • 获取响应

水墨映客图床的上传接口为https://img.ink/api/upload,如果上传成功状态码返回200,失败返回500

上传成功的返回格式:

{
    "code":200,
    "msg":"success",
    "data":		  
        {
            "id":"281381",
            "name":".jpg",
            "url":"https:\/\/pic2.ziyuan.wang\/user\/userNickName\/2024\/04\/fileName_d75b474147589.jpg",               "size":101168,
            "mime":"image\/jpeg",
            "sha1":"9adb76331eb1254567547afea3e516ac1901eac1",
            "md5":"aef7bc728fd44e77d5688529c8122882",
            "quota":"6485442560.00",
            "use_quota":"6666141.00"
        },
    "time":1714282312
}

设置图片上传请求的参数

 // 设置上传地址
URL url = new URL("https://img.ink/api/upload");
HttpURLConnection connection = (HttpURLConnection) url.openConnection();
 // 设置请求方法为POST
connection.setRequestMethod("POST");
connection.setDoOutput(true);
// 设置请求头
connection.setRequestProperty("token", "你的请求头"); // 替换为你的token,在设置中获取
// 构建请求参数
String boundary = Long.toHexString(System.currentTimeMillis());//用来标识multipart/form-data内容类型的边界字符串,使用时间戳,确保每次请求的边界字符串都是唯一的,以避免冲突
connection.setRequestProperty("Content-Type", "multipart/form-data; boundary=" + boundary);//设置上传文件的格式
OutputStream output = connection.getOutputStream();//获取与HTTP连接关联的输出流
PrintWriter writer = new PrintWriter(new OutputStreamWriter(output, "UTF-8"), true);//向输出流写入文本形式的数据

设置图片的参数

writer.append("--" + boundary).append("\r\n");//添加了一个分隔边界标记
writer.append("Content-Disposition: form-data; name=\"image\"; filename=\"" + fileName + "\"").append("\r\n");//设置Content-Disposition头部信息,
writer.append("Content-Type: image/jpeg").append("\r\n");//声明上传文件的MIME类型为image/jpeg
writer.append("\r\n");//回车换行符作为分隔
writer.flush();

读取图片内容并写入请求

//接受传入的输入流
InputStream input = inputStream;
byte[] buffer = new byte[4096];//临时存储从输入流中读取的数据
int bytesRead;
//持续读取输入流中的数据直到没有数据
while ((bytesRead = input.read(buffer)) != -1) {
    output.write(buffer, 0, bytesRead);
}
output.flush();
input.close();
// 结束整个multipart/form-data请求体
writer.append("\r\n").append("--" + boundary + "--").append("\r\n");
writer.close();

获取响应

//获取服务器对上传请求的响应状态码,200代表上传成功
int responseCode = connection.getResponseCode();
if (responseCode == HttpURLConnection.HTTP_OK) {
    BufferedReader reader = new BufferedReader(new InputStreamReader(connection.getInputStream()));
    String line;
    StringBuffer response = new StringBuffer();
    //逐行读取服务器返回的文本数据
    while ((line = reader.readLine()) != null) {
        response.append(line);
    }
    reader.close();
    ObjectMapper mapper = new ObjectMapper();
    //使用Jackson库的ObjectMapper来解析response中的JSON字符串为JsonNode对象
    JsonNode rootNode = mapper.readTree(String.valueOf(response));
    //从解析出的JSON对象中,通过路径rootNode.path("data")定位到"data"节点,再从该节点下获取"url"字段的值,即图片上传后的URL
    JsonNode userNode = rootNode.path("data");
    String imgUrl = userNode.path("url").asText();
    return imgUrl;
} else {
    return "error";
}

调用该方法时的使用(file为MultipartFile对象):

String originalFilename = file.getOriginalFilename();//获取完整文件名
String fileName = originalFilename.substring(originalFilename.lastIndexOf("."));//获取文件名后缀
String url = InkImageUtil.uploadImg(fileName,file.getInputStream());//调用方法上传图片

测试:

image-20240428143227459

image-20240428143258379

源码:

public class InkImageUtil {
    public static String uploadImg(String fileName,InputStream inputStream) throws IOException {
            // 设置上传地址
            URL url = new URL("https://img.ink/api/upload");
            HttpURLConnection connection = (HttpURLConnection) url.openConnection();
            // 设置请求方法为POST
            connection.setRequestMethod("POST");
            connection.setDoOutput(true);
            // 设置请求头
            connection.setRequestProperty("token", "f3ee57bcc8d796ea9b72bd776f243d98"); // 替换为你的token
            // 构建请求参数
            String boundary = Long.toHexString(System.currentTimeMillis());
            connection.setRequestProperty("Content-Type", "multipart/form-data; boundary=" + boundary);
            OutputStream output = connection.getOutputStream();
            PrintWriter writer = new PrintWriter(new OutputStreamWriter(output, "UTF-8"), true);
            // 添加图片参数
            writer.append("--" + boundary).append("\r\n");
            writer.append("Content-Disposition: form-data; name=\"image\"; filename=\"" + fileName + "\"").append("\r\n");
            writer.append("Content-Type: image/jpeg").append("\r\n");
            writer.append("\r\n");
            writer.flush();
            // 读取图片内容并写入请求
            InputStream input = inputStream;
            byte[] buffer = new byte[4096];
            int bytesRead;
            while ((bytesRead = input.read(buffer)) != -1) {
                output.write(buffer, 0, bytesRead);
            }
            output.flush();
            input.close();
            // 结束请求
            writer.append("\r\n").append("--" + boundary + "--").append("\r\n");
            writer.close();
            // 获取响应
            int responseCode = connection.getResponseCode();
            if (responseCode == HttpURLConnection.HTTP_OK) {
                BufferedReader reader = new BufferedReader(new InputStreamReader(connection.getInputStream()));
                String line;
                StringBuffer response = new StringBuffer();
                while ((line = reader.readLine()) != null) {
                    response.append(line);
                }
                reader.close();
                System.out.println(response.toString());
                ObjectMapper mapper = new ObjectMapper();
                JsonNode rootNode = mapper.readTree(String.valueOf(response));
                JsonNode userNode = rootNode.path("data");
                String imgUrl = userNode.path("url").asText();
                return imgUrl;
            } else {
                return "error";
            }
    }
}
@PostMapping("/upload")
    public Result<String> fileUpload(MultipartFile file) throws IOException {
        String originalFilename = file.getOriginalFilename();
        String fileName = originalFilename.substring(originalFilename.lastIndexOf("."));
        String url = InkImageUtil.uploadImg(fileName,file.getInputStream());
        return Result.success(url);
    }

欢迎关注公众号:愚生浅末

posted @ 2024-04-28 14:40  愚生浅末  阅读(81)  评论(0编辑  收藏  举报