Java使用POI为Excel打水印，调整列宽并设置Excel只读

本文介绍在Java语言环境下，使用POI为Excel打水印的解决方案，具体的代码编写以及相关的注意事项。

需求描述：

要求通过系统下载的Excel都带上公司的水印，列宽调整为合适的宽度，并且设置为不可编辑，即只读。

即：

1：加水印；

2：调整列宽将单元格内容显示全；

3：设置只读；

解决方案思路介绍：

三点需求比较来说，以第一点比较复杂，同时网上关于POI为Excel加水印的资料非常少，而这些资料又多数是相互之间Copy得来，干货较少。

一：使用模版Excel的形式设置水印：

目前网上关于POI为Excel打水印，主要是通过模版的形式来实现，即先准备一份打了水印的模版Excel，说白了就是在这个模版Excel中的一个Sheet中添加一些艺术字，调整下透明度还有字体，角度等，模仿水印，然后加载该模版，再将内容输出到该模版中，以达到为Excel添加水印的目的，详细可参考下面这份博客（不追溯该博客是否是原始版本）：http://jsonchar.blog.163.com/blog/static/17601614120106135519213/

但这种方式有如下问题：

1：通过手动添加水印，水印数量固定：通过人工在一个Sheet中添加水印，个数必然固定，当实际内容行数不定，列数不定，会导致水印不能覆盖内容；

2：当无法确定下载的Excel会有多少个Sheet的时候，无法保证输出的多个Sheet都有水印：产生这种情况是因为，这种实现方式的根本原理是读取已经存在的模版Excel内的Sheet，并将内容输出到该Sheet中，也就是说如果模版内的Sheet内有水印则输出内容有水印，如果该Sheet没有水印则输出内容没有水印。毕竟通过手工添加水印，准备模版的方式，你不能准备无限多个模版Sheet，准备一个两个也就到头了。

3：你无法通过程序拷贝模版Sheet：你可能会问了，那我准备一个模版Sheet，在其中尽量多的打上水印，麻烦一点横向纵向多大点，然后再通过程序拷贝该模版Sheet，想其中输出内容的形式不行吗？很遗憾，不行，翻查POI的API你就会发现创建Sheet的方式就那么两个，即通过workbook进行创建，虽然sheet（无论类型）的构造函数是public的，但是你无法将你构造好的sheet添加到workbook中。当然，workbook也提供了cloneSheet的api，但是如果你的模版水印是通过艺术字或者图片的形式打上去的，那么也将无法拷贝。

所以这种方案，适合于输出的内容Sheet页个数固定，行数可控的形式，因为只有这些固定下来了，在提供模版Excel的时候才能做出合适的模版，在固定的sheet页，大致的行上打上水印。

二：使用程序将水印图片动态打到Sheet上：

因为上面方案的问题，我选择通过程序将提前准备好的水印图片打印到Sheet上的方案，这种方案的主要步骤为：

1：将需要输出的内容正常输出到Excel中，输出的Excel假定将存在多个Sheet，每个Sheet中内容的行数也不一定；

2：获取workbook对象，提取其中的多个sheet；

3：调用工具类，传入workbook和每一个sheet，根据提供好的水印图片将睡衣图片打到每一个sheet上，水印图片在sheet上的位置，个数等可配置；

要求：

1：水印图片是png格式，无背景，且水印主体颜色要尽可能浅，且细，避免遮挡excel上的信息；

2：使用的POI的版本是3.9，pom文件配置如下：

<!-- poi -->
<dependency>
<groupId>org.apache.poi</groupId>
<artifactId>poi</artifactId>
<version>3.9</version>
</dependency>
<dependency>
<groupId>org.apache.poi</groupId>
<artifactId>poi-ooxml</artifactId>
<version>3.9</version>
</dependency>

步骤1和步骤2不提供代码，网上有很多，直接贴步骤三的代码，如下：

 1
import java.awt.image.BufferedImage;
2 import java.io.ByteArrayOutputStream;
3 import java.io.IOException;
4 import java.io.InputStream;
5
6 import javax.imageio.ImageIO;
7
8 import org.apache.poi.ss.usermodel.ClientAnchor;
9 import org.apache.poi.ss.usermodel.Drawing;
10 import org.apache.poi.ss.usermodel.Picture;
11 import org.apache.poi.ss.usermodel.Sheet;
12 import org.apache.poi.ss.usermodel.Workbook;
13
14 /**
15
* Excel水印工具类
16
* @author gang.wang
17
* 2017年4月23日
18
*/
19 public class ExcelWaterRemarkUtils {
20
21
/**
22
* 为Excel打上水印工具函数
23
* 请自行确保参数值，以保证水印图片之间不会覆盖。
24
* 在计算水印的位置的时候，并没有考虑到单元格合并的情况，请注意
25
* @param wb
Excel Workbook
26
* @param sheet
需要打水印的Excel
27
* @param waterRemarkPath
水印地址，classPath，目前只支持png格式的图片，
28
* 因为非png格式的图片打到Excel上后可能会有图片变红的问题，且不容易做出透明效果。
29
* 同时请注意传入的地址格式，应该为类似："\excelTemplate\test.png"
30
* @param startXCol
水印起始列
31
* @param startYRow
水印起始行
32
* @param betweenXCol 水印横向之间间隔多少列
33
* @param betweenYRow 水印纵向之间间隔多少行
34
* @param XCount 横向共有水印多少个
35
* @param YCount 纵向共有水印多少个
36
* @param waterRemarkWidth 水印图片宽度为多少列
37
* @param waterRemarkHeight 水印图片高度为多少行
38
* @throws IOException
39
*/
40
public static void putWaterRemarkToExcel(Workbook wb, Sheet
sheet, String waterRemarkPath, int startXCol, int startYRow,
41 int betweenXCol, int betweenYRow, int XCount, int YCount,
42 int waterRemarkWidth, int waterRemarkHeight) throws IOException{
43
44
//校验传入的水印图片格式
45
if(!waterRemarkPath.endsWith("png") &&
!waterRemarkPath.endsWith("PNG")){
46 throw new RuntimeException("向Excel上面打印水印，目前支持png格式的图片。");
47
}
48
49
//加载图片
50
ByteArrayOutputStream byteArrayOut = new
ByteArrayOutputStream;
51
InputStream imageIn =
Thread.currentThread.getContextClassLoader.getResourceAsStream(waterRemarkPath);
52
if(null == imageIn || imageIn.available < 1){
53 throw new RuntimeException("向Excel上面打印水印，读取水印图片失败(1)。");
54
}
55
BufferedImage bufferImg = ImageIO.read(imageIn);
56
if(null == bufferImg) {
57 throw new RuntimeException("向Excel上面打印水印，读取水印图片失败(2)。");
58
}
59
ImageIO.write(bufferImg,"png",byteArrayOut);
60
61
//开始打水印
62
Drawing drawing = sheet.createDrawingPatriarch;
63
64
//按照共需打印多少行水印进行循环
65
for(int yCount=0; yCount<YCount; yCount++){
66 //按照每行需要打印多少个水印进行循环
67 for(int xCount=0; xCount<XCount; xCount++){
68 //创建水印图片位置
69 int xIndexInteger = startXCol + (xCount * waterRemarkWidth) + (xCount
* betweenXCol);
70 int yIndexInteger = startYRow + (yCount * waterRemarkHeight) +
(yCount * betweenYRow);
71
72 /*
73
* 参数定义：
74
* 第一个参数是（x轴的开始节点）；
75
* 第二个参数是（是y轴的开始节点）；
76
* 第三个参数是（是x轴的结束节点）；
77
* 第四个参数是（是y轴的结束节点）；
78
* 第五个参数是（是从Excel的第几列开始插入图片，从0开始计数）；
79
* 第六个参数是（是从excel的第几行开始插入图片，从0开始计数）；
80
* 第七个参数是（图片宽度，共多少列）；
81
* 第8个参数是（图片高度，共多少行）；
82 */
83 ClientAnchor anchor = drawing.createAnchor(0, 0, Short.MAX_VALUE,
Integer.MAX_VALUE, xIndexInteger, yIndexInteger, waterRemarkWidth,
waterRemarkHeight);
84 Picture pic = drawing.createPicture(anchor,
wb.addPicture(byteArrayOut.toByteArray, Workbook.PICTURE_TYPE_PNG));
85
pic.resize;
86
}
87
}
88
}
89 }

函数参数的定义介绍的很详细了，不再过多介绍，说说需要注意的地方：

1：一定要先向Excel中写内容，然后再打日志，要不然图片有可能会拉伸导致失真；

2：最好使用Png格式的图片，避免造成打上的图片背景变红的问题，网上有这种问题的解决方案，这里不再赘述；

3：该函数默认是将图片放在了项目的classpath目录下；

至此，使用poi向Excel上面打水印的功能就完成了！！！可能会有写遮挡，但也实在无法避免了，目前还没有发现类似于设置图片透明度，文字环绕效果，图片置底的api~~

接下来再说两个小点：

1：怎样实现调整列宽：

Sheet提供了默认的自动设置列宽的api，即根据cell中内容的宽度，自动调整列宽（sheet.autoSizeColumnt），但是经过测试，在SXSSFWorkbook和SXSSFSheet中，会遇到个别列特别窄的问题，就是计算的行宽不太准，而且遇到了公式，数字也有可能计算的不太准，因此我是自己计算的列宽，并设置的。

首先在程序循环向Excel中写内容的时候，自行设置一个Map存储每一列的最大列宽，具体的函数很简单，就是一个比较大小的函数，举例如下：

 1
private void getMaxColLength(Map<Integer,Integer> colMaxLength, Integer colIndex, Integer length){
2
Integer oriLength = 0;
3
if(colMaxLength.containsKey(colIndex)){
4 oriLength = colMaxLength.get(colIndex);
5
}
6
7
if(length > oriLength){
8
colMaxLength.put(colIndex, length);
9
} else {
10
colMaxLength.put(colIndex, oriLength);
11
}
12
}

得到的每一列的最大宽度（调用字符串的length()函数），需要和Excel中的宽度进行换算，换算的公式是宽度*256，即程序求得的每一列的宽度乘以256，在实际使用中，大多数情况需要多乘以一些，因为实测中，如果只乘以256，会使得列正正好好的匹配内容宽度，遇到汉字还有可能遮挡一部分，因此最好将这个基数扩大些：

sheet.setColumnWidth(colIndex, length * 480);

2：如何设置Excel只读，或者说是不可编辑：

当Excel中的数据敏感，希望客户不能修改内容时，除了使用水印的形式，还需要配合不可修改功能，我的实现是为Excel设置一个密码，保证该Excel不可修改，试图修改将会被要求输入密码，只要密码够复杂应该没有破解的可能，比如你设置一个随机的UUID，并且不记录该UUID，这样就没有人知道该密码了，保证安全性。在设置了密码之后用户依然可以通过拷贝的方法，将Excel中的内容拷贝到其他sheet或者Excel中去，这点需要注意，具体的代码很简单，如下：

sheet.protectSheet(UUID.randomUUID.toString);

到这，本文要介绍的主体内容就介绍完了，实现了一个通过POI，向Excel中打水印图片的主体功能。希望对大家有所帮助。