jakartaee / authentication

Jakarta Authentication
https://eclipse.org/ee4j/jaspic
Other
23 stars 32 forks source link

AuthConfigFactory javadoc indicates methods throw AuthException but method signatures do not #2

Open glassfishrobot opened 11 years ago

glassfishrobot commented 11 years ago

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.

glassfishrobot commented 6 years ago
glassfishrobot commented 11 years ago

@glassfishrobot Commented Reported by monzillo

glassfishrobot commented 11 years ago

@glassfishrobot Commented Was assigned to monzillo

glassfishrobot commented 7 years ago

@glassfishrobot Commented This issue was imported from java.net JIRA JASPIC_SPEC-2