jdk/src/share/classes/javax/security/sasl/Sasl.java
changeset 18156 edb590d448c5
parent 14342 8435a30053c1
child 18830 90956ead732f
equal deleted inserted replaced
18155:889970e5b728 18156:edb590d448c5
   276     /**
   276     /**
   277      * Creates a <tt>SaslClient</tt> using the parameters supplied.
   277      * Creates a <tt>SaslClient</tt> using the parameters supplied.
   278      *
   278      *
   279      * This method uses the
   279      * This method uses the
   280 <a href="{@docRoot}/../technotes/guides/security/crypto/CryptoSpec.html#Provider">JCA Security Provider Framework</a>, described in the
   280 <a href="{@docRoot}/../technotes/guides/security/crypto/CryptoSpec.html#Provider">JCA Security Provider Framework</a>, described in the
   281      * "Java Cryptography Architecture API Specification & Reference", for
   281      * "Java Cryptography Architecture API Specification &amp; Reference", for
   282      * locating and selecting a <tt>SaslClient</tt> implementation.
   282      * locating and selecting a <tt>SaslClient</tt> implementation.
   283      *
   283      *
   284      * First, it
   284      * First, it
   285      * obtains an ordered list of <tt>SaslClientFactory</tt> instances from
   285      * obtains an ordered list of <tt>SaslClientFactory</tt> instances from
   286      * the registered security providers for the "SaslClientFactory" service
   286      * the registered security providers for the "SaslClientFactory" service
   301      * <tt>com.wiz.sasl.digest.ClientFactory</tt>, that supports the
   301      * <tt>com.wiz.sasl.digest.ClientFactory</tt>, that supports the
   302      * "DIGEST-MD5" mechanism would register the following entry with the JCA:
   302      * "DIGEST-MD5" mechanism would register the following entry with the JCA:
   303      * <tt>SaslClientFactory.DIGEST-MD5 com.wiz.sasl.digest.ClientFactory</tt>
   303      * <tt>SaslClientFactory.DIGEST-MD5 com.wiz.sasl.digest.ClientFactory</tt>
   304      *<p>
   304      *<p>
   305      * See the
   305      * See the
   306      * "Java Cryptography Architecture API Specification & Reference"
   306      * "Java Cryptography Architecture API Specification &amp; Reference"
   307      * for information about how to install and configure security service
   307      * for information about how to install and configure security service
   308      *  providers.
   308      *  providers.
   309      *
   309      *
   310      * @param mechanisms The non-null list of mechanism names to try. Each is the
   310      * @param mechanisms The non-null list of mechanism names to try. Each is the
   311      * IANA-registered name of a SASL mechanism. (e.g. "GSSAPI", "CRAM-MD5").
   311      * IANA-registered name of a SASL mechanism. (e.g. "GSSAPI", "CRAM-MD5").
   426      * Creates a <tt>SaslServer</tt> for the specified mechanism.
   426      * Creates a <tt>SaslServer</tt> for the specified mechanism.
   427      *
   427      *
   428      * This method uses the
   428      * This method uses the
   429 <a href="{@docRoot}/../technotes/guides/security/crypto/CryptoSpec.html#Provider">JCA Security Provider Framework</a>,
   429 <a href="{@docRoot}/../technotes/guides/security/crypto/CryptoSpec.html#Provider">JCA Security Provider Framework</a>,
   430      * described in the
   430      * described in the
   431      * "Java Cryptography Architecture API Specification & Reference", for
   431      * "Java Cryptography Architecture API Specification &amp; Reference", for
   432      * locating and selecting a <tt>SaslServer</tt> implementation.
   432      * locating and selecting a <tt>SaslServer</tt> implementation.
   433      *
   433      *
   434      * First, it
   434      * First, it
   435      * obtains an ordered list of <tt>SaslServerFactory</tt> instances from
   435      * obtains an ordered list of <tt>SaslServerFactory</tt> instances from
   436      * the registered security providers for the "SaslServerFactory" service
   436      * the registered security providers for the "SaslServerFactory" service
   451      * <tt>com.wiz.sasl.digest.ServerFactory</tt>, that supports the
   451      * <tt>com.wiz.sasl.digest.ServerFactory</tt>, that supports the
   452      * "DIGEST-MD5" mechanism would register the following entry with the JCA:
   452      * "DIGEST-MD5" mechanism would register the following entry with the JCA:
   453      * <tt>SaslServerFactory.DIGEST-MD5  com.wiz.sasl.digest.ServerFactory</tt>
   453      * <tt>SaslServerFactory.DIGEST-MD5  com.wiz.sasl.digest.ServerFactory</tt>
   454      *<p>
   454      *<p>
   455      * See the
   455      * See the
   456      * "Java Cryptography Architecture API Specification & Reference"
   456      * "Java Cryptography Architecture API Specification &amp; Reference"
   457      * for information about how to install and configure security
   457      * for information about how to install and configure security
   458      * service providers.
   458      * service providers.
   459      *
   459      *
   460      * @param mechanism The non-null mechanism name. It must be an
   460      * @param mechanism The non-null mechanism name. It must be an
   461      * IANA-registered name of a SASL mechanism. (e.g. "GSSAPI", "CRAM-MD5").
   461      * IANA-registered name of a SASL mechanism. (e.g. "GSSAPI", "CRAM-MD5").