1 /* 2 * Copyright 2006 Sun Microsystems, Inc. All rights reserved. 3 */ 4 /* 5 * $Id: XMLValidateContext.java,v 1.8 2005/05/10 16:03:49 mullan Exp $ 6 */ 7 package javax.xml.crypto.dsig; 8 9 import javax.xml.crypto.XMLCryptoContext; 10 11 /** 12 * Contains context information for validating XML Signatures. This interface 13 * is primarily intended for type-safety. 14 * 15 * <p>Note that <code>XMLValidateContext</code> instances can contain 16 * information and state specific to the XML signature structure it is 17 * used with. The results are unpredictable if an 18 * <code>XMLValidateContext</code> is used with different signature structures 19 * (for example, you should not use the same <code>XMLValidateContext</code> 20 * instance to validate two different {@link XMLSignature} objects). 21 * <p> 22 * <b><a name="Supported Properties"></a>Supported Properties</b> 23 * <p>The following properties can be set by an application using the 24 * {@link #setProperty setProperty} method. 25 * <ul> 26 * <li><code>javax.xml.crypto.dsig.cacheReference</code>: value must be a 27 * {@link Boolean}. This property controls whether or not the 28 * {@link Reference#validate Reference.validate} method will cache the 29 * dereferenced content and pre-digested input for subsequent retrieval via 30 * the {@link Reference#getDereferencedData Reference.getDereferencedData} 31 * and {@link Reference#getDigestInputStream 32 * Reference.getDigestInputStream} methods. The default value if not 33 * specified is <code>Boolean.FALSE</code>. 34 * </ul> 35 * 36 * @author Sean Mullan 37 * @author JSR 105 Expert Group 38 * @since 1.6 39 * @see XMLSignature#validate(XMLValidateContext) 40 * @see Reference#validate(XMLValidateContext) 41 */ 42 public interface XMLValidateContext extends XMLCryptoContext {} 43