com.feilong.core.util.comparator.ComparatorUtil Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of feilong Show documentation
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.
/*
* 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.comparator;
import java.util.Comparator;
import java.util.List;
import com.feilong.core.Validate;
import com.feilong.lib.collection4.comparators.FixedOrderComparator;
import com.feilong.lib.collection4.comparators.FixedOrderComparator.UnknownObjectBehavior;
/**
* {@link Comparator} 工具类.
*
* @author feilong
* @see "org.apache.commons.collections4.ComparatorUtils"
* @see FixedOrderComparator
* @since 1.14.3
*/
public final class ComparatorUtil{
/** Don't let anyone instantiate this class. */
private ComparatorUtil(){
//AssertionError不是必须的. 但它可以避免不小心在类的内部调用构造器. 保证该类在任何情况下都不会被实例化.
//see 《Effective Java》 2nd
throw new AssertionError("No " + getClass().getName() + " instances for you!");
}
//---------------------------------------------------------------
/**
* Builds the.
*
*
* 默认使用的是 {@link UnknownObjectBehavior#AFTER} ,不在指定固定顺序的元素将排在后面
*
*
* @param
* the value type
* @param list
* the property values
* @return 如果 list
是null,抛出 {@link NullPointerException}
*/
public static FixedOrderComparator buildFixedOrderComparator(List list){
return buildFixedOrderComparator(list, UnknownObjectBehavior.AFTER);
}
/**
* Builds the.
*
* @param
* the value type
* @param list
* the property values
* @param unknownObjectBehavior
* the unknown object behavior
* @return 如果 list
是null,抛出 {@link NullPointerException}
* 如果 unknownObjectBehavior
是null,抛出 {@link NullPointerException}
*/
public static FixedOrderComparator buildFixedOrderComparator(List list,UnknownObjectBehavior unknownObjectBehavior){
Validate.notNull(list, "propertyValues can't be null!");
Validate.notNull(unknownObjectBehavior, "unknownObjectBehavior can't be null!");
//---------------------------------------------------------------
FixedOrderComparator fixedOrderComparator = new FixedOrderComparator<>(list);
fixedOrderComparator.setUnknownObjectBehavior(unknownObjectBehavior);
return fixedOrderComparator;
}
}