Интерфейс Predicate

public interface Predicate

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

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

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

2.0 Рекомендации по реализации

Чтобы задать предикат для FilteredRowSet, необходимо реализовать этот интерфейс. В настоящее время в спецификации JDBC RowSet Implementations (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, использующих оба способа идентификации столбцов.