oracle.security.crypto.crs

Class HttpCRSRequest

java.lang.Object

oracle.security.crypto.crs.HttpCRSRequest

public class HttpCRSRequest
extends java.lang.Object

Implementation of CRS Message over HTTP. Before using the method getResponse, be sure to have set the right content handler factory in your application by calling:
URLConnection.setContentHandlerFactory(new CRSContentHandlerFactory());

The method GET is not implemented. Therefore, a Http CRS Request read from an input stream must use the POST method.

This class should be used on the client side to send CRS Messages to a server over HTTP. The CRS Messages that will need to use this class are PKCSReq, GetCert, GetCRL, RevokeReq and GetCertInitial(Verisign Only).

Constructor Summary

Constructors

Constructor and Description
HttpCRSRequest(CRSMessage request, java.net.URL url) Creates a new Http CRS message.
HttpCRSRequest(java.io.InputStream is) Creates a new Http CRS Request by reading an input stream.

Method Summary

Modifier and Type	Method and Description
CRSMessage	getRequest() Gets the CRS message of this http request.
CRSMessage	getResponse() Gets the CRSMessage from the server.
static CRSMessage	getResponse(CRSMessage request, java.net.HttpURLConnection conn) Gets the CRSMessage from the server using the given HttpURLConnection.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

HttpCRSRequest

public HttpCRSRequest(CRSMessage request,
                      java.net.URL url)

Creates a new Http CRS message. This constructor should be used on the client side.

Note: If the URL has and HTTPS protocol specifier, you will need to call the URL.setURLStreamHandlerFactory method with a HttpsURLStreamHandlerFactory.

Parameters:

request - The request to send over http.

url - The url to use to connect to the CRS server.

HttpCRSRequest

public HttpCRSRequest(java.io.InputStream is)
               throws java.io.IOException

Creates a new Http CRS Request by reading an input stream. This constructor should be used on the server side.

Parameters:

is - The InputStream from which the HttpCRSRequest will be created.

Throws:

java.io.IOException - If an I/O error occurs or the input encoding is incorrect or the HTTP request headers are not acceptable.

Method Detail

getResponse

public static CRSMessage getResponse(CRSMessage request,
                                     java.net.HttpURLConnection conn)
                              throws java.io.IOException

Gets the CRSMessage from the server using the given HttpURLConnection. This method should be used on the client side in a context where calling the method URL.setURLStreamHandlerFactory for HTTPS URLs is impractical.

Throws:

java.io.IOException

getResponse

public CRSMessage getResponse()
                       throws java.io.IOException

Gets the CRSMessage from the server. This method should be used on the client side.

Returns:

An CRSMessage object representing the response from the server on this HttpCRSRequest.

Throws:

java.io.IOException

getRequest

public CRSMessage getRequest()

Gets the CRS message of this http request.

Returns:

An CRSMessage object representing the request of this HttpCRSRequest object.