java.rmi.transport
Interface SecureCallContext


public interface SecureCallContext

A context for making a secure remote call, encapsulating information about the constraints that must be used for the call, the preferences that can be supported, and the subject (if any) that must be used for client authentication.

A context includes information about how many distinct types (classes, not instances) of preferences can be supported, derived from the ordered list of negotiations that would be attempted if a new connection was opened with the context. The getMinPreferenceTypes method returns the minimum number of preference types that would be satisfied among all of the possible negotiation attempts. If the complete ordering of negotiation attempts is known, then the getMaxPreferenceTypes method returns the number of preference types that would be satisfied by the initial negotiation attempt, otherwise it returns the minimum number of preference types that would be satisfied among all of the possible initial negotiation attempts. Preference types can be counted as supported even if definitive support could only be determined by actually negotiating with the remote server.

Given a collection of constraints, a constraint in the collection is said to be unnecessary if its use depends on one or more constraints that are not in the collection; all other constraints are said to be necessary. For example, a ClientAuthentication.YES constraint is necessary regardless of what other constraints are present, but a Delegation.YES constraint is unnecessary unless a ClientAuthentication.YES constraint is also present. The preferences eligible for counting by getMinPreferenceTypes and getMaxPreferenceTypes must be such that the collection formed from all of the supported requirements plus the eligible preferences contains only necessary constraints, and the calling thread (at the time the context is created) has the requisite permissions (such as AuthenticationPermission) to satisfy all of the eligible preferences.

Since:
1.4

Method Summary
 int getMaxPreferenceTypes()
          Returns the maximum number of preference types that can be supported.
 int getMinPreferenceTypes()
          Returns the minimum number of preference types that can be supported.
 

Method Detail

getMinPreferenceTypes

public int getMinPreferenceTypes()
Returns the minimum number of preference types that can be supported.
Returns:
the minimum number of preference types that can be supported

getMaxPreferenceTypes

public int getMaxPreferenceTypes()
Returns the maximum number of preference types that can be supported.
Returns:
the maximum number of preference types that can be supported


Copyright © 2000 Sun Microsystems, Inc. All rights reserved