wt.method
Class AuthenticationException

java.lang.Object
  java.lang.Throwable
      java.lang.Error
          wt.method.AuthenticationException

All Implemented Interfaces:

Serializable

public class AuthenticationException
extends Error

An unchecked exception thrown by the method server when an unauthenticated call requires authentication. The exception may carry with it a MethodAuthenticator object which is used to authenticate subsequent requests. Usually, this exception is caught within the RemoteMethodServer.invoke method and used to perform login followed by retrying the failed call.

The method server can process annonymous calls, so it does not require calls to be authenticated up front. The first time a method asks for the authenticated user name of the client, this exception will be thrown causing login at that time. It extends Error so that all levels of intervening methods do not need to declare this exception in their throws clause and also to avoid accidentally being caught and handled by intervening methods that catch standard Exceptions (including RuntimeException).

Supported API: true
Extendable: false

See Also:

Serialized Form

Constructor Summary

AuthenticationException(MethodAuthenticator method_authenticator)


Supported API: true

Method Summary

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

AuthenticationException

public AuthenticationException(MethodAuthenticator method_authenticator)

Supported API: true