OSCHINA-MIRROR/apache-commons-lang

Apache Commons Lang

Apache Commons Lang — это пакет классов утилит Java для классов, которые находятся в иерархии java.lang или считаются настолько стандартными, что оправдывают своё существование в java.lang.

Код тестируется с использованием последней версии JDK для поддерживаемых LTS-релизов: 8, 11, 17 и 21 на данный момент.

Пожалуйста, убедитесь, что ваша среда сборки обновлена, и сообщите о любых проблемах со сборкой.

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

Более подробную информацию можно найти на домашней странице Apache Commons Lang (https://commons.apache.org/proper/commons-lang).

Примечание: часть текста не удалось перевести из-за отсутствия контекста. Получение последнего релиза

Вы можете просмотреть Javadoc по ссылке: Javadoc. Вопросы, связанные с использованием Apache Commons Lang, следует размещать в списке рассылки пользователей по адресу: user mailing list.

Скачать исходные коды и двоичные файлы можно на нашей странице загрузки по ссылке: download page.

Также вы можете загрузить их из центральных репозиториев Maven:

<dependency>
  <groupId>org.apache.commons</groupId>
  <artifactId>commons-lang3</artifactId>
  <version>3.17.0</version>
</dependency>

Сборка

Для сборки требуется Java JDK и Apache Maven. Требуемая версия Java указана в файле pom.xml как свойство maven.compiler.source.

В командной строке запустите команду mvn без аргументов, чтобы запустить цель Maven по умолчанию для выполнения всех тестов и проверок.

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

Мы принимаем запросы на вытягивание через GitHub. Основной канал связи для участников — список рассылки разработчиков по адресу: developer mailing list. Вот несколько рекомендаций, которые облегчат нам обработку PR:

Не используйте табуляцию! Для отступов используйте пробелы.
Уважайте существующий стиль кода для каждого файла.
Создавайте минимальные различия — отключите действия при сохранении, такие как переформатирование исходного кода или организация импорта. Если вы считаете, что исходный код должен быть переформатирован, создайте отдельный PR для этого изменения.
Предоставьте тесты JUnit для ваших изменений и убедитесь, что ваши изменения не нарушают существующие тесты, запустив команду mvn.
Прежде чем отправлять PR, запустите команду mvn (самостоятельно), это запускает цель по умолчанию, которая содержит все проверки сборки.
Чтобы увидеть отчёт о покрытии кода, независимо от сбоев покрытия, выполните команду mvn clean site -Dcommons.jacoco.haltOnFailure=false.

Если вы планируете вносить вклад на регулярной основе, рассмотрите возможность заключения лицензионного соглашения участника по адресу: contributor license agreement. Подробнее о внесении вклада через GitHub можно узнать в наших рекомендациях по внесению вклада по адресу: CONTRIBUTING.md.

Лицензия

Этот код лицензирован под Apache License v2.

Необходимые уведомления и указания атрибуции см. в файле NOTICE.txt.

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

Вам нравится Apache Commons Lang? Тогда пожертвуйте обратно в ASF, чтобы поддержать разработку.

Дополнительные ресурсы

Домашняя страница Apache Commons по адресу: Apache Commons Homepage.
Трекер проблем Apache (JIRA) по адресу: Apache Issue Tracker (JIRA).
Канал Slack Apache Commons по адресу: Apache Commons Slack Channel.
Аккаунт Twitter Apache Commons по адресу: Apache Commons Twitter Account.

Компоненты Apache Commons

Пожалуйста, ознакомьтесь со списком компонентов по адресу: list of components.