猿创征文｜SpringBoot 集成 thumbnailator （图片缩放，区域裁剪，水印，旋转，保持比例）

红太狼 2023-10-11 18:21 127阅读 0赞

之前在公司工作的时候，曾经做过企业的数据加密，其中就包含图片，文档以及pdf的水印添加问题，好久没弄有些遗忘了，今天又重新整理了一下，也顺便给自己留个记录。

thumbnailator 是 Google 开源的图片处理库，支持：图片缩放，区域裁剪，水印，旋转，保持比例。

下面跟着我的操作，大家一起走一遍。

首先确保自己已经搭建好了一个SpringBoot的web项目。

## 1.引入依赖 thumbnailator ##

<dependency>
                <groupId>net.coobird</groupId>
                <artifactId>thumbnailator</artifactId>
                <version>0.4.8</version>
            </dependency>

## 2.controller ##

import net.coobird.thumbnailator.geometry.Positions;
    import org.springframework.util.StringUtils;
    import org.springframework.web.bind.annotation.GetMapping;
    import org.springframework.web.bind.annotation.RestController;
    import org.springframework.web.multipart.MultipartFile;
    
    import javax.annotation.Resource;
    import java.util.UUID;
    
    
    @RestController
    public class ThumbnailsController {
        
        @Resource
        private IThumbnailsService thumbnailsService;
    
        /**
         * 指定大小缩放
         */
        @GetMapping("/changeSize")
        public String changeSize(MultipartFile resource, int width, int height) {
        
            String toFile = "C:\\Users\\NineSun\\Desktop\\Thumbnails\\";//文件存储路径
            String uuid = UUID.randomUUID().toString();//文件名
            toFile += uuid;
            return thumbnailsService.changeSize(resource, width, height, toFile);
        }
    
        /**
         * 指定比例缩放
         */
        @GetMapping("/changeScale")
        public String changeScale(MultipartFile resource, double scale) {
        
            String toFile = "C:\\Users\\NineSun\\Desktop\\Thumbnails\\";//文件存储路径
            String uuid = UUID.randomUUID().toString();//文件名
            toFile += uuid;
            return thumbnailsService.changeScale(resource, scale, toFile);
        }
    
        /**
         * 添加水印 watermark(位置,水印,透明度)
         */
        @GetMapping("/watermark")
        public String watermark(MultipartFile resource, Positions position, MultipartFile watermark, float opacity) {
        
            String toFile = "C:\\Users\\NineSun\\Desktop\\Thumbnails\\";//文件存储路径
            String uuid = UUID.randomUUID().toString();//文件名
            toFile += uuid;
            return thumbnailsService.watermark(resource, position, watermark, opacity, toFile);
        }
    
        /**
         * 图片旋转 rotate(度数),顺时针旋转
         */
        @GetMapping("/rotate")
        public String rotate(MultipartFile resource, double rotate) {
        
            String toFile = "C:\\Users\\NineSun\\Desktop\\Thumbnails\\";//文件存储路径
            String uuid = UUID.randomUUID().toString();//文件名
            toFile += uuid;
            return thumbnailsService.rotate(resource, rotate, toFile);
        }
    
        /**
         * 图片裁剪
         */
        @GetMapping("/region")
        public String region(MultipartFile resource, Positions position, int width, int height) {
        
            String toFile = "C:\\Users\\NineSun\\Desktop\\Thumbnails\\";//文件存储路径
            String uuid = UUID.randomUUID().toString();//文件名
            toFile += uuid;
            return thumbnailsService.region(resource, position, width, height, toFile);
        }
    }

## 3.service ##

import net.coobird.thumbnailator.geometry.Positions;
    import org.springframework.web.multipart.MultipartFile;
    
    public interface IThumbnailsService {
        
    
        /**
         * 指定大小缩放 若图片横比width小，高比height小，放大
         * 若图片横比width小，高比height大，高缩小到height，图片比例不变
         * 若图片横比width大，高比height小，横缩小到width，图片比例不变
         * 若图片横比width大，高比height大，图片按比例缩小，横为width或高为height
         *
         * @param resource 源文件路径
         * @param width    宽
         * @param height   高
         * @param toFile   生成文件路径
         */
    
        public String changeSize(MultipartFile resource, int width, int height, String toFile);
    
        /**
         * 指定比例缩放 scale(),参数小于1,缩小;大于1,放大
         *
         * @param resource 源文件路径
         * @param scale    指定比例
         * @param toFile   生成文件路径
         */
        public String changeScale(MultipartFile resource, double scale, String toFile);
    
        /**
         * 添加水印 watermark(位置,水印,透明度)
         *
         * @param resource  源文件路径
         * @param center    水印位置
         * @param watermark 水印文件
         * @param opacity   水印透明度
         * @param toFile    生成文件路径
         */
        public String watermark(MultipartFile resource, Positions center, MultipartFile watermark, float opacity, String toFile);
        /**
         * 图片旋转 rotate(度数),顺时针旋转
         *
         * @param resource  源文件路径
         * @param rotate    旋转度数
         * @param toFile    生成文件路径
         */
        public String rotate(MultipartFile resource, double rotate, String toFile);
    
        /**
         * 图片裁剪 sourceRegion()有多种构造方法，示例使用的是sourceRegion(裁剪位置,宽,高)
         *
         * @param resource  源文件路径
         * @param center    裁剪位置
         * @param width     裁剪区域宽
         * @param height    裁剪区域高
         * @param toFile    生成文件路径
         */
        public String region(MultipartFile resource, Positions center, int width, int height, String toFile);
    }

## 4.service的实现类 ##

import com.example.thumbnailator.service.IThumbnailsService;
    import net.coobird.thumbnailator.Thumbnails;
    import net.coobird.thumbnailator.geometry.Positions;
    import org.springframework.stereotype.Service;
    import org.springframework.web.multipart.MultipartFile;
    
    import javax.imageio.ImageIO;
    import java.io.IOException;
    
    @Service
    public class IThumbnailsServiceImpl implements IThumbnailsService {
        
    
        @Override
        public String changeSize(MultipartFile resource, int width, int height, String toFile) {
        
            try {
        
                Thumbnails.of(resource.getInputStream()).size(width, height).outputFormat("jpg").toFile(toFile);
            } catch (IOException e) {
        
                e.printStackTrace();
            }
            return "changeSize";
        }
    
        @Override
        public String changeScale(MultipartFile resource, double scale, String toFile) {
        
            try {
        
                Thumbnails.of(resource.getInputStream()).scale(scale).toFile(toFile);
            } catch (IOException e) {
        
                e.printStackTrace();
            }
            return "changeScale";
        }
    
        @Override
        public String watermark(MultipartFile resource, Positions center, MultipartFile watermark, float opacity, String toFile) {
        
            try {
        
                Thumbnails.of(resource.getInputStream()).scale(1).watermark(center, ImageIO.read(watermark.getInputStream()), opacity).toFile(toFile);
            } catch (IOException e) {
        
                e.printStackTrace();
            }
            return "watermark";
        }
    
        @Override
        public String rotate(MultipartFile resource, double rotate, String toFile) {
        
            try {
        
                Thumbnails.of(resource.getInputStream()).scale(1).rotate(rotate).toFile(toFile);
            } catch (IOException e) {
        
                e.printStackTrace();
            }
            return "rotate";
        }
    
        @Override
        public String region(MultipartFile resource, Positions center, int width, int height, String toFile) {
        
            try {
        
                Thumbnails.of(resource.getInputStream()).scale(1).sourceRegion(center, width, height).toFile(toFile);
            } catch (IOException e) {
        
                e.printStackTrace();
            }
            return "region";
        }
    
    }

## 5.测试 ##

### 5.1 指定大小缩放 ###

![在这里插入图片描述][de88999ecc774f73b77e0a0fc4629ec6.png_pic_center]

结果如下：  
![在这里插入图片描述][04f3ee0da9534ce7af0fb8534fd3cb9f.png_pic_center]

### 5.2 指定比例缩放 ###

![在这里插入图片描述][4861dc6925cf48e68cd74348c2d76abc.png_pic_center]

### 5.3 添加水印 ###

我把水印图片放在此处，有需要自取。  
![在这里插入图片描述][791739d0061f453ab662e8e706ecd83e.png_pic_center]

![在这里插入图片描述][4cf42ebf08974ba78412d44d68ea0222.png_pic_center]

效果如下：  
![在这里插入图片描述][58c6650b96df4a0dbe40185ec852cdf6.png_pic_center]

### 5.4 图片旋转 ###

![在这里插入图片描述][7a0a3f7576fd41e1b8586a18dbf7fd71.png_pic_center]

### 5.5 图片裁剪 ###

![在这里插入图片描述][f865cafd92304d48b4b8263c3675a69a.png_pic_center]

可能有人在测试的过程中对Position怎么去写有疑问，其实就是个枚举类  
![在这里插入图片描述][a6e715ed14ab4454b5259aeef1be491b.png_pic_center]

自己点进去看一下，按需选择自己的位置就可以了。

[de88999ecc774f73b77e0a0fc4629ec6.png_pic_center]: https://img-blog.csdnimg.cn/de88999ecc774f73b77e0a0fc4629ec6.png#pic_center
[04f3ee0da9534ce7af0fb8534fd3cb9f.png_pic_center]: https://img-blog.csdnimg.cn/04f3ee0da9534ce7af0fb8534fd3cb9f.png#pic_center
[4861dc6925cf48e68cd74348c2d76abc.png_pic_center]: https://img-blog.csdnimg.cn/4861dc6925cf48e68cd74348c2d76abc.png#pic_center
[791739d0061f453ab662e8e706ecd83e.png_pic_center]: https://img-blog.csdnimg.cn/791739d0061f453ab662e8e706ecd83e.png#pic_center
[4cf42ebf08974ba78412d44d68ea0222.png_pic_center]: https://img-blog.csdnimg.cn/4cf42ebf08974ba78412d44d68ea0222.png#pic_center
[58c6650b96df4a0dbe40185ec852cdf6.png_pic_center]: https://img-blog.csdnimg.cn/58c6650b96df4a0dbe40185ec852cdf6.png#pic_center
[7a0a3f7576fd41e1b8586a18dbf7fd71.png_pic_center]: https://img-blog.csdnimg.cn/7a0a3f7576fd41e1b8586a18dbf7fd71.png#pic_center
[f865cafd92304d48b4b8263c3675a69a.png_pic_center]: https://img-blog.csdnimg.cn/f865cafd92304d48b4b8263c3675a69a.png#pic_center
[a6e715ed14ab4454b5259aeef1be491b.png_pic_center]: https://img-blog.csdnimg.cn/a6e715ed14ab4454b5259aeef1be491b.png#pic_center