java.rmi
Class UnsupportedSecurityException
java.lang.Object
|
+--java.lang.Throwable
|
+--java.lang.Exception
|
+--java.io.IOException
|
+--java.rmi.RemoteException
|
+--java.rmi.UnsupportedSecurityException
- All Implemented Interfaces:
- java.io.Serializable
- public class UnsupportedSecurityException
- extends java.rmi.RemoteException
Thrown if the security constraints for a secure RMI call cannot be
satisfied. In a client, security checks that can result in throwing this
exception are only made at the time a remote method is invoked. For
example, it is possible to place a client requirement on a stub that is
not supported by the server, or that is not supported by the RMI runtime
implementation in which the client is executing, without an exception
immediately being thrown.
This exception can be thrown at the point a remote method is invoked for
any of the following reasons:
- A client requirement is not supported by the server.
- A client or server requirement conflicts with some other client or
server requirement.
- The calling thread does not have the requisite permissions (such as
AuthenticationPermission
) to
satisfy the requirements.
- A client or server requirement cannot be satisfied by the RMI
runtime implementation in which the client is executing.
- For a client or server requirement, the RMI runtime implementation in
which the client is executing does not implement any algorithm in common
with the server.
- A delegated remote call is being attempted, and the current time is
either earlier than the granted delegation start time or later than the
granted delegation stop time.
The combined client and server constraints for the call are included as a
non-null
value in the constraints
field of
this exception. No specific indication is given as to which requirements
could not be satisfied.
This exception can also be thrown by a server, when constructing a
SecureExportDesc
.
- Since:
- 1.4
- See Also:
- Serialized Form
Fields inherited from class java.rmi.RemoteException |
detail |
Constructor Summary |
UnsupportedSecurityException(java.lang.String s,
SecurityConstraints constraints)
Creates an instance with the specified detail message and sets the
constraints field to the specified constraints, or to a
constraints instance containing no constraints if the specified
constraints value is null . |
Method Summary |
java.lang.String |
getMessage()
Returns the detail message, including the constraints. |
Methods inherited from class java.rmi.RemoteException |
printStackTrace, printStackTrace, printStackTrace |
Methods inherited from class java.lang.Throwable |
fillInStackTrace, getLocalizedMessage, toString |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
constraints
public SecurityConstraints constraints
- The combined client and server constraints for the call.
UnsupportedSecurityException
public UnsupportedSecurityException(java.lang.String s,
SecurityConstraints constraints)
- Creates an instance with the specified detail message and sets the
constraints
field to the specified constraints, or to a
constraints instance containing no constraints if the specified
constraints value is null
.
- Parameters:
s
- the detail messageconstraints
- the combined client and server constraints for the
call, or null
getMessage
public java.lang.String getMessage()
- Returns the detail message, including the constraints.
- Overrides:
getMessage
in class java.rmi.RemoteException
Copyright © 2000 Sun Microsystems, Inc. All rights reserved