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, 2008, Oracle and/or its affiliates. All rights reserved.
  25  */
  26 /*
  27  * $Id$
  28  */
  29 package com.sun.org.apache.xml.internal.security.signature.reference;
  30 
  31 import java.util.Iterator;
  32 
  33 import org.w3c.dom.Node;
  34 
  35 /**
  36  * An abstract representation of a <code>ReferenceData</code> type containing a node-set.
  37  */
  38 public 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 }