jOOX 技术文档

1. 安装指南

依赖关系

jOOX 项目依赖于以下 Java 包：

• java.sql
• java.xml
• java.xml.bind

下载与安装

根据您的 Java 版本，选择以下依赖项：

Java 9 及以上版本

<dependency>
  <groupId>org.jooq</groupId>
  <artifactId>joox</artifactId>
  <version>2.0.1</version>
</dependency>

Java 8 及以上版本

<dependency>
  <groupId>org.jooq</groupId>
  <artifactId>joox-java-8</artifactId>
  <version>2.0.1</version>
</dependency>

请确保将这些依赖项添加到您的项目构建配置中。

2. 项目的使用说明

jOOX 是一个面向对象的 XML 处理库，它为 org.w3c.dom 包提供了一个简单的封装，允许在需要 DOM 但 DOM 过于冗长的情况下进行流畅的 XML 文档创建和操作。jOOX 仅封装底层文档，可以用来增强 DOM，而不是替代 DOM。

jOOX 的流畅性灵感来自于 jRTF，一个用于在 Java 中创建 RTF 文档的非常不错的流畅 API。

jOOX 的 API 灵感来自于 jQuery，一个用于高效操作 HTML 和 XML 的优秀 JavaScript 库。

jOOX 的命名灵感来自于 jOOQ，一个用于 SQL 构建和执行的流畅 API。

简单示例

以下是一个简单的示例，展示了如何使用 jOOX：

// 在索引为 4 的订单中添加一个 "paid" 元素
$(document).find("orders").children().eq(4).append("<paid>true</paid>");

// 找到已付款的订单并标记为 "settled"
$(document).find("orders").children().find("paid").after("<settled>true</settled>");

// 添加一个复杂的元素
$(document).find("orders").append(
  $("order", $("date", "2011-08-14"),
             $("amount", "155"),
             $("paid", "false"),
             $("settled", "false")).attr("id", "13");

3. 项目 API 使用文档

jOOX 依赖于静态方法，从 Java 5 和静态导入开始，使用 jOOX 非常简单。只需导入：

import static org.joox.JOOX.*;

使用上述静态导入，使用 jOOX 封装 DOM 对象非常简单：

导航方法

所有导航方法都会返回一个新的包装器，包含对结果 DOM 元素的引用：

// 从文件解析文档
Document document = $(xmlFile).document();

// 使用 jOOX API 封装文档
Match x1 = $(document);

// 获取所有书籍（封装的 <book/> DOM 元素）
Match x2 = $(document).find("book");

// 获取所有偶数或奇数书籍
Match x3 = $(document).find("book").filter(even());
Match x4 = $(document).find("book").filter(odd());

// 获取所有书籍 ID
List<String> ids = $(document).find("book").ids();

// 获取 ID 为 1 或 2 的书籍
Match x5 = $(document).find("book").filter(ids("1", "2"));

// 或者，使用 CSS 选择器语法：
Match x6 = $(document).find("book#1, book#2");

// 使用 XPath 查找 ID 为 1 或 2 的书籍
Match x7 = $(document).xpath("//book[@id = 1 or @id = 2]");

操作方法

所有 jOOX 的操作都会在底层的 DOM 文档上执行：

// 添加一本新书
$(document).find("books").append("<book id=\"5\"><name>Harry Potter</name></book>");

// 也可以这样做
$(document).find("book").filter(ids(5)).after("<book id=\"6\"/>");

// 删除 ID 为 1 的书籍
$(document).find("book").filter(ids(1)).remove();

// 或者这样做
$(document).find("book").remove(ids(1));

4. 项目安装方式

请参考上述“安装指南”部分，根据您的 Java 版本选择合适的依赖项，并将其添加到您的项目构建配置中。这样可以确保 jOOX 库被正确地包含在您的项目中，并且可以正常使用。