Java™ Platform
Standard Ed. 6

javax.xml.crypto.dsig.keyinfo
Interface X509IssuerSerial

All Superinterfaces:
XMLStructure

public interface X509IssuerSerial
extends XMLStructure

A representation of the XML X509IssuerSerial element as defined in the W3C Recommendation for XML-Signature Syntax and Processing. An X509IssuerSerial object contains an X.509 issuer distinguished name (DN) and serial number pair. The XML schema definition is defined as:

   <element name="X509IssuerSerial" type="ds:X509IssuerSerialType"/>
   <complexType name="X509IssuerSerialType">
     <sequence>
       <element name="X509IssuerName" type="string"/> 
       <element name="X509SerialNumber" type="integer"/> 
     </sequence>  
   </complexType>
 
An X509IssuerSerial instance may be created by invoking the newX509IssuerSerial method of the KeyInfoFactory class, and passing it a String and BigInteger representing the X.500 DN and serial number. Here is an example of creating an X509IssuerSerial from the issuer DN and serial number of an existing X509Certificate:
 KeyInfoFactory factory = KeyInfoFactory.getInstance("DOM");
 X509IssuerSerial issuer = factory.newX509IssuerSerial
     (cert.getIssuerX500Principal().getName(), cert.getSerialNumber());
 

Since:
1.6
See Also:
X509Data.getContent(), KeyInfoFactory.newX509IssuerSerial(String, BigInteger)

Method Summary
 String getIssuerName()
          Returns the X.500 distinguished name of this X509IssuerSerial in RFC 2253 String format.
 BigInteger getSerialNumber()
          Returns the serial number of this X509IssuerSerial.
 
Methods inherited from interface javax.xml.crypto.XMLStructure
isFeatureSupported
 

Method Detail

getIssuerName

String getIssuerName()
Returns the X.500 distinguished name of this X509IssuerSerial in RFC 2253 String format.

Returns:
the X.500 distinguished name in RFC 2253 String format (never null)

getSerialNumber

BigInteger getSerialNumber()
Returns the serial number of this X509IssuerSerial.

Returns:
the serial number (never null)

Java™ Platform
Standard Ed. 6

Submit a bug or feature
For further API reference and developer documentation, see Java SE Developer Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.

Copyright 2009 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.