Интерфейс Predicate

public interface Predicate

Стандартный интерфейс, который предоставляет основу для всех FilteredRowSet объектов для описания их фильтров.

1.0 Общие сведения

Интерфейс Predicate — это стандартный интерфейс, который приложения могут реализовывать для определения фильтра, который они хотят применить к объекту FilteredRowSet. Объект FilteredRowSet потребляет реализации этого интерфейса и навязывает ограничения, определённые в реализации метода evaluate. Объект FilteredRowSet навязывает ограничения фильтра двунаправленно: он выводит только строки, которые соответствуют ограничениям фильтра; и наоборот, он вставляет, изменяет или обновляет только строки, которые соответствуют ограничениям фильтра.

2.0 Руководство по реализации

Для того, чтобы предоставить предикат для FilteredRowSet, необходимо реализовать этот интерфейс. В настоящее время реализации JDBC RowSet (JSR-114) не определяют никаких стандартных фильтров. Задавая стандартный способ и механизм для определения и развертывания различных фильтров с использованием как эталонных, так и поставщицких реализаций интерфейса FilteredRowSet, это позволяет создавать гибкие и ориентированные на приложения реализации Predicate.

Пример реализации выглядит примерно так:

    public class Range implements Predicate {

       private int[] lo;
       private int[] hi;
       private int[] idx;

       public Range(int[] lo, int[] hi, int[] idx) {
          this.lo = lo;
          this.hi = hi;
          this.idx = idx;
       }

      public boolean evaluate(RowSet rs) {

          // Check the present row determine if it lies
          // within the filtering criteria.

          for (int i = 0; i < idx.length; i++) {
             int value;
             try {
                 value = (Integer) rs.getObject(idx[i]);
             } catch (SQLException ex) {
                 Logger.getLogger(Range.class.getName()).log(Level.SEVERE, null, ex);
                 return false;
             }

             if (value < lo[i] && value > hi[i]) {
                 // outside of filter constraints
                 return false;
             }
         }
         // Within filter constraints
        return true;
      }
   }
 

Приведенный выше пример реализует простой предикат диапазона. Обратите внимание, что реализации должны, но не обязаны предоставлять String и конструкторы на основе целочисленных индексов, чтобы обеспечить поддержку приложений JDBC RowSet, которые используют оба соглашения об идентификации столбцов.