TopBlend:
Here is the
first difference.
There are 4 differences.
is old.
is new.
javax.security.sasl
Interface SaslServerFactory
-
public interface SaslServerFactory
An interface for creating instances of
SaslServer
. A class that implements this interface must be thread-safe and handle multiple simultaneous requests. It must also have a public constructor that accepts no argument.
This interface is not normally accessed directly by a server, which will use the
Sasl
static methods instead. However, a particular environment may provide and install a new or different
SaslServerFactory
.
-
Since:
-
1.5
-
See Also:
-
SaslServer
,
Sasl
createSaslServer
SaslServercreateSaslServer(String mechanism,
String protocol,
String serverName,
Map
<? super
String![](../../../diffpics/oold.gif)
< ![](../../../diffpics/oold.gif)
String,?> props,
CallbackHandler cbh)
throws SaslException
-
Creates a
SaslServer
using the parameters supplied. It returns null if no
SaslServer
can be created using the parameters supplied. Throws
SaslException
if it cannot create a
SaslServer
because of an error.
-
-
Parameters:
-
mechanism - The non-null IANA-registered name of a SASL mechanism. (e.g. "GSSAPI", "CRAM-MD5").
-
protocol - The non-null string name of the protocol for which the authentication is being performed (e.g., "ldap").
-
serverName - The non-null fully qualified host name of the server to authenticate to.
-
props - The possibly null set of properties used to select the SASL mechanism and to configure the authentication exchange of the selected mechanism. See the
Sasl
class for a list of standard properties. Other, possibly mechanism-specific, properties can be included. Properties not relevant to the selected mechanism are ignored.
-
cbh - The possibly null callback handler to used by the SASL mechanisms to get further information from the application/library to complete the authentication. For example, a SASL mechanism might require the authentication ID, password and realm from the caller. The authentication ID is requested by using a
NameCallback
. The password is requested by using a
PasswordCallback
. The realm is requested by using a
RealmChoiceCallback
if there is a list of realms to choose from, and by using a
RealmCallback
if the realm must be entered.
-
Returns:
-
A possibly null
SaslServer
created using the parameters supplied. If null, this factory cannot produce a
SaslServer
using the parameters supplied.
-
Throws:
-
SaslException
- If cannot create a
SaslServer
because of an error.
getMechanismNames
String[] getMechanismNames(Map
<? super
String![](../../../diffpics/oold.gif)
< ![](../../../diffpics/oold.gif)
String,?> props)
-
Returns an array of names of mechanisms that match the specified mechanism selection policies.
-
-
Parameters:
-
props - The possibly null set of properties used to specify the security policy of the SASL mechanisms. For example, if
props
contains the
Sasl.POLICY_NOPLAINTEXT
property with the value
"true"
, then the factory must not return any SASL mechanisms that are susceptible to simple plain passive attacks. See the
Sasl
class for a complete list of policy properties. Non-policy related properties, if present in
props
, are ignored.
-
Returns:
-
A non-null array containing a IANA-registered SASL mechanism names.