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

Field Summary

MethodAuthenticator	authenticator
private static String	versionID

Fields inherited from class java.lang.Error

Fields inherited from class java.lang.Throwable

Constructor Summary

AuthenticationException()


Supported API: false

AuthenticationException(MethodAuthenticator method_authenticator)


Supported API: true

AuthenticationException(String s)


Supported API: false

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

Field Detail

versionID

private static final String versionID

See Also:

Constant Field Values

authenticator

public MethodAuthenticator authenticator

Constructor Detail

AuthenticationException

public AuthenticationException()

Supported API: false

AuthenticationException

public AuthenticationException(String s)

Supported API: false

AuthenticationException

public AuthenticationException(MethodAuthenticator method_authenticator)

Supported API: true