Common-tools

Этот инструмент я больше не обновляю, большинство методов из него перенесены в пакет hutool, а некоторые редко используемые функции были заброшены. Проект пока оставлен для дальнейшего использования.

1. Инструменты для работы с базами данных

• C3p0Ds и DruidDs — это две реализации пулов соединений, которые зависят от файла конфигурации базы данных. Пример файла конфигурации можно найти в config/db-example.setting. Для использования необходимо скопировать файл db-example.setting в каталог ${classpath}/config/db.setting и заменить значения в соответствии с инструкциями в файле. Если вы используете Druid, вам также потребуется создать файл ${classpath}/config/druid.setting на основе druid-example.setting, следуя инструкциям в официальной документации. Для C3P0 вам нужно будет создать файл ${classpath}/c3p0-config.xml на основе c3p0-config-example.xml для настройки параметров C3P0. После этого вы можете вызвать методы C3p0Ds.getDataSource() или DruidDs.getDataSource(), чтобы получить источник данных по умолчанию.

• com.baijob.commonTools.db.DbUtil — класс инструментов для работы с базой данных, который предоставляет метод закрытия для одновременного закрытия Connection, Statement и ResultSet. Метод newSqlRunner используется для быстрого создания экземпляра SqlRunner (см. ниже).

• com.baijob.commonTools.db.DsSetting — вспомогательный класс для чтения файлов db.setting, используемый внутри.

• com.baijob.commonTools.db.SqlRunner — класс, аналогичный инструментам Apache DbUtils, который инкапсулирует общие операции CRUD и используется вместе с com.baijob.commonTools.db.RsHandler.

2. Инструменты для отправки электронной почты

• com.baijob.commonTools.mail.MailAccount — класс учётных записей электронной почты. Вы можете использовать MailAccount(String accountSettingFileBaseClassLoader) для чтения файла настроек, расположенного относительно пути.

• com.baijob.commonTools.mail.MailUtil — класс инструментов для отправки электронной почты, методы которого описаны в комментариях. Этот класс зависит от javax.mail, поэтому добавьте зависимость в pom.xml или загрузите его вручную.

3. Сетевые инструменты

• com.baijob.commonTools.net.AccessControl — контроль доступа на основе файла конфигурации, который позволяет настроить белый или чёрный список IP-адресов и реализовать простую аутентификацию учётных записей. Файл конфигурации доступен в access-example.xml.

• com.baijob.commonTools.net.Connector — объект соединения, имеющий свойства хоста, порта, имени пользователя и пароля.

• com.baijob.commonTools.net.HtmlUtil — HTML-инструменты, которые в настоящее время предоставляют только функцию экранирования специальных символов.

• com.baijob.commonTools.net.SocketUtil — инструменты сокетов. isUsableLocalPort() проверяет доступность локального порта (не занят ли он другими программами), isValidPort() определяет, соответствует ли порт стандартам, longToIpv4() преобразует long в IPv4-адрес, ipv4ToLong() выполняет обратное преобразование, netCat() — простой метод передачи данных.

• com.baijob.commonTools.net.SSHUtil — SSH-инструменты. getSession() получает сеанс SSH, bindPort() сопоставляет удалённый порт с локальным портом.

• com.baijob.commonTools.net.URLUtil — преобразует относительные и абсолютные пути в объекты URL для чтения и записи сетевых данных или потоков файлов. Настройка этого пакета зависит от конфигурации.

4. Инструменты для управления потоками

• com.baijob.commonTools.thread.BaseRunnable — реализует интерфейс Runnable и расширяет его функциональность, включая добавление имени, идентификатора, статистики вызовов и времени выполнения, а также запрет на повторный запуск потока во время выполнения.

• com.baijob.commonTools.thread.Executor — класс пула потоков. Вызов статического метода execute() запускает поток в общем пуле потоков. Если требуется настроить размер пула или независимый контроль, можно использовать newExecutor() для создания пула. excAsync() выполняет асинхронный метод.

• com.baijob.commonTools.thread.SyncQueue — блокирующая очередь, упрощающая использование BlockingQueue из JDK.