模块  java.desktop
软件包  javax.swing

Class RowFilter<M,​I>

  • 参数类型
    M - 模型的类型; 例如PersonModel
    I - 标识符的类型; 当使用TableRowSorter这将是Integer 
    public abstract class RowFilter<M,​I>extends Object
    RowFilter用于过滤掉模型中的条目，以便它们不会显示在视图中。 例如，与RowFilter关联的JTable可能仅允许包含具有特定字符串的列的行。 条目的含义取决于组件类型。 例如，当过滤器与JTable相关联时，条目对应于一行; 当与JTree关联时，条目对应于节点。

    子类必须覆盖include方法以指示是否应在视图中显示该条目。 Entry参数可用于获取该条目中每个列中的值。 以下示例显示了一个include方法，该方法仅允许包含一个或多个以字符串“a”开头的值的条目： 

      RowFilter<Object,Object> startsWithAFilter = new RowFilter<Object,Object>() {   public boolean include(Entry<? extends Object, ? extends Object> entry) {     for (int i = entry.getValueCount() - 1; i >= 0; i--) {       if (entry.getStringValue(i).startsWith("a")) {         // The value starts with "a", include it         return true;       }     }     // None of the columns start with "a"; return false so that this     // entry is not shown     return false;   } };
    RowFilter有两个正式的类型参数，允许您为特定模型创建RowFilter 。 例如，以下假定包装类型为Person对象的特定模型。 仅Person年龄超过20岁的Person ： 
      RowFilter<PersonModel,Integer> ageFilter = new RowFilter<PersonModel,Integer>() {   public boolean include(Entry<? extends PersonModel, ? extends Integer> entry) {     PersonModel personModel = entry.getModel();     Person person = personModel.getPerson(entry.getIdentifier());     if (person.getAge() > 20) {       // Returning true indicates this row should be shown.       return true;     }     // Age is <= 20, don't show it.     return false;   } }; PersonModel model = createPersonModel(); TableRowSorter<PersonModel> sorter = new TableRowSorter<PersonModel>(model); sorter.setRowFilter(ageFilter);
    从以下版本开始：
    1.6
    另请参见：
    TableRowSorter

    • 构造方法详细信息

      • RowFilter

        public RowFilter()

    • 方法详细信息

      • regexFilter

        public static <M,​I> RowFilter<M,​I> regexFilter​(String regex,                                                           int... indices)
        返回RowFilter ，它使用正则表达式来确定要包含的条目。 仅包含具有至少一个匹配值的条目。 例如，以下内容创建了一个RowFilter ，其中包含至少一个以“a”开头的值的条目： 
          RowFilter.regexFilter("^a");

        返回的过滤器使用Matcher.find()来测试是否包含。 要测试完全匹配，请使用字符'^'和'$'分别匹配字符串的开头和结尾。 例如，“^ foo $”仅包括其字符串恰好为“foo”的行，而不包括例如“food”。 有关受支持的正则表达式构造的完整说明，请参见Pattern 。

        参数类型
        M - RowFilter适用的型号类型
        I - 传递给 RowFilter的标识符的类型
        参数
        regex - 要过滤的正则表达式
        indices - 要检查的值的索引。 如果未提供，则评估所有值
        结果
        a RowFilter实现指定的标准
        异常
        NullPointerException - 如果 regex是 null
        IllegalArgumentException - 如果 indices中的任何一个<0
        PatternSyntaxException - 如果 regex不是有效的正则表达式。
        另请参见：
        Pattern

      • dateFilter

        public static <M,​I> RowFilter<M,​I> dateFilter​(RowFilter.ComparisonType type,                                                          Date date,                                                          int... indices)
        返回RowFilter ，其中包含至少一个符合指定条件的Date值的条目。 例如，以下RowFilter仅包含当前日期之后至少有一个日期值的条目： 
          RowFilter.dateFilter(ComparisonType.AFTER, new Date());
        参数类型
        M - RowFilter适用的型号类型
        I - 传递给 RowFilter的标识符的类型
        参数
        type - 要执行的比较类型
        date - 要比较的日期
        indices - 要检查的值的索引。 如果未提供，则评估所有值
        结果
        a RowFilter实现指定的标准
        异常
        NullPointerException - 如果 date是 null
        IllegalArgumentException - 如果 indices中的任何一个<0或 type是 null
        另请参见：
        Calendar ， Date

      • numberFilter

        public static <M,​I> RowFilter<M,​I> numberFilter​(RowFilter.ComparisonType type,                                                            Number number,                                                            int... indices)
        返回RowFilter ，其中包含至少有一个Number值满足指定条件的条目。 例如，以下过滤器仅包含至少有一个数值等于10的条目： 
          RowFilter.numberFilter(ComparisonType.EQUAL, 10);
        参数类型
        M - RowFilter适用的模型类型
        I - 传递给 RowFilter的标识符的类型
        参数
        type - 要执行的比较类型
        number - 要比较的 Number值
        indices - 要检查的值的索引。 如果未提供，则评估所有值
        结果
        a RowFilter实施指定的标准
        异常
        IllegalArgumentException - 如果 indices中的任何一个< type是 null或 number是 null

      • orFilter

        public static <M,​I> RowFilter<M,​I> orFilter​(Iterable<? extends RowFilter<? super M,​? super I>> filters)
        如果任何提供的过滤器包含条目，则返回包含条目的RowFilter 。

        以下示例创建一个RowFilter ，其中包含任何包含字符串“foo”或字符串“bar”的条目： 

          List<RowFilter<Object,Object>> filters = new ArrayList<RowFilter<Object,Object>>(2);   filters.add(RowFilter.regexFilter("foo"));   filters.add(RowFilter.regexFilter("bar"));   RowFilter<Object,Object> fooBarFilter = RowFilter.orFilter(filters);
        参数类型
        M - RowFilter适用的型号类型
        I - 传递给 RowFilter的标识符的类型
        参数
        filters - 要测试的 RowFilter s
        结果
        a RowFilter实施指定的标准
        异常
        IllegalArgumentException - 如果任何过滤器是 null
        NullPointerException - 如果 filters为空
        另请参见：
        Arrays.asList(T...)

      • andFilter

        public static <M,​I> RowFilter<M,​I> andFilter​(Iterable<? extends RowFilter<? super M,​? super I>> filters)
        如果所有提供的过滤器都包含条目，则返回包含条目的RowFilter 。

        以下示例创建一个RowFilter ，其中包含包含字符串“foo”和字符串“bar”的所有条目： 

          List<RowFilter<Object,Object>> filters = new ArrayList<RowFilter<Object,Object>>(2);   filters.add(RowFilter.regexFilter("foo"));   filters.add(RowFilter.regexFilter("bar"));   RowFilter<Object,Object> fooBarFilter = RowFilter.andFilter(filters);
        参数类型
        M - RowFilter适用的型号类型
        I - 传递给 RowFilter的标识符的类型
        参数
        filters - 要测试的 RowFilter
        结果
        a RowFilter实现指定的标准
        异常
        IllegalArgumentException - 如果任何过滤器是 null
        NullPointerException - 如果 filters为空
        另请参见：
        Arrays.asList(T...)

      • notFilter

        public static <M,​I> RowFilter<M,​I> notFilter​(RowFilter<M,​I> filter)
        如果提供的过滤器不包含该条目，则返回包含条目的 RowFilter 。
        参数类型
        M - RowFilter适用的模型类型
        I - 传递给 RowFilter的标识符的类型
        参数
        filter - RowFilter否定
        结果
        a RowFilter实现指定的标准
        异常
        IllegalArgumentException - 如果 filter是 null

      • include

        public abstract boolean include​(RowFilter.Entry<? extends M,​? extends I> entry)
        如果应显示指定的条目，则返回true; 如果应隐藏条目，则返回false。

        entry参数仅在调用期间有效。 在调用返回后使用entry导致未定义的行为。

        参数
        entry - 非 null对象，它包装模型中的基础对象
        结果
        true if the entry should be shown