SQLite-JDBC 项目编译与 ICU 扩展集成指南-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_07239/article/details/148507046

SQLite-JDBC 项目编译与 ICU 扩展集成指南

sqlite-jdbc xerial/sqlite-jdbc: 是一个基于 Java 的 SQLite 数据库驱动器，它提供了 Java 应用程序与 SQLite 数据库之间的连接和操作接口。适合用于 Java 应用程序的 SQLite 数据库操作，特别是对于需要使用 SQLite 数据库的场景。特点是 Java 数据库驱动器、支持 SQLite。项目地址: https://gitcode.com/gh_mirrors/sq/sqlite-jdbc

SQLite-JDBC 是一个将 SQLite 数据库引擎与 Java JDBC 接口集成的开源项目。本文将详细介绍如何从源代码编译 SQLite-JDBC 并集成 ICU 扩展模块，解决在 Windows 环境下编译时可能遇到的问题。

编译环境准备

在开始编译前，需要确保系统已安装以下工具：

Java 开发环境（JDK）
Maven 构建工具
GCC 编译器（MinGW 或 MSYS2）
Git 版本控制工具

编译步骤详解

1. 获取源代码

首先需要克隆 SQLite-JDBC 项目的源代码仓库：

git clone https://github.com/xerial/sqlite-jdbc.git
cd sqlite-jdbc

2. 编译 SQLite 原生库

SQLite-JDBC 项目默认会下载预编译的 SQLite 库，但为了集成 ICU 扩展，我们需要手动编译 SQLite：

gcc -I. -shared -fPIC sqlite3.c -ldl -lm -o sqlite3.dll

要启用 ICU 扩展，需要在编译时添加相关参数：

gcc -I. -shared -fPIC sqlite3.c -ldl -lm -licuuc -licui18n -o sqlite3.dll

3. 配置 SQLite-JDBC 使用自定义库

有两种方式让 SQLite-JDBC 使用自定义编译的 SQLite 库：

方法一：替换默认库 将编译好的 sqlite3.dll 复制到项目的 target/classes/org/sqlite/native/Windows/x86_64/ 目录下。

方法二：运行时指定 通过 Java 系统属性指定自定义库路径：

System.setProperty("org.sqlite.lib.path", "自定义路径");
System.setProperty("org.sqlite.lib.name", "sqlite3");

4. 构建 SQLite-JDBC

使用 Maven 构建项目：

mvn clean package

常见问题解决

1. 编译错误处理

如果遇到类似 "Failure writing output to destination" 的错误，通常是环境变量配置问题。确保：

JAVA_HOME 环境变量正确设置
Maven 和 JDK 版本兼容
系统 PATH 包含必要的工具路径

2. ICU 扩展加载问题

当使用 ICU 扩展时，确保：

ICU 库文件（icuuc.dll 和 icui18n.dll）位于系统 PATH 或与 sqlite3.dll 相同的目录
编译时正确链接了 ICU 库

3. 函数未找到错误

出现 "UnsatisfiedLinkError" 通常是因为：

编译的 SQLite 版本与 JDBC 驱动不兼容
缺少必要的导出函数
架构不匹配（32位 vs 64位）

解决方案是确保使用与 JDBC 驱动兼容的 SQLite 源代码版本编译。

高级配置

动态扩展加载

要在 Java 中加载 SQLite 扩展（如 ICU），可以使用以下代码：

Properties props = new Properties();
props.setProperty("enable_load_extension", "true");
Connection conn = DriverManager.getConnection("jdbc:sqlite:sample.db", props);
Statement stmt = conn.createStatement();
stmt.execute("SELECT load_extension('icu')");