javax.sql.rowset

Interface Predicate

Inhaltsverzeichnis

  • public interface Predicate
    The standard interface that provides the framework for all FilteredRowSet objects to describe their filters.

    1.0 Background

    The Predicate interface is a standard interface that applications can implement to define the filter they wish to apply to a a FilteredRowSet object. A FilteredRowSet object consumes implementations of this interface and enforces the constraints defined in the implementation of the method evaluate. A FilteredRowSet object enforces the filter constraints in a bi-directional manner: It outputs only rows that are within the constraints of the filter; and conversely, it inserts, modifies, or updates only rows that are within the constraints of the filter.

    2.0 Implementation Guidelines

    In order to supply a predicate for the FilteredRowSet. this interface must be implemented. At this time, the JDBC RowSet Implementations (JSR-114) does not specify any standard filters definitions. By specifying a standard means and mechanism for a range of filters to be defined and deployed with both the reference and vendor implementations of the FilteredRowSet interface, this allows for a flexible and application motivated implementations of Predicate to emerge.

    A sample implementation would look something like this: 

     
    public class Range implements Predicate {

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

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

      public boolean evaluate(RowSet rs) {
          CachedRowSet crs = (CachedRowSet)rs;
          boolean bool1,bool2;

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

          for (int i = 0; i < idx.length; i++) {

              if ((rs.getObject(idx[i]) >= lo[i]) &&
                  (rs.getObject(idx[i]) >= hi[i]) {
                  bool1 = true; // within filter constraints
          } else {
            bool2 = true; // outside of filter constraints
          }
      }

      if (bool2) {
         return false;
      } else {
         return true;
      }
  }

    The example above implements a simple range predicate. Note, that implementations should but are not required to provider String and integer index based constructors to provide for JDBC RowSet Implementation applications that use both column identification conventions.

    • Method Summary

      Methods 
      Modifier and Type Method and Description
      boolean evaluate(Object value, int column)
      This method is called by a FilteredRowSet object to check whether the value lies between the filtering criterion (or criteria if multiple constraints exist) set using the setFilter() method.
      boolean evaluate(Object value, String columnName)
      This method is called by the FilteredRowSet object to check whether the value lies between the filtering criteria set using the setFilter method.
      boolean evaluate(RowSet rs)
      This method is typically called a FilteredRowSet object internal methods (not public) that control the RowSet object's cursor moving from row to the next.

      Erste Seite von API Java Inhaltsverzeichnis Haut

    • Method Detail

      • evaluate

        boolean evaluate(RowSet rs)
        This method is typically called a FilteredRowSet object internal methods (not public) that control the RowSet object's cursor moving from row to the next. In addition, if this internal method moves the cursor onto a row that has been deleted, the internal method will continue to ove the cursor until a valid row is found.
        Returns:
        true if there are more rows in the filter; false otherwise

      • evaluate

        boolean evaluate(Object value,
               int column)
                 throws SQLException
        This method is called by a FilteredRowSet object to check whether the value lies between the filtering criterion (or criteria if multiple constraints exist) set using the setFilter() method.

        The FilteredRowSet object will use this method internally while inserting new rows to a FilteredRowSet instance.

        Parameters:
        value - An Object value which needs to be checked, whether it can be part of this FilterRowSet object.
        column - a int object that must match the SQL index of a column in this RowSet object. This must have been passed to Predicate as one of the columns for filtering while initializing a Predicate
        Returns:
        true ifrow value lies within the filter; false otherwise
        Throws:
        SQLException - if the column is not part of filtering criteria

      • evaluate

        boolean evaluate(Object value,
               String columnName)
                 throws SQLException
        This method is called by the FilteredRowSet object to check whether the value lies between the filtering criteria set using the setFilter method.

        The FilteredRowSet object will use this method internally while inserting new rows to a FilteredRowSet instance.

        Parameters:
        value - An Object value which needs to be checked, whether it can be part of this FilterRowSet.
        columnName - a String object that must match the SQL name of a column in this RowSet, ignoring case. This must have been passed to Predicate as one of the columns for filtering while initializing a Predicate
        Returns:
        true if value lies within the filter; false otherwise
        Throws:
        SQLException - if the column is not part of filtering criteria

Deutsche Übersetzung

Sie haben gebeten, diese Seite auf Deutsch zu besuchen. Momentan ist nur die Oberfläche übersetzt, aber noch nicht der gesamte Inhalt.

Wenn Sie mir bei Übersetzungen helfen wollen, ist Ihr Beitrag willkommen. Alles, was Sie tun müssen, ist, sich auf der Website zu registrieren und mir eine Nachricht zu schicken, in der Sie gebeten werden, Sie der Gruppe der Übersetzer hinzuzufügen, die Ihnen die Möglichkeit gibt, die gewünschten Seiten zu übersetzen. Ein Link am Ende jeder übersetzten Seite zeigt an, dass Sie der Übersetzer sind und einen Link zu Ihrem Profil haben.

Vielen Dank im Voraus.

Dokument erstellt 11/06/2005, zuletzt geändert 04/03/2020
Quelle des gedruckten Dokuments:https://www.gaudry.be/de/java-api-rf-javax/sql/rowset/predicate.html

Die Infobro ist eine persönliche Seite, deren Inhalt in meiner alleinigen Verantwortung liegt. Der Text ist unter der CreativeCommons-Lizenz (BY-NC-SA) verfügbar. Weitere Informationen auf die Nutzungsbedingungen und dem Autor.

Referenzen

  1. Zeigen Sie - html-Dokument Sprache des Dokuments:fr Manuel PHP : https://docs.oracle.com

Diese Verweise und Links verweisen auf Dokumente, die während des Schreibens dieser Seite konsultiert wurden, oder die zusätzliche Informationen liefern können, aber die Autoren dieser Quellen können nicht für den Inhalt dieser Seite verantwortlich gemacht werden.
Der Autor Diese Website ist allein dafür verantwortlich, wie die verschiedenen Konzepte und Freiheiten, die mit den Nachschlagewerken gemacht werden, hier dargestellt werden. Denken Sie daran, dass Sie mehrere Quellinformationen austauschen müssen, um das Risiko von Fehlern zu reduzieren.

Inhaltsverzeichnis Haut