1 /* 2 * Copyright 2006 Sun Microsystems, Inc. All rights reserved. 3 */ 4 /* 5 * $Id: NodeSetData.java,v 1.5 2005/05/10 15:47:42 mullan Exp $ 6 */ 7 package javax.xml.crypto; 8 9 import java.util.Iterator; 10 11 /** 12 * An abstract representation of a <code>Data</code> type containing a 13 * node-set. The type (class) and ordering of the nodes contained in the set 14 * are not defined by this class; instead that behavior should be 15 * defined by <code>NodeSetData</code> subclasses. 16 * 17 * @author Sean Mullan 18 * @author JSR 105 Expert Group 19 * @since 1.6 20 */ 21 public interface NodeSetData extends Data { 22 23 /** 24 * Returns a read-only iterator over the nodes contained in this 25 * <code>NodeSetData</code> in 26 * <a HREF="http://www.w3.org/TR/1999/REC-xpath-19991116#dt-document-order"> 27 * document order</a>. Attempts to modify the returned iterator 28 * via the <code>remove</code> method throw 29 * <code>UnsupportedOperationException</code>. 30 * 31 * @return an <code>Iterator</code> over the nodes in this 32 * <code>NodeSetData</code> in document order 33 */ 34 Iterator iterator(); 35 } 36