001 /* 002 * Created on Mar 31, 2008 003 * 004 * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except 005 * in compliance with the License. You may obtain a copy of the License at 006 * 007 * http://www.apache.org/licenses/LICENSE-2.0 008 * 009 * Unless required by applicable law or agreed to in writing, software distributed under the License 010 * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express 011 * or implied. See the License for the specific language governing permissions and limitations under 012 * the License. 013 * 014 * Copyright @2008-2009 the original author or authors. 015 */ 016 package org.fest.assertions; 017 018 import java.util.*; 019 020 /** 021 * Understands utility methods related to <code>{@link Collections}</code>. 022 * 023 * @author Alex Ruiz 024 */ 025 public final class Collections { 026 027 /** 028 * Attempts to find the given objects in the given <code>{@link Collection}</code>, returning the ones that were not 029 * found. 030 * @param target the given <code>Collection</code>. 031 * @param objects the elements to find in the given <code>Collection</code>. 032 * @return the elements that were not found in the given <code>Collection</code>. 033 */ 034 public static Collection<Object> notFound(Collection<?> target, Object...objects) { 035 List<Object> notFound = new ArrayList<Object>(); 036 for (Object o : objects) if (!target.contains(o)) notFound.add(o); 037 return notFound; 038 } 039 040 /** 041 * Attempts to find the given objects in the given <code>{@link Collection}</code>, returning the ones that were 042 * found. 043 * @param target the given <code>Collection</code>. 044 * @param objects the elements to find in the given <code>Collection</code>. 045 * @return the elements that were found in the given <code>Collection</code>. 046 */ 047 public static Collection<Object> found(Collection<?> target, Object...objects) { 048 List<Object> found = new ArrayList<Object>(); 049 for (Object o : objects) if (target.contains(o)) found.add(o); 050 return found; 051 } 052 053 private Collections() {} 054 }