2
* Copyright 2005 The Apache Software Foundation.
4
* Licensed under the Apache License, Version 2.0 (the "License");
5
* you may not use this file except in compliance with the License.
6
* You may obtain a copy of the License at
8
* http://www.apache.org/licenses/LICENSE-2.0
10
* Unless required by applicable law or agreed to in writing, software
11
* distributed under the License is distributed on an "AS IS" BASIS,
12
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
* See the License for the specific language governing permissions and
14
* limitations under the License.
18
* Copyright 2005 Sun Microsystems, Inc. All rights reserved.
21
* $Id: SignatureProperty.java 375655 2006-02-07 18:35:54 +0000 (Tue, 07 Feb 2006) mullan $
23
package javax.xml.crypto.dsig;
25
import javax.xml.crypto.XMLStructure;
26
import java.util.List;
29
* A representation of the XML <code>SignatureProperty</code> element as
30
* defined in the <a href="http://www.w3.org/TR/xmldsig-core/">
31
* W3C Recommendation for XML-Signature Syntax and Processing</a>.
32
* The XML Schema Definition is defined as:
34
*<element name="SignatureProperty" type="ds:SignaturePropertyType"/>
35
* <complexType name="SignaturePropertyType" mixed="true">
36
* <choice maxOccurs="unbounded">
37
* <any namespace="##other" processContents="lax"/>
38
* <!-- (1,1) elements from (1, unbounded) namespaces -->
40
* <attribute name="Target" type="anyURI" use="required"/>
41
* <attribute name="Id" type="ID" use="optional"/>
42
* </complexType>
45
* A <code>SignatureProperty</code> instance may be created by invoking the
46
* {@link XMLSignatureFactory#newSignatureProperty newSignatureProperty}
47
* method of the {@link XMLSignatureFactory} class; for example:
50
* XMLSignatureFactory factory = XMLSignatureFactory.getInstance("DOM");
51
* SignatureProperty property = factory.newSignatureProperty
52
* (Collections.singletonList(content), "#Signature-1", "TimeStamp");
56
* @author JSR 105 Expert Group
57
* @see XMLSignatureFactory#newSignatureProperty(List, String, String)
58
* @see SignatureProperties
60
public interface SignatureProperty extends XMLStructure {
63
* Returns the target URI of this <code>SignatureProperty</code>.
65
* @return the target URI of this <code>SignatureProperty</code> (never
71
* Returns the Id of this <code>SignatureProperty</code>.
73
* @return the Id of this <code>SignatureProperty</code> (or
74
* <code>null</code> if not specified)
79
* Returns an {@link java.util.Collections#unmodifiableList unmodifiable
80
* list} of one or more {@link XMLStructure}s that are contained in
81
* this <code>SignatureProperty</code>. These represent additional
82
* information items concerning the generation of the {@link XMLSignature}
83
* (i.e. date/time stamp or serial numbers of cryptographic hardware used
84
* in signature generation).
86
* @return an unmodifiable list of one or more <code>XMLStructure</code>s