--- old/src/share/classes/java/security/AuthProvider.java 2013-06-28 10:31:35.510377135 -0700 +++ new/src/share/classes/java/security/AuthProvider.java 2013-06-28 10:31:35.350377137 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2003, 2004, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2003, 2013, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -32,8 +32,8 @@ /** * This class defines login and logout methods for a provider. * - *
While callers may invoke login
directly,
- * the provider may also invoke login
on behalf of callers
+ *
While callers may invoke {@code login} directly, + * the provider may also invoke {@code login} on behalf of callers * if it determines that a login must be performed * prior to certain operations. * @@ -56,11 +56,11 @@ /** * Log in to this provider. * - *
The provider relies on a CallbackHandler
+ *
The provider relies on a {@code CallbackHandler}
* to obtain authentication information from the caller
- * (a PIN, for example). If the caller passes a null
+ * (a PIN, for example). If the caller passes a {@code null}
* handler to this method, the provider uses the handler set in the
- * setCallbackHandler
method.
+ * {@code setCallbackHandler} method.
* If no handler was set in that method, the provider queries the
* auth.login.defaultCallbackHandler security property
* for the fully qualified class name of a default handler implementation.
@@ -68,21 +68,21 @@
* the provider is assumed to have alternative means
* for obtaining authentication information.
*
- * @param subject the Subject
which may contain
+ * @param subject the {@code Subject} which may contain
* principals/credentials used for authentication,
* or may be populated with additional principals/credentials
* after successful authentication has completed.
- * This parameter may be null
.
- * @param handler the CallbackHandler
used by
+ * This parameter may be {@code null}.
+ * @param handler the {@code CallbackHandler} used by
* this provider to obtain authentication information
- * from the caller, which may be null
+ * from the caller, which may be {@code null}
*
* @exception LoginException if the login operation fails
* @exception SecurityException if the caller does not pass a
* security check for
- * SecurityPermission("authProvider.name")
,
- * where name is the value returned by
- * this provider's getName
method
+ * {@code SecurityPermission("authProvider.name")},
+ * where {@code name} is the value returned by
+ * this provider's {@code getName} method
*/
public abstract void login(Subject subject, CallbackHandler handler)
throws LoginException;
@@ -93,18 +93,18 @@
* @exception LoginException if the logout operation fails
* @exception SecurityException if the caller does not pass a
* security check for
- * SecurityPermission("authProvider.name")
,
- * where name is the value returned by
- * this provider's getName
method
+ * {@code SecurityPermission("authProvider.name")},
+ * where {@code name} is the value returned by
+ * this provider's {@code getName} method
*/
public abstract void logout() throws LoginException;
/**
- * Set a CallbackHandler
.
+ * Set a {@code CallbackHandler}.
*
*
The provider uses this handler if one is not passed to the
- * login
method. The provider also uses this handler
- * if it invokes login
on behalf of callers.
+ * {@code login} method. The provider also uses this handler
+ * if it invokes {@code login} on behalf of callers.
* In either case if a handler is not set via this method,
* the provider queries the
* auth.login.defaultCallbackHandler security property
@@ -113,14 +113,14 @@
* the provider is assumed to have alternative means
* for obtaining authentication information.
*
- * @param handler a CallbackHandler
for obtaining
- * authentication information, which may be null
+ * @param handler a {@code CallbackHandler} for obtaining
+ * authentication information, which may be {@code null}
*
* @exception SecurityException if the caller does not pass a
* security check for
- * SecurityPermission("authProvider.name")
,
- * where name is the value returned by
- * this provider's getName
method
+ * {@code SecurityPermission("authProvider.name")},
+ * where {@code name} is the value returned by
+ * this provider's {@code getName} method
*/
public abstract void setCallbackHandler(CallbackHandler handler);
}