Класс SettingControl

public abstract class SettingControl extends Object

Базовый класс для расширения при создании элементов управления настройками.

Следующий пример демонстрирует простое реализацию элемента управления настройками для регулярных выражений:

 final class RegExpControl extends SettingControl {
   private Pattern pattern = Pattern.compile(".*");

   @Override
   public void setValue(String value) {
     this.pattern = Pattern.compile(value);
   }

   @Override
   public String combine(Set<String> values) {
     return String.join("|", values);
   }

   @Override
   public String getValue() {
     return pattern.toString();
   }

   public boolean matches(String s) {
     return pattern.matcher(s).find();
   }
 }
 

Методы setValue(String), getValue() и combine(Set<String>) вызываются при изменении значения настройки, что обычно происходит при запуске или остановке записи. Метод combine(Set<String>) вызывается для определения значения, используемого при одновременном выполнении нескольких записей.

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

Чтобы использовать элемент управления настройками с событием, добавьте метод, возвращающий значение boolean и принимающий элемент управления настройками в качестве параметра. Отметьте метод аннотацией @SettingDefinition. По умолчанию имя метода используется в качестве имени настройки, но имя можно явно задать с помощью аннотации @Name. Если метод возвращает true, событие будет подтверждено.

Рекомендуется, чтобы метод setValue(String) обновлял эффективную структуру данных, которую можно быстро проверить при подтверждении события.

Следующий пример демонстрирует создание события, использующего фильтр регулярных выражений, определенный выше.

 abstract class HTTPRequest extends Event {
   @Label("Request URI")
   protected String uri;

   @Label("Servlet URI Filter")
   @SettingDefinition
   protected boolean uriFilter(RegExpControl regExp) {
     return regExp.matches(uri);
   }
 }

 @Label("HTTP Get Request")
 class HTTPGetRequest extends HTTPRequest {
 }

 @Label("HTTP Post Request")
 class HTTPPostRequest extends HTTPRequest {
 }

 class ExampleServlet extends HttpServlet {
   protected void doGet(HttpServletRequest req, HttpServletResponse resp) {
     HTTPGetRequest request = new HTTPGetRequest();
     request.begin();
     request.uri = req.getRequestURI();
     ...
     request.commit();
   }

   protected void doPost(HttpServletRequest req, HttpServletResponse resp) {
     HTTPPostRequest request = new HTTPPostRequest();
     request.begin();
     request.uri = req.getRequestURI();
     ...
     request.commit();
   }
 }
 

Следующий пример показывает, как событие можно отфильтровать, присвоив настройке "uriFilter" заданные регулярные выражения.

 Recording r = new Recording();
 r.enable("HTTPGetRequest").with("uriFilter", "https://www.example.com/list/.*");
 r.enable("HTTPPostRequest").with("uriFilter", "https://www.example.com/login/.*");
 r.start();