eu.stratosphere.nephele.util.UnmodifiableIterator Maven / Gradle / Ivy
/***********************************************************************************************************************
* Copyright (C) 2010-2013 by the Stratosphere project (http://stratosphere.eu)
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with
* the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
* an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
* specific language governing permissions and limitations under the License.
**********************************************************************************************************************/
package eu.stratosphere.nephele.util;
import java.util.Iterator;
/**
* An auxiliary implementation of an iterator which protects the underlying collection from being modified. As a result,
* calling the remove method on this iterator will result in an {@link UnsupportedOperationException}.
*
* This class is thread-safe.
*
* @param
* the type of the encapsulated iterator
*/
public final class UnmodifiableIterator implements Iterator {
/**
* The encapsulated iterator.
*/
private final Iterator encapsulatedIterator;
/**
* Constructs a new unmodifiable iterator.
*
* @param encapsulatedIterator
* the encapsulated iterator
*/
public UnmodifiableIterator(final Iterator encapsulatedIterator) {
this.encapsulatedIterator = encapsulatedIterator;
}
@Override
public boolean hasNext() {
return this.encapsulatedIterator.hasNext();
}
@Override
public T next() {
return this.encapsulatedIterator.next();
}
@Override
public void remove() {
throw new UnsupportedOperationException("Calling the remove method on this iterator is not allowed");
}
}