org.bouncycastle.operator
Class OperatorCreationException

java.lang.Object
  java.lang.Throwable
      java.lang.Exception
          org.bouncycastle.operator.OperatorException
              org.bouncycastle.operator.OperatorCreationException

All Implemented Interfaces:

java.io.Serializable

public class OperatorCreationException

extends OperatorException

Thrown by an operator builder when it cannot produce the requested operator.

Operator builders — for example , , , — assemble a configured operator (, , etc.) from caller-supplied inputs: an algorithm identifier or name, a key, a , optional JCA provider, and so on. Construction can fail before any data has been processed, for reasons such as: unknown or unsupported algorithm OID / name; key type incompatible with the requested algorithm (e.g. an RSA key passed to an EC signer); invalid or unsupported parameter combination (key size, hash, PSS salt length, etc.); the underlying JCA provider is missing, misconfigured, or rejects the algorithm (manifests as a / / on the cause chain); a lightweight engine could not be initialised (manifests as a on the cause chain). Inspect Throwable.getCause() for the underlying exception when one is supplied.

See Also:

Serialized Form

Constructor Summary

OperatorCreationException(java.lang.String msg)
Construct an exception with the supplied diagnostic message and no underlying cause.

OperatorCreationException(java.lang.String msg, java.lang.Throwable cause)
Construct an exception with the supplied diagnostic message and the underlying cause (typically a GeneralSecurityException subclass or a lightweight ) returned by the JCA or lightweight machinery the builder was driving.

Methods inherited from class java.lang.Throwable

fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

OperatorCreationException

public OperatorCreationException(java.lang.String msg,
                                 java.lang.Throwable cause)

Construct an exception with the supplied diagnostic message and the underlying cause (typically a GeneralSecurityException subclass or a lightweight ) returned by the JCA or lightweight machinery the builder was driving.

Parameters:

msg - diagnostic message describing what the builder was trying to do and why it failed.

cause - the underlying exception that triggered the failure, or .

OperatorCreationException

public OperatorCreationException(java.lang.String msg)

Construct an exception with the supplied diagnostic message and no underlying cause.

Parameters:

msg - diagnostic message describing what the builder was trying to do and why it failed.