Project Report: fawkez

Packagesummary org.jcoderz.commons.util

org.jcoderz.commons.util.EmptyIterator

LineHitsNoteSource
1  /*
2   * $Id: EmptyIterator.java 1011 2008-06-16 17:57:36Z amandel $
3   *
4   * Copyright 2006, The jCoderZ.org Project. All rights reserved.
5   *
6   * Redistribution and use in source and binary forms, with or without
7   * modification, are permitted provided that the following conditions are
8   * met:
9   *
10   *    * Redistributions of source code must retain the above copyright
11   *      notice, this list of conditions and the following disclaimer.
12   *    * Redistributions in binary form must reproduce the above
13   *      copyright notice, this list of conditions and the following
14   *      disclaimer in the documentation and/or other materials
15   *      provided with the distribution.
16   *    * Neither the name of the jCoderZ.org Project nor the names of
17   *      its contributors may be used to endorse or promote products
18   *      derived from this software without specific prior written
19   *      permission.
20   *
21   * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS "AS IS" AND
22   * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
23   * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
24   * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS AND CONTRIBUTORS
25   * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
26   * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
27   * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
28   * BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
29   * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
30   * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
31   * ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
32   */
33  package org.jcoderz.commons.util;
34  
35  import java.util.Iterator;
36  import java.util.NoSuchElementException;
37  
38  /**
39   * An empty iterator that is just empty.
40   *
41   * @author Andreas Mandel
42   */
43  public final class EmptyIterator
44        implements Iterator
45  {
46     /** The constant no state EmptyIterator. */
470    public static final Iterator EMPTY_ITERATOR = new EmptyIterator();
48  
49     /**
50      * No instances use the EMPTY_ITERATOR constant.
51      */
52     private EmptyIterator ()
530    {
54        // nothing to do.
550    }
56  
57     /**
58      * {@inheritDoc}
59      * @throws IllegalStateException always.
60      */
61     public void remove ()
62         throws IllegalStateException
63     {
640       throw new IllegalStateException();
65     }
66  
67     /**
68      * {@inheritDoc}
69      * Always returns false.
70      */
71     public boolean hasNext ()
72     {
730       return false;
74     }
75  
76     /**
77      * {@inheritDoc}
78      * @throws NoSuchElementException always.
79      */
80     public Object next ()
81         throws NoSuchElementException
82     {
830       throw new NoSuchElementException();
84     }
85  
86  }

Findings in this File