{"id":27273434,"url":"https://github.com/chinabugotech/hutool4","last_synced_at":"2025-04-11T14:32:48.300Z","repository":{"id":44728341,"uuid":"214054856","full_name":"chinabugotech/hutool4","owner":"chinabugotech","description":"A set of tools that keep Java sweet.","archived":false,"fork":false,"pushed_at":"2022-01-28T11:52:49.000Z","size":2103,"stargazers_count":19,"open_issues_count":0,"forks_count":5,"subscribers_count":3,"default_branch":"v4-dev","last_synced_at":"2025-03-25T10:42:30.968Z","etag":null,"topics":["http","hutool","java","json","orm","tool","util"],"latest_commit_sha":null,"homepage":"http://hutool.cn","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/chinabugotech.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-10-10T01:01:22.000Z","updated_at":"2025-02-20T02:45:43.000Z","dependencies_parsed_at":"2022-08-25T13:30:13.601Z","dependency_job_id":null,"html_url":"https://github.com/chinabugotech/hutool4","commit_stats":null,"previous_names":["chinabugotech/hutool4"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chinabugotech%2Fhutool4","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chinabugotech%2Fhutool4/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chinabugotech%2Fhutool4/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chinabugotech%2Fhutool4/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/chinabugotech","download_url":"https://codeload.github.com/chinabugotech/hutool4/tar.gz/refs/heads/v4-dev","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248419704,"owners_count":21100233,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["http","hutool","java","json","orm","tool","util"],"created_at":"2025-04-11T14:31:30.545Z","updated_at":"2025-04-11T14:32:48.290Z","avatar_url":"https://github.com/chinabugotech.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\r\n\t\u003ca href=\"https://hutool.cn/\"\u003e\u003cimg src=\"https://cdn.jsdelivr.net/gh/looly/hutool-site/images/logo.jpg\" width=\"400\"\u003e\u003c/a\u003e\r\n\u003c/p\u003e\r\n\u003cp align=\"center\"\u003e\r\n\t\u003cstrong\u003eA set of tools that keep Java sweet.\u003c/strong\u003e\r\n\u003c/p\u003e\r\n\u003cp align=\"center\"\u003e\r\n\t\u003ca target=\"_blank\" href=\"https://search.maven.org/search?q=g:%22cn.hutool%22%20AND%20a:%22hutool-all%22\"\u003e\r\n        \u003cimg src=\"https://img.shields.io/maven-central/v/cn.hutool/hutool-all.svg?label=Maven%20Central\" /\u003e\r\n\t\u003c/a\u003e\r\n\t\u003ca target=\"_blank\" href=\"http://license.coscl.org.cn/MulanPSL/\"\u003e\r\n        \u003cimg src=\"https://img.shields.io/:license-MulanPSL-blue.svg\" /\u003e\r\n\t\u003c/a\u003e\r\n\t\u003ca target=\"_blank\" href=\"https://www.oracle.com/technetwork/java/javase/downloads/index.html\"\u003e\r\n\t\t\u003cimg src=\"https://img.shields.io/badge/JDK-1.7+-green.svg\" /\u003e\r\n\t\u003c/a\u003e\r\n\t\u003ca target=\"_blank\" href=\"https://travis-ci.org/looly/hutool\"\u003e\r\n\t\t\u003cimg src=\"https://travis-ci.org/looly/hutool.svg?branch=v4-master\" /\u003e\r\n\t\u003c/a\u003e\r\n\t\u003ca href=\"https://www.codacy.com/app/looly/hutool?utm_source=github.com\u0026amp;utm_medium=referral\u0026amp;utm_content=looly/hutool\u0026amp;utm_campaign=Badge_Grade\"\u003e\r\n\t\t\u003cimg src=\"https://api.codacy.com/project/badge/Grade/3e1b8a70248c46579b7b0d01d60c6377\"/\u003e\r\n\t\u003c/a\u003e\r\n\t\u003ca href=\"https://codecov.io/gh/looly/hutool\"\u003e\r\n\t\t\u003cimg src=\"https://codecov.io/gh/looly/hutool/branch/v4-master/graph/badge.svg\" /\u003e\r\n\t\u003c/a\u003e\r\n\t\u003ca target=\"_blank\" href=\"https://gitter.im/hutool/Lobby?utm_source=badge\u0026utm_medium=badge\u0026utm_campaign=pr-badge\u0026utm_content=badge\"\u003e\r\n\t\t\u003cimg src=\"https://badges.gitter.im/hutool/Lobby.svg\" /\u003e\r\n\t\u003c/a\u003e\r\n\t\u003ca target=\"_blank\" href=\"https://gitee.com/loolly/hutool/stargazers\"\u003e\r\n\t\t\u003cimg src=\"https://gitee.com/loolly/hutool/badge/star.svg?theme=dark\" alt='gitee star'/\u003e\r\n\t\u003c/a\u003e\r\n\t\u003ca target=\"_blank\" href='https://github.com/looly/hutool'\u003e\r\n\t\t\u003cimg src=\"https://img.shields.io/github/stars/looly/hutool.svg?style=social\" alt=\"github star\"/\u003e\r\n\t\u003c/a\u003e\r\n\t\u003ca target=\"_blank\" href='https://app.netlify.com/sites/hutool/deploys'\u003e\r\n\t\t\u003cimg src=\"https://api.netlify.com/api/v1/badges/7e0824f9-5f9a-4df0-89dd-b2fccfbeccb1/deploy-status\" alt=\"netlify\"/\u003e\r\n\t\u003c/a\u003e\r\n\u003c/p\u003e\r\n\u003cp align=\"center\"\u003e\r\n\t-- 主页：\u003ca href=\"https://hutool.cn\"\u003ehttps://hutool.cn/\u003c/a\u003e | \u003ca href=\"https://www.hutool.club/\"\u003ehttps://www.hutool.club/\u003c/a\u003e --\r\n\u003c/p\u003e\r\n\u003cp align=\"center\"\u003e\r\n\t-- QQ群③：\u003ca href=\"https://shang.qq.com/wpa/qunwpa?idkey=35764b2247c46ffebe28e4541e5b2af8f5dee5efcf47ceec69d21e4521aa8c75\"\u003e555368316\u003c/a\u003e --\r\n\t-- QQ群④：\u003ca href=\"https://shang.qq.com/wpa/qunwpa?idkey=309056e409a304a454c7ba250a10d38dd82b9b49cd0e1f180fedbde78b02ae0d\"\u003e718802356\u003c/a\u003e --\r\n\u003c/p\u003e\r\n\r\n-------------------------------------------------------------------------------\r\n\r\n## 简介\r\n\r\nHutool是一个Java工具包，也只是一个工具包，它帮助我们简化每一行代码，减少每一个方法，让Java语言也可以“甜甜的”。它最初是作者项目中“util”包的一个整理，后来慢慢积累并加入更多非业务相关功能，并广泛学习其它开源项目精髓，经过自己整理修改，最终形成丰富的开源工具集。\r\n\r\nHutool是Hu + tool的自造词，谐音“糊涂”，寓意，追求“万事都作糊涂观，无所谓失，无所谓得”的境界。\r\n\r\n### Hutool如何改变我们的coding方式\r\n\r\nHutool的目标是使用一个工具方法代替一段复杂代码，从而最大限度的避免“复制粘贴”代码的问题，彻底改变我们写代码的方式。\r\n\r\n以计算MD5为例：\r\n\r\n- 【以前】打开百度 -\u003e 搜“Java MD5加密” -\u003e 打开某篇博客-\u003e 复制粘贴 -\u003e 改改好用\r\n- 【现在】引入Hutool -\u003e SecureUtil.md5()\r\n\r\n同样，当我们想实现什么功能，脑袋中第一个想到的就是去找XXXUtil，而非百度。\r\n\r\n-------------------------------------------------------------------------------\r\n\r\n## 包含组件\r\n一个Java基础工具类，对文件、流、加密解密、转码、正则、线程、XML等JDK方法进行封装，组成各种Util工具类，同时提供以下组件：\r\n\r\n- hutool-aop              JDK动态代理封装，提供非IOC下的切面支持\r\n- hutool-bloomFilter  布隆过滤，提供一些Hash算法的布隆过滤\r\n- hutool-cache           简单缓存实现\r\n- hutool-core             核心，包括Bean操作、日期、各种Util等\r\n- hutool-cron             定时任务模块，提供类Crontab表达式的定时任务\r\n- hutool-crypto          加密解密模块，提供对称、非对称和摘要算法封装\r\n- hutool-db               JDBC封装后的数据操作，基于ActiveRecord思想\r\n- hutool-dfa              基于DFA模型的多关键字查找\r\n- hutool-extra            扩展模块，对第三方封装（模板引擎、邮件、Servlet、二维码、Emoji、FTP、分词等）\r\n- hutool-http             基于HttpUrlConnection的Http客户端封装\r\n- hutool-log              自动识别日志实现的日志门面\r\n- hutool-script           脚本执行封装，例如Javascript\r\n- hutool-setting         功能更强大的Setting配置文件和Properties封装\r\n- hutool-system        系统参数调用封装（JVM信息等）\r\n- hutool-json             JSON实现\r\n- hutool-captcha      图片验证码实现\r\n- hutool-poi              针对POI中Excel的封装\r\n- hutool-socket         基于Java的NIO和AIO的Socket封装\r\n\r\n可以根据需求对每个模块单独引入，也可以通过引入`hutool-all`方式引入所有模块。\r\n\r\n-------------------------------------------------------------------------------\r\n\r\n## 文档 \r\n\r\n[中文文档](https://www.hutool.cn/docs/)\r\n[中文文档（备用）](https://www.hutool.club/docs/)\r\n\r\n[参考API](https://apidoc.gitee.com/loolly/hutool/)\r\n\r\n-------------------------------------------------------------------------------\r\n\r\n## 安装\r\n\r\n### Maven\r\n在项目的pom.xml的dependencies中加入以下内容:\r\n\r\n```xml\r\n\u003cdependency\u003e\r\n    \u003cgroupId\u003ecn.hutool\u003c/groupId\u003e\r\n    \u003cartifactId\u003ehutool-all\u003c/artifactId\u003e\r\n    \u003cversion\u003e4.6.18\u003c/version\u003e\r\n\u003c/dependency\u003e\r\n```\r\n\r\n### Gradle\r\n```\r\ncompile 'cn.hutool:hutool-all:4.6.18'\r\n```\r\n\r\n### 非Maven项目\r\n\r\n点击以下任一链接，下载`hutool-all-X.X.X.jar`即可：\r\n\r\n- [Maven中央库1](https://repo1.maven.org/maven2/cn/hutool/hutool-all/4.6.18/)\r\n- [Maven中央库2](http://repo2.maven.org/maven2/cn/hutool/hutool-all/4.6.18/)\r\n\r\n\u003e 注意\r\n\u003e Hutool支持JDK7+，对Android平台没有测试，不能保证所有工具类获工具方法可用。\r\n\r\n### 编译安装\r\n\r\n访问Hutool的码云主页：[https://gitee.com/loolly/hutool](https://gitee.com/loolly/hutool) 下载整个项目源码（v4-master或v4-dev分支都可）然后进入Hutool项目目录执行：\r\n\r\n```sh\r\n./hutool.sh install\r\n```\r\n\r\n然后就可以使用Maven引入了。\r\n\r\n-------------------------------------------------------------------------------\r\n\r\n## 添砖加瓦\r\n\r\n### 提供bug反馈或建议\r\n\r\n- [码云Gitee](https://gitee.com/loolly/hutool/issues)\r\n- [Github](https://github.com/looly/hutool/issues)\r\n\r\n### 遵照的原则\r\n\r\nHutool欢迎任何人为Hutool添砖加瓦，贡献代码，不过作者是一个强迫症患者，为了照顾病人，需要提交的pr（pull request）符合一些规范，规范如下：\r\n\r\n1. 注释完备，尤其每个新增的方法应按照Java文档规范标明方法说明、参数说明、返回值说明等信息，如果愿意，也可以加上你的大名。\r\n2. Hutool的缩进按照Eclipse（~~不要跟我说IDEA多好用，作者非常懒，学不会~~，IDEA真香，改了Eclipse快捷键后\r\n舒服多了）默认（tab）缩进，所以请遵守（不要和我争执空格与tab的问题，这是一个病人的习惯）。\r\n3. 新加的方法不要使用第三方库的方法，Hutool遵循无依赖原则（除非在extra模块中加方法工具）。\r\n4. 请pull request到`v4-dev`分支。Hutool在4.x版本后使用了新的分支：`v4-master`是主分支，表示已经发布中央库的版本，这个分支不允许pr，也不允许修改。`v4-dev`分支是开发分支，Hutool的下个版本或者SNAPSHOT版本在这个分支上开发，你可以pr到这个分支。\r\n\r\n### 贡献代码的步骤\r\n\r\n1. 在Gitee或者Github上fork项目到自己的repo\r\n2. 把fork过去的项目也就是你的项目clone到你的本地\r\n3. 修改代码（记得一定要修改v4-dev分支）\r\n4. commit后push到自己的库（v4-dev分支）\r\n5. 登录Gitee或Github在你首页可以看到一个 pull request 按钮，点击它，填写一些说明信息，然后提交即可。\r\n6. 等待作者合并\r\n\r\n-------------------------------------------------------------------------------\r\n\r\n## 捐赠\r\n\r\n如果你觉得Hutool不错，可以捐赠请作者吃包辣条~，在此表示感谢^_^。\r\n\r\n点击以下链接，将页面拉到最下方点击“捐赠”即可。\r\n\r\n[前往捐赠](https://gitee.com/loolly/hutool)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchinabugotech%2Fhutool4","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchinabugotech%2Fhutool4","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchinabugotech%2Fhutool4/lists"}