View Javadoc

1   /*
2    * EL4J, the Extension Library for the J2EE, adds incremental enhancements to
3    * the spring framework, http://el4j.sf.net
4    * Copyright (C) 2006 by ELCA Informatique SA, Av. de la Harpe 22-24,
5    * 1000 Lausanne, Switzerland, http://www.elca.ch
6    *
7    * EL4J is published under the GNU Lesser General Public License (LGPL)
8    * Version 2.1. See http://www.gnu.org/licenses/
9    *
10   * This program is distributed in the hope that it will be useful,
11   * but WITHOUT ANY WARRANTY; without even the implied warranty of
12   * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13   * GNU Lesser General Public License for more details.
14   *
15   * For alternative licensing, please contact info@elca.ch
16   */
17  package ch.elca.el4j.util.collections;
18  
19  import java.util.List;
20  
21  import ch.elca.el4j.util.collections.helpers.Filter;
22  import ch.elca.el4j.util.collections.helpers.Function;
23  
24  /**
25   * A slightly extended Iterable.
26   *
27   * @param <T> the member type.
28   *
29   *
30   * @svnLink $Revision: 3875 $;$Date: 2009-08-04 14:35:53 +0200 (Di, 04. Aug 2009) $;$Author: swismer $;$URL: https://el4j.svn.sourceforge.net/svnroot/el4j/branches/el4j_3_1/el4j/framework/modules/core/src/main/java/ch/elca/el4j/util/collections/ExtendedList.java $
31   *
32   * @author Adrian Moos (AMS)
33   */
34  public interface ExtendedList<T> extends List<T> {
35  	/**
36  	 * @param c the element type for the new array
37  	 * @return an new array containing this list's contents
38  	 */
39  	T[] toArray(Class<T> c);
40  	
41  	/**
42  	 * Convenience method returning a filtered view on this collection.
43  	 * @param filter the filter deciding which elements are included
44  	 */
45  	FilteredList<T> filtered(Filter<? super T> filter);
46  	
47  	
48  	/**
49  	 * Convenience method returning a {@link TransformedList} view to this
50  	 * list.
51  	 * @param function the transformation function to apply to each element
52  	 * @return see above
53  	 */
54  	public <O> TransformedList<T, O> mapped(
55  		Function<? super T, O> function);
56  }