users@jaspic-spec.java.net

[JIRA] Created: (JASPIC_SPEC-2) AuthConfigFactory javadoc indicates methods throw AuthException but method signatures do not

From: monzillo (JIRA) <"monzillo>
Date: Wed, 13 Feb 2013 02:49:53 +0000 (GMT+00:00)

AuthConfigFactory javadoc indicates methods throw AuthException but method signatures do not
--------------------------------------------------------------------------------------------

                 Key: JASPIC_SPEC-2
                 URL: http://java.net/jira/browse/JASPIC_SPEC-2
             Project: jaspic-spec
          Issue Type: Bug
            Reporter: monzillo
            Assignee: monzillo


avadoc of four AuthConfigFactory methods indicate that they throw
AuthException (which is a checked exception) but method signatures do not
declare that they throw AuthException, and thus the exception cannot be thrown.
Moreover, the inability to throw this exception, makes it unclear how errors
are to be signaled by these methods.


public static AuthConfigFactory getFactory();

public abstract java.lang.StringregisterConfigProvider(
    java.lang.String className,
    java.util.Map properties,
    java.lang.String layer,
    java.lang.String appContext,
    java.lang.String description);

public abstract java.lang.String registerConfigProvider(
    AuthConfigProvider provider,
    java.lang.String layer,
    java.lang.String appContext,
    java.lang.String description)

public abstract void refresh()

javadoc if refresh method of AuthConfig interface also indicates that it throws
AuthException although method signature does not declare that it does.

javadoc if refresh method of AuthConfigProvider interface also indicates that
it throws AuthException although method signature does not declare that it
does.

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://java.net/jira/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira