Hickory：终极HTML数据处理工具，让Clojure轻松解析与转换网页内容

【免费下载链接】hickoryHTML as data项目地址: https://gitcode.com/gh_mirrors/hic/hickory

Hickory 是一款专为Clojure生态系统设计的终极HTML数据处理工具，它能将HTML内容解析为Clojure数据结构，让开发者轻松实现网页内容的分析、转换和重新输出。无论是在Clojure还是ClojureScript环境中，Hickory都能提供一致且强大的HTML处理能力，是网页数据提取与转换的理想选择。

🌟 核心功能：HTML与Clojure数据的无缝转换

Hickory的核心价值在于它能将HTML文本转换为两种灵活的数据格式，满足不同场景的处理需求：

🔹 Hickory格式：结构化DOM表示

Hickory格式采用map结构精确描述HTML文档，包含:type、:tag、:attrs和:content等关键字段：

• :type- 节点类型（:comment、:document、:element等）
• :tag- 元素标签（如:div、:a）
• :attrs- 属性键值对（如{:href "/path"}）
• :content- 子节点向量

这种格式几乎与clojure.xml结构一致，但增加了类型信息，能完整表达HTML中的注释、文档类型等特殊节点。

🔹 Hiccup格式：简洁的向量表示

Hiccup格式使用Clojure向量简洁表达HTML结构，如[:a {:href "foo"} "bar"]，适合快速编写和修改HTML片段。Hickory提供as-hiccup函数实现HTML到Hiccup的转换，让开发者可以使用熟悉的Hiccup语法操作HTML。

🚀 快速上手：Hickory基础操作指南

🔧 安装与引入

在project.clj中添加依赖：

[org.clj-commons/hickory "0.7.3"]

引入核心命名空间：

(use 'hickory.core) (require '[hickory.select :as s]) (require '[hickory.render :refer [hickory-to-html]])

🔍 解析HTML文档

使用parse函数解析完整HTML文档：

(def parsed-doc (parse "<a href=\"foo\">bar</a>"))

使用parse-fragment处理HTML片段：

(def parsed-frag (parse-fragment "<p>Hello</p><p>World</p>"))

🔄 格式转换

转换为Hickory格式：

(as-hickory parsed-doc) ;; 返回 {:type :document, :content [{:type :element, :tag :html, ...}]}

转换为Hiccup格式：

(as-hiccup parsed-doc) ;; 返回 [[:html {} [:head {}] [:body {} [:a {:href "foo"} "bar"]]]]

✏️ 修改与渲染

使用zippers修改文档结构：

(require '[hickory.zip :as zip] '[clojure.zip :as z]) (-> (hickory-zip (as-hickory parsed-doc)) z/next z/next (z/replace {:type :element :tag :head :attrs {:id "new-head"} :content nil}) z/root hickory-to-html) ;; 返回修改后的HTML字符串

🎯 高级应用：CSS选择器与数据提取

Hickory的hickory.select命名空间提供强大的CSS风格选择器，让数据提取变得简单高效：

🔑 常用选择器

• tag- 按标签选择：(tag :div)
• id- 按ID选择：(id :main-content)
• class- 按类选择：(class :article)
• attr- 按属性选择：(attr :href #(.startsWith % "https"))

🔗 选择器组合

使用组合器构建复杂查询：

(select (s/descendant (s/class "posts") (s/tag :h2) (s/first-child)) hickory-tree)

📊 实战示例：提取网页数据

;; 解析网页并提取所有文章标题 (-> (client/get "https://example.com/blog") :body parse as-hickory (s/select (s/descendant (s/class "post") (s/tag :h1))) (->> (map #(get-in % [:content 0]))))

💡 最佳实践与注意事项

🔀 格式选择建议

• Hickory格式：适合需要完整文档信息、复杂查询和修改的场景
• Hiccup格式：适合简洁表示、快速编写和简单修改的场景

🌐 跨平台支持

Hickory在不同环境下的使用注意事项：

• 浏览器环境：支持IE9+，无需额外依赖
• Node.js环境：需要安装DOM实现（如jsdom或xmldom）
• Clojure后端：使用Jsoup作为解析引擎，支持完整HTML5解析

📚 学习资源

• 官方API文档：API.md
• 核心实现代码：src/clj/hickory/core.clj
• 选择器功能：src/cljc/hickory/select.cljc

🛠️ 项目结构与核心文件

Hickory采用跨平台设计，核心代码组织清晰：

• Clojure代码：src/clj/hickory/core.clj
• ClojureScript代码：src/cljs/hickory/core.cljs
• 通用代码：src/cljc/hickory/
  • 转换功能：convert.cljc
  • 渲染功能：render.cljc
  • 选择器：select.cljc

📥 获取与安装

克隆仓库

git clone https://gitcode.com/gh_mirrors/hic/hickory

构建项目

使用Leiningen构建：

lein compile

📝 总结

Hickory作为Clojure生态系统中的HTML数据处理工具，通过将HTML转换为可操作的数据结构，极大简化了网页内容的解析、分析和转换工作。无论是构建网页爬虫、处理模板还是实现前端组件，Hickory都能提供高效、灵活的解决方案，是Clojure开发者处理HTML数据的必备工具。

无论你是Clojure新手还是资深开发者，Hickory直观的API和强大的功能都能帮助你轻松应对各种HTML处理挑战，让数据处理工作变得更加高效和愉悦！

【免费下载链接】hickoryHTML as data项目地址: https://gitcode.com/gh_mirrors/hic/hickory