Фреймворк для инструментации Java

Использование

• Скачайте с страницы релизов.

• Добавьте аргумент -javaagent:/absolute/path/to/ja-netfilter.jar (замените на свой фактический путь):

  • добавьте в качестве аргумента команды java. Например: java -javaagent:/absolute/path/to/ja-netfilter.jar -jar executable_jar_file.jar.
  • некоторые приложения поддерживают файл параметров JVM, вы можете добавить его как строку файла параметров JVM.
  • ВНИМАНИЕ: НЕ добавляйте лишние пробельные символы!

• или выполните команду java -jar /path/to/ja-netfilter.jar, чтобы использовать режим присоединения.

• для Java 17 необходимо добавить как минимум следующие параметры JVM:

  --add-opens=java.base/jdk.internal.org.objectweb.asm=ALL-UNNAMED
  --add-opens=java.base/jdk.internal.org.objectweb.asm.tree=ALL-UNNAMED

• отредактируйте файлы конфигурации плагина: файл ${lower plugin name}.conf в каталоге config, где находится ja-netfilter.jar.

• каталоги config, logs и plugins можно указать через аргументы javaagent.

  • например: -javaagent:/path/to/ja-netfilter.jar=appName, ваши каталоги конфигурации, журналов и плагинов будут config-appname, logs-appname и plugins-appname.
  • если аргументы javaagent отсутствуют, по умолчанию используются config, logs и plugins.
  • этот механизм позволит избежать лишних и раздутых каталогов config, logs и plugins.

• запустите приложение Java и наслаждайтесь~

Формат файла конфигурации

[ABC]
# для указанного имени раздела

# например
[URL]
EQUAL,https://someurl

[DNS]
EQUAL,somedomain

# EQUAL       Использовать `equals` для сравнения
# EQUAL_IC     Использовать `equals` для сравнения, игнорировать регистр
# KEYWORD     Использовать `contains` для сравнения
# KEYWORD_IC  Использовать `contains` для сравнения, игнорировать регистр
# PREFIX      Использовать `startsWith` для сравнения
# PREFIX_IC   Использовать `startsWith` для сравнения, игнорировать регистр
# SUFFIX      Использовать `endsWith` для сравнения
# SUFFIX_IC   Использовать `endsWith` для сравнения, игнорировать регистр
# REGEXP      Использовать регулярные выражения для сопоставления

Отладочная информация

• ja-netfilter по умолчанию не выводит отладочную информацию.
• добавьте переменную среды JANF_DEBUG=1 (уровень журнала) и включите её.
• или добавьте системное свойство -Djanf.debug=1 (уровень журнала), чтобы включить его.
• уровень журнала: NONE=0, DEBUG=1, INFO=2, WARN=3, ERROR=4

Вывод отладочной информации

• по умолчанию ja-netfilter выводит отладочную информацию на консоль.
• добавьте переменную окружения JANF_OUTPUT=value и измените средство вывода.
• или добавьте системное свойство -Djanf.output=value, чтобы изменить средство вывода.
• значение средства вывода: [NONE=0, CONSOLE=1, FILE=2, CONSOLE+FILE=3, WITH_PID=4].
• например: console + file + имя файла pid = 1 + 2 + 4 = 7, поэтому -Djanf.output=7

Система плагинов

• Для разработчиков:

  • просмотрите проект-шаблон, написанный для системы плагинов.
  • скомпилируйте свой плагин и опубликуйте его.
  • просто используйте своё воображение~

• Для пользователей:

  • скачайте файл jar плагина.
  • поместите его в подкаталог с именем plugins, где находится файл ja-netfilter.jar.
  • наслаждайтесь новыми возможностями, которые предоставляет плагин.
  • если суффикс файла .disabled.jar, плагин будет отключён.