org.bouncycastle.x509

Class X509StreamParser

Implemented Interfaces:
org.bouncycastle.util.StreamParser

public class X509StreamParser
extends java.lang.Object
implements org.bouncycastle.util.StreamParser

This class allows access to different implementations for reading X.509 objects from streams.

A X509StreamParser is used to read a collection of objects or a single object of a certain X.509 object structure. E.g. one X509StreamParser can read certificates, another one CRLs, certification paths, attribute certificates and so on. The kind of object structure is specified with the algorithm parameter to the getInstance methods.

Implementations must implement the X509StreamParserSpi.

Method Summary

static X509StreamParser
getInstance(String type)
Generates a StreamParser object that implements the specified type.
static X509StreamParser
getInstance(String type, Provider provider)
Generates a X509StreamParser object for the specified type from the specified provider.
static X509StreamParser
getInstance(String type, String provider)
Generates a X509StreamParser object for the specified type from the specified provider.
Provider
getProvider()
void
init(InputStream stream)
void
init(byte[] data)
Object
read()
Collection
readAll()

Method Details

getInstance

public static X509StreamParser getInstance(String type)
            throws NoSuchParserException
Generates a StreamParser object that implements the specified type. If the default provider package provides an implementation of the requested type, an instance of StreamParser containing that implementation is returned. If the type is not available in the default package, other packages are searched.
Parameters:
type - The name of the requested X.509 object type.
Returns:
a StreamParser object for the specified type.
Throws:
NoSuchParserException - if the requested type is not available in the default provider package or any of the other provider packages that were searched.

getInstance

public static X509StreamParser getInstance(String type,
                                           Provider provider)
            throws NoSuchParserException
Generates a X509StreamParser object for the specified type from the specified provider.
Parameters:
type - the name of the requested X.509 object type.
provider - the Provider to use.
Returns:
a X509StreamParser object for the specified type.
Throws:
NoSuchParserException - if the type is not available from the specified provider.
See Also:
Provider

getInstance

public static X509StreamParser getInstance(String type,
                                           String provider)
            throws NoSuchParserException,
                   NoSuchProviderException
Generates a X509StreamParser object for the specified type from the specified provider.
Parameters:
type - the name of the requested X.509 object type.
provider - the name of the provider.
Returns:
a X509StreamParser object for the specified type.
Throws:
NoSuchParserException - if the type is not available from the specified provider.
See Also:
Provider

getProvider

public Provider getProvider()

init

public void init(InputStream stream)

init

public void init(byte[] data)

read

public Object read()
            throws org.bouncycastle.util.StreamParsingException
Specified by:
read in interface org.bouncycastle.util.StreamParser

readAll

public Collection readAll()
            throws org.bouncycastle.util.StreamParsingException
Specified by:
readAll in interface org.bouncycastle.util.StreamParser