001    /*
002    // $Id: NamedList.java 482 2012-01-05 23:27:27Z jhyde $
003    //
004    // Licensed to Julian Hyde under one or more contributor license
005    // agreements. See the NOTICE file distributed with this work for
006    // additional information regarding copyright ownership.
007    //
008    // Julian Hyde licenses this file to you under the Apache License,
009    // Version 2.0 (the "License"); you may not use this file except in
010    // compliance with the License. You may obtain a copy of the License at:
011    //
012    // http://www.apache.org/licenses/LICENSE-2.0
013    //
014    // Unless required by applicable law or agreed to in writing, software
015    // distributed under the License is distributed on an "AS IS" BASIS,
016    // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
017    // See the License for the specific language governing permissions and
018    // limitations under the License.
019    */
020    package org.olap4j.metadata;
021    
022    import java.util.List;
023    
024    /**
025     * Extension to {@link java.util.List} which allows access to members of the
026     * list by name as well as by ordinal.
027     *
028     * @author jhyde
029     * @version $Id: NamedList.java 482 2012-01-05 23:27:27Z jhyde $
030     * @since Aug 22, 2006
031     */
032    public interface NamedList<E> extends List<E> {
033        /**
034         * Retrieves a member by name.
035         *
036         * @param name name of the element to return
037         *
038         * @see #get(int)
039         *
040         * @return the element of the list with the specified name, or null if
041         * there is no such element
042         */
043        E get(String name);
044    
045        /**
046         * Returns the position where a member of a given name is found, or -1
047         * if the member is not present.
048         *
049         * @param name name of the element to return
050         *
051         * @return the index of element of the list with the specified name, or -1
052         * if there is no such element
053         *
054         * @see #indexOf(Object)
055         */
056        int indexOfName(String name);
057    }
058    
059    // End NamedList.java