1/*
2 * reserved comment block
3 * DO NOT REMOVE OR ALTER!
4 */
5/**
6 * Licensed to the Apache Software Foundation (ASF) under one
7 * or more contributor license agreements. See the NOTICE file
8 * distributed with this work for additional information
9 * regarding copyright ownership. The ASF licenses this file
10 * to you under the Apache License, Version 2.0 (the
11 * "License"); you may not use this file except in compliance
12 * with the License. You may obtain a copy of the License at
13 *
14 * http://www.apache.org/licenses/LICENSE-2.0
15 *
16 * Unless required by applicable law or agreed to in writing,
17 * software distributed under the License is distributed on an
18 * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
19 * KIND, either express or implied. See the License for the
20 * specific language governing permissions and limitations
21 * under the License.
22 */
23/*
24 * Copyright (c) 2005, 2013, Oracle and/or its affiliates. All rights reserved.
25 */
26/*
27 * $Id$
28 */
29package com.sun.org.apache.xml.internal.security.signature.reference;
30
31import java.util.Iterator;
32
33import org.w3c.dom.Node;
34
35/**
36 * An abstract representation of a <code>ReferenceData</code> type containing a node-set.
37 */
38public interface ReferenceNodeSetData extends ReferenceData {
39
40    /**
41     * Returns a read-only iterator over the nodes contained in this
42     * <code>NodeSetData</code> in
43     * <a href="http://www.w3.org/TR/1999/REC-xpath-19991116#dt-document-order">
44     * document order</a>. Attempts to modify the returned iterator
45     * via the <code>remove</code> method throw
46     * <code>UnsupportedOperationException</code>.
47     *
48     * @return an <code>Iterator</code> over the nodes in this
49     *    <code>NodeSetData</code> in document order
50     */
51    Iterator<Node> iterator();
52
53}
54