Java on 雨夜无声

== 和 equals 的区别

Thu, 01 Aug 2024 00:00:00 +0000

== 运算符

当应用于基本数据类型（如 int, double, char 等）时，它比较的是值是否相等。当用于引用类型（比如对象、数组）时，== 比较的是两个引用是否指向堆内存中的同一个对象，即它们的内存地址是否相同。

equals() 方法

equals() 是从 Object 类继承而来的方法，默认实现实际上也是比较对象的引用是否相同，和 == 的行为一致。然而，许多类（尤其是像 String, Integer 这样的包装类）重写了 equals() 方法，使其比较的是对象的实际内容是否相等，而不是引用。

String类的equals方法：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26


public boolean equals(Object anObject) {
 // 判断两个对象是否为同一个引用
 if (this == anObject) {
 return true;
 }
 // 检查参数是否为字符串实例
 if (anObject instanceof String) {
 String anotherString = (String)anObject;
 int n = value.length;
 // 比较两个字符串的长度
 if (n == anotherString.value.length) {
 char v1[] = value;
 char v2[] = anotherString.value;
 int i = 0;
 // 循环比较两个字符串的字符内容
 while (n-- != 0) {
 if (v1[i] != v2[i])
 // 如果发现字符不同，则字符串不相等
 return false;
 i++;
 }
 return true;
 }
 }
 return false;
}

Integer类的equals方法：

1
2
3
4
5
6
7
8


public boolean equals(Object obj) {
 if (obj instanceof Integer) {
 // 与传入的实际值进行比较
 // .intValue()将Integer对象包装的整数值提取出来，返回一个基本类型的int值
 return value == ((Integer)obj).intValue();
 }
 return false;
}

示例代码：

下面通过具体的Java代码示例来阐述这两个操作符的区别：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16


public class EqualsDemo {
 public static void main(String[] args) {
 // 基本类型比较
 int num1 = 10;
 int num2 = 10;
 System.out.println(num1 == num2); // 输出 true，因为数值相等

 // 引用类型的 == 比较
 String str1 = new String("Hello");
 String str2 = new String("Hello");
 System.out.println(str1 == str2); // 输出 false，虽然内容相同，但不是同一个对象引用

 // 使用 equals 比较
 System.out.println(str1.equals(str2)); // 输出 true，因为 String 类重写了 equals 方法，比较的是内容 
 }
}

实操：bean equals方法重写进行比较

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31


public class EqualsDemo {
 public static void main(String[] args) {
 // 自定义类的示例
 Person person1 = new Person("Alice", 30);
 Person person2 = new Person("Alice", 30);
 System.out.println(person1 == person2); // 输出 false，因为是两个不同对象
 System.out.println(person1.equals(person2)); // 默认输出 false，除非重写 equals 方法
 }
 
 static class Person {
 String name;
 int age;
 
 Person(String name, int age) {
 this.name = name;
 this.age = age;
 }
 
 @Override
 public boolean equals(Object obj) {
 if (this == obj) {
 return true;
 }
 if (obj == null || getClass() != obj.getClass()) {
 return false;
 }
 Person person = (Person) obj;
 return age == person.age && name.equals(person.name);
 }
 }
}

总结

== 主要来判断基本类型变量的值是否相等，或判断两个引用是否指向同一个对象。
equals() 默认行为为比较引用与 == 相同，当使用String、Integer等重写了equals方法包装类时会比较对象的实际属性。

pom.xml配置学习

Mon, 15 Apr 2024 00:00:00 +0000

pom.xml 文件是 Maven 项目的核心配置文件，全称为 Project Object Model (POM)，它以 XML 格式定义了项目的构建、依赖、插件、属性、构建生命周期等关键信息。以下是 pom.xml 文件的详细配置说明：

1. 基本结构

一个典型的 pom.xml 文件结构如下：

1
2
3
4
5
6


<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
 <!-- 元素配置 -->
</project>

<?xml ... ?>：XML 声明，指定了文件的版本和编码。
<project> 根元素，包含了所有 POM 相关配置。
xmlns 和 xsi 属性定义了 XML 命名空间和对应的 XML 架构位置，确保 Maven 能正确解析 POM 文件。

2. 核心配置元素

2.1 `modelVersion`

1

<modelVersion>4.0.0</modelVersion>

指定 POM 的模型版本，通常固定为 4.0.0，表示遵循 Maven 2 或 3 的 POM 规范。

2.2 `groupId`

1

<groupId>com.example.myproject</groupId>

标识项目的唯一性，通常采用反向域名形式，对应项目的组织或公司域名。例如，公司域名为 example.com，项目的 groupId 可设置为 com.example。

2.3 `artifactId`

1

<artifactId>my-project</artifactId>

定义项目的唯一标识符，通常与项目文件夹名称或主 JAR/WAR 文件名相同。在同一 groupId 下，不同项目应有不同的 artifactId。

2.4 `version`

1

<version>1.0.0-SNAPSHOT</version>

设定项目的版本号，遵循语义化版本控制（Semantic Versioning, SemVer）。SNAPSHOT 表示开发版本，发布版则去掉 -SNAPSHOT。

2.5 `packaging`

1

<packaging>jar</packaging>

指定项目打包类型，默认为 jar（Java 库）。其他常见类型包括 war（Web 应用）、pom（聚合项目）等。

3. 依赖管理

3.1 `dependencies`

1
2
3
4
5
6
7


<dependencies>
 <dependency>
 <groupId>org.springframework.boot</groupId>
 <artifactId>spring-boot-starter-web</artifactId>
 <version>1.0.0</version>
 </dependency>
</dependencies>

定义项目依赖的其他库或模块。每个 dependency 元素包含 groupId、artifactId 和 version，用于唯一确定依赖项。

3.2 `properties`

1
2
3
4


<properties>
 <java.version>1.8</java.version>
 <spring-boot.version>2.7.0</spring-boot.version>
</properties>

定义项目中可复用的属性值，通常用于存放版本号、路径、变量等，方便在整个 POM 文件中引用。

3.3 `dependencyManagement`

1
2
3
4
5


<dependencyManagement>
 <dependencies>
 <!-- 依赖版本统一管理 -->
 </dependencies>
</dependencyManagement>

用于集中管理项目及其子模块中依赖的版本。在此处声明的依赖版本会被子模块继承，但不会直接引入依赖。

3.4 `exclusions`

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


<dependency>
 <groupId>...</groupId>
 <artifactId>...</artifactId>
 <version>...</version>
 <exclusions>
 <exclusion>
 <groupId>...</groupId>
 <artifactId>...</artifactId>
 </exclusion>
 </exclusions>
</dependency>

在某个依赖中排除特定的传递依赖。

4. 构建配置

在 Maven 的 pom.xml 文件中，<build> 元素用于定义项目的构建过程和相关配置。以下是 <build> 元素及其子元素的详细说明：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53


<build>
 <pluginManagement>
 <plugins>
 <!-- ... -->
 </plugins>
 </pluginManagement>
 <plugins>
 <plugin>
 <groupId>...</groupId>
 <artifactId>...</artifactId>
 <version>...</version>
 <executions>
 <!-- 插件执行配置 -->
 </executions>
 <configuration>
 <!-- 插件具体配置 -->
 </configuration>
 </plugin>
 </plugins>

 <resources>
 <!-- ... -->
 </resources>
 <testResources>
 <!-- ... -->
 </testResources>

 <directory>...</directory>
 <outputDirectory>...</outputDirectory>
 <testOutputDirectory>...</testOutputDirectory>
 <sourceDirectory>...</sourceDirectory>
 <scriptSourceDirectory>...</scriptSourceDirectory>
 <testSourceDirectory>...</testSourceDirectory>
 <resourcesDirectory>...</resourcesDirectory>
 <testResourcesDirectory>...</testResourcesDirectory>

 <filters>
 <!-- ... -->
 </filters>

 <extensions>
 <!-- ... -->
 </extensions>

 <finalName>${artifactId}-${version}</finalName>
 <defaultGoal>...</defaultGoal>
 <sourceEncoding>...</sourceEncoding>
 <targetEncoding>...</targetEncoding>
 <encoding>...</encoding>
 <finalName>...</finalName>
 <filtering>...</filtering>
 <!-- ... -->
</build>

4.1 Plugin Management

<pluginManagement>：集中管理项目及其子模块中插件的版本和配置。在此处声明的插件配置会被子模块继承，但不会直接执行。子模块仍需在 <plugins> 中声明要使用的插件。

4.2 Plugins

<plugins>：配置项目使用的 Maven 插件及其执行细节。插件用于扩展 Maven 的构建功能，如编译、打包、测试、代码检查、部署等。

4.3 Directory Settings

<directory>：指定项目构建生成文件的根目录。
<outputDirectory>：指定项目主构建结果（如 JAR、WAR 文件）的输出目录。
<testOutputDirectory>：指定项目测试构建结果（如测试报告、测试覆盖率报告）的输出目录。
<sourceDirectory>：指定项目主源代码目录。
<scriptSourceDirectory>：指定项目脚本源代码目录（如 Groovy、Ruby 等）。
<testSourceDirectory>：指定项目测试源代码目录。
<resourcesDirectory>：指定项目主资源文件目录。
<testResourcesDirectory>：指定项目测试资源文件目录。

4.4 Filters

<filters>：定义过滤器列表，这些过滤器在资源文件复制过程中用于替换资源文件中的占位符（如 ${property}）。

4.5 Build Extensions

<extensions>：配置 Maven 扩展插件，这些插件可以扩展 Maven 的核心功能，如支持新的打包类型、构建生命周期等。

4.6 Other Settings

<finalName>：指定项目构建产物（如 JAR、WAR 文件）的最终文件名，默认值是 `${artifactId}-${version}。
<defaultGoal>：指定项目默认的构建目标（Maven 命令中的 mvn [defaultGoal]）。
<sourceEncoding>、<targetEncoding>、<encoding>：指定源代码、构建产物、资源文件的字符编码。
<filtering>：在 <resources> 或 <testResources> 中使用，指定是否对资源文件进行过滤（即替换占位符）。

4.7 Resources

<resources>：定义项目主资源文件，如 properties 文件、配置文件、静态资源等。Maven 在构建过程中会将这些资源复制到输出目录中。
<testResources>：定义项目测试资源文件，如测试用到的配置文件、数据文件等。Maven 在构建过程中会将这些资源复制到测试输出目录中。

<build> 元素包含了项目构建过程的方方面面，包括资源文件管理、插件配置、构建目录设置、过滤器定义、扩展插件配置等。合理配置 <build> 元素，可以定制项目的构建过程，满足特定的构建需求。

5. 其他重要元素

5.1 `profiles`

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


<profiles>
 <profile>
 <id>dev</id>
 <activation>
 <activeByDefault>true</activeByDefault>
 </activation>
 <!-- 环境特定配置 -->
 </profile>
 <!-- 更多环境配置 -->
</profiles>

定义不同构建环境（如开发、测试、生产）的配置，通过激活特定 profile 来切换环境。

5.2 `repositories` & `pluginRepositories`

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13


<repositories>
 <repository>
 <id>...</id>
 <url>...</url>
 </repository>
</repositories>

<pluginRepositories>
 <pluginRepository>
 <id>...</id>
 <url>...</url>
 </pluginRepository>
</pluginRepositories>

配置项目所需的远程仓库地址，用于下载依赖和插件。

总结

pom.xml 文件是 Maven 项目的核心配置文件，涵盖了项目基本信息、依赖管理、构建过程、环境配置等多个方面。通过合理配置 pom.xml，可以有效地管理项目依赖、定制构建过程、适应不同环境需求，确保项目的构建、测试、部署等工作高效、规范地进行。

使用PDFBox生成酒店水单

Mon, 03 Jul 2023 00:00:00 +0000

什么是Apache PDFBox

Apache PDFBox是一个开源的Java库，用于处理和操作PDF文档。它提供了一组功能强大的API，可以用于创建、修改、提取内容和元数据、加密、签名以及验证PDF文档。

以下是Apache PDFBox的一些主要特点和功能：

创建和编辑PDF文档：Apache PDFBox允许你使用Java代码创建新的PDF文档，并且可以添加文本、图像、表格、链接和其他元素。它还提供了修改现有PDF文档的功能，如添加、删除和更新页面、注释、书签等。
提取和操作内容：你可以使用Apache PDFBox提取PDF文档中的文本、图像和其他内容。它支持文本搜索、文本替换、图像提取、页面提取等操作，使你能够对PDF文档中的内容进行灵活的处理。
加密和签名：Apache PDFBox支持对PDF文档进行加密和数字签名，以确保文档的安全性和完整性。你可以使用不同的加密算法和密钥长度来保护PDF文档，并且可以使用数字证书对文档进行签名。

最重要的是不需要商业许可

下载字体

阿里巴巴普惠体是一套全球永久免费正版商用的字体家族。阿里巴巴普惠体3.0为一套符合新国家标准GB18030-2022的简体中文字符集，包含GB18030-2022强制规范三个实现级别：实现级别1＋实现级别2标准规格的7字重、实现级别3标准规格的Regular 单一字重。7字重共194,460个全形汉字。包含拉丁字母、希腊字母、西里尔字母、标点符号。

下载字体：Alibaba PuHuiTi 3.0 - 55 Regular 阿里巴巴普惠体 (alibabagroup.com) 放到resources目录

代码实现

pom 引入

1
2
3
4
5


<dependency>
 <groupId>org.apache.pdfbox</groupId>
 <artifactId>pdfbox</artifactId>
 <version>2.0.27</version>
</dependency>

代码示例

 1
 2
 3
 4
 5
 6
 7
 8
 9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195


import cn.hutool.core.date.DateUtil; 
import cn.hutool.core.util.NumberUtil; 
import com.umetrip.hotel.order.constants.LogSchemaOrder; 
import com.umetrip.hotel.order.constants.OrderErrorCode; 
import com.umetrip.hotel.order.service.dto.Result; 
import com.umetrip.hotel.order.service.iface.HotelReceiptService; 
import com.umetrip.hotel.order.service.iface.dto.ProducePdfRequest; 
import lombok.extern.slf4j.Slf4j; 
import org.apache.pdfbox.pdmodel.PDDocument; 
import org.apache.pdfbox.pdmodel.PDDocumentInformation; 
import org.apache.pdfbox.pdmodel.PDPage; 
import org.apache.pdfbox.pdmodel.PDPageContentStream; 
import org.apache.pdfbox.pdmodel.common.PDRectangle; 
import org.apache.pdfbox.pdmodel.font.PDType0Font; 
import org.apache.pdfbox.pdmodel.graphics.image.JPEGFactory; 
import org.apache.pdfbox.pdmodel.graphics.image.PDImageXObject; 
import org.springframework.stereotype.Service; 
 
import java.awt.Color; 
import java.io.IOException; 
import java.io.InputStream; 
import java.util.Arrays; 
import java.util.List;
public class HotelReceiptServiceImpl implements HotelReceiptService { 
 
 private PDPageContentStream contentStream; 
 
 @Override 
 public Result<String> producePdf(ProducePdfRequest producePdfRequest) { 
 try (PDDocument document = new PDDocument()) { 
 PDPage page = new PDPage(PDRectangle.A4); 
 document.addPage(page); 
 // 创建 PDDocumentInformation 对象 
 PDDocumentInformation pdd = document.getDocumentInformation(); 
 // 设置文档的作者 
 pdd.setAuthor("XX平台"); 
 // 设置文档的标题 
 pdd.setTitle("XX平台酒店预订账单（水单）"); 
 
 contentStream = new PDPageContentStream(document, page); 
 InputStream inFont = this.getClass().getClassLoader().getResourceAsStream("font/AlibabaPuHuiTi-3-55-Regular.ttf"); 
 PDType0Font font = PDType0Font.load(document, inFont); 
 // 设置标题的字体大小 
 float fontSize = 15; 
 contentStream.setFont(font, fontSize); 
 // 设置标题文本 
 String title = "XX平台酒店预订账单（水单）"; 
 float titleWidth = font.getStringWidth(title) / 1000 * fontSize; 
 float titleHeight = font.getFontDescriptor().getFontBoundingBox().getHeight() / 1000 * fontSize; 
 float startX = (page.getMediaBox().getWidth() - titleWidth) / 2; 
 // 从页面顶部向下50点开始 
 float startY = page.getMediaBox().getHeight() - titleHeight - 50; 
 showTextByLeft(title, "", startX, startY); 
 
 contentStream.setFont(font, 12); 
 List<String> titleList = Arrays.asList("酒店名称:", "订单号:", "下单时间:", "入住人:", "联系手机:", "房型:", "入住:", "离店:", ""); 
 String checkin = producePdfRequest.getCheckin() + "(" + DateUtil.dayOfWeekEnum(DateUtil.parse(producePdfRequest.getCheckin())).toChinese() + ")"; 
 String checkout = producePdfRequest.getCheckout() + "(" + DateUtil.dayOfWeekEnum(DateUtil.parse(producePdfRequest.getCheckout())).toChinese() + ")"; 
 List<String> valueList = Arrays.asList( 
 producePdfRequest.getHotelName(), 
 producePdfRequest.getOrderNo(), 
 producePdfRequest.getOrderTime(), 
 producePdfRequest.getOccupant(), 
 producePdfRequest.getPhone(), 
 producePdfRequest.getRoomType(), 
 checkin, 
 checkout, 
 "" 
 ); 
 pdfTable(page, 150, 8, 2, titleList, valueList); 
 
 titleList = Arrays.asList("项目", "房费", "其他费用", "退款", "实付", ""); 
 String actualPayment = NumberUtil.round(NumberUtil.sub(producePdfRequest.getPayAmount(), producePdfRequest.getRefundAmount()), 2).toString(); 
 valueList = Arrays.asList( 
 "金额", 
 "RMB " + NumberUtil.round(producePdfRequest.getPayAmount(), 2), 
 "RMB 0.00", 
 "RMB " + NumberUtil.round(producePdfRequest.getRefundAmount(), 2), 
 "RMB " + actualPayment, 
 "" 
 ); 
 pdfTable(page, 350, 5, 2, titleList, valueList); 
 
 
 showTextByLeft(String.format("用户本单通过XX平台平台预订，发票由%s提供。", producePdfRequest.getReceiptIssuer()), "", 100, page.getMediaBox().getHeight() - 490); 
 showTextByLeft(String.format("客服电话%s", producePdfRequest.getReceiptTel()), "", 100, page.getMediaBox().getHeight() - 510); 
 
 InputStream logoFile = this.getClass().getClassLoader().getResourceAsStream("invoice/XX平台酒店.jpeg"); 
 PDImageXObject logo = JPEGFactory.createFromStream(document, logoFile); 
 // 缩放因子 
 float logoScale = 0.4f; 
 contentStream.drawImage(logo, 100, page.getMediaBox().getHeight() - 560, logo.getWidth() * logoScale, logo.getHeight() * logoScale); 
 if (producePdfRequest.getIsStamp() == 1) { 
 InputStream imageFile = this.getClass().getClassLoader().getResourceAsStream("invoice/电子印章.jpeg"); 
 PDImageXObject image = JPEGFactory.createFromStream(document, imageFile); 
 float scale = 0.3f; 
 contentStream.drawImage(image, page.getMediaBox().getWidth() - 270, page.getMediaBox().getHeight() - 670, image.getWidth() * scale, image.getHeight() * scale); 
 } 
 contentStream.close(); 
 String file = String.format("/opt/applog/MskyLog/umehotel-order-service/XX平台水单%s.pdf", producePdfRequest.getOrderNo()); 
 document.save(file); 
 return Result.success(file); 
 } catch (IOException e) { 
 log.error(LogSchemaOrder.ERROR_KEY_REQUEST_EXCEPTION, "producePdf", producePdfRequest, e); 
 return Result.fail(OrderErrorCode.SYSTEM_ERROR); 
 } 
 } 
 
 /** 
 * pdf表格生成 
 * 
 * @param page pdf页 
 * @param yStart 上边距 
 * @param rows 行数 
 * @param cols 列数 
 * @param titleList 固定标题 
 * @param valueList 动态值 
 * @throws IOException io 
 */ private void pdfTable(PDPage page, float yStart, int rows, int cols, List<String> titleList, List<String> valueList) throws IOException { 
 // 开始绘制表格 
 float margin = 100; 
 // top margin 
 yStart = page.getMediaBox().getHeight() - yStart; 
 // 表格宽度 
 float tableWidth = page.getMediaBox().getWidth() - 2 * 100; 
 
 // 单元格高度 
 float rowHeight = 20f; 
 
 // 表格高度 
 float tableHeight = rowHeight * rows; 
 // 单元格宽度 
 float colWidth = tableWidth / (float) cols; 
 // 第一列单元格宽度 
 float firstColumnWidth = tableWidth * 20 / 100; 
 
 // 染色 
 List<String> stainList = Arrays.asList("酒店名称:", "订单号:", "下单时间:", "入住人:", "联系手机:", "房型:", "入住:", "离店:", "项目", "金额"); 
 
 // 绘制行 
 for (int i = 0; i <= rows; i++) { 
 contentStream.moveTo(margin, yStart - i * rowHeight); 
 contentStream.lineTo(margin + tableWidth, yStart - i * rowHeight); 
 
 contentStream.setNonStrokingColor(Color.black); 
 if (stainList.contains(titleList.get(i))) { 
 contentStream.setNonStrokingColor(Color.gray); 
 } 
 showTextByLeft(titleList.get(i), "", margin + 5, yStart - i * rowHeight - 15); 
 contentStream.setNonStrokingColor(Color.black); 
 if (stainList.contains(valueList.get(i))) { 
 contentStream.setNonStrokingColor(Color.gray); 
 } 
 showTextByLeft(valueList.get(i), "", margin + firstColumnWidth + 5, yStart - i * rowHeight - 15); 
 } 
 
 // 绘制列 
 for (int i = 0; i <= cols; i++) { 
 float colWidthSpe = colWidth; 
 if (i == 1) { 
 colWidthSpe = firstColumnWidth; 
 } 
 contentStream.moveTo(margin + i * colWidthSpe, yStart); 
 contentStream.lineTo(margin + i * colWidthSpe, yStart - tableHeight); 
 } 
 
 contentStream.stroke(); 
 } 
 
 /** 
 * 文本添加 
 * 
 * @param txt 添加文本 
 * @param def 默认文本 
 * @param x x轴 
 * @param y y轴 
 * @throws IOException IOException 
 */ private void showTextByLeft(String txt, String def, float x, float y) throws IOException { 
 // Begin the Content stream 
 contentStream.beginText(); 
 // contentStream.setWordSpacing(0.01F); 
 if (null == txt) { 
 txt = def; 
 } 
 
 // Setting the position for the line 
 contentStream.newLineAtOffset(x, y); 
 
 // Adding text in the form of string 
 contentStream.showText(txt); 
 
 // Ending the content stream 
 contentStream.endText(); 
 } 
}

实现效果

对接金税wsdl记录

Mon, 15 May 2023 00:00:00 +0000

什么是WSDL

WSDL 是用于描述 Web Service 的一种 XML 表示法。 WSDL 定义告诉客户如何编写 Web Service 请求，并且描述了由 Web Service 提供程序提供的接口。

SoapUI简介

SoapUI是一个开源测试工具，通过soap/http来检查、调用、实现Web Service的功能/负载/符合性测试。该工具既可作为一个单独的测试软件使用，也可利用插件集成到Eclipse，maven2.X，Netbeans 和intellij中使用。

SoapUI是一个自由和开放源码的跨平台功能测试解决方案。通过一个易于使用的图形界面和企业级功能，SoapUI让您轻松，快速创建和执行自动化功能、回归、合规和负载测试。在一个测试环境，SoapUI提供完整的测试覆盖，并支持所有的标准协议和技术。

对接流程

下载wsdl文件

启动一个wsdl服务

导出wsdl文件

把wsdl文件放入resources目录

pom引入

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24


<plugin>
 <groupId>org.codehaus.mojo</groupId>
 <artifactId>jaxws-maven-plugin</artifactId>
 <version>2.6</version>
 <executions>
 <execution>
 <goals>
 <goal>wsimport</goal>
 </goals>
 <configuration>
 <!--<wsdlUrls>-->
 <!--<wsdlUrl>${basedir}/src/main/resources/goldenTax/zkiService_1.wsdl</wsdlUrl>-->
 <!--</wsdlUrls>-->
 <wsdlDirectory>${project.basedir}/src/main/resources/goldenTax</wsdlDirectory>
 <wsdlFiles>
 <wsdlFile>zkiService_1.wsdl</wsdlFile>
 </wsdlFiles>
 <wsdlLocation>http://example.com/eisp-lslx/ws/zkiService?wsdl</wsdlLocation>
 <!--<wsdlLocation>${project.build.directory}/goldenTax/zkiService_1.wsdl</wsdlLocation>-->
 <packageName>com.umetrip.hotel.proxy.service.wsdl.goldenTax</packageName>
 </configuration>
 </execution>
 </executions>
</plugin>

wsdlFiles 指定用于生成Java代码的WSDL文件。 wsdlLocation 指定运行时应用程序中的WSDL文件位置，一般来说都是引用本地文件。由于我用不到pom里面的配置，我就直接写了一个wsdl文件的地址。

代码调整

ZKInvoiceService 和 AsyncInvoiceServiceService 为wsdl文件生成的类

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22


private ZKInvoiceService getAsyncInvoiceServiceService() {
 // 获取代理配置
 String proxyName = ApolloUtil.getNamespaceConfig(ApolloConstant.GOLDEN_TAX, "proxyName", "hotel:jinshui");
 // 获取代理地址
 String baseUrl = UmeProxyUtil.getProxy(proxyName);
 if (StringUtils.isEmpty(baseUrl)) {
 baseUrl = "http://example.com";
 }
 // 拼接金税接口请求地址
 String apiUrlPath = ApolloUtil.getNamespaceConfig(ApolloConstant.GOLDEN_TAX, "apiUrlPath", "/eisp-lslx/ws/zkiService");
 String url = baseUrl + apiUrlPath;

 // 获取打包文件夹内的wsdl文件流
 URL wsdlLocation = this.getClass().getResource("/goldenTax/zkiService_1.wsdl");
 // 修改在pom中设置的wsdlLocation
 AsyncInvoiceServiceService asyncInvoiceServiceService = new AsyncInvoiceServiceService(wsdlLocation);
 ZKInvoiceService zkInvoiceService = asyncInvoiceServiceService.getAsyncInvoiceServicePort();
 BindingProvider bindingProvider = (BindingProvider) zkInvoiceService;
 // 修改请求的接口地址（soap:address location）
 bindingProvider.getRequestContext().put(BindingProvider.ENDPOINT_ADDRESS_PROPERTY, url);
 return zkInvoiceService;
}

备注

由于打包和运行不在同一个环境内，生成的Java代码一直找不到pom文件 wsdlLocation 配置的wsdl文件，所以在代码内部重新引入运行时需要用到的wsdl文件。
如果没有正向代理不需要修改请求的接口地址（soap:address location）。

Java请求参数注解验证并统一处理

Tue, 25 Oct 2022 00:00:00 +0000

什么是javax.validation

JSR303 是一套JavaBean参数校验的标准，它定义了很多常用的校验注解，我们可以直接将这些注解加在我们JavaBean的属性上面(面向注解编程的时代)，就可以省略很多繁琐的串行校验代码。

引入依赖包

可根据需要，自行调整依赖包版本。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12


<!--jsr 303-->
<dependency>
 <groupId>javax.validation</groupId>
 <artifactId>validation-api</artifactId>
 <version>1.1.0.Final</version>
</dependency>
<!-- hibernate validator-->
<dependency>
 <groupId>org.hibernate</groupId>
 <artifactId>hibernate-validator</artifactId>
 <version>5.2.0.Final</version>
</dependency>

接管validation抛出的异常

@ControllerAdvice 是Spring3.2提供的新注解，它是一个Controller增强器，可对controller中被 @RequestMapping、@getmapping、@postmapping、@deletemapping注解的方法加一些逻辑处理。

最常用的就是异常处理 @ControllerAdvice需要配合@ExceptionHandler使用。当将异常抛到controller时，可以对异常进行统一处理，规定返回的json格式或是跳转到一个错误页面。

validation的异常类是MethodArgumentNotValidException.class，下面的代码对validation异常进行捕获并统一返回格式。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35


import lombok.extern.slf4j.Slf4j;
import org.springframework.validation.BindingResult;
import org.springframework.web.bind.MethodArgumentNotValidException;
import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.ResponseBody;

/**
 * @author ydong
 */
@ControllerAdvice
@Slf4j
public class ValidatorException {

 @ExceptionHandler(MethodArgumentNotValidException.class)
 @ResponseBody
 public S2cRespWrap exceptionHandler(MethodArgumentNotValidException methodArgumentNotValidException) {
 RespBean result = new RespBean();
 BindingResult bindingResult = methodArgumentNotValidException.getBindingResult();
 // 创建封装校验出错信息map
 // HashMap<String, String> errorMap = new HashMap<>();
 // 遍历所有校验出错字段
 // bindingResult.getFieldErrors().forEach(field -> {
 // errorMap.put(field.getField(), field.getDefaultMessage());
 // });

 String errorMsg = "捕获异常失败";
 if (bindingResult.getAllErrors().size() > 0) {
 errorMsg = bindingResult.getAllErrors().get(0).getDefaultMessage();
 }
 result.setErrorMsg(errorMsg);
 result.setErrorCode(-2240001);
 return UmeCommonRuler.getResponse(result);
 }
}

简单验证示例

更多用法：搜索引擎搜索“validator”

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15


import org.hibernate.validator.constraints.NotBlank;
import org.hibernate.validator.constraints.Range;
import javax.validation.constraints.Min;
import javax.validation.constraints.NotNull;

@NotNull(message = "page:页数必须")
@Min(value = 1, message = "page需大于0")
private Integer page;

@NotNull(message = "size必须")
@Range(min = 1, max = 50, message = "size要求在1-50内")
private Integer size;

@NotBlank(message = "酒店ID必须")
private String hotelId;

自定义注解验证

待补充

思考

可使用@ControllerAdvice接管特殊异常进行飞书推送，提高异常响应率

参考链接

https://blog.csdn.net/xnn_fjj/article/details/100603270 https://blog.csdn.net/Cjava_math/article/details/120001150 https://blog.csdn.net/qq_41175358/article/details/121254789