Revision 35115 branches/dal_time_support/libraries/libFMap_dal/src/org/gvsig/fmap/dal/feature/spi/FeatureSetProvider.java

View differences:

FeatureSetProvider.java
50 50

  
51 51
	boolean isEmpty() throws DataException;
52 52

  
53
    /**
54
     * Returns an iterator over the elements in this set, in the order
55
     * (if any) defined when the collection was obtained.
56
     * 
57
     * <p>
58
     * Fast in this case means that each of the elements returned may be a
59
     * reused or pooled object instance, so don't use it to be stored in any
60
     * way.
61
     * </p>
62
     * <p>
63
     * If you need to store one of the {@link FeatureProvider} of the iterator,
64
     * use the {@link FeatureProvider#getCopy()} to create a clone of the
65
     * object.
66
     * </p>
67
     * 
68
     * @return an iterator of the elements in this collection (in proper
69
     *         sequence).
70
     * 
71
     * @throws DataException
72
     *             if there is an error getting the iterator
73
     * 
74
     * @deprecated use {@link #fastIterator()} instead
75
     */
53 76
	DisposableIterator iterator() throws DataException;
54 77

  
78
    /**
79
     * Returns an iterator over the elements in this set, in the order
80
     * (if any) defined when the collection was obtained.
81
     * 
82
     * <p>
83
     * Fast in this case means that each of the elements returned may be a
84
     * reused or pooled object instance, so don't use it to be stored in any
85
     * way.
86
     * </p>
87
     * <p>
88
     * If you need to store one of the {@link FeatureProvider} of the iterator,
89
     * use the {@link FeatureProvider#getCopy()} to create a clone of the
90
     * object.
91
     * </p>
92
     * 
93
     * @param index
94
     *            index of first element to be returned from the iterator (by a
95
     *            call to the <tt>next</tt> method).
96
     * @return an iterator of the elements in this collection (in proper
97
     *         sequence).
98
     * 
99
     * @throws DataException
100
     *             if there is an error getting the iterator
101
     * 
102
     * @deprecated use {@link #fastIterator()} instead
103
     */
55 104
	DisposableIterator iterator(long index) throws DataException;
56 105

  
106
    /**
107
     * Returns an iterator over the elements in this set, in the order
108
     * (if any) defined when the collection was obtained.
109
     * 
110
     * @see #fastIterator()
111
     * @see #fastIterator(long)
112
     * 
113
     * @return an iterator of the elements in this collection (in proper
114
     *         sequence).
115
     * 
116
     * @throws DataException
117
     *             if there is an error getting the iterator
118
     */
119
    DisposableIterator fastIterator() throws DataException;
120

  
121
    /**
122
     * Returns an iterator over the elements in this set, in the order
123
     * (if any) defined when the collection was obtained.
124
     * 
125
     * @see #fastIterator()
126
     * @see #fastIterator(long)
127
     * 
128
     * @param index
129
     *            index of first element to be returned from the iterator (by a
130
     *            call to the <tt>next</tt> method).
131
     * @return an iterator of the elements in this collection (in proper
132
     *         sequence).
133
     * 
134
     * @throws DataException
135
     *             if there is an error getting the iterator
136
     */
57 137
	DisposableIterator fastIterator(long index) throws DataException;
58 138

  
59
	DisposableIterator fastIterator() throws DataException;
60

  
61 139
}

Also available in: Unified diff