com.feilong.core.util.predicate.BeanPredicate Maven / Gradle / Ivy

Show more of this group Show more artifacts with this name
Show all versions of feilong Show documentation

feilong is a suite of core and expanded libraries that include utility classes, http, excel,cvs, io classes, and much much more.

There is a newer version: 4.0.8

Show newest version

/*
 * Copyright (C) 2008 feilong
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *         http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package com.feilong.core.util.predicate;

import org.apache.commons.collections4.Predicate;

import com.feilong.core.Validate;
import com.feilong.core.bean.PropertyUtil;

/**
 * 调用 {@link PropertyUtil#getProperty(Object, String)} 匹配属性值.
 *
 * @author feilong
 * @param 
 *            the generic type
 * @see "org.apache.commons.beanutils.BeanPredicate"
 * @see "org.apache.commons.beanutils.BeanPropertyValueEqualsPredicate"
 * @see com.feilong.lib.collection4.functors.ComparatorPredicate
 * @since 1.8.0
 */
//XXX 如果{@link org.apache.commons.beanutils.BeanPredicate}支持泛型且支持 commons-collections4之后,那么这么类将会废弃
public class BeanPredicate implements Predicate{

    /**
     * 泛型T对象指定的属性名称,Possibly indexed and/or nested name of the property to be modified,参见
     * propertyName.
     */
    private final String    propertyName;

    /** The value predicate. */
    @SuppressWarnings("rawtypes")
    private final Predicate valuePredicate;

    //---------------------------------------------------------------

    /**
     * The Constructor.
     * 
     * 
     * 如果 propertyName 是null,抛出 {@link NullPointerException}

     * 如果 propertyName 是blank,抛出 {@link IllegalArgumentException}

     * 如果 valuePredicate 是null,抛出 {@link NullPointerException}

     * 
     *
     * @param propertyName
     *            泛型T对象指定的属性名称,Possibly indexed and/or nested name of the property to be modified,参见
     *            propertyName
     * @param valuePredicate
     *            the predicate
     */
    public BeanPredicate(String propertyName, @SuppressWarnings("rawtypes") Predicate valuePredicate){
        Validate.notBlank(propertyName, "propertyName can't be blank!");
        Validate.notNull(valuePredicate, "predicate can't be null!");

        this.propertyName = propertyName;
        this.valuePredicate = valuePredicate;
    }

    //---------------------------------------------------------------

    /*
     * (non-Javadoc)
     * 
     * @see org.apache.commons.collections4.Predicate#evaluate(java.lang.Object)
     */
    @SuppressWarnings("unchecked")
    @Override
    public boolean evaluate(T object){
        Object currentPropertyValue = PropertyUtil.getProperty(object, propertyName);
        return valuePredicate.evaluate(currentPropertyValue);
    }
}