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());
 

Author:

Sean Mullan, JSR 105 Expert Group

See Also:

X509Data.getContent(), KeyInfoFactory.newX509IssuerSerial(String, BigInteger)

Method Summary

java.lang.String	getIssuerName() Returns the X.500 distinguished name of this X509IssuerSerial in RFC 2253 String format.
java.math.BigInteger	getSerialNumber() Returns the serial number of this X509IssuerSerial.

Methods inherited from interface javax.xml.crypto.XMLStructure

isFeatureSupported

Method Detail

getIssuerName

public java.lang.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

public java.math.BigInteger getSerialNumber()

Returns the serial number of this X509IssuerSerial.

Returns:

the serial number (never null)