工具类 - 召田最帅boy

Swagger使用教程

Swagger（OpenAPI）提供统一的API描述、可视化文档和代码生成工具链。核心组件包括 OpenAPI 规范、Swagger UI、Editor、Codegen，解决前后端不同步、文档滞后和接口测试繁琐等痛点。教程分别演示了 Node.js+Express（通过 swagger-jsdoc 与 swagger-ui‑express）和 Spring Boot（使用 springdoc‑openapi）的快速集成步骤、注解写法以及文档访问方式。随后介绍了 OpenAPI YAML 编写规范、利用 UI “Try it out” 进行手动/自动化测试（Postman、Dredd、cURL），以及通过 Codegen 生成服务器骨架和客户端 SDK 的实践。最后给出生产部署安全、Docker 化、CI/CD 纳入契约测试和代码生成的最佳实践，并建议新项目采用“契约先行”设计、自动化生成和持续集成，以提升协作效率和代码质量。

2025-12-09 10:18:38 阅读

Hutool：让Java开发更简洁高效

Hutool 是一套面向 Java 的实用工具库，提供字符串、文件、网络、JSON 等常用功能的封装，极大简化开发。文章介绍了在 Maven 中引入 hutool-all 的方式，并通过 StrUtil、FileUtil、IoUtil、HttpUtil、JSONUtil 等类的示例代码演示了字符串去空格、文件读写、HTTP 请求、JSON 转换等典型场景。使用 Hutool 可让代码更简洁、可读性更高，是 Java 开发者提升效率的利器。

2024-06-28 17:32:46 阅读

实现异步天气数据获取与Spring缓存集成

本文介绍在Spring Boot中通过@Async实现异步调用、@Cacheable实现缓存，高效获取并存储天气数据的完整方案。首先启用Spring异步支持，使网络请求在后台执行，提升响应速度；随后使用Spring Cache缓存当天天气，避免重复调用高德天气API，降低服务器负载。示例代码展示了获取客户端IP、解析地区、调用高德地理编码与天气接口、处理返回结果并将数据放入Model。文中还提醒需自行实现IP解析工具、替换API密钥，并确保项目已引入Spring Cache和Web依赖。整体思路是异步获取、结果缓存，从而优化用户体验和系统性能。

2024-07-15 11:46:00 阅读

Java实现给PDF文件加水印、图片、签名（含测试类）

本文介绍使用 iText（5.5.13）在 Java 中为 PDF 添加文字水印、指定坐标文字、关键字定位文字、图片和签名的完整实现。首先在 pom 中引入 `itextpdf` 与 `itext-asian` 依赖；随后提供 `PdfUtil` 工具类，核心方法包括： * `addWaterMark`：遍历所有页，在每页以指定透明度、倾斜角度绘制重复文字水印。 * `addText`：根据传入的坐标列表（页码、左下右上坐标）在对应页添加自定义文字。 * `addTextByKeyword`：解析 PDF 内容，定位关键字所在的基线坐标并在其附近插入文字。 * `addImage`、`addSignature`：加载本地图片或签章图片，按坐标、尺寸绘制到指定页。文中还给出对应的实体类 `PdfAddContentParam`、异常处理和资源关闭细节，并提供了完整的 JUnit 测试示例，演示如何调用上述方法生成带水印、印章或签名的 PDF。整个实现代码结构清晰，适合作为 PDF 加签、盖章功能的参考模板。

2022-11-25 17:32:57 阅读

给PDF添加水印并保存（Java实现）

本文介绍如何使用 Java 的 iText5 库为 PDF 添加文字水印并保存。首先在 Maven 中引入 `itextpdf` 与 `itext-asian` 依赖，然后实现 `PDFUtils.addWaterMark` 方法：读取原 PDF、创建 `PdfStamper`、加载自定义字体、设置透明度、遍历每页按指定间距和倾斜角度绘制水印文本，最后关闭流。文末给出调用示例 `AddWaterMarkTest`，演示将本地 PDF 加水印后输出新文件。整个过程代码完整，可直接复制使用。

2022-11-24 11:14:41 阅读