Интерфейс 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, которые используют условные обозначения идентификации столбцов.