小菜鸟

java菜鸟号正在起航

0%

发表于 更新于 分类于 阅读次数： Valine：
本文字数： 6.2k 阅读时长 ≈ 6 分钟

POI操作EXCEL插入图片：完整实现与优化技巧

在 Excel 中插入图片（如 Logo、二维码、报表图表）可增强文档的可视化效果。Apache POI 提供了灵活的图片插入功能，支持多种图片格式（PNG、JPG 等）和位置调整。本文将详细讲解插入图片的核心步骤、代码实现及常见问题解决方案。

核心原理与类

POI 插入图片的核心逻辑是：

  1. 将图片转为字节数组；
  2. 通过 Workbook.addPicture() 注册图片资源；
  3. 使用绘图对象（Drawing）将图片锚定到指定单元格位置。

关键类说明：

类名 作用描述
HSSFWorkbook/XSSFWorkbook 工作簿对象，提供 addPicture() 方法注册图片资源（返回图片索引）。
HSSFPatriarch/XSSFDrawing 绘图管理器，负责创建图片对象并关联到工作表。
ClientAnchor 图片锚点，定义图片在工作表中的位置（起始行列、偏移量等）。
Picture 图片对象，支持调整尺寸、获取图片信息等操作。

完整代码实现

以下示例支持 .xls（Excel 2003）和 .xlsx（Excel 2007+）格式，演示如何插入本地图片到指定单元格，并调整尺寸。

通用工具类（兼容两种格式）

maven依赖

1
2
3
4
5
6
7
8
9
10
<dependency>
    <groupId>org.apache.poi</groupId>
    <artifactId>poi</artifactId>
    <version>4.1.2</version>
</dependency>
<dependency>
    <groupId>org.apache.poi</groupId>
    <artifactId>poi-ooxml</artifactId>
    <version>4.1.2</version>
</dependency>
阅读全文 »

发表于 更新于 分类于 阅读次数： Valine：
本文字数： 4.7k 阅读时长 ≈ 4 分钟

POI 操作 Excel 实现下拉框：隐藏 Sheet 方案详解

在批量导入数据的场景中，为 Excel 单元格添加下拉框可减少手动输入错误（如格式不符、选项错误）。Apache POI 提供了数据有效性校验功能，通过隐藏 Sheet 存储下拉选项的方式，可支持大量选项且避免下拉框配置冗余。本文将详细讲解实现步骤、核心代码及扩展技巧。

实现原理

为 Excel 单元格添加下拉框的核心是通过 数据有效性校验（Data Validation） 实现，具体方案：

  1. 创建隐藏 Sheet：用于存储下拉框的所有可选值（如 “供应商列表”“状态选项”）；
  2. 设置数据有效性：在目标 Sheet 的指定单元格区域，引用隐藏 Sheet 中的选项作为下拉来源；
  3. 隐藏辅助 Sheet：避免用户误编辑下拉选项，仅保留目标 Sheet 可见。

环境准备

依赖配置

需引入 POI 核心库和 OOXML 库（支持 .xlsx 格式）：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
<dependencies>  
    <!-- 处理 .xls 格式（Excel 2003 及以下） -->  
    <dependency>  
        <groupId>org.apache.poi</groupId>  
        <artifactId>poi</artifactId>  
        <version>4.1.2</version>  
    </dependency>  
    <!-- 处理 .xlsx 格式（Excel 2007 及以上） -->  
    <dependency>  
        <groupId>org.apache.poi</groupId>  
        <artifactId>poi-ooxml</artifactId>  
        <version>4.1.2</version>  
    </dependency>  
</dependencies>

完整实现代码

以下示例以 .xlsx 格式为例，在 “用户信息表” 的 “部门” 列添加下拉框，选项存储在隐藏的 “部门列表” Sheet 中。

核心代码

阅读全文 »

发表于 更新于 分类于 阅读次数： Valine：
本文字数： 7.6k 阅读时长 ≈ 7 分钟

Xuggle 视频处理实战：轻量级视频元数据提取指南

在多媒体处理场景中，经常需要提取视频的基础信息（如宽高、时长、码率）。Xuggle 作为一款基于 FFmpeg 的 Java 多媒体框架，提供了简洁的 API 实现视频解析，相比直接使用 FFmpeg 命令行更适合集成到 Java 应用中。本文将详细讲解 Xuggle 的依赖配置、核心 API 及视频元数据提取实战，帮助你快速实现视频信息解析需求。

Xuggle 简介与优势

Xuggle 核心功能

Xuggle（发音为 “Ex-Ug-Lee”）是基于 FFmpeg 的 Java 封装库，支持：

  • 视频 / 音频文件的读写与转码；
  • 元数据提取（宽高、时长、码率等）；
  • 视频帧捕获与处理；
  • 音频采样与分析。

为何选择 Xuggle？

  • 轻量易用：API 简洁，无需深入理解 FFmpeg 底层细节；
  • 功能聚焦：适合仅需元数据提取、简单转码的场景，避免引入 FFmpeg 全量依赖；
  • Java 原生集成：纯 Java 调用，无需额外部署 FFmpeg 可执行文件（依赖内置的 native 库）。

环境配置与依赖引入

Maven 依赖配置

Xuggle 官方 Maven 仓库已停止维护，需通过第三方仓库或手动安装依赖：

第三方仓库引入（推荐）
阅读全文 »

发表于 更新于 分类于 阅读次数： Valine：
本文字数： 4.9k 阅读时长 ≈ 4 分钟

Eureka 客户端核心机制：服务获取与服务续约的实现解析

Eureka 客户端（Eureka Client）通过两个核心定时任务与 Eureka Server 交互：服务获取（拉取服务注册表）和服务续约（发送心跳维持存活状态）。这两个任务在DiscoveryClient类中初始化，是保证服务发现准确性和服务状态有效性的关键。

定时任务初始化：initScheduledTasks 方法

initScheduledTasks是 Eureka 客户端初始化时的核心方法，用于启动服务获取和服务续约的定时任务。其核心逻辑是：根据配置判断是否需要拉取注册表和注册服务，若需要则创建对应的定时任务。

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
private void initScheduledTasks() {
    // 1. 服务获取定时任务（拉取服务注册表）
    if (clientConfig.shouldFetchRegistry()) {
        // 拉取间隔（默认30秒，可通过eureka.client.registry-fetch-interval-seconds配置）
        int registryFetchIntervalSeconds = clientConfig.getRegistryFetchIntervalSeconds();
        // 指数退避边界（任务失败时重试间隔的最大倍数）
        int expBackOffBound = clientConfig.getCacheRefreshExecutorExponentialBackOffBound();
        
        // 启动定时任务：每registryFetchIntervalSeconds秒执行一次CacheRefreshThread
        scheduler.schedule(
            new TimedSupervisorTask(
                "cacheRefresh",  // 任务名称
                scheduler,
                cacheRefreshExecutor,  // 执行线程池
                registryFetchIntervalSeconds,
                TimeUnit.SECONDS,
                expBackOffBound,
                new CacheRefreshThread()  // 服务获取线程
            ),
            registryFetchIntervalSeconds, TimeUnit.SECONDS);
    }

    // 2. 服务续约定时任务（发送心跳）
    if (clientConfig.shouldRegisterWithEureka()) {
        // 续约间隔（默认30秒，由eureka.instance.lease-renewal-interval-in-seconds配置）
        int renewalIntervalInSecs = instanceInfo.getLeaseInfo().getRenewalIntervalInSecs();
        int expBackOffBound = clientConfig.getHeartbeatExecutorExponentialBackOffBound();
        
        // 启动定时任务：每renewalIntervalInSecs秒执行一次HeartbeatThread
        scheduler.schedule(
            new TimedSupervisorTask(
                "heartbeat",  // 任务名称
                scheduler,
                heartbeatExecutor,  // 执行线程池
                renewalIntervalInSecs,
                TimeUnit.SECONDS,
                expBackOffBound,
                new HeartbeatThread()  // 服务续约线程
            ),
            renewalIntervalInSecs, TimeUnit.SECONDS);
        
        // 省略实例信息同步相关逻辑...
    }
}

核心设计：

阅读全文 »