* 用该方法来代替 { @code new LinkedList<E>()} 方式获得新的 { @code java.util.Queue} 的实例对象。
*
* @param <E> { @code Queue<E>} 中保存的对象。
* @return 返回 { @code java.util.Queue<E>} 关于 { @code java.util.LinkedList<E>} 实现的新实例。
*/
public static <E> Queue<E> getQueue() {
return new LinkedList<E>();
}
/**
* 合并两个有相同元素类型的 {@code java.util.Set}。
* <ul>
* <li>{@code setA == null && setB == null} --> 返回 {@link #getHashSet()}。</li>
* <li>{@code setA != null && setB == null} --> 返回 {@code setA}。</li>
* <li>{@code setA == null && setB != null} --> 返回 {@code setB}。</li>
* <li>{@code setA != null && setB != null} --> 返回 {@code setA} 和 {@code setB} 的并集。
* </li>
* </ul>
*
* @param <T> {@code Set} 中保存的对象。
* @param setA 第一个 {@code Set}。
* @param setB 第二个 {@code Set}。
* @return 返回 {@code setA} 和 {@code setB} 的并集。
*/
public static <T> Set<T> unionHashSet(Set<T> setA, Set<T> setB) {
boolean isEmptySetA = ObjectUtils.isEmpty(setA);
boolean isEmptySetB = ObjectUtils.isEmpty(setB);
if (isEmptySetA && isEmptySetB)
return getHashSet();
if (isEmptySetA && !isEmptySetB)
return setB;
if (!isEmptySetA && isEmptySetB)
return setA;
Set<T> result = getHashSet(setA);
result.addAll(setB);
return result;
}
/**
* 取两个有相同元素类型的 {@code java.util.Set} 的交集,即公共部份的新的 {@code java.util.Set}。
* <ul>
* <li>{@code setA == null && setB == null} --> 返回 {@code null}。</li>
* <li>{@code setA != null && setB == null} --> 返回 {@code null}。</li>
* <li>{@code setA == null && setB != null} --> 返回 {@code null}。</li>
* <li>{@code setA != null && setB != null} --> 返回 {@code setA} 和 {@code setB} 的交集。
* </li>
* </ul>
*
* @param <T> {@code Set} 中保存的对象。
* @param setA 第一个 {@code Set}。
* @param setB 第二个 {@code Set}。
* @return 返回 {@code setA} 和 {@code setB} 的交集。
*/
public static <T> Set<T> intersectHashSet(Set<T> setA, Set<T> setB) {
if (ObjectUtils.isEmpty(setA) || ObjectUtils.isEmpty(setB))
return null;
Set<T> result = getHashSet(setA);
result.retainAll(setB);
return result;
}
/**
* 移除 {@code setA} 中那些包含在 {@code setB} 中的元素。<br />
* 此方法不会修改 {@code setA},只是复制一份作相应操作,返回的是全新的 {@code Set} 对象。
* <ul>
* <li>{@code setA == null} --> 返回 {@code null}。</li>
* <li>{@code setB == null} --> 返回 {@code setA}。</li>
* <li>{@code setA != null && setB != null} --> 返回 {@code setA} 和 {@code setB}
* 的不对称差集。</li>
* </ul>
*
* @param <T> {@code Set} 中保存的对象。
* @param setA 第一个 {@code Set}。
* @param setB 第二个 {@code Set}。
* @return 返回 {@code setA} 和 {@code setB} 的不对称差集。
*/
public static <T> Set<T> differenceHashSet(Set<T> setA, Set<T> setB) {
if (ObjectUtils.isEmpty(setA))
return null;
if (ObjectUtils.isEmpty(setB))
return setA;
Set<T> result = getHashSet(setA);
result.removeAll(setB);
return result;
}
/**
* 取两个有相同元素类型的 {@code java.util.Set} 的补集。
*
* @param <T> {@code Set} 中保存的对象。
* @param setA 第一个 {@code Set}。
* @param setB 第二个 {@code Set}。
* @return 返回 {@code setA} 和 {@code setB} 的补集。
*/
public static <T> Set<T> complementHashSet(Set<T> setA, Set<T> setB) {
return differenceHashSet(unionHashSet(setA, setB), intersectHashSet(setA, setB));
}
}