Always add exception cause

[hendrikebbers]

Today Bouncy Castle uses several different ways/pattern how exceptions are handled. In general the best practice would be code like this:

try {
    doSomeMagic(); 
} catch(AnyException e) {
    throw new ConcreteException("Error in doing some magic!", e);
}

While many places of Bounce Castle follow that pattern some places are use other patterns like this:

try {
    doSomeMagic(); 
} catch(AnyException e) {
    throw new ConcreteException("Error in doing some magic:" + e.getMessage());
}

By doing so the original exception (including any possible cause and stack trace) got lost. Especially for application in production that relay on logging regarding errors, those information are very important to understand the cause of an exception.

There are even some other patterns in the code like this snippet from DerUtil.java:

static byte[] toByteArray(ASN1Primitive primitive)
    {
        try
        {
            return primitive.getEncoded();
        }
        catch (final IOException e)
        {
            throw new IllegalStateException("Cannot get encoding: " + e.getMessage())
            {
                public Throwable getCause()
                {
                    return e;
                }
            };
        }
    }

A good starting point to find the places that does not use the best practice pattern is by searching in the project for e.getMessage().

I would be more than happy to work on this issue and migrate all exception handling in Bounce Castle to the same pattern. If you agree on this please assign me to the issue and leave a comment :)

[dghgit]

Ah, those were the days... I hate to be the one to break this to you, but jdk14 in the maven directory actually stands for Java 1.4, not Java 14. I've updated DerUtil so it's actually doing things "correctly". It is probably true that it would be better to deal with this all at once, rather than the piecemeal fashion we've been using. If you interested in helping, would you care to submit a PR with commits for IllegalStateException, IllegalArgumentException and IOException using the Exceptions class? There's also a few related to offshoots of GeneralSecurityException, while a similar approach would work there we would need to find somewhere else to put the required methods (not a real problem, just something we haven't got around to, which we'll do now).