dromara__hutool_CVE-2018-17297_4-1-1111

Набор инструментов, который делает Java слаще.

-- Главная страница: http://hutool.cn/ --

-- QQ-группа ②: 871141901 --

Введение

Hutool — это набор инструментов для Java, и только набор инструментов. Он помогает нам упростить каждую строку кода, сократить каждый метод, чтобы язык Java тоже мог быть «сладким». Hutool изначально был систематизацией пакета «util» в моём проекте, затем постепенно накапливался и обрастал дополнительными функциями, не связанными с бизнесом, а также вбирал в себя лучшие идеи других проектов с открытым исходным кодом. В итоге, после собственной доработки и систематизации, сформировался этот богатый набор инструментов с открытым исходным кодом.

Hutool — это искусственное слово из Hu + tool: первое — дань уважения моей «предыдущей компании», второе означает «инструмент». По звучанию оно похоже на китайское «хуту» (糊涂), что символизирует стремление к состоянию, когда «на всё взираешь с лёгкой дымкой, не важно — потеря или приобретение».

Состав компонентов

Базовая утилита для Java, которая инкапсулирует методы JDK для работы с файлами, потоками, шифрованием и дешифрованием, перекодированием, регулярными выражениями, потоками, XML и т.д., формируя различные классы Util. Кроме того, предоставляются следующие компоненты:

• hutool-aop Инкапсуляция динамических прокси JDK, поддержка аспектов без IOC
• hutool-bloomFilter Фильтр Блума, реализация фильтра Блума на основе некоторых хеш-алгоритмов
• hutool-cache Кэш
• hutool-core Ядро, включая операции с Bean, датами, различные Util и т.д.
• hutool-cron Модуль планировщика задач, поддерживающий выражения, подобные Crontab
• hutool-crypto Модуль шифрования и дешифрования
• hutool-db Операции с данными после инкапсуляции JDBC, основанные на идеях ActiveRecord
• hutool-dfa Поиск нескольких ключевых слов на основе модели DFA
• hutool-extra Модуль расширения, инкапсуляция сторонних библиотек (шаблонизаторы, почта, Servlet, QR-коды и т.д.)
• hutool-http Инкапсуляция HTTP-клиента на основе HttpUrlConnection
• hutool-log Фасад логирования с автоматическим определением реализации
• hutool-script Инкапсуляция выполнения скриптов, например Javascript
• hutool-setting Более функциональная инкапсуляция Setting-конфигурации и Properties
• hutool-system Инкапсуляция вызова системных параметров (информация о JVM и т.д.)
• hutool-json Реализация JSON
• hutool-captcha Реализация графической капчи

Документация

Китайская документация

Справочное API

Установка

Maven

Добавьте в dependencies в pom.xml проекта следующее:

<dependency>
    <groupId>cn.hutool</groupId>
    <artifactId>hutool-all</artifactId>
    <version>4.1.11</version>
</dependency>

Gradle

compile 'cn.hutool:hutool-all:4.1.11'

Проекты без Maven

Нажмите на любую из ссылок ниже, чтобы скачать hutool-all-X.X.X.jar:

• Центральный репозиторий Maven 1
• Центральный репозиторий Maven 2

Изменения версий

• История изменений Release-версий

• История изменений SNAPSHOT-версий

Внесение вклада

Сообщение об ошибке или предложение

• Gitee (码云)
• Github

Принципы, которым необходимо следовать

Hutool приветствует любой вклад в развитие проекта, однако автор — человек с навязчивой идеей, и, чтобы позаботиться о больном, необходимо, чтобы отправляемые pull request соответствовали некоторым правилам:

1. Комментарии должны быть полными, особенно для каждого нового метода — согласно стандартам Java-документации указывайте описание метода, параметров, возвращаемого значения и т.д. Если хотите, можете также указать своё имя.
2. Отступы в Hutool выполняются по умолчанию в Eclipse (не говорите мне, насколько хороша IDEA, автор очень ленив и не может её освоить) — табуляция, поэтому соблюдайте это (не спорьте со мной о пробелах и табуляции, это привычка больного).
3. В новых методах не используйте сторонние библиотеки. Hutool следует принципу отсутствия зависимостей (за исключением дополнительных методов-инструментов в модуле extra).
4. Пожалуйста, отправляйте pull request в ветку v4-dev. Начиная с версии 4.x Hutool использует новые ветки: v4-master — основная ветка, означающая, что версия уже опубликована в центральном репозитории; в эту ветку pull request не допускаются и изменения запрещены. Ветка v4-dev — ветка разработки; следующая версия Hutool или SNAPSHOT-версия разрабатывается в этой ветке, так что вы можете отправлять pull request в неё.

Шаги по добавлению кода

1. Форкните проект на Gitee или Github в свой репозиторий.
2. Склонируйте форкнутый проект (то есть ваш проект) на свой локальный компьютер.
3. Измените код (обязательно в ветке v4-dev).
4. После commit запушьте в свой репозиторий (ветка v4-dev).
5. Войдите на Gitee или Github: на главной странице вы увидите кнопку pull request. Нажмите её, заполните некоторую информацию и отправьте.
6. Дождитесь, пока автор объединит изменения.

Пожертвования

Если вам нравится Hutool, вы можете пожертвовать и угостить автора пачкой «латяо» (острые снеки) ~ За это выражаю благодарность ^_^.

Нажмите на ссылку ниже, прокрутите страницу до самого низа и нажмите «Пожертвовать».

Перейти к пожертвованию