利用Thumbnailator轻松实现图片缩放、旋转与加水印

概述

Thumbnailator 是一个开源的 Java 项目，它提供了非常简单的 API 来对图片进行缩放、旋转以及加水印的处理。

有多简单呢？简单到一行代码就可以完成图片处理。形式如下：

Thumbnails.of(new File("path/to/directory").listFiles())
 .size(640, 480)
 .outputFormat("jpg")
 .toFiles(Rename.PREFIX_DOT_THUMBNAIL);

当然，Thumbnailator 还有一些使用细节，下面我会一一道来。

核心 API

Thumbnails

Thumbnails 是使用 Thumbnailator 创建缩略图的主入口。

它提供了一组初始化 Thumbnails.Builder 的接口。

先看下这组接口的声明：

// 可变长度参数列表
public static Builder<File> of(String... files) {...}
public static Builder<File> of(File... files) {...}
public static Builder<URL> of(URL... urls) {...}
public static Builder<? extends InputStream> of(InputStream... inputStreams) {...}
public static Builder<BufferedImage> of(BufferedImage... images) {...}
// 迭代器（所有实现 Iterable 接口的 Java 对象都可以，当然也包括 List、Set）
public static Builder<File> fromFilenames(Iterable<String> files) {...}
public static Builder<File> fromFiles(Iterable<File> files) {...}
public static Builder<URL> fromURLs(Iterable<URL> urls) {...}
public static Builder<InputStream> fromInputStreams(Iterable<? extends InputStream> inputStreams) {...}
public static Builder<BufferedImage> fromImages(Iterable<BufferedImage> images) {...}

很显然，Thumbnails 允许通过传入文件名、文件、网络图的URL、图片流、图片缓存多种方式来初始化构造器。

因此，你可以根据实际需求来灵活的选择图片的输入方式。

需要注意一点：如果输入是多个对象（无论你是直接输入容器对象或使用可变参数方式传入多个对象），则输出也必须选用输出多个对象的方式，否则会报异常。

Thumbnails.Builder

Thumbnails.Builder 是 Thumbnails 的内部静态类。它用于设置生成缩略图任务的相关参数。

注：Thumbnails.Builder 的构造函数是私有函数。所以，它只允许通过 Thumbnails 的实例化函数来进行初始化。

设置参数的函数

Thumbnails.Builder 提供了一组函数链形式的接口来设置缩放图参数。

以设置大小函数为例：

public Builder<T> size(int width, int height)
{
 updateStatus(Properties.SIZE, Status.ALREADY_SET);
 updateStatus(Properties.SCALE, Status.CANNOT_SET);
 
 validateDimensions(width, height);
 this.width = width;
 this.height = height;
 
 return this;
}

通过返回this指针，使得设置参数函数可以以链式调用的方式来使用，形式如下：

Thumbnails.of(new File("original.jpg"))
 .size(160, 160)
 .rotate(90)
 .watermark(Positions.BOTTOM_RIGHT, ImageIO.read(new File("watermark.png")), 0.5f)
 .outputQuality(0.8)
 .toFile(new File("image-with-watermark.jpg"));

好处，不言自明：那就是大大简化了代码。

输出函数

Thumbnails.Builder 提供了一组重载函数来输出生成的缩放图。

函数声明如下：

// 返回图片缓存
public List<BufferedImage> asBufferedImages() throws IOException {...}
public BufferedImage asBufferedImage() throws IOException {...}
// 返回文件列表
public List<File> asFiles(Iterable<File> iterable) throws IOException {...}
public List<File> asFiles(Rename rename) throws IOException {...}
public List<File> asFiles(File destinationDir, Rename rename) throws IOException {...}
// 创建文件
public void toFile(File outFile) throws IOException {...}
public void toFile(String outFilepath) throws IOException {...}
public void toFiles(Iterable<File> iterable) throws IOException {...}
public void toFiles(Rename rename) throws IOException {...}
public void toFiles(File destinationDir, Rename rename) throws IOException {...}
// 创建输出流
public void toOutputStream(OutputStream os) throws IOException {...}
public void toOutputStreams(Iterable<? extends OutputStream> iterable) throws IOException {...}

工作流

Thumbnailator 的工作步骤十分简单，可分为三步：

1. 输入：Thumbnails 根据输入初始化构造器—— Thumbnails.Builder 。
2. 设置：Thumbnails.Builder 设置缩放图片的参数。
3. 输出：Thumbnails.Builder 输出图片文件或图片流。

更多详情可以参考： Thumbnailator 官网javadoc

实战

前文介绍了 Thumbnailator 的核心 API，接下来我们就可以通过实战来看看 Thumbnailator 究竟可以做些什么。

Thumbnailator 生成什么样的图片，是根据设置参数来决定的。

安装

maven项目中引入依赖：

<dependency>
 <groupId>net.coobird</groupId>
 <artifactId>thumbnailator</artifactId>
 <version>[0.4, 0.5)</version>
</dependency>

图片缩放

Thumbnails.Builder 的 size 函数可以设置新图片精确的宽度和高度，也可以用 scale 函数设置缩放比例。

Thumbnails.of("oldFile.png")
 .size(16, 16)
 .toFile("newFile_16_16.png");

Thumbnails.of("oldFile.png")
 .scale(2.0)
 .toFile("newFile_scale_2.0.png");

Thumbnails.of("oldFile.png")
 .scale(1.0, 0.5)
 .toFile("newFile_scale_1.0_0.5.png");

oldFile.png

newFile_scale_1.0_0.5.png

图片旋转

Thumbnails.Builder 的 size 函数可以设置新图片的旋转角度。

Thumbnails.of("oldFile.png")
 .scale(0.8)
 .rotate(90)
 .toFile("newFile_rotate_90.png");

Thumbnails.of("oldFile.png")
 .scale(0.8)
 .rotate(180)
 .toFile("newFile_rotate_180.png");

newFile_rotate_90.png

加水印

Thumbnails.Builder 的 watermark 函数可以为图片添加水印图片。第一个参数是水印的位置；第二个参数是水印图片的缓存数据；第三个参数是透明度。

BufferedImage watermarkImage = ImageIO.read(new File("wartermarkFile.png"));
Thumbnails.of("oldFile.png")
 .scale(0.8)
 .watermark(Positions.BOTTOM_LEFT, watermarkImage, 0.5f)
 .toFile("newFile_watermark.png");

wartermarkFile.png

newFile_watermark.png

批量处理图片

下面以批量给图片加水印来展示一下如何处理多个图片文件。

BufferedImage watermarkImage = ImageIO.read(new File("wartermarkFile.png"));

File destinationDir = new File("D:\\watermark\\");
Thumbnails.of("oldFile.png", "oldFile2.png")
 .scale(0.8)
 .watermark(Positions.BOTTOM_LEFT, watermarkImage, 0.5f)
 .toFiles(destinationDir, Rename.PREFIX_DOT_THUMBNAIL);

总结

以上就是这篇文章的全部内容了，希望本文的内容对大家学习或者使用java能带来一定的帮助，如果有疑问大家可以留言交流。

# thumbnailator  # 水印  # ava  # 文字水印  # 旋转  # java  # 图片缩放  # Java缩略图生成库之Thumbnailator应用说明  # Java图片处理开源框架Thumbnailator  # 多个  # 链式  # 会报  # 就可以  # 是一个  # 我会  # 你是  # 你可以  # 第一个  # 不言自明  # 工作流  # 可以用  # 有多  # 第二个  # 来看看  # 为例  # 这篇文章  # 文件列表  # 第三个  # 还有一些 

相关文章： 如何在沈阳梯子盘古建站优化SEO排名与功能模块？  新网站制作渠道有哪些,跪求一个无线渠道比较强的小说网站，我要发表小说？  ,制作一个手机app网站要多少钱？  长沙企业网站制作哪家好,长沙水业集团官方网站？  动图在线制作网站有哪些,滑动动图图集怎么做？  韩国网站服务器搭建指南：VPS选购、域名解析与DNS配置推荐  手机怎么制作网站教程步骤,手机怎么做自己的网页链接？  如何用PHP快速搭建CMS系统？  如何访问已购建站主机并解决登录问题？  建站之星与建站宝盒如何选择最佳方案？  建站之星展会模板：智能建站与自助搭建高效解决方案  ,交易猫的商品怎么发布到网站上去？  网站代码制作软件有哪些,如何生成自己网站的代码？  C#怎么创建控制台应用 C# Console App项目创建方法  如何在阿里云虚拟服务器快速搭建网站？  厦门模型网站设计制作公司,厦门航空飞机模型掉色怎么办？  广州营销型建站服务商推荐：技术优势与SEO优化解析  Thinkphp 中 distinct 的用法解析  专业制作网站的公司哪家好,建立一个公司网站的费用.有哪些部分,分别要多少钱？  一键制作网站软件下载安装,一键自动采集网页文档制作步骤？  c++如何打印函数堆栈信息_c++ backtrace函数与符号名解析【方法】  成都响应式网站开发,dw怎么把手机适应页面变成网页？  招贴海报怎么做,什么是海报招贴？  制作网站的过程怎么写,用凡科建站如何制作自己的网站？  网站制作企业,网站的banner和导航栏是指什么？  内部网站制作流程,如何建立公司内部网站？  如何快速生成凡客建站的专业级图册？  建站之星上传入口如何快速找到？  建站之星下载版如何获取与安装？  宝塔新建站点为何无法访问？如何排查？  微信网站制作公司有哪些,民生银行办理公司开户怎么在微信网页上查询进度？  如何用狗爹虚拟主机快速搭建网站？  如何在万网自助建站中设置域名及备案？  高端建站三要素：定制模板、企业官网与响应式设计优化  建站IDE高效指南：快速搭建+SEO优化+自适应模板全解析  如何通过二级域名建站提升品牌影响力？  广州顶尖建站服务：企业官网建设与SEO优化一体化方案  c++ stringstream用法详解_c++字符串与数字转换利器  如何通过商城免费建站系统源码自定义网站主题？  建站之星在线版空间：自助建站+智能模板一键生成方案  网站制作怎么样才能赚钱,用自己的电脑做服务器架设网站有什么利弊，能赚钱吗？  购物网站制作公司有哪些,哪个购物网站比较好？  阿里云高弹*务器配置方案｜支持分布式架构与多节点部署  广州网站设计制作一条龙,广州巨网网络科技有限公司是干什么的？  自助网站制作软件,个人如何自助建网站？  武汉网站如何制作,黄黄高铁武穴北站途经哪些村庄？  如何正确下载安装西数主机建站助手？  C++用Dijkstra(迪杰斯特拉)算法求最短路径  北京网站制作网页,网站升级改版需要多久？  建站之星展会模版如何一键下载生成？