Skip to content

D
dragonwell8_jdk

openanolis / dragonwell8_jdk

通知 4
Star 2
Fork 0
D
dragonwell8_jdk
提交 fe6c9f2d 编写于 作者: J juh
浏览文件
操作

8019360: Cleanup of the javadoc <code> tag in java.security.* 

Summary: Convert to {@code ...} tags. convert package.html to package-info.java.
Reviewed-by: darcy
上级 09d88156
展开全部 隐藏空白更改
内联 并排
Showing with 1429 addition and 1466 deletion
src/share/classes/java/security/AccessControlContext.java
浏览文件 @ fe6c9f2d
...@@ -36,10 +36,10 @@ import sun.security.util.SecurityConstants; ...@@ -36,10 +36,10 @@ import sun.security.util.SecurityConstants;
* based on the context it encapsulates. * based on the context it encapsulates.
* *
* <p>More specifically, it encapsulates a context and * <p>More specifically, it encapsulates a context and
* has a single method, <code>checkPermission</code>, * has a single method, {@code checkPermission},
* that is equivalent to the <code>checkPermission</code> method * that is equivalent to the {@code checkPermission} method
* in the AccessController class, with one difference: The AccessControlContext * in the AccessController class, with one difference: The AccessControlContext
* <code>checkPermission</code> method makes access decisions based on the * {@code checkPermission} method makes access decisions based on the
* context it encapsulates, * context it encapsulates,
* rather than that of the current execution thread. * rather than that of the current execution thread.
* *
...@@ -49,8 +49,8 @@ import sun.security.util.SecurityConstants; ...@@ -49,8 +49,8 @@ import sun.security.util.SecurityConstants;
* <i>different</i> context (for example, from within a worker thread). * <i>different</i> context (for example, from within a worker thread).
* *
* <p> An AccessControlContext is created by calling the * <p> An AccessControlContext is created by calling the
* <code>AccessController.getContext</code> method. * {@code AccessController.getContext} method.
* The <code>getContext</code> method takes a "snapshot" * The {@code getContext} method takes a "snapshot"
* of the current calling context, and places * of the current calling context, and places
* it in an AccessControlContext object, which it returns. A sample call is * it in an AccessControlContext object, which it returns. A sample call is
* the following: * the following:
...@@ -61,7 +61,7 @@ import sun.security.util.SecurityConstants; ...@@ -61,7 +61,7 @@ import sun.security.util.SecurityConstants;
* *
* <p> * <p>
* Code within a different context can subsequently call the * Code within a different context can subsequently call the
* <code>checkPermission</code> method on the * {@code checkPermission} method on the
* previously-saved AccessControlContext object. A sample call is the * previously-saved AccessControlContext object. A sample call is the
* following: * following:
* *
...@@ -121,7 +121,7 @@ public final class AccessControlContext { ...@@ -121,7 +121,7 @@ public final class AccessControlContext {
* @param context the ProtectionDomains associated with this context. * @param context the ProtectionDomains associated with this context.
* The non-duplicate domains are copied from the array. Subsequent * The non-duplicate domains are copied from the array. Subsequent
* changes to the array will not affect this AccessControlContext. * changes to the array will not affect this AccessControlContext.
* @throws NullPointerException if <code>context</code> is <code>null</code> * @throws NullPointerException if {@code context} is {@code null}
*/ */
public AccessControlContext(ProtectionDomain context[]) public AccessControlContext(ProtectionDomain context[])
{ {
...@@ -147,22 +147,22 @@ public final class AccessControlContext { ...@@ -147,22 +147,22 @@ public final class AccessControlContext {
} }
/** /**
* Create a new <code>AccessControlContext</code> with the given * Create a new {@code AccessControlContext} with the given
* <code>AccessControlContext</code> and <code>DomainCombiner</code>. * {@code AccessControlContext} and {@code DomainCombiner}.
* This constructor associates the provided * This constructor associates the provided
* <code>DomainCombiner</code> with the provided * {@code DomainCombiner} with the provided
* <code>AccessControlContext</code>. * {@code AccessControlContext}.
* *
* <p> * <p>
* *
* @param acc the <code>AccessControlContext</code> associated * @param acc the {@code AccessControlContext} associated
* with the provided <code>DomainCombiner</code>. * with the provided {@code DomainCombiner}.
* *
* @param combiner the <code>DomainCombiner</code> to be associated * @param combiner the {@code DomainCombiner} to be associated
* with the provided <code>AccessControlContext</code>. * with the provided {@code AccessControlContext}.
* *
* @exception NullPointerException if the provided * @exception NullPointerException if the provided
* <code>context</code> is <code>null</code>. * {@code context} is {@code null}.
* *
* @exception SecurityException if a security manager is installed and the * @exception SecurityException if a security manager is installed and the
* caller does not have the "createAccessControlContext" * caller does not have the "createAccessControlContext"
...@@ -320,13 +320,13 @@ public final class AccessControlContext { ...@@ -320,13 +320,13 @@ public final class AccessControlContext {
} }
/** /**
* Get the <code>DomainCombiner</code> associated with this * Get the {@code DomainCombiner} associated with this
* <code>AccessControlContext</code>. * {@code AccessControlContext}.
* *
* <p> * <p>
* *
* @return the <code>DomainCombiner</code> associated with this * @return the {@code DomainCombiner} associated with this
* <code>AccessControlContext</code>, or <code>null</code> * {@code AccessControlContext}, or {@code null}
* if there is none. * if there is none.
* *
* @exception SecurityException if a security manager is installed and * @exception SecurityException if a security manager is installed and
......
src/share/classes/java/security/AccessControlException.java
浏览文件 @ fe6c9f2d
/* /*
* Copyright (c) 1997, 2003, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
...@@ -48,7 +48,7 @@ public class AccessControlException extends SecurityException { ...@@ -48,7 +48,7 @@ public class AccessControlException extends SecurityException {
private Permission perm; private Permission perm;
/** /**
* Constructs an <code>AccessControlException</code> with the * Constructs an {@code AccessControlException} with the
* specified, detailed message. * specified, detailed message.
* *
* @param s the detail message. * @param s the detail message.
...@@ -58,7 +58,7 @@ public class AccessControlException extends SecurityException { ...@@ -58,7 +58,7 @@ public class AccessControlException extends SecurityException {
} }
/** /**
* Constructs an <code>AccessControlException</code> with the * Constructs an {@code AccessControlException} with the
* specified, detailed message, and the requested permission that caused * specified, detailed message, and the requested permission that caused
* the exception. * the exception.
* *
......
src/share/classes/java/security/AlgorithmParameterGenerator.java
浏览文件 @ fe6c9f2d
/* /*
* Copyright (c) 1997, 2011, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
...@@ -28,10 +28,10 @@ package java.security; ...@@ -28,10 +28,10 @@ package java.security;
import java.security.spec.AlgorithmParameterSpec; import java.security.spec.AlgorithmParameterSpec;
/** /**
* The <code>AlgorithmParameterGenerator</code> class is used to generate a * The {@code AlgorithmParameterGenerator} class is used to generate a
* set of * set of
* parameters to be used with a certain algorithm. Parameter generators * parameters to be used with a certain algorithm. Parameter generators
* are constructed using the <code>getInstance</code> factory methods * are constructed using the {@code getInstance} factory methods
* (static methods that return instances of a given class). * (static methods that return instances of a given class).
* *
* <P>The object that will generate the parameters can be initialized * <P>The object that will generate the parameters can be initialized
...@@ -61,17 +61,17 @@ import java.security.spec.AlgorithmParameterSpec; ...@@ -61,17 +61,17 @@ import java.security.spec.AlgorithmParameterSpec;
* *
* <P>In case the client does not explicitly initialize the * <P>In case the client does not explicitly initialize the
* AlgorithmParameterGenerator * AlgorithmParameterGenerator
* (via a call to an <code>init</code> method), each provider must supply (and * (via a call to an {@code init} method), each provider must supply (and
* document) a default initialization. For example, the Sun provider uses a * document) a default initialization. For example, the Sun provider uses a
* default modulus prime size of 1024 bits for the generation of DSA * default modulus prime size of 1024 bits for the generation of DSA
* parameters. * parameters.
* *
* <p> Every implementation of the Java platform is required to support the * <p> Every implementation of the Java platform is required to support the
* following standard <code>AlgorithmParameterGenerator</code> algorithms and * following standard {@code AlgorithmParameterGenerator} algorithms and
* keysizes in parentheses: * keysizes in parentheses:
* <ul> * <ul>
* <li><tt>DiffieHellman</tt> (1024)</li> * <li>{@code DiffieHellman} (1024)</li>
* <li><tt>DSA</tt> (1024)</li> * <li>{@code DSA} (1024)</li>
* </ul> * </ul>
* These algorithms are described in the <a href= * These algorithms are described in the <a href=
* "{@docRoot}/../technotes/guides/security/StandardNames.html#AlgorithmParameterGenerator"> * "{@docRoot}/../technotes/guides/security/StandardNames.html#AlgorithmParameterGenerator">
...@@ -272,11 +272,11 @@ public class AlgorithmParameterGenerator { ...@@ -272,11 +272,11 @@ public class AlgorithmParameterGenerator {
/** /**
* Initializes this parameter generator for a certain size. * Initializes this parameter generator for a certain size.
* To create the parameters, the <code>SecureRandom</code> * To create the parameters, the {@code SecureRandom}
* implementation of the highest-priority installed provider is used as * implementation of the highest-priority installed provider is used as
* the source of randomness. * the source of randomness.
* (If none of the installed providers supply an implementation of * (If none of the installed providers supply an implementation of
* <code>SecureRandom</code>, a system-provided source of randomness is * {@code SecureRandom}, a system-provided source of randomness is
* used.) * used.)
* *
* @param size the size (number of bits). * @param size the size (number of bits).
...@@ -299,11 +299,11 @@ public class AlgorithmParameterGenerator { ...@@ -299,11 +299,11 @@ public class AlgorithmParameterGenerator {
/** /**
* Initializes this parameter generator with a set of algorithm-specific * Initializes this parameter generator with a set of algorithm-specific
* parameter generation values. * parameter generation values.
* To generate the parameters, the <code>SecureRandom</code> * To generate the parameters, the {@code SecureRandom}
* implementation of the highest-priority installed provider is used as * implementation of the highest-priority installed provider is used as
* the source of randomness. * the source of randomness.
* (If none of the installed providers supply an implementation of * (If none of the installed providers supply an implementation of
* <code>SecureRandom</code>, a system-provided source of randomness is * {@code SecureRandom}, a system-provided source of randomness is
* used.) * used.)
* *
* @param genParamSpec the set of algorithm-specific parameter generation values. * @param genParamSpec the set of algorithm-specific parameter generation values.
......
src/share/classes/java/security/AlgorithmParameterGeneratorSpi.java
浏览文件 @ fe6c9f2d
/* /*
* Copyright (c) 1997, 1999, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
...@@ -29,7 +29,7 @@ import java.security.spec.AlgorithmParameterSpec; ...@@ -29,7 +29,7 @@ import java.security.spec.AlgorithmParameterSpec;
/** /**
* This class defines the <i>Service Provider Interface</i> (<b>SPI</b>) * This class defines the <i>Service Provider Interface</i> (<b>SPI</b>)
* for the <code>AlgorithmParameterGenerator</code> class, which * for the {@code AlgorithmParameterGenerator} class, which
* is used to generate a set of parameters to be used with a certain algorithm. * is used to generate a set of parameters to be used with a certain algorithm.
* *
* <p> All the abstract methods in this class must be implemented by each * <p> All the abstract methods in this class must be implemented by each
...@@ -37,7 +37,7 @@ import java.security.spec.AlgorithmParameterSpec; ...@@ -37,7 +37,7 @@ import java.security.spec.AlgorithmParameterSpec;
* of a parameter generator for a particular algorithm. * of a parameter generator for a particular algorithm.
* *
* <p> In case the client does not explicitly initialize the * <p> In case the client does not explicitly initialize the
* AlgorithmParameterGenerator (via a call to an <code>engineInit</code> * AlgorithmParameterGenerator (via a call to an {@code engineInit}
* method), each provider must supply (and document) a default initialization. * method), each provider must supply (and document) a default initialization.
* For example, the Sun provider uses a default modulus prime size of 1024 * For example, the Sun provider uses a default modulus prime size of 1024
* bits for the generation of DSA parameters. * bits for the generation of DSA parameters.
......
src/share/classes/java/security/AlgorithmParameters.java
浏览文件 @ fe6c9f2d
/* /*
* Copyright (c) 1997, 2011, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
...@@ -32,28 +32,28 @@ import java.security.spec.InvalidParameterSpecException; ...@@ -32,28 +32,28 @@ import java.security.spec.InvalidParameterSpecException;
/** /**
* This class is used as an opaque representation of cryptographic parameters. * This class is used as an opaque representation of cryptographic parameters.
* *
* <p>An <code>AlgorithmParameters</code> object for managing the parameters * <p>An {@code AlgorithmParameters} object for managing the parameters
* for a particular algorithm can be obtained by * for a particular algorithm can be obtained by
* calling one of the <code>getInstance</code> factory methods * calling one of the {@code getInstance} factory methods
* (static methods that return instances of a given class). * (static methods that return instances of a given class).
* *
* <p>Once an <code>AlgorithmParameters</code> object is obtained, it must be * <p>Once an {@code AlgorithmParameters} object is obtained, it must be
* initialized via a call to <code>init</code>, using an appropriate parameter * initialized via a call to {@code init}, using an appropriate parameter
* specification or parameter encoding. * specification or parameter encoding.
* *
* <p>A transparent parameter specification is obtained from an * <p>A transparent parameter specification is obtained from an
* <code>AlgorithmParameters</code> object via a call to * {@code AlgorithmParameters} object via a call to
* <code>getParameterSpec</code>, and a byte encoding of the parameters is * {@code getParameterSpec}, and a byte encoding of the parameters is
* obtained via a call to <code>getEncoded</code>. * obtained via a call to {@code getEncoded}.
* *
* <p> Every implementation of the Java platform is required to support the * <p> Every implementation of the Java platform is required to support the
* following standard <code>AlgorithmParameters</code> algorithms: * following standard {@code AlgorithmParameters} algorithms:
* <ul> * <ul>
* <li><tt>AES</tt></li> * <li>{@code AES}</li>
* <li><tt>DES</tt></li> * <li>{@code DES}</li>
* <li><tt>DESede</tt></li> * <li>{@code DESede}</li>
* <li><tt>DiffieHellman</tt></li> * <li>{@code DiffieHellman}</li>
* <li><tt>DSA</tt></li> * <li>{@code DSA}</li>
* </ul> * </ul>
* These algorithms are described in the <a href= * These algorithms are described in the <a href=
* "{@docRoot}/../technotes/guides/security/StandardNames.html#AlgorithmParameters"> * "{@docRoot}/../technotes/guides/security/StandardNames.html#AlgorithmParameters">
...@@ -123,7 +123,7 @@ public class AlgorithmParameters { ...@@ -123,7 +123,7 @@ public class AlgorithmParameters {
* the {@link Security#getProviders() Security.getProviders()} method. * the {@link Security#getProviders() Security.getProviders()} method.
* *
* <p> The returned parameter object must be initialized via a call to * <p> The returned parameter object must be initialized via a call to
* <code>init</code>, using an appropriate parameter specification or * {@code init}, using an appropriate parameter specification or
* parameter encoding. * parameter encoding.
* *
* @param algorithm the name of the algorithm requested. * @param algorithm the name of the algorithm requested.
...@@ -165,7 +165,7 @@ public class AlgorithmParameters { ...@@ -165,7 +165,7 @@ public class AlgorithmParameters {
* the {@link Security#getProviders() Security.getProviders()} method. * the {@link Security#getProviders() Security.getProviders()} method.
* *
* <p>The returned parameter object must be initialized via a call to * <p>The returned parameter object must be initialized via a call to
* <code>init</code>, using an appropriate parameter specification or * {@code init}, using an appropriate parameter specification or
* parameter encoding. * parameter encoding.
* *
* @param algorithm the name of the algorithm requested. * @param algorithm the name of the algorithm requested.
...@@ -212,7 +212,7 @@ public class AlgorithmParameters { ...@@ -212,7 +212,7 @@ public class AlgorithmParameters {
* does not have to be registered in the provider list. * does not have to be registered in the provider list.
* *
* <p>The returned parameter object must be initialized via a call to * <p>The returned parameter object must be initialized via a call to
* <code>init</code>, using an appropriate parameter specification or * {@code init}, using an appropriate parameter specification or
* parameter encoding. * parameter encoding.
* *
* @param algorithm the name of the algorithm requested. * @param algorithm the name of the algorithm requested.
...@@ -259,7 +259,7 @@ public class AlgorithmParameters { ...@@ -259,7 +259,7 @@ public class AlgorithmParameters {
/** /**
* Initializes this parameter object using the parameters * Initializes this parameter object using the parameters
* specified in <code>paramSpec</code>. * specified in {@code paramSpec}.
* *
* @param paramSpec the parameter specification. * @param paramSpec the parameter specification.
* *
...@@ -295,9 +295,9 @@ public class AlgorithmParameters { ...@@ -295,9 +295,9 @@ public class AlgorithmParameters {
} }
/** /**
* Imports the parameters from <code>params</code> and decodes them * Imports the parameters from {@code params} and decodes them
* according to the specified decoding scheme. * according to the specified decoding scheme.
* If <code>format</code> is null, the * If {@code format} is null, the
* primary decoding format for parameters is used. The primary decoding * primary decoding format for parameters is used. The primary decoding
* format is ASN.1, if an ASN.1 specification for these parameters * format is ASN.1, if an ASN.1 specification for these parameters
* exists. * exists.
...@@ -318,11 +318,11 @@ public class AlgorithmParameters { ...@@ -318,11 +318,11 @@ public class AlgorithmParameters {
/** /**
* Returns a (transparent) specification of this parameter object. * Returns a (transparent) specification of this parameter object.
* <code>paramSpec</code> identifies the specification class in which * {@code paramSpec} identifies the specification class in which
* the parameters should be returned. It could, for example, be * the parameters should be returned. It could, for example, be
* <code>DSAParameterSpec.class</code>, to indicate that the * {@code DSAParameterSpec.class}, to indicate that the
* parameters should be returned in an instance of the * parameters should be returned in an instance of the
* <code>DSAParameterSpec</code> class. * {@code DSAParameterSpec} class.
* *
* @param paramSpec the specification class in which * @param paramSpec the specification class in which
* the parameters should be returned. * the parameters should be returned.
...@@ -363,7 +363,7 @@ public class AlgorithmParameters { ...@@ -363,7 +363,7 @@ public class AlgorithmParameters {
/** /**
* Returns the parameters encoded in the specified scheme. * Returns the parameters encoded in the specified scheme.
* If <code>format</code> is null, the * If {@code format} is null, the
* primary encoding format for parameters is used. The primary encoding * primary encoding format for parameters is used. The primary encoding
* format is ASN.1, if an ASN.1 specification for these parameters * format is ASN.1, if an ASN.1 specification for these parameters
* exists. * exists.
......
src/share/classes/java/security/AlgorithmParametersSpi.java
浏览文件 @ fe6c9f2d
/* /*
* Copyright (c) 1997, 2004, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
...@@ -31,7 +31,7 @@ import java.security.spec.InvalidParameterSpecException; ...@@ -31,7 +31,7 @@ import java.security.spec.InvalidParameterSpecException;
/** /**
* This class defines the <i>Service Provider Interface</i> (<b>SPI</b>) * This class defines the <i>Service Provider Interface</i> (<b>SPI</b>)
* for the <code>AlgorithmParameters</code> class, which is used to manage * for the {@code AlgorithmParameters} class, which is used to manage
* algorithm parameters. * algorithm parameters.
* *
* <p> All the abstract methods in this class must be implemented by each * <p> All the abstract methods in this class must be implemented by each
...@@ -52,7 +52,7 @@ public abstract class AlgorithmParametersSpi { ...@@ -52,7 +52,7 @@ public abstract class AlgorithmParametersSpi {
/** /**
* Initializes this parameters object using the parameters * Initializes this parameters object using the parameters
* specified in <code>paramSpec</code>. * specified in {@code paramSpec}.
* *
* @param paramSpec the parameter specification. * @param paramSpec the parameter specification.
* *
...@@ -77,9 +77,9 @@ public abstract class AlgorithmParametersSpi { ...@@ -77,9 +77,9 @@ public abstract class AlgorithmParametersSpi {
throws IOException; throws IOException;
/** /**
* Imports the parameters from <code>params</code> and * Imports the parameters from {@code params} and
* decodes them according to the specified decoding format. * decodes them according to the specified decoding format.
* If <code>format</code> is null, the * If {@code format} is null, the
* primary decoding format for parameters is used. The primary decoding * primary decoding format for parameters is used. The primary decoding
* format is ASN.1, if an ASN.1 specification for these parameters * format is ASN.1, if an ASN.1 specification for these parameters
* exists. * exists.
...@@ -96,11 +96,11 @@ public abstract class AlgorithmParametersSpi { ...@@ -96,11 +96,11 @@ public abstract class AlgorithmParametersSpi {
/** /**
* Returns a (transparent) specification of this parameters * Returns a (transparent) specification of this parameters
* object. * object.
* <code>paramSpec</code> identifies the specification class in which * {@code paramSpec} identifies the specification class in which
* the parameters should be returned. It could, for example, be * the parameters should be returned. It could, for example, be
* <code>DSAParameterSpec.class</code>, to indicate that the * {@code DSAParameterSpec.class}, to indicate that the
* parameters should be returned in an instance of the * parameters should be returned in an instance of the
* <code>DSAParameterSpec</code> class. * {@code DSAParameterSpec} class.
* *
* @param paramSpec the specification class in which * @param paramSpec the specification class in which
* the parameters should be returned. * the parameters should be returned.
...@@ -128,7 +128,7 @@ public abstract class AlgorithmParametersSpi { ...@@ -128,7 +128,7 @@ public abstract class AlgorithmParametersSpi {
/** /**
* Returns the parameters encoded in the specified format. * Returns the parameters encoded in the specified format.
* If <code>format</code> is null, the * If {@code format} is null, the
* primary encoding format for parameters is used. The primary encoding * primary encoding format for parameters is used. The primary encoding
* format is ASN.1, if an ASN.1 specification for these parameters * format is ASN.1, if an ASN.1 specification for these parameters
* exists. * exists.
......
src/share/classes/java/security/AllPermission.java
浏览文件 @ fe6c9f2d
/* /*
* Copyright (c) 1998, 2012, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1998, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
...@@ -69,7 +69,7 @@ public final class AllPermission extends Permission { ...@@ -69,7 +69,7 @@ public final class AllPermission extends Permission {
/** /**
* Creates a new AllPermission object. This * Creates a new AllPermission object. This
* constructor exists for use by the <code>Policy</code> object * constructor exists for use by the {@code Policy} object
* to instantiate new Permission objects. * to instantiate new Permission objects.
* *
* @param name ignored * @param name ignored
......
src/share/classes/java/security/AuthProvider.java
浏览文件 @ fe6c9f2d
/* /*
* 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. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
...@@ -32,8 +32,8 @@ import javax.security.auth.callback.CallbackHandler; ...@@ -32,8 +32,8 @@ import javax.security.auth.callback.CallbackHandler;
/** /**
* This class defines login and logout methods for a provider. * This class defines login and logout methods for a provider.
* *
* <p> While callers may invoke <code>login</code> directly, * <p> While callers may invoke {@code login} directly,
* the provider may also invoke <code>login</code> on behalf of callers * the provider may also invoke {@code login} on behalf of callers
* if it determines that a login must be performed * if it determines that a login must be performed
* prior to certain operations. * prior to certain operations.
* *
...@@ -56,11 +56,11 @@ public abstract class AuthProvider extends Provider { ...@@ -56,11 +56,11 @@ public abstract class AuthProvider extends Provider {
/** /**
* Log in to this provider. * Log in to this provider.
* *
* <p> The provider relies on a <code>CallbackHandler</code> * <p> The provider relies on a {@code CallbackHandler}
* to obtain authentication information from the caller * to obtain authentication information from the caller
* (a PIN, for example). If the caller passes a <code>null</code> * (a PIN, for example). If the caller passes a {@code null}
* handler to this method, the provider uses the handler set in the * handler to this method, the provider uses the handler set in the
* <code>setCallbackHandler</code> method. * {@code setCallbackHandler} method.
* If no handler was set in that method, the provider queries the * If no handler was set in that method, the provider queries the
* <i>auth.login.defaultCallbackHandler</i> security property * <i>auth.login.defaultCallbackHandler</i> security property
* for the fully qualified class name of a default handler implementation. * for the fully qualified class name of a default handler implementation.
...@@ -68,21 +68,21 @@ public abstract class AuthProvider extends Provider { ...@@ -68,21 +68,21 @@ public abstract class AuthProvider extends Provider {
* the provider is assumed to have alternative means * the provider is assumed to have alternative means
* for obtaining authentication information. * for obtaining authentication information.
* *
* @param subject the <code>Subject</code> which may contain * @param subject the {@code Subject} which may contain
* principals/credentials used for authentication, * principals/credentials used for authentication,
* or may be populated with additional principals/credentials * or may be populated with additional principals/credentials
* after successful authentication has completed. * after successful authentication has completed.
* This parameter may be <code>null</code>. * This parameter may be {@code null}.
* @param handler the <code>CallbackHandler</code> used by * @param handler the {@code CallbackHandler} used by
* this provider to obtain authentication information * this provider to obtain authentication information
* from the caller, which may be <code>null</code> * from the caller, which may be {@code null}
* *
* @exception LoginException if the login operation fails * @exception LoginException if the login operation fails
* @exception SecurityException if the caller does not pass a * @exception SecurityException if the caller does not pass a
* security check for * security check for
* <code>SecurityPermission("authProvider.<i>name</i>")</code>, * {@code SecurityPermission("authProvider.name")},
* where <i>name</i> is the value returned by * where {@code name} is the value returned by
* this provider's <code>getName</code> method * this provider's {@code getName} method
*/ */
public abstract void login(Subject subject, CallbackHandler handler) public abstract void login(Subject subject, CallbackHandler handler)
throws LoginException; throws LoginException;
...@@ -93,18 +93,18 @@ public abstract class AuthProvider extends Provider { ...@@ -93,18 +93,18 @@ public abstract class AuthProvider extends Provider {
* @exception LoginException if the logout operation fails * @exception LoginException if the logout operation fails
* @exception SecurityException if the caller does not pass a * @exception SecurityException if the caller does not pass a
* security check for * security check for
* <code>SecurityPermission("authProvider.<i>name</i>")</code>, * {@code SecurityPermission("authProvider.name")},
* where <i>name</i> is the value returned by * where {@code name} is the value returned by
* this provider's <code>getName</code> method * this provider's {@code getName} method
*/ */
public abstract void logout() throws LoginException; public abstract void logout() throws LoginException;
/** /**
* Set a <code>CallbackHandler</code>. * Set a {@code CallbackHandler}.
* *
* <p> The provider uses this handler if one is not passed to the * <p> The provider uses this handler if one is not passed to the
* <code>login</code> method. The provider also uses this handler * {@code login} method. The provider also uses this handler
* if it invokes <code>login</code> on behalf of callers. * if it invokes {@code login} on behalf of callers.
* In either case if a handler is not set via this method, * In either case if a handler is not set via this method,
* the provider queries the * the provider queries the
* <i>auth.login.defaultCallbackHandler</i> security property * <i>auth.login.defaultCallbackHandler</i> security property
...@@ -113,14 +113,14 @@ public abstract class AuthProvider extends Provider { ...@@ -113,14 +113,14 @@ public abstract class AuthProvider extends Provider {
* the provider is assumed to have alternative means * the provider is assumed to have alternative means
* for obtaining authentication information. * for obtaining authentication information.
* *
* @param handler a <code>CallbackHandler</code> for obtaining * @param handler a {@code CallbackHandler} for obtaining
* authentication information, which may be <code>null</code> * authentication information, which may be {@code null}
* *
* @exception SecurityException if the caller does not pass a * @exception SecurityException if the caller does not pass a
* security check for * security check for
* <code>SecurityPermission("authProvider.<i>name</i>")</code>, * {@code SecurityPermission("authProvider.name")},
* where <i>name</i> is the value returned by * where {@code name} is the value returned by
* this provider's <code>getName</code> method * this provider's {@code getName} method
*/ */
public abstract void setCallbackHandler(CallbackHandler handler); public abstract void setCallbackHandler(CallbackHandler handler);
} }
src/share/classes/java/security/BasicPermission.java
浏览文件 @ fe6c9f2d
/* /*
* Copyright (c) 1997, 2012, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
...@@ -124,8 +124,8 @@ public abstract class BasicPermission extends Permission ...@@ -124,8 +124,8 @@ public abstract class BasicPermission extends Permission
* *
* @param name the name of the BasicPermission. * @param name the name of the BasicPermission.
* *
* @throws NullPointerException if <code>name</code> is <code>null</code>. * @throws NullPointerException if {@code name} is {@code null}.
* @throws IllegalArgumentException if <code>name</code> is empty. * @throws IllegalArgumentException if {@code name} is empty.
*/ */
public BasicPermission(String name) { public BasicPermission(String name) {
super(name); super(name);
...@@ -141,8 +141,8 @@ public abstract class BasicPermission extends Permission ...@@ -141,8 +141,8 @@ public abstract class BasicPermission extends Permission
* @param name the name of the BasicPermission. * @param name the name of the BasicPermission.
* @param actions ignored. * @param actions ignored.
* *
* @throws NullPointerException if <code>name</code> is <code>null</code>. * @throws NullPointerException if {@code name} is {@code null}.
* @throws IllegalArgumentException if <code>name</code> is empty. * @throws IllegalArgumentException if {@code name} is empty.
*/ */
public BasicPermission(String name, String actions) { public BasicPermission(String name, String actions) {
super(name); super(name);
...@@ -217,7 +217,7 @@ public abstract class BasicPermission extends Permission ...@@ -217,7 +217,7 @@ public abstract class BasicPermission extends Permission
/** /**
* Returns the hash code value for this object. * Returns the hash code value for this object.
* The hash code used is the hash code of the name, that is, * The hash code used is the hash code of the name, that is,
* <code>getName().hashCode()</code>, where <code>getName</code> is * {@code getName().hashCode()}, where {@code getName} is
* from the Permission superclass. * from the Permission superclass.
* *
* @return a hash code value for this object. * @return a hash code value for this object.
...@@ -243,7 +243,7 @@ public abstract class BasicPermission extends Permission ...@@ -243,7 +243,7 @@ public abstract class BasicPermission extends Permission
* *
* <p>BasicPermission objects must be stored in a manner that allows them * <p>BasicPermission objects must be stored in a manner that allows them
* to be inserted in any order, but that also enables the * to be inserted in any order, but that also enables the
* PermissionCollection <code>implies</code> method * PermissionCollection {@code implies} method
* to be implemented in an efficient (and consistent) manner. * to be implemented in an efficient (and consistent) manner.
* *
* @return a new PermissionCollection object suitable for * @return a new PermissionCollection object suitable for
...@@ -312,7 +312,7 @@ final class BasicPermissionCollection ...@@ -312,7 +312,7 @@ final class BasicPermissionCollection
private transient Map<String, Permission> perms; private transient Map<String, Permission> perms;
/** /**
* This is set to <code>true</code> if this BasicPermissionCollection * This is set to {@code true} if this BasicPermissionCollection
* contains a BasicPermission with '*' as its permission name. * contains a BasicPermission with '*' as its permission name.
* *
* @see #serialPersistentFields * @see #serialPersistentFields
...@@ -477,7 +477,7 @@ final class BasicPermissionCollection ...@@ -477,7 +477,7 @@ final class BasicPermissionCollection
* The Hashtable is indexed by the BasicPermission name; the value * The Hashtable is indexed by the BasicPermission name; the value
* of the Hashtable entry is the permission. * of the Hashtable entry is the permission.
* @serialField all_allowed boolean * @serialField all_allowed boolean
* This is set to <code>true</code> if this BasicPermissionCollection * This is set to {@code true} if this BasicPermissionCollection
* contains a BasicPermission with '*' as its permission name. * contains a BasicPermission with '*' as its permission name.
* @serialField permClass java.lang.Class * @serialField permClass java.lang.Class
* The class to which all BasicPermissions in this * The class to which all BasicPermissions in this
......
src/share/classes/java/security/Certificate.java
浏览文件 @ fe6c9f2d
/* /*
* Copyright (c) 1996, 2006, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1996, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
...@@ -96,7 +96,7 @@ public interface Certificate { ...@@ -96,7 +96,7 @@ public interface Certificate {
/** /**
* Encodes the certificate to an output stream in a format that can * Encodes the certificate to an output stream in a format that can
* be decoded by the <code>decode</code> method. * be decoded by the {@code decode} method.
* *
* @param stream the output stream to which to encode the * @param stream the output stream to which to encode the
* certificate. * certificate.
...@@ -115,8 +115,8 @@ public interface Certificate { ...@@ -115,8 +115,8 @@ public interface Certificate {
/** /**
* Decodes a certificate from an input stream. The format should be * Decodes a certificate from an input stream. The format should be
* that returned by <code>getFormat</code> and produced by * that returned by {@code getFormat} and produced by
* <code>encode</code>. * {@code encode}.
* *
* @param stream the input stream from which to fetch the data * @param stream the input stream from which to fetch the data
* being decoded. * being decoded.
...@@ -137,8 +137,8 @@ public interface Certificate { ...@@ -137,8 +137,8 @@ public interface Certificate {
/** /**
* Returns the name of the coding format. This is used as a hint to find * Returns the name of the coding format. This is used as a hint to find
* an appropriate parser. It could be "X.509", "PGP", etc. This is * an appropriate parser. It could be "X.509", "PGP", etc. This is
* the format produced and understood by the <code>encode</code> * the format produced and understood by the {@code encode}
* and <code>decode</code> methods. * and {@code decode} methods.
* *
* @return the name of the coding format. * @return the name of the coding format.
*/ */
......
src/share/classes/java/security/CodeSigner.java
浏览文件 @ fe6c9f2d
/* /*
* Copyright (c) 2003, 2011, 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. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
...@@ -63,12 +63,12 @@ public final class CodeSigner implements Serializable { ...@@ -63,12 +63,12 @@ public final class CodeSigner implements Serializable {
* Constructs a CodeSigner object. * Constructs a CodeSigner object.
* *
* @param signerCertPath The signer's certificate path. * @param signerCertPath The signer's certificate path.
* It must not be <code>null</code>. * It must not be {@code null}.
* @param timestamp A signature timestamp. * @param timestamp A signature timestamp.
* If <code>null</code> then no timestamp was generated * If {@code null} then no timestamp was generated
* for the signature. * for the signature.
* @throws NullPointerException if <code>signerCertPath</code> is * @throws NullPointerException if {@code signerCertPath} is
* <code>null</code>. * {@code null}.
*/ */
public CodeSigner(CertPath signerCertPath, Timestamp timestamp) { public CodeSigner(CertPath signerCertPath, Timestamp timestamp) {
if (signerCertPath == null) { if (signerCertPath == null) {
...@@ -90,7 +90,7 @@ public final class CodeSigner implements Serializable { ...@@ -90,7 +90,7 @@ public final class CodeSigner implements Serializable {
/** /**
* Returns the signature timestamp. * Returns the signature timestamp.
* *
* @return The timestamp or <code>null</code> if none is present. * @return The timestamp or {@code null} if none is present.
*/ */
public Timestamp getTimestamp() { public Timestamp getTimestamp() {
return timestamp; return timestamp;
......
src/share/classes/java/security/CodeSource.java
浏览文件 @ fe6c9f2d
/* /*
* Copyright (c) 1997, 2012, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
...@@ -485,13 +485,13 @@ public class CodeSource implements java.io.Serializable { ...@@ -485,13 +485,13 @@ public class CodeSource implements java.io.Serializable {
/** /**
* Writes this object out to a stream (i.e., serializes it). * Writes this object out to a stream (i.e., serializes it).
* *
* @serialData An initial <code>URL</code> is followed by an * @serialData An initial {@code URL} is followed by an
* <code>int</code> indicating the number of certificates to follow * {@code int} indicating the number of certificates to follow
* (a value of "zero" denotes that there are no certificates associated * (a value of "zero" denotes that there are no certificates associated
* with this object). * with this object).
* Each certificate is written out starting with a <code>String</code> * Each certificate is written out starting with a {@code String}
* denoting the certificate type, followed by an * denoting the certificate type, followed by an
* <code>int</code> specifying the length of the certificate encoding, * {@code int} specifying the length of the certificate encoding,
* followed by the certificate encoding itself which is written out as an * followed by the certificate encoding itself which is written out as an
* array of bytes. Finally, if any code signers are present then the array * array of bytes. Finally, if any code signers are present then the array
* of code signers is serialized and written out too. * of code signers is serialized and written out too.
......
src/share/classes/java/security/DigestException.java
浏览文件 @ fe6c9f2d
/* /*
* Copyright (c) 1996, 2003, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1996, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
...@@ -55,13 +55,13 @@ public class DigestException extends GeneralSecurityException { ...@@ -55,13 +55,13 @@ public class DigestException extends GeneralSecurityException {
} }
/** /**
* Creates a <code>DigestException</code> with the specified * Creates a {@code DigestException} with the specified
* detail message and cause. * detail message and cause.
* *
* @param message the detail message (which is saved for later retrieval * @param message the detail message (which is saved for later retrieval
* by the {@link #getMessage()} method). * by the {@link #getMessage()} method).
* @param cause the cause (which is saved for later retrieval by the * @param cause the cause (which is saved for later retrieval by the
* {@link #getCause()} method). (A <tt>null</tt> value is permitted, * {@link #getCause()} method). (A {@code null} value is permitted,
* and indicates that the cause is nonexistent or unknown.) * and indicates that the cause is nonexistent or unknown.)
* @since 1.5 * @since 1.5
*/ */
...@@ -70,13 +70,13 @@ public class DigestException extends GeneralSecurityException { ...@@ -70,13 +70,13 @@ public class DigestException extends GeneralSecurityException {
} }
/** /**
* Creates a <code>DigestException</code> with the specified cause * Creates a {@code DigestException} with the specified cause
* and a detail message of <tt>(cause==null ? null : cause.toString())</tt> * and a detail message of {@code (cause==null ? null : cause.toString())}
* (which typically contains the class and detail message of * (which typically contains the class and detail message of
* <tt>cause</tt>). * {@code cause}).
* *
* @param cause the cause (which is saved for later retrieval by the * @param cause the cause (which is saved for later retrieval by the
* {@link #getCause()} method). (A <tt>null</tt> value is permitted, * {@link #getCause()} method). (A {@code null} value is permitted,
* and indicates that the cause is nonexistent or unknown.) * and indicates that the cause is nonexistent or unknown.)
* @since 1.5 * @since 1.5
*/ */
......
src/share/classes/java/security/DigestInputStream.java
浏览文件 @ fe6c9f2d
/* /*
* Copyright (c) 1996, 1999, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1996, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
...@@ -37,13 +37,13 @@ import java.io.ByteArrayInputStream; ...@@ -37,13 +37,13 @@ import java.io.ByteArrayInputStream;
* the bits going through the stream. * the bits going through the stream.
* *
* <p>To complete the message digest computation, call one of the * <p>To complete the message digest computation, call one of the
* <code>digest</code> methods on the associated message * {@code digest} methods on the associated message
* digest after your calls to one of this digest input stream's * digest after your calls to one of this digest input stream's
* {@link #read() read} methods. * {@link #read() read} methods.
* *
* <p>It is possible to turn this stream on or off (see * <p>It is possible to turn this stream on or off (see
* {@link #on(boolean) on}). When it is on, a call to one of the * {@link #on(boolean) on}). When it is on, a call to one of the
* <code>read</code> methods * {@code read} methods
* results in an update on the message digest. But when it is off, * results in an update on the message digest. But when it is off,
* the message digest is not updated. The default is for the stream * the message digest is not updated. The default is for the stream
* to be on. * to be on.
...@@ -111,7 +111,7 @@ public class DigestInputStream extends FilterInputStream { ...@@ -111,7 +111,7 @@ public class DigestInputStream extends FilterInputStream {
* function is on). That is, this method reads a byte from the * function is on). That is, this method reads a byte from the
* input stream, blocking until the byte is actually read. If the * input stream, blocking until the byte is actually read. If the
* digest function is on (see {@link #on(boolean) on}), this method * digest function is on (see {@link #on(boolean) on}), this method
* will then call <code>update</code> on the message digest associated * will then call {@code update} on the message digest associated
* with this stream, passing it the byte read. * with this stream, passing it the byte read.
* *
* @return the byte read. * @return the byte read.
...@@ -131,25 +131,25 @@ public class DigestInputStream extends FilterInputStream { ...@@ -131,25 +131,25 @@ public class DigestInputStream extends FilterInputStream {
/** /**
* Reads into a byte array, and updates the message digest (if the * Reads into a byte array, and updates the message digest (if the
* digest function is on). That is, this method reads up to * digest function is on). That is, this method reads up to
* <code>len</code> bytes from the input stream into the array * {@code len} bytes from the input stream into the array
* <code>b</code>, starting at offset <code>off</code>. This method * {@code b}, starting at offset {@code off}. This method
* blocks until the data is actually * blocks until the data is actually
* read. If the digest function is on (see * read. If the digest function is on (see
* {@link #on(boolean) on}), this method will then call <code>update</code> * {@link #on(boolean) on}), this method will then call {@code update}
* on the message digest associated with this stream, passing it * on the message digest associated with this stream, passing it
* the data. * the data.
* *
* @param b the array into which the data is read. * @param b the array into which the data is read.
* *
* @param off the starting offset into <code>b</code> of where the * @param off the starting offset into {@code b} of where the
* data should be placed. * data should be placed.
* *
* @param len the maximum number of bytes to be read from the input * @param len the maximum number of bytes to be read from the input
* stream into b, starting at offset <code>off</code>. * stream into b, starting at offset {@code off}.
* *
* @return the actual number of bytes read. This is less than * @return the actual number of bytes read. This is less than
* <code>len</code> if the end of the stream is reached prior to * {@code len} if the end of the stream is reached prior to
* reading <code>len</code> bytes. -1 is returned if no bytes were * reading {@code len} bytes. -1 is returned if no bytes were
* read because the end of the stream had already been reached when * read because the end of the stream had already been reached when
* the call was made. * the call was made.
* *
...@@ -167,7 +167,7 @@ public class DigestInputStream extends FilterInputStream { ...@@ -167,7 +167,7 @@ public class DigestInputStream extends FilterInputStream {
/** /**
* Turns the digest function on or off. The default is on. When * Turns the digest function on or off. The default is on. When
* it is on, a call to one of the <code>read</code> methods results in an * it is on, a call to one of the {@code read} methods results in an
* update on the message digest. But when it is off, the message * update on the message digest. But when it is off, the message
* digest is not updated. * digest is not updated.
* *
......
src/share/classes/java/security/DigestOutputStream.java
浏览文件 @ fe6c9f2d
...@@ -37,13 +37,13 @@ import java.io.ByteArrayOutputStream; ...@@ -37,13 +37,13 @@ import java.io.ByteArrayOutputStream;
* the bits going through the stream. * the bits going through the stream.
* *
* <p>To complete the message digest computation, call one of the * <p>To complete the message digest computation, call one of the
* <code>digest</code> methods on the associated message * {@code digest} methods on the associated message
* digest after your calls to one of this digest ouput stream's * digest after your calls to one of this digest ouput stream's
* {@link #write(int) write} methods. * {@link #write(int) write} methods.
* *
* <p>It is possible to turn this stream on or off (see * <p>It is possible to turn this stream on or off (see
* {@link #on(boolean) on}). When it is on, a call to one of the * {@link #on(boolean) on}). When it is on, a call to one of the
* <code>write</code> methods results in * {@code write} methods results in
* an update on the message digest. But when it is off, the message * an update on the message digest. But when it is off, the message
* digest is not updated. The default is for the stream to be on. * digest is not updated. The default is for the stream to be on.
* *
...@@ -99,8 +99,8 @@ public class DigestOutputStream extends FilterOutputStream { ...@@ -99,8 +99,8 @@ public class DigestOutputStream extends FilterOutputStream {
* the specified byte, and in any case writes the byte * the specified byte, and in any case writes the byte
* to the output stream. That is, if the digest function is on * to the output stream. That is, if the digest function is on
* (see {@link #on(boolean) on}), this method calls * (see {@link #on(boolean) on}), this method calls
* <code>update</code> on the message digest associated with this * {@code update} on the message digest associated with this
* stream, passing it the byte <code>b</code>. This method then * stream, passing it the byte {@code b}. This method then
* writes the byte to the output stream, blocking until the byte * writes the byte to the output stream, blocking until the byte
* is actually written. * is actually written.
* *
...@@ -122,7 +122,7 @@ public class DigestOutputStream extends FilterOutputStream { ...@@ -122,7 +122,7 @@ public class DigestOutputStream extends FilterOutputStream {
* Updates the message digest (if the digest function is on) using * Updates the message digest (if the digest function is on) using
* the specified subarray, and in any case writes the subarray to * the specified subarray, and in any case writes the subarray to
* the output stream. That is, if the digest function is on (see * the output stream. That is, if the digest function is on (see
* {@link #on(boolean) on}), this method calls <code>update</code> * {@link #on(boolean) on}), this method calls {@code update}
* on the message digest associated with this stream, passing it * on the message digest associated with this stream, passing it
* the subarray specifications. This method then writes the subarray * the subarray specifications. This method then writes the subarray
* bytes to the output stream, blocking until the bytes are actually * bytes to the output stream, blocking until the bytes are actually
...@@ -131,11 +131,11 @@ public class DigestOutputStream extends FilterOutputStream { ...@@ -131,11 +131,11 @@ public class DigestOutputStream extends FilterOutputStream {
* @param b the array containing the subarray to be used for updating * @param b the array containing the subarray to be used for updating
* and writing to the output stream. * and writing to the output stream.
* *
* @param off the offset into <code>b</code> of the first byte to * @param off the offset into {@code b} of the first byte to
* be updated and written. * be updated and written.
* *
* @param len the number of bytes of data to be updated and written * @param len the number of bytes of data to be updated and written
* from <code>b</code>, starting at offset <code>off</code>. * from {@code b}, starting at offset {@code off}.
* *
* @exception IOException if an I/O error occurs. * @exception IOException if an I/O error occurs.
* *
...@@ -150,7 +150,7 @@ public class DigestOutputStream extends FilterOutputStream { ...@@ -150,7 +150,7 @@ public class DigestOutputStream extends FilterOutputStream {
/** /**
* Turns the digest function on or off. The default is on. When * Turns the digest function on or off. The default is on. When
* it is on, a call to one of the <code>write</code> methods results in an * it is on, a call to one of the {@code write} methods results in an
* update on the message digest. But when it is off, the message * update on the message digest. But when it is off, the message
* digest is not updated. * digest is not updated.
* *
......
src/share/classes/java/security/DomainCombiner.java
浏览文件 @ fe6c9f2d
/* /*
* Copyright (c) 1999, 2006, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1999, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
...@@ -26,27 +26,27 @@ ...@@ -26,27 +26,27 @@
package java.security; package java.security;
/** /**
* A <code>DomainCombiner</code> provides a means to dynamically * A {@code DomainCombiner} provides a means to dynamically
* update the ProtectionDomains associated with the current * update the ProtectionDomains associated with the current
* <code>AccessControlContext</code>. * {@code AccessControlContext}.
* *
* <p> A <code>DomainCombiner</code> is passed as a parameter to the * <p> A {@code DomainCombiner} is passed as a parameter to the
* appropriate constructor for <code>AccessControlContext</code>. * appropriate constructor for {@code AccessControlContext}.
* The newly constructed context is then passed to the * The newly constructed context is then passed to the
* <code>AccessController.doPrivileged(..., context)</code> method * {@code AccessController.doPrivileged(..., context)} method
* to bind the provided context (and associated <code>DomainCombiner</code>) * to bind the provided context (and associated {@code DomainCombiner})
* with the current execution Thread. Subsequent calls to * with the current execution Thread. Subsequent calls to
* <code>AccessController.getContext</code> or * {@code AccessController.getContext} or
* <code>AccessController.checkPermission</code> * {@code AccessController.checkPermission}
* cause the <code>DomainCombiner.combine</code> to get invoked. * cause the {@code DomainCombiner.combine} to get invoked.
* *
* <p> The combine method takes two arguments. The first argument represents * <p> The combine method takes two arguments. The first argument represents
* an array of ProtectionDomains from the current execution Thread, * an array of ProtectionDomains from the current execution Thread,
* since the most recent call to <code>AccessController.doPrivileged</code>. * since the most recent call to {@code AccessController.doPrivileged}.
* If no call to doPrivileged was made, then the first argument will contain * If no call to doPrivileged was made, then the first argument will contain
* all the ProtectionDomains from the current execution Thread. * all the ProtectionDomains from the current execution Thread.
* The second argument represents an array of inherited ProtectionDomains, * The second argument represents an array of inherited ProtectionDomains,
* which may be <code>null</code>. ProtectionDomains may be inherited * which may be {@code null}. ProtectionDomains may be inherited
* from a parent Thread, or from a privileged context. If no call to * from a parent Thread, or from a privileged context. If no call to
* doPrivileged was made, then the second argument will contain the * doPrivileged was made, then the second argument will contain the
* ProtectionDomains inherited from the parent Thread. If one or more calls * ProtectionDomains inherited from the parent Thread. If one or more calls
...@@ -54,25 +54,25 @@ package java.security; ...@@ -54,25 +54,25 @@ package java.security;
* doPrivileged(action, context), then the second argument will contain the * doPrivileged(action, context), then the second argument will contain the
* ProtectionDomains from the privileged context. If the most recent call * ProtectionDomains from the privileged context. If the most recent call
* was to doPrivileged(action), then there is no privileged context, * was to doPrivileged(action), then there is no privileged context,
* and the second argument will be <code>null</code>. * and the second argument will be {@code null}.
* *
* <p> The <code>combine</code> method investigates the two input arrays * <p> The {@code combine} method investigates the two input arrays
* of ProtectionDomains and returns a single array containing the updated * of ProtectionDomains and returns a single array containing the updated
* ProtectionDomains. In the simplest case, the <code>combine</code> * ProtectionDomains. In the simplest case, the {@code combine}
* method merges the two stacks into one. In more complex cases, * method merges the two stacks into one. In more complex cases,
* the <code>combine</code> method returns a modified * the {@code combine} method returns a modified
* stack of ProtectionDomains. The modification may have added new * stack of ProtectionDomains. The modification may have added new
* ProtectionDomains, removed certain ProtectionDomains, or simply * ProtectionDomains, removed certain ProtectionDomains, or simply
* updated existing ProtectionDomains. Re-ordering and other optimizations * updated existing ProtectionDomains. Re-ordering and other optimizations
* to the ProtectionDomains are also permitted. Typically the * to the ProtectionDomains are also permitted. Typically the
* <code>combine</code> method bases its updates on the information * {@code combine} method bases its updates on the information
* encapsulated in the <code>DomainCombiner</code>. * encapsulated in the {@code DomainCombiner}.
* *
* <p> After the <code>AccessController.getContext</code> method * <p> After the {@code AccessController.getContext} method
* receives the combined stack of ProtectionDomains back from * receives the combined stack of ProtectionDomains back from
* the <code>DomainCombiner</code>, it returns a new * the {@code DomainCombiner}, it returns a new
* AccessControlContext that has both the combined ProtectionDomains * AccessControlContext that has both the combined ProtectionDomains
* as well as the <code>DomainCombiner</code>. * as well as the {@code DomainCombiner}.
* *
* @see AccessController * @see AccessController
* @see AccessControlContext * @see AccessControlContext
...@@ -91,21 +91,21 @@ public interface DomainCombiner { ...@@ -91,21 +91,21 @@ public interface DomainCombiner {
* *
* @param currentDomains the ProtectionDomains associated with the * @param currentDomains the ProtectionDomains associated with the
* current execution Thread, up to the most recent * current execution Thread, up to the most recent
* privileged <code>ProtectionDomain</code>. * privileged {@code ProtectionDomain}.
* The ProtectionDomains are are listed in order of execution, * The ProtectionDomains are are listed in order of execution,
* with the most recently executing <code>ProtectionDomain</code> * with the most recently executing {@code ProtectionDomain}
* residing at the beginning of the array. This parameter may * residing at the beginning of the array. This parameter may
* be <code>null</code> if the current execution Thread * be {@code null} if the current execution Thread
* has no associated ProtectionDomains.<p> * has no associated ProtectionDomains.<p>
* *
* @param assignedDomains an array of inherited ProtectionDomains. * @param assignedDomains an array of inherited ProtectionDomains.
* ProtectionDomains may be inherited from a parent Thread, * ProtectionDomains may be inherited from a parent Thread,
* or from a privileged <code>AccessControlContext</code>. * or from a privileged {@code AccessControlContext}.
* This parameter may be <code>null</code> * This parameter may be {@code null}
* if there are no inherited ProtectionDomains. * if there are no inherited ProtectionDomains.
* *
* @return a new array consisting of the updated ProtectionDomains, * @return a new array consisting of the updated ProtectionDomains,
* or <code>null</code>. * or {@code null}.
*/ */
ProtectionDomain[] combine(ProtectionDomain[] currentDomains, ProtectionDomain[] combine(ProtectionDomain[] currentDomains,
ProtectionDomain[] assignedDomains); ProtectionDomain[] assignedDomains);
......
src/share/classes/java/security/GeneralSecurityException.java
浏览文件 @ fe6c9f2d
/* /*
* Copyright (c) 1997, 2003, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
...@@ -26,7 +26,7 @@ ...@@ -26,7 +26,7 @@
package java.security; package java.security;
/** /**
* The <code>GeneralSecurityException</code> class is a generic * The {@code GeneralSecurityException} class is a generic
* security exception class that provides type safety for all the * security exception class that provides type safety for all the
* security-related exception classes that extend from it. * security-related exception classes that extend from it.
* *
...@@ -57,13 +57,13 @@ public class GeneralSecurityException extends Exception { ...@@ -57,13 +57,13 @@ public class GeneralSecurityException extends Exception {
} }
/** /**
* Creates a <code>GeneralSecurityException</code> with the specified * Creates a {@code GeneralSecurityException} with the specified
* detail message and cause. * detail message and cause.
* *
* @param message the detail message (which is saved for later retrieval * @param message the detail message (which is saved for later retrieval
* by the {@link #getMessage()} method). * by the {@link #getMessage()} method).
* @param cause the cause (which is saved for later retrieval by the * @param cause the cause (which is saved for later retrieval by the
* {@link #getCause()} method). (A <tt>null</tt> value is permitted, * {@link #getCause()} method). (A {@code null} value is permitted,
* and indicates that the cause is nonexistent or unknown.) * and indicates that the cause is nonexistent or unknown.)
* @since 1.5 * @since 1.5
*/ */
...@@ -72,13 +72,13 @@ public class GeneralSecurityException extends Exception { ...@@ -72,13 +72,13 @@ public class GeneralSecurityException extends Exception {
} }
/** /**
* Creates a <code>GeneralSecurityException</code> with the specified cause * Creates a {@code GeneralSecurityException} with the specified cause
* and a detail message of <tt>(cause==null ? null : cause.toString())</tt> * and a detail message of {@code (cause==null ? null : cause.toString())}
* (which typically contains the class and detail message of * (which typically contains the class and detail message of
* <tt>cause</tt>). * {@code cause}).
* *
* @param cause the cause (which is saved for later retrieval by the * @param cause the cause (which is saved for later retrieval by the
* {@link #getCause()} method). (A <tt>null</tt> value is permitted, * {@link #getCause()} method). (A {@code null} value is permitted,
* and indicates that the cause is nonexistent or unknown.) * and indicates that the cause is nonexistent or unknown.)
* @since 1.5 * @since 1.5
*/ */
......
src/share/classes/java/security/Guard.java
浏览文件 @ fe6c9f2d
/* /*
* Copyright (c) 1997, 1998, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
...@@ -29,9 +29,9 @@ package java.security; ...@@ -29,9 +29,9 @@ package java.security;
* <p> This interface represents a guard, which is an object that is used * <p> This interface represents a guard, which is an object that is used
* to protect access to another object. * to protect access to another object.
* *
* <p>This interface contains a single method, <code>checkGuard</code>, * <p>This interface contains a single method, {@code checkGuard},
* with a single <code>object</code> argument. <code>checkGuard</code> is * with a single {@code object} argument. {@code checkGuard} is
* invoked (by the GuardedObject <code>getObject</code> method) * invoked (by the GuardedObject {@code getObject} method)
* to determine whether or not to allow access to the object. * to determine whether or not to allow access to the object.
* *
* @see GuardedObject * @see GuardedObject
...@@ -44,7 +44,7 @@ public interface Guard { ...@@ -44,7 +44,7 @@ public interface Guard {
/** /**
* Determines whether or not to allow access to the guarded object * Determines whether or not to allow access to the guarded object
* <code>object</code>. Returns silently if access is allowed. * {@code object}. Returns silently if access is allowed.
* Otherwise, throws a SecurityException. * Otherwise, throws a SecurityException.
* *
* @param object the object being protected by the guard. * @param object the object being protected by the guard.
......
src/share/classes/java/security/GuardedObject.java
浏览文件 @ fe6c9f2d
/* /*
* Copyright (c) 1997, 2004, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
...@@ -33,9 +33,9 @@ package java.security; ...@@ -33,9 +33,9 @@ package java.security;
* such that access to the target object is possible * such that access to the target object is possible
* only if the Guard object allows it. * only if the Guard object allows it.
* Once an object is encapsulated by a GuardedObject, * Once an object is encapsulated by a GuardedObject,
* access to that object is controlled by the <code>getObject</code> * access to that object is controlled by the {@code getObject}
* method, which invokes the * method, which invokes the
* <code>checkGuard</code> method on the Guard object that is * {@code checkGuard} method on the Guard object that is
* guarding access. If access is not allowed, * guarding access. If access is not allowed,
* an exception is thrown. * an exception is thrown.
* *
......
src/share/classes/java/security/Identity.java
浏览文件 @ fe6c9f2d
/* /*
* Copyright (c) 1996, 2006, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1996, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
...@@ -52,9 +52,9 @@ import java.util.*; ...@@ -52,9 +52,9 @@ import java.util.*;
* *
* @author Benjamin Renaud * @author Benjamin Renaud
* @deprecated This class is no longer used. Its functionality has been * @deprecated This class is no longer used. Its functionality has been
* replaced by <code>java.security.KeyStore</code>, the * replaced by {@code java.security.KeyStore}, the
* <code>java.security.cert</code> package, and * {@code java.security.cert} package, and
* <code>java.security.Principal</code>. * {@code java.security.Principal}.
*/ */
@Deprecated @Deprecated
public abstract class Identity implements Principal, Serializable { public abstract class Identity implements Principal, Serializable {
...@@ -164,8 +164,8 @@ public abstract class Identity implements Principal, Serializable { ...@@ -164,8 +164,8 @@ public abstract class Identity implements Principal, Serializable {
* Sets this identity's public key. The old key and all of this * Sets this identity's public key. The old key and all of this
* identity's certificates are removed by this operation. * identity's certificates are removed by this operation.
* *
* <p>First, if there is a security manager, its <code>checkSecurityAccess</code> * <p>First, if there is a security manager, its {@code checkSecurityAccess}
* method is called with <code>"setIdentityPublicKey"</code> * method is called with {@code "setIdentityPublicKey"}
* as its argument to see if it's ok to set the public key. * as its argument to see if it's ok to set the public key.
* *
* @param key the public key for this identity. * @param key the public key for this identity.
...@@ -174,7 +174,7 @@ public abstract class Identity implements Principal, Serializable { ...@@ -174,7 +174,7 @@ public abstract class Identity implements Principal, Serializable {
* identity's scope has the same public key, or if another exception occurs. * identity's scope has the same public key, or if another exception occurs.
* *
* @exception SecurityException if a security manager exists and its * @exception SecurityException if a security manager exists and its
* <code>checkSecurityAccess</code> method doesn't allow * {@code checkSecurityAccess} method doesn't allow
* setting the public key. * setting the public key.
* *
* @see #getPublicKey * @see #getPublicKey
...@@ -191,14 +191,14 @@ public abstract class Identity implements Principal, Serializable { ...@@ -191,14 +191,14 @@ public abstract class Identity implements Principal, Serializable {
/** /**
* Specifies a general information string for this identity. * Specifies a general information string for this identity.
* *
* <p>First, if there is a security manager, its <code>checkSecurityAccess</code> * <p>First, if there is a security manager, its {@code checkSecurityAccess}
* method is called with <code>"setIdentityInfo"</code> * method is called with {@code "setIdentityInfo"}
* as its argument to see if it's ok to specify the information string. * as its argument to see if it's ok to specify the information string.
* *
* @param info the information string. * @param info the information string.
* *
* @exception SecurityException if a security manager exists and its * @exception SecurityException if a security manager exists and its
* <code>checkSecurityAccess</code> method doesn't allow * {@code checkSecurityAccess} method doesn't allow
* setting the information string. * setting the information string.
* *
* @see #getInfo * @see #getInfo
...@@ -226,8 +226,8 @@ public abstract class Identity implements Principal, Serializable { ...@@ -226,8 +226,8 @@ public abstract class Identity implements Principal, Serializable {
* the identity does not have a public key, the identity's * the identity does not have a public key, the identity's
* public key is set to be that specified in the certificate. * public key is set to be that specified in the certificate.
* *
* <p>First, if there is a security manager, its <code>checkSecurityAccess</code> * <p>First, if there is a security manager, its {@code checkSecurityAccess}
* method is called with <code>"addIdentityCertificate"</code> * method is called with {@code "addIdentityCertificate"}
* as its argument to see if it's ok to add a certificate. * as its argument to see if it's ok to add a certificate.
* *
* @param certificate the certificate to be added. * @param certificate the certificate to be added.
...@@ -237,7 +237,7 @@ public abstract class Identity implements Principal, Serializable { ...@@ -237,7 +237,7 @@ public abstract class Identity implements Principal, Serializable {
* this identity's public key, or if another exception occurs. * this identity's public key, or if another exception occurs.
* *
* @exception SecurityException if a security manager exists and its * @exception SecurityException if a security manager exists and its
* <code>checkSecurityAccess</code> method doesn't allow * {@code checkSecurityAccess} method doesn't allow
* adding a certificate. * adding a certificate.
* *
* @see SecurityManager#checkSecurityAccess * @see SecurityManager#checkSecurityAccess
...@@ -277,8 +277,8 @@ public abstract class Identity implements Principal, Serializable { ...@@ -277,8 +277,8 @@ public abstract class Identity implements Principal, Serializable {
/** /**
* Removes a certificate from this identity. * Removes a certificate from this identity.
* *
* <p>First, if there is a security manager, its <code>checkSecurityAccess</code> * <p>First, if there is a security manager, its {@code checkSecurityAccess}
* method is called with <code>"removeIdentityCertificate"</code> * method is called with {@code "removeIdentityCertificate"}
* as its argument to see if it's ok to remove a certificate. * as its argument to see if it's ok to remove a certificate.
* *
* @param certificate the certificate to be removed. * @param certificate the certificate to be removed.
...@@ -287,7 +287,7 @@ public abstract class Identity implements Principal, Serializable { ...@@ -287,7 +287,7 @@ public abstract class Identity implements Principal, Serializable {
* missing, or if another exception occurs. * missing, or if another exception occurs.
* *
* @exception SecurityException if a security manager exists and its * @exception SecurityException if a security manager exists and its
* <code>checkSecurityAccess</code> method doesn't allow * {@code checkSecurityAccess} method doesn't allow
* removing a certificate. * removing a certificate.
* *
* @see SecurityManager#checkSecurityAccess * @see SecurityManager#checkSecurityAccess
...@@ -390,15 +390,15 @@ public abstract class Identity implements Principal, Serializable { ...@@ -390,15 +390,15 @@ public abstract class Identity implements Principal, Serializable {
* Returns a short string describing this identity, telling its * Returns a short string describing this identity, telling its
* name and its scope (if any). * name and its scope (if any).
* *
* <p>First, if there is a security manager, its <code>checkSecurityAccess</code> * <p>First, if there is a security manager, its {@code checkSecurityAccess}
* method is called with <code>"printIdentity"</code> * method is called with {@code "printIdentity"}
* as its argument to see if it's ok to return the string. * as its argument to see if it's ok to return the string.
* *
* @return information about this identity, such as its name and the * @return information about this identity, such as its name and the
* name of its scope (if any). * name of its scope (if any).
* *
* @exception SecurityException if a security manager exists and its * @exception SecurityException if a security manager exists and its
* <code>checkSecurityAccess</code> method doesn't allow * {@code checkSecurityAccess} method doesn't allow
* returning a string describing this identity. * returning a string describing this identity.
* *
* @see SecurityManager#checkSecurityAccess * @see SecurityManager#checkSecurityAccess
...@@ -415,20 +415,20 @@ public abstract class Identity implements Principal, Serializable { ...@@ -415,20 +415,20 @@ public abstract class Identity implements Principal, Serializable {
/** /**
* Returns a string representation of this identity, with * Returns a string representation of this identity, with
* optionally more details than that provided by the * optionally more details than that provided by the
* <code>toString</code> method without any arguments. * {@code toString} method without any arguments.
* *
* <p>First, if there is a security manager, its <code>checkSecurityAccess</code> * <p>First, if there is a security manager, its {@code checkSecurityAccess}
* method is called with <code>"printIdentity"</code> * method is called with {@code "printIdentity"}
* as its argument to see if it's ok to return the string. * as its argument to see if it's ok to return the string.
* *
* @param detailed whether or not to provide detailed information. * @param detailed whether or not to provide detailed information.
* *
* @return information about this identity. If <code>detailed</code> * @return information about this identity. If {@code detailed}
* is true, then this method returns more information than that * is true, then this method returns more information than that
* provided by the <code>toString</code> method without any arguments. * provided by the {@code toString} method without any arguments.
* *
* @exception SecurityException if a security manager exists and its * @exception SecurityException if a security manager exists and its
* <code>checkSecurityAccess</code> method doesn't allow * {@code checkSecurityAccess} method doesn't allow
* returning a string describing this identity. * returning a string describing this identity.
* *
* @see #toString * @see #toString
......
src/share/classes/java/security/IdentityScope.java
浏览文件 @ fe6c9f2d
/* /*
* Copyright (c) 1996, 2010, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1996, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
...@@ -57,9 +57,9 @@ import java.util.Properties; ...@@ -57,9 +57,9 @@ import java.util.Properties;
* @author Benjamin Renaud * @author Benjamin Renaud
* *
* @deprecated This class is no longer used. Its functionality has been * @deprecated This class is no longer used. Its functionality has been
* replaced by <code>java.security.KeyStore</code>, the * replaced by {@code java.security.KeyStore}, the
* <code>java.security.cert</code> package, and * {@code java.security.cert} package, and
* <code>java.security.Principal</code>. * {@code java.security.Principal}.
*/ */
@Deprecated @Deprecated
public abstract public abstract
...@@ -146,14 +146,14 @@ class IdentityScope extends Identity { ...@@ -146,14 +146,14 @@ class IdentityScope extends Identity {
* Sets the system's identity scope. * Sets the system's identity scope.
* *
* <p>First, if there is a security manager, its * <p>First, if there is a security manager, its
* <code>checkSecurityAccess</code> * {@code checkSecurityAccess}
* method is called with <code>"setSystemScope"</code> * method is called with {@code "setSystemScope"}
* as its argument to see if it's ok to set the identity scope. * as its argument to see if it's ok to set the identity scope.
* *
* @param scope the scope to set. * @param scope the scope to set.
* *
* @exception SecurityException if a security manager exists and its * @exception SecurityException if a security manager exists and its
* <code>checkSecurityAccess</code> method doesn't allow * {@code checkSecurityAccess} method doesn't allow
* setting the identity scope. * setting the identity scope.
* *
* @see #getSystemScope * @see #getSystemScope
...@@ -176,8 +176,8 @@ class IdentityScope extends Identity { ...@@ -176,8 +176,8 @@ class IdentityScope extends Identity {
* *
* @param name the name of the identity to be retrieved. * @param name the name of the identity to be retrieved.
* *
* @return the identity named <code>name</code>, or null if there are * @return the identity named {@code name}, or null if there are
* no identities named <code>name</code> in this scope. * no identities named {@code name} in this scope.
*/ */
public abstract Identity getIdentity(String name); public abstract Identity getIdentity(String name);
......
src/share/classes/java/security/InvalidAlgorithmParameterException.java
浏览文件 @ fe6c9f2d
/* /*
* Copyright (c) 1997, 2003, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
...@@ -65,13 +65,13 @@ extends GeneralSecurityException { ...@@ -65,13 +65,13 @@ extends GeneralSecurityException {
} }
/** /**
* Creates a <code>InvalidAlgorithmParameterException</code> with the * Creates a {@code InvalidAlgorithmParameterException} with the
* specified detail message and cause. * specified detail message and cause.
* *
* @param message the detail message (which is saved for later retrieval * @param message the detail message (which is saved for later retrieval
* by the {@link #getMessage()} method). * by the {@link #getMessage()} method).
* @param cause the cause (which is saved for later retrieval by the * @param cause the cause (which is saved for later retrieval by the
* {@link #getCause()} method). (A <tt>null</tt> value is permitted, * {@link #getCause()} method). (A {@code null} value is permitted,
* and indicates that the cause is nonexistent or unknown.) * and indicates that the cause is nonexistent or unknown.)
* @since 1.5 * @since 1.5
*/ */
...@@ -80,14 +80,14 @@ extends GeneralSecurityException { ...@@ -80,14 +80,14 @@ extends GeneralSecurityException {
} }
/** /**
* Creates a <code>InvalidAlgorithmParameterException</code> with the * Creates a {@code InvalidAlgorithmParameterException} with the
* specified cause and a detail message of * specified cause and a detail message of
* <tt>(cause==null ? null : cause.toString())</tt> * {@code (cause==null ? null : cause.toString())}
* (which typically contains the class and detail message of * (which typically contains the class and detail message of
* <tt>cause</tt>). * {@code cause}).
* *
* @param cause the cause (which is saved for later retrieval by the * @param cause the cause (which is saved for later retrieval by the
* {@link #getCause()} method). (A <tt>null</tt> value is permitted, * {@link #getCause()} method). (A {@code null} value is permitted,
* and indicates that the cause is nonexistent or unknown.) * and indicates that the cause is nonexistent or unknown.)
* @since 1.5 * @since 1.5
*/ */
......
src/share/classes/java/security/InvalidKeyException.java
浏览文件 @ fe6c9f2d
/* /*
* Copyright (c) 1996, 2003, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1996, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
...@@ -58,13 +58,13 @@ public class InvalidKeyException extends KeyException { ...@@ -58,13 +58,13 @@ public class InvalidKeyException extends KeyException {
} }
/** /**
* Creates a <code>InvalidKeyException</code> with the specified * Creates a {@code InvalidKeyException} with the specified
* detail message and cause. * detail message and cause.
* *
* @param message the detail message (which is saved for later retrieval * @param message the detail message (which is saved for later retrieval
* by the {@link #getMessage()} method). * by the {@link #getMessage()} method).
* @param cause the cause (which is saved for later retrieval by the * @param cause the cause (which is saved for later retrieval by the
* {@link #getCause()} method). (A <tt>null</tt> value is permitted, * {@link #getCause()} method). (A {@code null} value is permitted,
* and indicates that the cause is nonexistent or unknown.) * and indicates that the cause is nonexistent or unknown.)
* @since 1.5 * @since 1.5
*/ */
...@@ -73,13 +73,13 @@ public class InvalidKeyException extends KeyException { ...@@ -73,13 +73,13 @@ public class InvalidKeyException extends KeyException {
} }
/** /**
* Creates a <code>InvalidKeyException</code> with the specified cause * Creates a {@code InvalidKeyException} with the specified cause
* and a detail message of <tt>(cause==null ? null : cause.toString())</tt> * and a detail message of {@code (cause==null ? null : cause.toString())}
* (which typically contains the class and detail message of * (which typically contains the class and detail message of
* <tt>cause</tt>). * {@code cause}).
* *
* @param cause the cause (which is saved for later retrieval by the * @param cause the cause (which is saved for later retrieval by the
* {@link #getCause()} method). (A <tt>null</tt> value is permitted, * {@link #getCause()} method). (A {@code null} value is permitted,
* and indicates that the cause is nonexistent or unknown.) * and indicates that the cause is nonexistent or unknown.)
* @since 1.5 * @since 1.5
*/ */
......
src/share/classes/java/security/Key.java
浏览文件 @ fe6c9f2d
/* /*
* Copyright (c) 1996, 2006, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1996, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
...@@ -47,9 +47,9 @@ package java.security; ...@@ -47,9 +47,9 @@ package java.security;
* representation of the key is needed outside the Java Virtual Machine, * representation of the key is needed outside the Java Virtual Machine,
* as when transmitting the key to some other party. The key * as when transmitting the key to some other party. The key
* is encoded according to a standard format (such as * is encoded according to a standard format (such as
* X.509 <code>SubjectPublicKeyInfo</code> or PKCS#8), and * X.509 {@code SubjectPublicKeyInfo} or PKCS#8), and
* is returned using the {@link #getEncoded() getEncoded} method. * is returned using the {@link #getEncoded() getEncoded} method.
* Note: The syntax of the ASN.1 type <code>SubjectPublicKeyInfo</code> * Note: The syntax of the ASN.1 type {@code SubjectPublicKeyInfo}
* is defined as follows: * is defined as follows:
* *
* <pre> * <pre>
...@@ -132,11 +132,11 @@ public interface Key extends java.io.Serializable { ...@@ -132,11 +132,11 @@ public interface Key extends java.io.Serializable {
* For example, the name of the ASN.1 data format for public * For example, the name of the ASN.1 data format for public
* keys is <I>SubjectPublicKeyInfo</I>, as * keys is <I>SubjectPublicKeyInfo</I>, as
* defined by the X.509 standard; in this case, the returned format is * defined by the X.509 standard; in this case, the returned format is
* <code>"X.509"</code>. Similarly, * {@code "X.509"}. Similarly,
* the name of the ASN.1 data format for private keys is * the name of the ASN.1 data format for private keys is
* <I>PrivateKeyInfo</I>, * <I>PrivateKeyInfo</I>,
* as defined by the PKCS #8 standard; in this case, the returned format is * as defined by the PKCS #8 standard; in this case, the returned format is
* <code>"PKCS#8"</code>. * {@code "PKCS#8"}.
* *
* @return the primary encoding format of the key. * @return the primary encoding format of the key.
*/ */
......
src/share/classes/java/security/KeyException.java
浏览文件 @ fe6c9f2d
/* /*
* Copyright (c) 1996, 2003, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1996, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
...@@ -59,13 +59,13 @@ public class KeyException extends GeneralSecurityException { ...@@ -59,13 +59,13 @@ public class KeyException extends GeneralSecurityException {
} }
/** /**
* Creates a <code>KeyException</code> with the specified * Creates a {@code KeyException} with the specified
* detail message and cause. * detail message and cause.
* *
* @param message the detail message (which is saved for later retrieval * @param message the detail message (which is saved for later retrieval
* by the {@link #getMessage()} method). * by the {@link #getMessage()} method).
* @param cause the cause (which is saved for later retrieval by the * @param cause the cause (which is saved for later retrieval by the
* {@link #getCause()} method). (A <tt>null</tt> value is permitted, * {@link #getCause()} method). (A {@code null} value is permitted,
* and indicates that the cause is nonexistent or unknown.) * and indicates that the cause is nonexistent or unknown.)
* @since 1.5 * @since 1.5
*/ */
...@@ -74,13 +74,13 @@ public class KeyException extends GeneralSecurityException { ...@@ -74,13 +74,13 @@ public class KeyException extends GeneralSecurityException {
} }
/** /**
* Creates a <code>KeyException</code> with the specified cause * Creates a {@code KeyException} with the specified cause
* and a detail message of <tt>(cause==null ? null : cause.toString())</tt> * and a detail message of {@code (cause==null ? null : cause.toString())}
* (which typically contains the class and detail message of * (which typically contains the class and detail message of
* <tt>cause</tt>). * {@code cause}).
* *
* @param cause the cause (which is saved for later retrieval by the * @param cause the cause (which is saved for later retrieval by the
* {@link #getCause()} method). (A <tt>null</tt> value is permitted, * {@link #getCause()} method). (A {@code null} value is permitted,
* and indicates that the cause is nonexistent or unknown.) * and indicates that the cause is nonexistent or unknown.)
* @since 1.5 * @since 1.5
*/ */
......
src/share/classes/java/security/KeyFactory.java
浏览文件 @ fe6c9f2d
/* /*
* Copyright (c) 1997, 2011, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
...@@ -37,7 +37,7 @@ import sun.security.jca.GetInstance.Instance; ...@@ -37,7 +37,7 @@ import sun.security.jca.GetInstance.Instance;
/** /**
* Key factories are used to convert <I>keys</I> (opaque * Key factories are used to convert <I>keys</I> (opaque
* cryptographic keys of type <code>Key</code>) into <I>key specifications</I> * cryptographic keys of type {@code Key}) into <I>key specifications</I>
* (transparent representations of the underlying key material), and vice * (transparent representations of the underlying key material), and vice
* versa. * versa.
* *
...@@ -47,8 +47,8 @@ import sun.security.jca.GetInstance.Instance; ...@@ -47,8 +47,8 @@ import sun.security.jca.GetInstance.Instance;
* *
* <P> Multiple compatible key specifications may exist for the same key. * <P> Multiple compatible key specifications may exist for the same key.
* For example, a DSA public key may be specified using * For example, a DSA public key may be specified using
* <code>DSAPublicKeySpec</code> or * {@code DSAPublicKeySpec} or
* <code>X509EncodedKeySpec</code>. A key factory can be used to translate * {@code X509EncodedKeySpec}. A key factory can be used to translate
* between compatible key specifications. * between compatible key specifications.
* *
* <P> The following is an example of how to use a key factory in order to * <P> The following is an example of how to use a key factory in order to
...@@ -68,11 +68,11 @@ import sun.security.jca.GetInstance.Instance; ...@@ -68,11 +68,11 @@ import sun.security.jca.GetInstance.Instance;
* </pre> * </pre>
* *
* <p> Every implementation of the Java platform is required to support the * <p> Every implementation of the Java platform is required to support the
* following standard <code>KeyFactory</code> algorithms: * following standard {@code KeyFactory} algorithms:
* <ul> * <ul>
* <li><tt>DiffieHellman</tt></li> * <li>{@code DiffieHellman}</li>
* <li><tt>DSA</tt></li> * <li>{@code DSA}</li>
* <li><tt>RSA</tt></li> * <li>{@code RSA}</li>
* </ul> * </ul>
* These algorithms are described in the <a href= * These algorithms are described in the <a href=
* "{@docRoot}/../technotes/guides/security/StandardNames.html#KeyFactory"> * "{@docRoot}/../technotes/guides/security/StandardNames.html#KeyFactory">
...@@ -120,7 +120,7 @@ public class KeyFactory { ...@@ -120,7 +120,7 @@ public class KeyFactory {
* @param keyFacSpi the delegate * @param keyFacSpi the delegate
* @param provider the provider * @param provider the provider
* @param algorithm the name of the algorithm * @param algorithm the name of the algorithm
* to associate with this <tt>KeyFactory</tt> * to associate with this {@code KeyFactory}
*/ */
protected KeyFactory(KeyFactorySpi keyFacSpi, Provider provider, protected KeyFactory(KeyFactorySpi keyFacSpi, Provider provider,
String algorithm) { String algorithm) {
...@@ -266,10 +266,10 @@ public class KeyFactory { ...@@ -266,10 +266,10 @@ public class KeyFactory {
/** /**
* Gets the name of the algorithm * Gets the name of the algorithm
* associated with this <tt>KeyFactory</tt>. * associated with this {@code KeyFactory}.
* *
* @return the name of the algorithm associated with this * @return the name of the algorithm associated with this
* <tt>KeyFactory</tt> * {@code KeyFactory}
*/ */
public final String getAlgorithm() { public final String getAlgorithm() {
return this.algorithm; return this.algorithm;
...@@ -389,11 +389,11 @@ public class KeyFactory { ...@@ -389,11 +389,11 @@ public class KeyFactory {
/** /**
* Returns a specification (key material) of the given key object. * Returns a specification (key material) of the given key object.
* <code>keySpec</code> identifies the specification class in which * {@code keySpec} identifies the specification class in which
* the key material should be returned. It could, for example, be * the key material should be returned. It could, for example, be
* <code>DSAPublicKeySpec.class</code>, to indicate that the * {@code DSAPublicKeySpec.class}, to indicate that the
* key material should be returned in an instance of the * key material should be returned in an instance of the
* <code>DSAPublicKeySpec</code> class. * {@code DSAPublicKeySpec} class.
* *
* @param key the key. * @param key the key.
* *
......
src/share/classes/java/security/KeyFactorySpi.java
浏览文件 @ fe6c9f2d
/* /*
* Copyright (c) 1997, 2004, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
...@@ -30,13 +30,13 @@ import java.security.spec.InvalidKeySpecException; ...@@ -30,13 +30,13 @@ import java.security.spec.InvalidKeySpecException;
/** /**
* This class defines the <i>Service Provider Interface</i> (<b>SPI</b>) * This class defines the <i>Service Provider Interface</i> (<b>SPI</b>)
* for the <code>KeyFactory</code> class. * for the {@code KeyFactory} class.
* All the abstract methods in this class must be implemented by each * All the abstract methods in this class must be implemented by each
* cryptographic service provider who wishes to supply the implementation * cryptographic service provider who wishes to supply the implementation
* of a key factory for a particular algorithm. * of a key factory for a particular algorithm.
* *
* <P> Key factories are used to convert <I>keys</I> (opaque * <P> Key factories are used to convert <I>keys</I> (opaque
* cryptographic keys of type <code>Key</code>) into <I>key specifications</I> * cryptographic keys of type {@code Key}) into <I>key specifications</I>
* (transparent representations of the underlying key material), and vice * (transparent representations of the underlying key material), and vice
* versa. * versa.
* *
...@@ -46,8 +46,8 @@ import java.security.spec.InvalidKeySpecException; ...@@ -46,8 +46,8 @@ import java.security.spec.InvalidKeySpecException;
* *
* <P> Multiple compatible key specifications may exist for the same key. * <P> Multiple compatible key specifications may exist for the same key.
* For example, a DSA public key may be specified using * For example, a DSA public key may be specified using
* <code>DSAPublicKeySpec</code> or * {@code DSAPublicKeySpec} or
* <code>X509EncodedKeySpec</code>. A key factory can be used to translate * {@code X509EncodedKeySpec}. A key factory can be used to translate
* between compatible key specifications. * between compatible key specifications.
* *
* <P> A provider should document all the key specifications supported by its * <P> A provider should document all the key specifications supported by its
...@@ -100,11 +100,11 @@ public abstract class KeyFactorySpi { ...@@ -100,11 +100,11 @@ public abstract class KeyFactorySpi {
/** /**
* Returns a specification (key material) of the given key * Returns a specification (key material) of the given key
* object. * object.
* <code>keySpec</code> identifies the specification class in which * {@code keySpec} identifies the specification class in which
* the key material should be returned. It could, for example, be * the key material should be returned. It could, for example, be
* <code>DSAPublicKeySpec.class</code>, to indicate that the * {@code DSAPublicKeySpec.class}, to indicate that the
* key material should be returned in an instance of the * key material should be returned in an instance of the
* <code>DSAPublicKeySpec</code> class. * {@code DSAPublicKeySpec} class.
* *
* @param key the key. * @param key the key.
* *
......
src/share/classes/java/security/KeyManagementException.java
浏览文件 @ fe6c9f2d
/* /*
* Copyright (c) 1996, 2003, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1996, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
...@@ -68,13 +68,13 @@ public class KeyManagementException extends KeyException { ...@@ -68,13 +68,13 @@ public class KeyManagementException extends KeyException {
} }
/** /**
* Creates a <code>KeyManagementException</code> with the specified * Creates a {@code KeyManagementException} with the specified
* detail message and cause. * detail message and cause.
* *
* @param message the detail message (which is saved for later retrieval * @param message the detail message (which is saved for later retrieval
* by the {@link #getMessage()} method). * by the {@link #getMessage()} method).
* @param cause the cause (which is saved for later retrieval by the * @param cause the cause (which is saved for later retrieval by the
* {@link #getCause()} method). (A <tt>null</tt> value is permitted, * {@link #getCause()} method). (A {@code null} value is permitted,
* and indicates that the cause is nonexistent or unknown.) * and indicates that the cause is nonexistent or unknown.)
* @since 1.5 * @since 1.5
*/ */
...@@ -83,13 +83,13 @@ public class KeyManagementException extends KeyException { ...@@ -83,13 +83,13 @@ public class KeyManagementException extends KeyException {
} }
/** /**
* Creates a <code>KeyManagementException</code> with the specified cause * Creates a {@code KeyManagementException} with the specified cause
* and a detail message of <tt>(cause==null ? null : cause.toString())</tt> * and a detail message of {@code (cause==null ? null : cause.toString())}
* (which typically contains the class and detail message of * (which typically contains the class and detail message of
* <tt>cause</tt>). * {@code cause}).
* *
* @param cause the cause (which is saved for later retrieval by the * @param cause the cause (which is saved for later retrieval by the
* {@link #getCause()} method). (A <tt>null</tt> value is permitted, * {@link #getCause()} method). (A {@code null} value is permitted,
* and indicates that the cause is nonexistent or unknown.) * and indicates that the cause is nonexistent or unknown.)
* @since 1.5 * @since 1.5
*/ */
......
src/share/classes/java/security/KeyPair.java
浏览文件 @ fe6c9f2d
/* /*
* Copyright (c) 1996, 2003, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1996, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
...@@ -50,7 +50,7 @@ public final class KeyPair implements java.io.Serializable { ...@@ -50,7 +50,7 @@ public final class KeyPair implements java.io.Serializable {
* *
* <p>Note that this constructor only stores references to the public * <p>Note that this constructor only stores references to the public
* and private key components in the generated key pair. This is safe, * and private key components in the generated key pair. This is safe,
* because <code>Key</code> objects are immutable. * because {@code Key} objects are immutable.
* *
* @param publicKey the public key. * @param publicKey the public key.
* *
......
src/share/classes/java/security/KeyPairGenerator.java
浏览文件 @ fe6c9f2d
/* /*
* Copyright (c) 1997, 2011, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
...@@ -37,7 +37,7 @@ import sun.security.jca.GetInstance.Instance; ...@@ -37,7 +37,7 @@ import sun.security.jca.GetInstance.Instance;
/** /**
* The KeyPairGenerator class is used to generate pairs of * The KeyPairGenerator class is used to generate pairs of
* public and private keys. Key pair generators are constructed using the * public and private keys. Key pair generators are constructed using the
* <code>getInstance</code> factory methods (static methods that * {@code getInstance} factory methods (static methods that
* return instances of a given class). * return instances of a given class).
* *
* <p>A Key pair generator for a particular algorithm creates a public/private * <p>A Key pair generator for a particular algorithm creates a public/private
...@@ -58,21 +58,21 @@ import sun.security.jca.GetInstance.Instance; ...@@ -58,21 +58,21 @@ import sun.security.jca.GetInstance.Instance;
* {@link #initialize(int, java.security.SecureRandom) initialize} * {@link #initialize(int, java.security.SecureRandom) initialize}
* method in this KeyPairGenerator class that takes these two universally * method in this KeyPairGenerator class that takes these two universally
* shared types of arguments. There is also one that takes just a * shared types of arguments. There is also one that takes just a
* <code>keysize</code> argument, and uses the <code>SecureRandom</code> * {@code keysize} argument, and uses the {@code SecureRandom}
* implementation of the highest-priority installed provider as the source * implementation of the highest-priority installed provider as the source
* of randomness. (If none of the installed providers supply an implementation * of randomness. (If none of the installed providers supply an implementation
* of <code>SecureRandom</code>, a system-provided source of randomness is * of {@code SecureRandom}, a system-provided source of randomness is
* used.) * used.)
* *
* <p>Since no other parameters are specified when you call the above * <p>Since no other parameters are specified when you call the above
* algorithm-independent <code>initialize</code> methods, it is up to the * algorithm-independent {@code initialize} methods, it is up to the
* provider what to do about the algorithm-specific parameters (if any) to be * provider what to do about the algorithm-specific parameters (if any) to be
* associated with each of the keys. * associated with each of the keys.
* *
* <p>If the algorithm is the <i>DSA</i> algorithm, and the keysize (modulus * <p>If the algorithm is the <i>DSA</i> algorithm, and the keysize (modulus
* size) is 512, 768, or 1024, then the <i>Sun</i> provider uses a set of * size) is 512, 768, or 1024, then the <i>Sun</i> provider uses a set of
* precomputed values for the <code>p</code>, <code>q</code>, and * precomputed values for the {@code p}, {@code q}, and
* <code>g</code> parameters. If the modulus size is not one of the above * {@code g} parameters. If the modulus size is not one of the above
* values, the <i>Sun</i> provider creates a new set of parameters. Other * values, the <i>Sun</i> provider creates a new set of parameters. Other
* providers might have precomputed parameter sets for more than just the * providers might have precomputed parameter sets for more than just the
* three modulus sizes mentioned above. Still others might not have a list of * three modulus sizes mentioned above. Still others might not have a list of
...@@ -83,35 +83,35 @@ import sun.security.jca.GetInstance.Instance; ...@@ -83,35 +83,35 @@ import sun.security.jca.GetInstance.Instance;
* <p>For situations where a set of algorithm-specific parameters already * <p>For situations where a set of algorithm-specific parameters already
* exists (e.g., so-called <i>community parameters</i> in DSA), there are two * exists (e.g., so-called <i>community parameters</i> in DSA), there are two
* {@link #initialize(java.security.spec.AlgorithmParameterSpec) * {@link #initialize(java.security.spec.AlgorithmParameterSpec)
* initialize} methods that have an <code>AlgorithmParameterSpec</code> * initialize} methods that have an {@code AlgorithmParameterSpec}
* argument. One also has a <code>SecureRandom</code> argument, while the * argument. One also has a {@code SecureRandom} argument, while the
* the other uses the <code>SecureRandom</code> * the other uses the {@code SecureRandom}
* implementation of the highest-priority installed provider as the source * implementation of the highest-priority installed provider as the source
* of randomness. (If none of the installed providers supply an implementation * of randomness. (If none of the installed providers supply an implementation
* of <code>SecureRandom</code>, a system-provided source of randomness is * of {@code SecureRandom}, a system-provided source of randomness is
* used.) * used.)
* </ul> * </ul>
* *
* <p>In case the client does not explicitly initialize the KeyPairGenerator * <p>In case the client does not explicitly initialize the KeyPairGenerator
* (via a call to an <code>initialize</code> method), each provider must * (via a call to an {@code initialize} method), each provider must
* supply (and document) a default initialization. * supply (and document) a default initialization.
* For example, the <i>Sun</i> provider uses a default modulus size (keysize) * For example, the <i>Sun</i> provider uses a default modulus size (keysize)
* of 1024 bits. * of 1024 bits.
* *
* <p>Note that this class is abstract and extends from * <p>Note that this class is abstract and extends from
* <code>KeyPairGeneratorSpi</code> for historical reasons. * {@code KeyPairGeneratorSpi} for historical reasons.
* Application developers should only take notice of the methods defined in * Application developers should only take notice of the methods defined in
* this <code>KeyPairGenerator</code> class; all the methods in * this {@code KeyPairGenerator} class; all the methods in
* the superclass are intended for cryptographic service providers who wish to * the superclass are intended for cryptographic service providers who wish to
* supply their own implementations of key pair generators. * supply their own implementations of key pair generators.
* *
* <p> Every implementation of the Java platform is required to support the * <p> Every implementation of the Java platform is required to support the
* following standard <code>KeyPairGenerator</code> algorithms and keysizes in * following standard {@code KeyPairGenerator} algorithms and keysizes in
* parentheses: * parentheses:
* <ul> * <ul>
* <li><tt>DiffieHellman</tt> (1024)</li> * <li>{@code DiffieHellman} (1024)</li>
* <li><tt>DSA</tt> (1024)</li> * <li>{@code DSA} (1024)</li>
* <li><tt>RSA</tt> (1024, 2048)</li> * <li>{@code RSA} (1024, 2048)</li>
* </ul> * </ul>
* These algorithms are described in the <a href= * These algorithms are described in the <a href=
* "{@docRoot}/../technotes/guides/security/StandardNames.html#KeyPairGenerator"> * "{@docRoot}/../technotes/guides/security/StandardNames.html#KeyPairGenerator">
...@@ -322,18 +322,18 @@ public abstract class KeyPairGenerator extends KeyPairGeneratorSpi { ...@@ -322,18 +322,18 @@ public abstract class KeyPairGenerator extends KeyPairGeneratorSpi {
/** /**
* Initializes the key pair generator for a certain keysize using * Initializes the key pair generator for a certain keysize using
* a default parameter set and the <code>SecureRandom</code> * a default parameter set and the {@code SecureRandom}
* implementation of the highest-priority installed provider as the source * implementation of the highest-priority installed provider as the source
* of randomness. * of randomness.
* (If none of the installed providers supply an implementation of * (If none of the installed providers supply an implementation of
* <code>SecureRandom</code>, a system-provided source of randomness is * {@code SecureRandom}, a system-provided source of randomness is
* used.) * used.)
* *
* @param keysize the keysize. This is an * @param keysize the keysize. This is an
* algorithm-specific metric, such as modulus length, specified in * algorithm-specific metric, such as modulus length, specified in
* number of bits. * number of bits.
* *
* @exception InvalidParameterException if the <code>keysize</code> is not * @exception InvalidParameterException if the {@code keysize} is not
* supported by this KeyPairGenerator object. * supported by this KeyPairGenerator object.
*/ */
public void initialize(int keysize) { public void initialize(int keysize) {
...@@ -349,7 +349,7 @@ public abstract class KeyPairGenerator extends KeyPairGeneratorSpi { ...@@ -349,7 +349,7 @@ public abstract class KeyPairGenerator extends KeyPairGeneratorSpi {
* number of bits. * number of bits.
* @param random the source of randomness. * @param random the source of randomness.
* *
* @exception InvalidParameterException if the <code>keysize</code> is not * @exception InvalidParameterException if the {@code keysize} is not
* supported by this KeyPairGenerator object. * supported by this KeyPairGenerator object.
* *
* @since 1.2 * @since 1.2
...@@ -369,11 +369,11 @@ public abstract class KeyPairGenerator extends KeyPairGeneratorSpi { ...@@ -369,11 +369,11 @@ public abstract class KeyPairGenerator extends KeyPairGeneratorSpi {
/** /**
* Initializes the key pair generator using the specified parameter * Initializes the key pair generator using the specified parameter
* set and the <code>SecureRandom</code> * set and the {@code SecureRandom}
* implementation of the highest-priority installed provider as the source * implementation of the highest-priority installed provider as the source
* of randomness. * of randomness.
* (If none of the installed providers supply an implementation of * (If none of the installed providers supply an implementation of
* <code>SecureRandom</code>, a system-provided source of randomness is * {@code SecureRandom}, a system-provided source of randomness is
* used.). * used.).
* *
* <p>This concrete method has been added to this previously-defined * <p>This concrete method has been added to this previously-defined
...@@ -382,10 +382,10 @@ public abstract class KeyPairGenerator extends KeyPairGeneratorSpi { ...@@ -382,10 +382,10 @@ public abstract class KeyPairGenerator extends KeyPairGeneratorSpi {
* {@link KeyPairGeneratorSpi#initialize( * {@link KeyPairGeneratorSpi#initialize(
* java.security.spec.AlgorithmParameterSpec, * java.security.spec.AlgorithmParameterSpec,
* java.security.SecureRandom) initialize} method, * java.security.SecureRandom) initialize} method,
* passing it <code>params</code> and a source of randomness (obtained * passing it {@code params} and a source of randomness (obtained
* from the highest-priority installed provider or system-provided if none * from the highest-priority installed provider or system-provided if none
* of the installed providers supply one). * of the installed providers supply one).
* That <code>initialize</code> method always throws an * That {@code initialize} method always throws an
* UnsupportedOperationException if it is not overridden by the provider. * UnsupportedOperationException if it is not overridden by the provider.
* *
* @param params the parameter set used to generate the keys. * @param params the parameter set used to generate the keys.
...@@ -410,8 +410,8 @@ public abstract class KeyPairGenerator extends KeyPairGeneratorSpi { ...@@ -410,8 +410,8 @@ public abstract class KeyPairGenerator extends KeyPairGeneratorSpi {
* KeyPairGeneratorSpi#initialize( * KeyPairGeneratorSpi#initialize(
* java.security.spec.AlgorithmParameterSpec, * java.security.spec.AlgorithmParameterSpec,
* java.security.SecureRandom) initialize} method, * java.security.SecureRandom) initialize} method,
* passing it <code>params</code> and <code>random</code>. * passing it {@code params} and {@code random}.
* That <code>initialize</code> * That {@code initialize}
* method always throws an * method always throws an
* UnsupportedOperationException if it is not overridden by the provider. * UnsupportedOperationException if it is not overridden by the provider.
* *
......
src/share/classes/java/security/KeyPairGeneratorSpi.java
浏览文件 @ fe6c9f2d
/* /*
* Copyright (c) 1997, 1999, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
...@@ -29,7 +29,7 @@ import java.security.spec.AlgorithmParameterSpec; ...@@ -29,7 +29,7 @@ import java.security.spec.AlgorithmParameterSpec;
/** /**
* <p> This class defines the <i>Service Provider Interface</i> (<b>SPI</b>) * <p> This class defines the <i>Service Provider Interface</i> (<b>SPI</b>)
* for the <code>KeyPairGenerator</code> class, which is used to generate * for the {@code KeyPairGenerator} class, which is used to generate
* pairs of public and private keys. * pairs of public and private keys.
* *
* <p> All the abstract methods in this class must be implemented by each * <p> All the abstract methods in this class must be implemented by each
...@@ -37,7 +37,7 @@ import java.security.spec.AlgorithmParameterSpec; ...@@ -37,7 +37,7 @@ import java.security.spec.AlgorithmParameterSpec;
* of a key pair generator for a particular algorithm. * of a key pair generator for a particular algorithm.
* *
* <p> In case the client does not explicitly initialize the KeyPairGenerator * <p> In case the client does not explicitly initialize the KeyPairGenerator
* (via a call to an <code>initialize</code> method), each provider must * (via a call to an {@code initialize} method), each provider must
* supply (and document) a default initialization. * supply (and document) a default initialization.
* For example, the <i>Sun</i> provider uses a default modulus size (keysize) * For example, the <i>Sun</i> provider uses a default modulus size (keysize)
* of 1024 bits. * of 1024 bits.
...@@ -61,7 +61,7 @@ public abstract class KeyPairGeneratorSpi { ...@@ -61,7 +61,7 @@ public abstract class KeyPairGeneratorSpi {
* *
* @param random the source of randomness for this generator. * @param random the source of randomness for this generator.
* *
* @exception InvalidParameterException if the <code>keysize</code> is not * @exception InvalidParameterException if the {@code keysize} is not
* supported by this KeyPairGeneratorSpi object. * supported by this KeyPairGeneratorSpi object.
*/ */
public abstract void initialize(int keysize, SecureRandom random); public abstract void initialize(int keysize, SecureRandom random);
...@@ -100,7 +100,7 @@ public abstract class KeyPairGeneratorSpi { ...@@ -100,7 +100,7 @@ public abstract class KeyPairGeneratorSpi {
* will be used. This will generate a new key pair every time it * will be used. This will generate a new key pair every time it
* is called. * is called.
* *
* @return the newly generated <tt>KeyPair</tt> * @return the newly generated {@code KeyPair}
*/ */
public abstract KeyPair generateKeyPair(); public abstract KeyPair generateKeyPair();
} }
src/share/classes/java/security/KeyRep.java
浏览文件 @ fe6c9f2d
/* /*
* Copyright (c) 2003, 2011, 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. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
...@@ -116,17 +116,17 @@ public class KeyRep implements Serializable { ...@@ -116,17 +116,17 @@ public class KeyRep implements Serializable {
* *
* @param type either one of Type.SECRET, Type.PUBLIC, or Type.PRIVATE * @param type either one of Type.SECRET, Type.PUBLIC, or Type.PRIVATE
* @param algorithm the algorithm returned from * @param algorithm the algorithm returned from
* <code>Key.getAlgorithm()</code> * {@code Key.getAlgorithm()}
* @param format the encoding format returned from * @param format the encoding format returned from
* <code>Key.getFormat()</code> * {@code Key.getFormat()}
* @param encoded the encoded bytes returned from * @param encoded the encoded bytes returned from
* <code>Key.getEncoded()</code> * {@code Key.getEncoded()}
* *
* @exception NullPointerException * @exception NullPointerException
* if type is <code>null</code>, * if type is {@code null},
* if algorithm is <code>null</code>, * if algorithm is {@code null},
* if format is <code>null</code>, * if format is {@code null},
* or if encoded is <code>null</code> * or if encoded is {@code null}
*/ */
public KeyRep(Type type, String algorithm, public KeyRep(Type type, String algorithm,
String format, byte[] encoded) { String format, byte[] encoded) {
......
src/share/classes/java/security/KeyStoreException.java
浏览文件 @ fe6c9f2d
/* /*
* Copyright (c) 1997, 2003, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
...@@ -59,13 +59,13 @@ public class KeyStoreException extends GeneralSecurityException { ...@@ -59,13 +59,13 @@ public class KeyStoreException extends GeneralSecurityException {
} }
/** /**
* Creates a <code>KeyStoreException</code> with the specified * Creates a {@code KeyStoreException} with the specified
* detail message and cause. * detail message and cause.
* *
* @param message the detail message (which is saved for later retrieval * @param message the detail message (which is saved for later retrieval
* by the {@link #getMessage()} method). * by the {@link #getMessage()} method).
* @param cause the cause (which is saved for later retrieval by the * @param cause the cause (which is saved for later retrieval by the
* {@link #getCause()} method). (A <tt>null</tt> value is permitted, * {@link #getCause()} method). (A {@code null} value is permitted,
* and indicates that the cause is nonexistent or unknown.) * and indicates that the cause is nonexistent or unknown.)
* @since 1.5 * @since 1.5
*/ */
...@@ -74,13 +74,13 @@ public class KeyStoreException extends GeneralSecurityException { ...@@ -74,13 +74,13 @@ public class KeyStoreException extends GeneralSecurityException {
} }
/** /**
* Creates a <code>KeyStoreException</code> with the specified cause * Creates a {@code KeyStoreException} with the specified cause
* and a detail message of <tt>(cause==null ? null : cause.toString())</tt> * and a detail message of {@code (cause==null ? null : cause.toString())}
* (which typically contains the class and detail message of * (which typically contains the class and detail message of
* <tt>cause</tt>). * {@code cause}).
* *
* @param cause the cause (which is saved for later retrieval by the * @param cause the cause (which is saved for later retrieval by the
* {@link #getCause()} method). (A <tt>null</tt> value is permitted, * {@link #getCause()} method). (A {@code null} value is permitted,
* and indicates that the cause is nonexistent or unknown.) * and indicates that the cause is nonexistent or unknown.)
* @since 1.5 * @since 1.5
*/ */
......
src/share/classes/java/security/KeyStoreSpi.java
浏览文件 @ fe6c9f2d
/* /*
* Copyright (c) 1998, 2006, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1998, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
...@@ -38,7 +38,7 @@ import javax.security.auth.callback.*; ...@@ -38,7 +38,7 @@ import javax.security.auth.callback.*;
/** /**
* This class defines the <i>Service Provider Interface</i> (<b>SPI</b>) * This class defines the <i>Service Provider Interface</i> (<b>SPI</b>)
* for the <code>KeyStore</code> class. * for the {@code KeyStore} class.
* All the abstract methods in this class must be implemented by each * All the abstract methods in this class must be implemented by each
* cryptographic service provider who wishes to supply the implementation * cryptographic service provider who wishes to supply the implementation
* of a keystore for a particular keystore type. * of a keystore for a particular keystore type.
...@@ -56,9 +56,9 @@ public abstract class KeyStoreSpi { ...@@ -56,9 +56,9 @@ public abstract class KeyStoreSpi {
/** /**
* Returns the key associated with the given alias, using the given * Returns the key associated with the given alias, using the given
* password to recover it. The key must have been associated with * password to recover it. The key must have been associated with
* the alias by a call to <code>setKeyEntry</code>, * the alias by a call to {@code setKeyEntry},
* or by a call to <code>setEntry</code> with a * or by a call to {@code setEntry} with a
* <code>PrivateKeyEntry</code> or <code>SecretKeyEntry</code>. * {@code PrivateKeyEntry} or {@code SecretKeyEntry}.
* *
* @param alias the alias name * @param alias the alias name
* @param password the password for recovering the key * @param password the password for recovering the key
...@@ -77,9 +77,9 @@ public abstract class KeyStoreSpi { ...@@ -77,9 +77,9 @@ public abstract class KeyStoreSpi {
/** /**
* Returns the certificate chain associated with the given alias. * Returns the certificate chain associated with the given alias.
* The certificate chain must have been associated with the alias * The certificate chain must have been associated with the alias
* by a call to <code>setKeyEntry</code>, * by a call to {@code setKeyEntry},
* or by a call to <code>setEntry</code> with a * or by a call to {@code setEntry} with a
* <code>PrivateKeyEntry</code>. * {@code PrivateKeyEntry}.
* *
* @param alias the alias name * @param alias the alias name
* *
...@@ -93,15 +93,15 @@ public abstract class KeyStoreSpi { ...@@ -93,15 +93,15 @@ public abstract class KeyStoreSpi {
* Returns the certificate associated with the given alias. * Returns the certificate associated with the given alias.
* *
* <p> If the given alias name identifies an entry * <p> If the given alias name identifies an entry
* created by a call to <code>setCertificateEntry</code>, * created by a call to {@code setCertificateEntry},
* or created by a call to <code>setEntry</code> with a * or created by a call to {@code setEntry} with a
* <code>TrustedCertificateEntry</code>, * {@code TrustedCertificateEntry},
* then the trusted certificate contained in that entry is returned. * then the trusted certificate contained in that entry is returned.
* *
* <p> If the given alias name identifies an entry * <p> If the given alias name identifies an entry
* created by a call to <code>setKeyEntry</code>, * created by a call to {@code setKeyEntry},
* or created by a call to <code>setEntry</code> with a * or created by a call to {@code setEntry} with a
* <code>PrivateKeyEntry</code>, * {@code PrivateKeyEntry},
* then the first element of the certificate chain in that entry * then the first element of the certificate chain in that entry
* (if a chain exists) is returned. * (if a chain exists) is returned.
* *
...@@ -126,7 +126,7 @@ public abstract class KeyStoreSpi { ...@@ -126,7 +126,7 @@ public abstract class KeyStoreSpi {
* Assigns the given key to the given alias, protecting it with the given * Assigns the given key to the given alias, protecting it with the given
* password. * password.
* *
* <p>If the given key is of type <code>java.security.PrivateKey</code>, * <p>If the given key is of type {@code java.security.PrivateKey},
* it must be accompanied by a certificate chain certifying the * it must be accompanied by a certificate chain certifying the
* corresponding public key. * corresponding public key.
* *
...@@ -139,7 +139,7 @@ public abstract class KeyStoreSpi { ...@@ -139,7 +139,7 @@ public abstract class KeyStoreSpi {
* @param password the password to protect the key * @param password the password to protect the key
* @param chain the certificate chain for the corresponding public * @param chain the certificate chain for the corresponding public
* key (only required if the given key is of type * key (only required if the given key is of type
* <code>java.security.PrivateKey</code>). * {@code java.security.PrivateKey}).
* *
* @exception KeyStoreException if the given key cannot be protected, or * @exception KeyStoreException if the given key cannot be protected, or
* this operation fails for some other reason * this operation fails for some other reason
...@@ -154,7 +154,7 @@ public abstract class KeyStoreSpi { ...@@ -154,7 +154,7 @@ public abstract class KeyStoreSpi {
* alias. * alias.
* *
* <p>If the protected key is of type * <p>If the protected key is of type
* <code>java.security.PrivateKey</code>, * {@code java.security.PrivateKey},
* it must be accompanied by a certificate chain certifying the * it must be accompanied by a certificate chain certifying the
* corresponding public key. * corresponding public key.
* *
...@@ -166,7 +166,7 @@ public abstract class KeyStoreSpi { ...@@ -166,7 +166,7 @@ public abstract class KeyStoreSpi {
* @param key the key (in protected format) to be associated with the alias * @param key the key (in protected format) to be associated with the alias
* @param chain the certificate chain for the corresponding public * @param chain the certificate chain for the corresponding public
* key (only useful if the protected key is of type * key (only useful if the protected key is of type
* <code>java.security.PrivateKey</code>). * {@code java.security.PrivateKey}).
* *
* @exception KeyStoreException if this operation fails. * @exception KeyStoreException if this operation fails.
*/ */
...@@ -178,9 +178,9 @@ public abstract class KeyStoreSpi { ...@@ -178,9 +178,9 @@ public abstract class KeyStoreSpi {
* Assigns the given certificate to the given alias. * Assigns the given certificate to the given alias.
* *
* <p> If the given alias identifies an existing entry * <p> If the given alias identifies an existing entry
* created by a call to <code>setCertificateEntry</code>, * created by a call to {@code setCertificateEntry},
* or created by a call to <code>setEntry</code> with a * or created by a call to {@code setEntry} with a
* <code>TrustedCertificateEntry</code>, * {@code TrustedCertificateEntry},
* the trusted certificate in the existing entry * the trusted certificate in the existing entry
* is overridden by the given certificate. * is overridden by the given certificate.
* *
...@@ -230,9 +230,9 @@ public abstract class KeyStoreSpi { ...@@ -230,9 +230,9 @@ public abstract class KeyStoreSpi {
/** /**
* Returns true if the entry identified by the given alias * Returns true if the entry identified by the given alias
* was created by a call to <code>setKeyEntry</code>, * was created by a call to {@code setKeyEntry},
* or created by a call to <code>setEntry</code> with a * or created by a call to {@code setEntry} with a
* <code>PrivateKeyEntry</code> or a <code>SecretKeyEntry</code>. * {@code PrivateKeyEntry} or a {@code SecretKeyEntry}.
* *
* @param alias the alias for the keystore entry to be checked * @param alias the alias for the keystore entry to be checked
* *
...@@ -243,9 +243,9 @@ public abstract class KeyStoreSpi { ...@@ -243,9 +243,9 @@ public abstract class KeyStoreSpi {
/** /**
* Returns true if the entry identified by the given alias * Returns true if the entry identified by the given alias
* was created by a call to <code>setCertificateEntry</code>, * was created by a call to {@code setCertificateEntry},
* or created by a call to <code>setEntry</code> with a * or created by a call to {@code setEntry} with a
* <code>TrustedCertificateEntry</code>. * {@code TrustedCertificateEntry}.
* *
* @param alias the alias for the keystore entry to be checked * @param alias the alias for the keystore entry to be checked
* *
...@@ -260,15 +260,15 @@ public abstract class KeyStoreSpi { ...@@ -260,15 +260,15 @@ public abstract class KeyStoreSpi {
* *
* <p>This method attempts to match the given certificate with each * <p>This method attempts to match the given certificate with each
* keystore entry. If the entry being considered was * keystore entry. If the entry being considered was
* created by a call to <code>setCertificateEntry</code>, * created by a call to {@code setCertificateEntry},
* or created by a call to <code>setEntry</code> with a * or created by a call to {@code setEntry} with a
* <code>TrustedCertificateEntry</code>, * {@code TrustedCertificateEntry},
* then the given certificate is compared to that entry's certificate. * then the given certificate is compared to that entry's certificate.
* *
* <p> If the entry being considered was * <p> If the entry being considered was
* created by a call to <code>setKeyEntry</code>, * created by a call to {@code setKeyEntry},
* or created by a call to <code>setEntry</code> with a * or created by a call to {@code setEntry} with a
* <code>PrivateKeyEntry</code>, * {@code PrivateKeyEntry},
* then the given certificate is compared to the first * then the given certificate is compared to the first
* element of that entry's certificate chain. * element of that entry's certificate chain.
* *
...@@ -297,14 +297,14 @@ public abstract class KeyStoreSpi { ...@@ -297,14 +297,14 @@ public abstract class KeyStoreSpi {
/** /**
* Stores this keystore using the given * Stores this keystore using the given
* <code>KeyStore.LoadStoreParmeter</code>. * {@code KeyStore.LoadStoreParmeter}.
* *
* @param param the <code>KeyStore.LoadStoreParmeter</code> * @param param the {@code KeyStore.LoadStoreParmeter}
* that specifies how to store the keystore, * that specifies how to store the keystore,
* which may be <code>null</code> * which may be {@code null}
* *
* @exception IllegalArgumentException if the given * @exception IllegalArgumentException if the given
* <code>KeyStore.LoadStoreParmeter</code> * {@code KeyStore.LoadStoreParmeter}
* input is not recognized * input is not recognized
* @exception IOException if there was an I/O problem with data * @exception IOException if there was an I/O problem with data
* @exception NoSuchAlgorithmException if the appropriate data integrity * @exception NoSuchAlgorithmException if the appropriate data integrity
...@@ -330,17 +330,17 @@ public abstract class KeyStoreSpi { ...@@ -330,17 +330,17 @@ public abstract class KeyStoreSpi {
* then integrity checking is not performed. * then integrity checking is not performed.
* *
* @param stream the input stream from which the keystore is loaded, * @param stream the input stream from which the keystore is loaded,
* or <code>null</code> * or {@code null}
* @param password the password used to check the integrity of * @param password the password used to check the integrity of
* the keystore, the password used to unlock the keystore, * the keystore, the password used to unlock the keystore,
* or <code>null</code> * or {@code null}
* *
* @exception IOException if there is an I/O or format problem with the * @exception IOException if there is an I/O or format problem with the
* keystore data, if a password is required but not given, * keystore data, if a password is required but not given,
* or if the given password was incorrect. If the error is due to a * or if the given password was incorrect. If the error is due to a
* wrong password, the {@link Throwable#getCause cause} of the * wrong password, the {@link Throwable#getCause cause} of the
* <code>IOException</code> should be an * {@code IOException} should be an
* <code>UnrecoverableKeyException</code> * {@code UnrecoverableKeyException}
* @exception NoSuchAlgorithmException if the algorithm used to check * @exception NoSuchAlgorithmException if the algorithm used to check
* the integrity of the keystore cannot be found * the integrity of the keystore cannot be found
* @exception CertificateException if any of the certificates in the * @exception CertificateException if any of the certificates in the
...@@ -351,24 +351,24 @@ public abstract class KeyStoreSpi { ...@@ -351,24 +351,24 @@ public abstract class KeyStoreSpi {
/** /**
* Loads the keystore using the given * Loads the keystore using the given
* <code>KeyStore.LoadStoreParameter</code>. * {@code KeyStore.LoadStoreParameter}.
* *
* <p> Note that if this KeyStore has already been loaded, it is * <p> Note that if this KeyStore has already been loaded, it is
* reinitialized and loaded again from the given parameter. * reinitialized and loaded again from the given parameter.
* *
* @param param the <code>KeyStore.LoadStoreParameter</code> * @param param the {@code KeyStore.LoadStoreParameter}
* that specifies how to load the keystore, * that specifies how to load the keystore,
* which may be <code>null</code> * which may be {@code null}
* *
* @exception IllegalArgumentException if the given * @exception IllegalArgumentException if the given
* <code>KeyStore.LoadStoreParameter</code> * {@code KeyStore.LoadStoreParameter}
* input is not recognized * input is not recognized
* @exception IOException if there is an I/O or format problem with the * @exception IOException if there is an I/O or format problem with the
* keystore data. If the error is due to an incorrect * keystore data. If the error is due to an incorrect
* <code>ProtectionParameter</code> (e.g. wrong password) * {@code ProtectionParameter} (e.g. wrong password)
* the {@link Throwable#getCause cause} of the * the {@link Throwable#getCause cause} of the
* <code>IOException</code> should be an * {@code IOException} should be an
* <code>UnrecoverableKeyException</code> * {@code UnrecoverableKeyException}
* @exception NoSuchAlgorithmException if the algorithm used to check * @exception NoSuchAlgorithmException if the algorithm used to check
* the integrity of the keystore cannot be found * the integrity of the keystore cannot be found
* @exception CertificateException if any of the certificates in the * @exception CertificateException if any of the certificates in the
...@@ -419,25 +419,25 @@ public abstract class KeyStoreSpi { ...@@ -419,25 +419,25 @@ public abstract class KeyStoreSpi {
} }
/** /**
* Gets a <code>KeyStore.Entry</code> for the specified alias * Gets a {@code KeyStore.Entry} for the specified alias
* with the specified protection parameter. * with the specified protection parameter.
* *
* @param alias get the <code>KeyStore.Entry</code> for this alias * @param alias get the {@code KeyStore.Entry} for this alias
* @param protParam the <code>ProtectionParameter</code> * @param protParam the {@code ProtectionParameter}
* used to protect the <code>Entry</code>, * used to protect the {@code Entry},
* which may be <code>null</code> * which may be {@code null}
* *
* @return the <code>KeyStore.Entry</code> for the specified alias, * @return the {@code KeyStore.Entry} for the specified alias,
* or <code>null</code> if there is no such entry * or {@code null} if there is no such entry
* *
* @exception KeyStoreException if the operation failed * @exception KeyStoreException if the operation failed
* @exception NoSuchAlgorithmException if the algorithm for recovering the * @exception NoSuchAlgorithmException if the algorithm for recovering the
* entry cannot be found * entry cannot be found
* @exception UnrecoverableEntryException if the specified * @exception UnrecoverableEntryException if the specified
* <code>protParam</code> were insufficient or invalid * {@code protParam} were insufficient or invalid
* @exception UnrecoverableKeyException if the entry is a * @exception UnrecoverableKeyException if the entry is a
* <code>PrivateKeyEntry</code> or <code>SecretKeyEntry</code> * {@code PrivateKeyEntry} or {@code SecretKeyEntry}
* and the specified <code>protParam</code> does not contain * and the specified {@code protParam} does not contain
* the information needed to recover the key (e.g. wrong password) * the information needed to recover the key (e.g. wrong password)
* *
* @since 1.5 * @since 1.5
...@@ -484,18 +484,18 @@ public abstract class KeyStoreSpi { ...@@ -484,18 +484,18 @@ public abstract class KeyStoreSpi {
} }
/** /**
* Saves a <code>KeyStore.Entry</code> under the specified alias. * Saves a {@code KeyStore.Entry} under the specified alias.
* The specified protection parameter is used to protect the * The specified protection parameter is used to protect the
* <code>Entry</code>. * {@code Entry}.
* *
* <p> If an entry already exists for the specified alias, * <p> If an entry already exists for the specified alias,
* it is overridden. * it is overridden.
* *
* @param alias save the <code>KeyStore.Entry</code> under this alias * @param alias save the {@code KeyStore.Entry} under this alias
* @param entry the <code>Entry</code> to save * @param entry the {@code Entry} to save
* @param protParam the <code>ProtectionParameter</code> * @param protParam the {@code ProtectionParameter}
* used to protect the <code>Entry</code>, * used to protect the {@code Entry},
* which may be <code>null</code> * which may be {@code null}
* *
* @exception KeyStoreException if this operation fails * @exception KeyStoreException if this operation fails
* *
...@@ -560,16 +560,16 @@ public abstract class KeyStoreSpi { ...@@ -560,16 +560,16 @@ public abstract class KeyStoreSpi {
} }
/** /**
* Determines if the keystore <code>Entry</code> for the specified * Determines if the keystore {@code Entry} for the specified
* <code>alias</code> is an instance or subclass of the specified * {@code alias} is an instance or subclass of the specified
* <code>entryClass</code>. * {@code entryClass}.
* *
* @param alias the alias name * @param alias the alias name
* @param entryClass the entry class * @param entryClass the entry class
* *
* @return true if the keystore <code>Entry</code> for the specified * @return true if the keystore {@code Entry} for the specified
* <code>alias</code> is an instance or subclass of the * {@code alias} is an instance or subclass of the
* specified <code>entryClass</code>, false otherwise * specified {@code entryClass}, false otherwise
* *
* @since 1.5 * @since 1.5
*/ */
......
src/share/classes/java/security/MessageDigest.java
浏览文件 @ fe6c9f2d
/* /*
* Copyright (c) 1996, 2011, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1996, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
...@@ -48,8 +48,8 @@ import java.nio.ByteBuffer; ...@@ -48,8 +48,8 @@ import java.nio.ByteBuffer;
* updated, one of the {@link #digest() digest} methods should * updated, one of the {@link #digest() digest} methods should
* be called to complete the hash computation. * be called to complete the hash computation.
* *
* <p>The <code>digest</code> method can be called once for a given number * <p>The {@code digest} method can be called once for a given number
* of updates. After <code>digest</code> has been called, the MessageDigest * of updates. After {@code digest} has been called, the MessageDigest
* object is reset to its initialized state. * object is reset to its initialized state.
* *
* <p>Implementations are free to implement the Cloneable interface. * <p>Implementations are free to implement the Cloneable interface.
...@@ -75,18 +75,18 @@ import java.nio.ByteBuffer; ...@@ -75,18 +75,18 @@ import java.nio.ByteBuffer;
* several instances, if the number of digests is known in advance. * several instances, if the number of digests is known in advance.
* *
* <p>Note that this class is abstract and extends from * <p>Note that this class is abstract and extends from
* <code>MessageDigestSpi</code> for historical reasons. * {@code MessageDigestSpi} for historical reasons.
* Application developers should only take notice of the methods defined in * Application developers should only take notice of the methods defined in
* this <code>MessageDigest</code> class; all the methods in * this {@code MessageDigest} class; all the methods in
* the superclass are intended for cryptographic service providers who wish to * the superclass are intended for cryptographic service providers who wish to
* supply their own implementations of message digest algorithms. * supply their own implementations of message digest algorithms.
* *
* <p> Every implementation of the Java platform is required to support * <p> Every implementation of the Java platform is required to support
* the following standard <code>MessageDigest</code> algorithms: * the following standard {@code MessageDigest} algorithms:
* <ul> * <ul>
* <li><tt>MD5</tt></li> * <li>{@code MD5}</li>
* <li><tt>SHA-1</tt></li> * <li>{@code SHA-1}</li>
* <li><tt>SHA-256</tt></li> * <li>{@code SHA-256}</li>
* </ul> * </ul>
* These algorithms are described in the <a href= * These algorithms are described in the <a href=
* "{@docRoot}/../technotes/guides/security/StandardNames.html#MessageDigest"> * "{@docRoot}/../technotes/guides/security/StandardNames.html#MessageDigest">
...@@ -301,7 +301,7 @@ public abstract class MessageDigest extends MessageDigestSpi { ...@@ -301,7 +301,7 @@ public abstract class MessageDigest extends MessageDigestSpi {
* @param offset the offset to start from in the array of bytes. * @param offset the offset to start from in the array of bytes.
* *
* @param len the number of bytes to use, starting at * @param len the number of bytes to use, starting at
* <code>offset</code>. * {@code offset}.
*/ */
public void update(byte[] input, int offset, int len) { public void update(byte[] input, int offset, int len) {
if (input == null) { if (input == null) {
...@@ -326,8 +326,8 @@ public abstract class MessageDigest extends MessageDigestSpi { ...@@ -326,8 +326,8 @@ public abstract class MessageDigest extends MessageDigestSpi {
/** /**
* Update the digest using the specified ByteBuffer. The digest is * Update the digest using the specified ByteBuffer. The digest is
* updated using the <code>input.remaining()</code> bytes starting * updated using the {@code input.remaining()} bytes starting
* at <code>input.position()</code>. * at {@code input.position()}.
* Upon return, the buffer's position will be equal to its limit; * Upon return, the buffer's position will be equal to its limit;
* its limit will not have changed. * its limit will not have changed.
* *
...@@ -365,7 +365,7 @@ public abstract class MessageDigest extends MessageDigestSpi { ...@@ -365,7 +365,7 @@ public abstract class MessageDigest extends MessageDigestSpi {
* *
* @param len number of bytes within buf allotted for the digest * @param len number of bytes within buf allotted for the digest
* *
* @return the number of bytes placed into <code>buf</code> * @return the number of bytes placed into {@code buf}
* *
* @exception DigestException if an error occurs. * @exception DigestException if an error occurs.
*/ */
...@@ -386,7 +386,7 @@ public abstract class MessageDigest extends MessageDigestSpi { ...@@ -386,7 +386,7 @@ public abstract class MessageDigest extends MessageDigestSpi {
* Performs a final update on the digest using the specified array * Performs a final update on the digest using the specified array
* of bytes, then completes the digest computation. That is, this * of bytes, then completes the digest computation. That is, this
* method first calls {@link #update(byte[]) update(input)}, * method first calls {@link #update(byte[]) update(input)},
* passing the <i>input</i> array to the <code>update</code> method, * passing the <i>input</i> array to the {@code update} method,
* then calls {@link #digest() digest()}. * then calls {@link #digest() digest()}.
* *
* @param input the input to be updated before the digest is * @param input the input to be updated before the digest is
...@@ -492,7 +492,7 @@ public abstract class MessageDigest extends MessageDigestSpi { ...@@ -492,7 +492,7 @@ public abstract class MessageDigest extends MessageDigestSpi {
* @return a clone if the implementation is cloneable. * @return a clone if the implementation is cloneable.
* *
* @exception CloneNotSupportedException if this is called on an * @exception CloneNotSupportedException if this is called on an
* implementation that does not support <code>Cloneable</code>. * implementation that does not support {@code Cloneable}.
*/ */
public Object clone() throws CloneNotSupportedException { public Object clone() throws CloneNotSupportedException {
if (this instanceof Cloneable) { if (this instanceof Cloneable) {
...@@ -536,7 +536,7 @@ public abstract class MessageDigest extends MessageDigestSpi { ...@@ -536,7 +536,7 @@ public abstract class MessageDigest extends MessageDigestSpi {
* @return a clone if the delegate is cloneable. * @return a clone if the delegate is cloneable.
* *
* @exception CloneNotSupportedException if this is called on a * @exception CloneNotSupportedException if this is called on a
* delegate that does not support <code>Cloneable</code>. * delegate that does not support {@code Cloneable}.
*/ */
public Object clone() throws CloneNotSupportedException { public Object clone() throws CloneNotSupportedException {
if (digestSpi instanceof Cloneable) { if (digestSpi instanceof Cloneable) {
......
src/share/classes/java/security/MessageDigestSpi.java
浏览文件 @ fe6c9f2d
/* /*
* Copyright (c) 1997, 2006, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
...@@ -31,7 +31,7 @@ import sun.security.jca.JCAUtil; ...@@ -31,7 +31,7 @@ import sun.security.jca.JCAUtil;
/** /**
* This class defines the <i>Service Provider Interface</i> (<b>SPI</b>) * This class defines the <i>Service Provider Interface</i> (<b>SPI</b>)
* for the <code>MessageDigest</code> class, which provides the functionality * for the {@code MessageDigest} class, which provides the functionality
* of a message digest algorithm, such as MD5 or SHA. Message digests are * of a message digest algorithm, such as MD5 or SHA. Message digests are
* secure one-way hash functions that take arbitrary-sized data and output a * secure one-way hash functions that take arbitrary-sized data and output a
* fixed-length hash value. * fixed-length hash value.
...@@ -88,14 +88,14 @@ public abstract class MessageDigestSpi { ...@@ -88,14 +88,14 @@ public abstract class MessageDigestSpi {
* @param offset the offset to start from in the array of bytes. * @param offset the offset to start from in the array of bytes.
* *
* @param len the number of bytes to use, starting at * @param len the number of bytes to use, starting at
* <code>offset</code>. * {@code offset}.
*/ */
protected abstract void engineUpdate(byte[] input, int offset, int len); protected abstract void engineUpdate(byte[] input, int offset, int len);
/** /**
* Update the digest using the specified ByteBuffer. The digest is * Update the digest using the specified ByteBuffer. The digest is
* updated using the <code>input.remaining()</code> bytes starting * updated using the {@code input.remaining()} bytes starting
* at <code>input.position()</code>. * at {@code input.position()}.
* Upon return, the buffer's position will be equal to its limit; * Upon return, the buffer's position will be equal to its limit;
* its limit will not have changed. * its limit will not have changed.
* *
...@@ -130,7 +130,7 @@ public abstract class MessageDigestSpi { ...@@ -130,7 +130,7 @@ public abstract class MessageDigestSpi {
/** /**
* Completes the hash computation by performing final * Completes the hash computation by performing final
* operations such as padding. Once <code>engineDigest</code> has * operations such as padding. Once {@code engineDigest} has
* been called, the engine should be reset (see * been called, the engine should be reset (see
* {@link #engineReset() engineReset}). * {@link #engineReset() engineReset}).
* Resetting is the responsibility of the * Resetting is the responsibility of the
...@@ -142,7 +142,7 @@ public abstract class MessageDigestSpi { ...@@ -142,7 +142,7 @@ public abstract class MessageDigestSpi {
/** /**
* Completes the hash computation by performing final * Completes the hash computation by performing final
* operations such as padding. Once <code>engineDigest</code> has * operations such as padding. Once {@code engineDigest} has
* been called, the engine should be reset (see * been called, the engine should be reset (see
* {@link #engineReset() engineReset}). * {@link #engineReset() engineReset}).
* Resetting is the responsibility of the * Resetting is the responsibility of the
...@@ -194,7 +194,7 @@ public abstract class MessageDigestSpi { ...@@ -194,7 +194,7 @@ public abstract class MessageDigestSpi {
* @return a clone if the implementation is cloneable. * @return a clone if the implementation is cloneable.
* *
* @exception CloneNotSupportedException if this is called on an * @exception CloneNotSupportedException if this is called on an
* implementation that does not support <code>Cloneable</code>. * implementation that does not support {@code Cloneable}.
*/ */
public Object clone() throws CloneNotSupportedException { public Object clone() throws CloneNotSupportedException {
if (this instanceof Cloneable) { if (this instanceof Cloneable) {
......
src/share/classes/java/security/NoSuchAlgorithmException.java
浏览文件 @ fe6c9f2d
/* /*
* Copyright (c) 1996, 2003, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1996, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
...@@ -58,13 +58,13 @@ public class NoSuchAlgorithmException extends GeneralSecurityException { ...@@ -58,13 +58,13 @@ public class NoSuchAlgorithmException extends GeneralSecurityException {
} }
/** /**
* Creates a <code>NoSuchAlgorithmException</code> with the specified * Creates a {@code NoSuchAlgorithmException} with the specified
* detail message and cause. * detail message and cause.
* *
* @param message the detail message (which is saved for later retrieval * @param message the detail message (which is saved for later retrieval
* by the {@link #getMessage()} method). * by the {@link #getMessage()} method).
* @param cause the cause (which is saved for later retrieval by the * @param cause the cause (which is saved for later retrieval by the
* {@link #getCause()} method). (A <tt>null</tt> value is permitted, * {@link #getCause()} method). (A {@code null} value is permitted,
* and indicates that the cause is nonexistent or unknown.) * and indicates that the cause is nonexistent or unknown.)
* @since 1.5 * @since 1.5
*/ */
...@@ -73,13 +73,13 @@ public class NoSuchAlgorithmException extends GeneralSecurityException { ...@@ -73,13 +73,13 @@ public class NoSuchAlgorithmException extends GeneralSecurityException {
} }
/** /**
* Creates a <code>NoSuchAlgorithmException</code> with the specified cause * Creates a {@code NoSuchAlgorithmException} with the specified cause
* and a detail message of <tt>(cause==null ? null : cause.toString())</tt> * and a detail message of {@code (cause==null ? null : cause.toString())}
* (which typically contains the class and detail message of * (which typically contains the class and detail message of
* <tt>cause</tt>). * {@code cause}).
* *
* @param cause the cause (which is saved for later retrieval by the * @param cause the cause (which is saved for later retrieval by the
* {@link #getCause()} method). (A <tt>null</tt> value is permitted, * {@link #getCause()} method). (A {@code null} value is permitted,
* and indicates that the cause is nonexistent or unknown.) * and indicates that the cause is nonexistent or unknown.)
* @since 1.5 * @since 1.5
*/ */
......
src/share/classes/java/security/Permission.java
浏览文件 @ fe6c9f2d
/* /*
* Copyright (c) 1997, 2009, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
...@@ -33,17 +33,17 @@ package java.security; ...@@ -33,17 +33,17 @@ package java.security;
* *
* <p>Most Permission objects also include an "actions" list that tells the actions * <p>Most Permission objects also include an "actions" list that tells the actions
* that are permitted for the object. For example, * that are permitted for the object. For example,
* for a <code>java.io.FilePermission</code> object, the permission name is * for a {@code java.io.FilePermission} object, the permission name is
* the pathname of a file (or directory), and the actions list * the pathname of a file (or directory), and the actions list
* (such as "read, write") specifies which actions are granted for the * (such as "read, write") specifies which actions are granted for the
* specified file (or for files in the specified directory). * specified file (or for files in the specified directory).
* The actions list is optional for Permission objects, such as * The actions list is optional for Permission objects, such as
* <code>java.lang.RuntimePermission</code>, * {@code java.lang.RuntimePermission},
* that don't need such a list; you either have the named permission (such * that don't need such a list; you either have the named permission (such
* as "system.exit") or you don't. * as "system.exit") or you don't.
* *
* <p>An important method that must be implemented by each subclass is * <p>An important method that must be implemented by each subclass is
* the <code>implies</code> method to compare Permissions. Basically, * the {@code implies} method to compare Permissions. Basically,
* "permission p1 implies permission p2" means that * "permission p1 implies permission p2" means that
* if one is granted permission p1, one is naturally granted permission p2. * if one is granted permission p1, one is naturally granted permission p2.
* Thus, this is not an equality test, but rather more of a * Thus, this is not an equality test, but rather more of a
...@@ -81,7 +81,7 @@ public abstract class Permission implements Guard, java.io.Serializable { ...@@ -81,7 +81,7 @@ public abstract class Permission implements Guard, java.io.Serializable {
/** /**
* Implements the guard interface for a permission. The * Implements the guard interface for a permission. The
* <code>SecurityManager.checkPermission</code> method is called, * {@code SecurityManager.checkPermission} method is called,
* passing this permission object as the permission to check. * passing this permission object as the permission to check.
* Returns silently if access is granted. Otherwise, throws * Returns silently if access is granted. Otherwise, throws
* a SecurityException. * a SecurityException.
...@@ -90,7 +90,7 @@ public abstract class Permission implements Guard, java.io.Serializable { ...@@ -90,7 +90,7 @@ public abstract class Permission implements Guard, java.io.Serializable {
* *
* @throws SecurityException * @throws SecurityException
* if a security manager exists and its * if a security manager exists and its
* <code>checkPermission</code> method doesn't allow access. * {@code checkPermission} method doesn't allow access.
* *
* @see Guard * @see Guard
* @see GuardedObject * @see GuardedObject
...@@ -109,7 +109,7 @@ public abstract class Permission implements Guard, java.io.Serializable { ...@@ -109,7 +109,7 @@ public abstract class Permission implements Guard, java.io.Serializable {
* This must be implemented by subclasses of Permission, as they are the * This must be implemented by subclasses of Permission, as they are the
* only ones that can impose semantics on a Permission object. * only ones that can impose semantics on a Permission object.
* *
* <p>The <code>implies</code> method is used by the AccessController to determine * <p>The {@code implies} method is used by the AccessController to determine
* whether or not a requested permission is implied by another permission that * whether or not a requested permission is implied by another permission that
* is known to be valid in the current execution context. * is known to be valid in the current execution context.
* *
...@@ -124,8 +124,8 @@ public abstract class Permission implements Guard, java.io.Serializable { ...@@ -124,8 +124,8 @@ public abstract class Permission implements Guard, java.io.Serializable {
/** /**
* Checks two Permission objects for equality. * Checks two Permission objects for equality.
* <P> * <P>
* Do not use the <code>equals</code> method for making access control * Do not use the {@code equals} method for making access control
* decisions; use the <code>implies</code> method. * decisions; use the {@code implies} method.
* *
* @param obj the object we are testing for equality with this object. * @param obj the object we are testing for equality with this object.
* *
...@@ -137,18 +137,18 @@ public abstract class Permission implements Guard, java.io.Serializable { ...@@ -137,18 +137,18 @@ public abstract class Permission implements Guard, java.io.Serializable {
/** /**
* Returns the hash code value for this Permission object. * Returns the hash code value for this Permission object.
* <P> * <P>
* The required <code>hashCode</code> behavior for Permission Objects is * The required {@code hashCode} behavior for Permission Objects is
* the following: <p> * the following: <p>
* <ul> * <ul>
* <li>Whenever it is invoked on the same Permission object more than * <li>Whenever it is invoked on the same Permission object more than
* once during an execution of a Java application, the * once during an execution of a Java application, the
* <code>hashCode</code> method * {@code hashCode} method
* must consistently return the same integer. This integer need not * must consistently return the same integer. This integer need not
* remain consistent from one execution of an application to another * remain consistent from one execution of an application to another
* execution of the same application. <p> * execution of the same application. <p>
* <li>If two Permission objects are equal according to the * <li>If two Permission objects are equal according to the
* <code>equals</code> * {@code equals}
* method, then calling the <code>hashCode</code> method on each of the * method, then calling the {@code hashCode} method on each of the
* two Permission objects must produce the same integer result. * two Permission objects must produce the same integer result.
* </ul> * </ul>
* *
...@@ -159,7 +159,7 @@ public abstract class Permission implements Guard, java.io.Serializable { ...@@ -159,7 +159,7 @@ public abstract class Permission implements Guard, java.io.Serializable {
/** /**
* Returns the name of this Permission. * Returns the name of this Permission.
* For example, in the case of a <code>java.io.FilePermission</code>, * For example, in the case of a {@code java.io.FilePermission},
* the name will be a pathname. * the name will be a pathname.
* *
* @return the name of this Permission. * @return the name of this Permission.
...@@ -184,7 +184,7 @@ public abstract class Permission implements Guard, java.io.Serializable { ...@@ -184,7 +184,7 @@ public abstract class Permission implements Guard, java.io.Serializable {
* </pre> * </pre>
* *
* both return * both return
* "read,write" when the <code>getActions</code> method is invoked. * "read,write" when the {@code getActions} method is invoked.
* *
* @return the actions of this Permission. * @return the actions of this Permission.
* *
...@@ -197,7 +197,7 @@ public abstract class Permission implements Guard, java.io.Serializable { ...@@ -197,7 +197,7 @@ public abstract class Permission implements Guard, java.io.Serializable {
* one is not defined. Subclasses of class Permission should * one is not defined. Subclasses of class Permission should
* override this if they need to store their permissions in a particular * override this if they need to store their permissions in a particular
* PermissionCollection object in order to provide the correct semantics * PermissionCollection object in order to provide the correct semantics
* when the <code>PermissionCollection.implies</code> method is called. * when the {@code PermissionCollection.implies} method is called.
* If null is returned, * If null is returned,
* then the caller of this method is free to store permissions of this * then the caller of this method is free to store permissions of this
* type in any PermissionCollection they choose (one that uses a Hashtable, * type in any PermissionCollection they choose (one that uses a Hashtable,
......
src/share/classes/java/security/PermissionCollection.java
浏览文件 @ fe6c9f2d
/* /*
* Copyright (c) 1997, 2006, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
...@@ -32,29 +32,29 @@ import java.util.*; ...@@ -32,29 +32,29 @@ import java.util.*;
* *
* <p>With a PermissionCollection, you can: * <p>With a PermissionCollection, you can:
* <UL> * <UL>
* <LI> add a permission to the collection using the <code>add</code> method. * <LI> add a permission to the collection using the {@code add} method.
* <LI> check to see if a particular permission is implied in the * <LI> check to see if a particular permission is implied in the
* collection, using the <code>implies</code> method. * collection, using the {@code implies} method.
* <LI> enumerate all the permissions, using the <code>elements</code> method. * <LI> enumerate all the permissions, using the {@code elements} method.
* </UL> * </UL>
* <P> * <P>
* *
* <p>When it is desirable to group together a number of Permission objects * <p>When it is desirable to group together a number of Permission objects
* of the same type, the <code>newPermissionCollection</code> method on that * of the same type, the {@code newPermissionCollection} method on that
* particular type of Permission object should first be called. The default * particular type of Permission object should first be called. The default
* behavior (from the Permission class) is to simply return null. * behavior (from the Permission class) is to simply return null.
* Subclasses of class Permission override the method if they need to store * Subclasses of class Permission override the method if they need to store
* their permissions in a particular PermissionCollection object in order * their permissions in a particular PermissionCollection object in order
* to provide the correct semantics when the * to provide the correct semantics when the
* <code>PermissionCollection.implies</code> method is called. * {@code PermissionCollection.implies} method is called.
* If a non-null value is returned, that PermissionCollection must be used. * If a non-null value is returned, that PermissionCollection must be used.
* If null is returned, then the caller of <code>newPermissionCollection</code> * If null is returned, then the caller of {@code newPermissionCollection}
* is free to store permissions of the * is free to store permissions of the
* given type in any PermissionCollection they choose * given type in any PermissionCollection they choose
* (one that uses a Hashtable, one that uses a Vector, etc). * (one that uses a Hashtable, one that uses a Vector, etc).
* *
* <p>The PermissionCollection returned by the * <p>The PermissionCollection returned by the
* <code>Permission.newPermissionCollection</code> * {@code Permission.newPermissionCollection}
* method is a homogeneous collection, which stores only Permission objects * method is a homogeneous collection, which stores only Permission objects
* for a given Permission type. A PermissionCollection may also be * for a given Permission type. A PermissionCollection may also be
* heterogeneous. For example, Permissions is a PermissionCollection * heterogeneous. For example, Permissions is a PermissionCollection
...@@ -62,16 +62,16 @@ import java.util.*; ...@@ -62,16 +62,16 @@ import java.util.*;
* That is, its members are each a homogeneous PermissionCollection. * That is, its members are each a homogeneous PermissionCollection.
* For example, a Permissions object might have a FilePermissionCollection * For example, a Permissions object might have a FilePermissionCollection
* for all the FilePermission objects, a SocketPermissionCollection for all the * for all the FilePermission objects, a SocketPermissionCollection for all the
* SocketPermission objects, and so on. Its <code>add</code> method adds a * SocketPermission objects, and so on. Its {@code add} method adds a
* permission to the appropriate collection. * permission to the appropriate collection.
* *
* <p>Whenever a permission is added to a heterogeneous PermissionCollection * <p>Whenever a permission is added to a heterogeneous PermissionCollection
* such as Permissions, and the PermissionCollection doesn't yet contain a * such as Permissions, and the PermissionCollection doesn't yet contain a
* PermissionCollection of the specified permission's type, the * PermissionCollection of the specified permission's type, the
* PermissionCollection should call * PermissionCollection should call
* the <code>newPermissionCollection</code> method on the permission's class * the {@code newPermissionCollection} method on the permission's class
* to see if it requires a special PermissionCollection. If * to see if it requires a special PermissionCollection. If
* <code>newPermissionCollection</code> * {@code newPermissionCollection}
* returns null, the PermissionCollection * returns null, the PermissionCollection
* is free to store the permission in any type of PermissionCollection it * is free to store the permission in any type of PermissionCollection it
* desires (one using a Hashtable, one using a Vector, etc.). For example, * desires (one using a Hashtable, one using a Vector, etc.). For example,
...@@ -81,7 +81,7 @@ import java.util.*; ...@@ -81,7 +81,7 @@ import java.util.*;
* <p> Subclass implementations of PermissionCollection should assume * <p> Subclass implementations of PermissionCollection should assume
* that they may be called simultaneously from multiple threads, * that they may be called simultaneously from multiple threads,
* and therefore should be synchronized properly. Furthermore, * and therefore should be synchronized properly. Furthermore,
* Enumerations returned via the <code>elements</code> method are * Enumerations returned via the {@code elements} method are
* not <em>fail-fast</em>. Modifications to a collection should not be * not <em>fail-fast</em>. Modifications to a collection should not be
* performed while enumerating over that collection. * performed while enumerating over that collection.
* *
...@@ -134,7 +134,7 @@ public abstract class PermissionCollection implements java.io.Serializable { ...@@ -134,7 +134,7 @@ public abstract class PermissionCollection implements java.io.Serializable {
* Marks this PermissionCollection object as "readonly". After * Marks this PermissionCollection object as "readonly". After
* a PermissionCollection object * a PermissionCollection object
* is marked as readonly, no new Permission objects can be added to it * is marked as readonly, no new Permission objects can be added to it
* using <code>add</code>. * using {@code add}.
*/ */
public void setReadOnly() { public void setReadOnly() {
readOnly = true; readOnly = true;
...@@ -143,10 +143,10 @@ public abstract class PermissionCollection implements java.io.Serializable { ...@@ -143,10 +143,10 @@ public abstract class PermissionCollection implements java.io.Serializable {
/** /**
* Returns true if this PermissionCollection object is marked as readonly. * Returns true if this PermissionCollection object is marked as readonly.
* If it is readonly, no new Permission objects can be added to it * If it is readonly, no new Permission objects can be added to it
* using <code>add</code>. * using {@code add}.
* *
* <p>By default, the object is <i>not</i> readonly. It can be set to * <p>By default, the object is <i>not</i> readonly. It can be set to
* readonly by a call to <code>setReadOnly</code>. * readonly by a call to {@code setReadOnly}.
* *
* @return true if this PermissionCollection object is marked as readonly, * @return true if this PermissionCollection object is marked as readonly,
* false otherwise. * false otherwise.
...@@ -166,7 +166,7 @@ public abstract class PermissionCollection implements java.io.Serializable { ...@@ -166,7 +166,7 @@ public abstract class PermissionCollection implements java.io.Serializable {
* // one per line.. * // one per line..
* )</pre> * )</pre>
* *
* <code>super.toString</code> is a call to the <code>toString</code> * {@code super.toString} is a call to the {@code toString}
* method of this * method of this
* object's superclass, which is Object. The result is * object's superclass, which is Object. The result is
* this PermissionCollection's type name followed by this object's * this PermissionCollection's type name followed by this object's
......
src/share/classes/java/security/Permissions.java
浏览文件 @ fe6c9f2d
/* /*
* Copyright (c) 1997, 2011, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
...@@ -44,26 +44,26 @@ import java.io.IOException; ...@@ -44,26 +44,26 @@ import java.io.IOException;
* This class represents a heterogeneous collection of Permissions. That is, * This class represents a heterogeneous collection of Permissions. That is,
* it contains different types of Permission objects, organized into * it contains different types of Permission objects, organized into
* PermissionCollections. For example, if any * PermissionCollections. For example, if any
* <code>java.io.FilePermission</code> objects are added to an instance of * {@code java.io.FilePermission} objects are added to an instance of
* this class, they are all stored in a single * this class, they are all stored in a single
* PermissionCollection. It is the PermissionCollection returned by a call to * PermissionCollection. It is the PermissionCollection returned by a call to
* the <code>newPermissionCollection</code> method in the FilePermission class. * the {@code newPermissionCollection} method in the FilePermission class.
* Similarly, any <code>java.lang.RuntimePermission</code> objects are * Similarly, any {@code java.lang.RuntimePermission} objects are
* stored in the PermissionCollection returned by a call to the * stored in the PermissionCollection returned by a call to the
* <code>newPermissionCollection</code> method in the * {@code newPermissionCollection} method in the
* RuntimePermission class. Thus, this class represents a collection of * RuntimePermission class. Thus, this class represents a collection of
* PermissionCollections. * PermissionCollections.
* *
* <p>When the <code>add</code> method is called to add a Permission, the * <p>When the {@code add} method is called to add a Permission, the
* Permission is stored in the appropriate PermissionCollection. If no such * Permission is stored in the appropriate PermissionCollection. If no such
* collection exists yet, the Permission object's class is determined and the * collection exists yet, the Permission object's class is determined and the
* <code>newPermissionCollection</code> method is called on that class to create * {@code newPermissionCollection} method is called on that class to create
* the PermissionCollection and add it to the Permissions object. If * the PermissionCollection and add it to the Permissions object. If
* <code>newPermissionCollection</code> returns null, then a default * {@code newPermissionCollection} returns null, then a default
* PermissionCollection that uses a hashtable will be created and used. Each * PermissionCollection that uses a hashtable will be created and used. Each
* hashtable entry stores a Permission object as both the key and the value. * hashtable entry stores a Permission object as both the key and the value.
* *
* <p> Enumerations returned via the <code>elements</code> method are * <p> Enumerations returned via the {@code elements} method are
* not <em>fail-fast</em>. Modifications to a collection should not be * not <em>fail-fast</em>. Modifications to a collection should not be
* performed while enumerating over that collection. * performed while enumerating over that collection.
* *
...@@ -155,9 +155,9 @@ implements Serializable ...@@ -155,9 +155,9 @@ implements Serializable
* "read" access for all files in all subdirectories of the "/tmp" * "read" access for all files in all subdirectories of the "/tmp"
* directory, and another FilePermission that specifies "write" access * directory, and another FilePermission that specifies "write" access
* for all files in the "/tmp/scratch/foo" directory. * for all files in the "/tmp/scratch/foo" directory.
* Then if the <code>implies</code> method * Then if the {@code implies} method
* is called with a permission specifying both "read" and "write" access * is called with a permission specifying both "read" and "write" access
* to files in the "/tmp/scratch/foo" directory, <code>true</code> is * to files in the "/tmp/scratch/foo" directory, {@code true} is
* returned. * returned.
* *
* <p>Additionally, if this PermissionCollection contains the * <p>Additionally, if this PermissionCollection contains the
...@@ -214,11 +214,11 @@ implements Serializable ...@@ -214,11 +214,11 @@ implements Serializable
* If createEmpty is true, * If createEmpty is true,
* this method creates a new PermissionCollection object for the specified * this method creates a new PermissionCollection object for the specified
* type of permission objects if one does not yet exist. * type of permission objects if one does not yet exist.
* To do so, it first calls the <code>newPermissionCollection</code> method * To do so, it first calls the {@code newPermissionCollection} method
* on <i>p</i>. Subclasses of class Permission * on <i>p</i>. Subclasses of class Permission
* override that method if they need to store their permissions in a * override that method if they need to store their permissions in a
* particular PermissionCollection object in order to provide the * particular PermissionCollection object in order to provide the
* correct semantics when the <code>PermissionCollection.implies</code> * correct semantics when the {@code PermissionCollection.implies}
* method is called. * method is called.
* If the call returns a PermissionCollection, that collection is stored * If the call returns a PermissionCollection, that collection is stored
* in this Permissions object. If the call returns null and createEmpty * in this Permissions object. If the call returns null and createEmpty
......
src/share/classes/java/security/Policy.java
浏览文件 @ fe6c9f2d
/* /*
* Copyright (c) 1997, 2012, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
...@@ -41,11 +41,11 @@ import sun.security.util.SecurityConstants; ...@@ -41,11 +41,11 @@ import sun.security.util.SecurityConstants;
* *
* <p> There is only one Policy object installed in the runtime at any * <p> There is only one Policy object installed in the runtime at any
* given time. A Policy object can be installed by calling the * given time. A Policy object can be installed by calling the
* <code>setPolicy</code> method. The installed Policy object can be * {@code setPolicy} method. The installed Policy object can be
* obtained by calling the <code>getPolicy</code> method. * obtained by calling the {@code getPolicy} method.
* *
* <p> If no Policy object has been installed in the runtime, a call to * <p> If no Policy object has been installed in the runtime, a call to
* <code>getPolicy</code> installs an instance of the default Policy * {@code getPolicy} installs an instance of the default Policy
* implementation (a default subclass implementation of this abstract class). * implementation (a default subclass implementation of this abstract class).
* The default Policy implementation can be changed by setting the value * The default Policy implementation can be changed by setting the value
* of the {@code policy.provider} security property to the fully qualified * of the {@code policy.provider} security property to the fully qualified
...@@ -53,26 +53,26 @@ import sun.security.util.SecurityConstants; ...@@ -53,26 +53,26 @@ import sun.security.util.SecurityConstants;
* *
* <p> Application code can directly subclass Policy to provide a custom * <p> Application code can directly subclass Policy to provide a custom
* implementation. In addition, an instance of a Policy object can be * implementation. In addition, an instance of a Policy object can be
* constructed by invoking one of the <code>getInstance</code> factory methods * constructed by invoking one of the {@code getInstance} factory methods
* with a standard type. The default policy type is "JavaPolicy". * with a standard type. The default policy type is "JavaPolicy".
* *
* <p> Once a Policy instance has been installed (either by default, or by * <p> Once a Policy instance has been installed (either by default, or by
* calling <code>setPolicy</code>), the Java runtime invokes its * calling {@code setPolicy}), the Java runtime invokes its
* <code>implies</code> method when it needs to * {@code implies} method when it needs to
* determine whether executing code (encapsulated in a ProtectionDomain) * determine whether executing code (encapsulated in a ProtectionDomain)
* can perform SecurityManager-protected operations. How a Policy object * can perform SecurityManager-protected operations. How a Policy object
* retrieves its policy data is up to the Policy implementation itself. * retrieves its policy data is up to the Policy implementation itself.
* The policy data may be stored, for example, in a flat ASCII file, * The policy data may be stored, for example, in a flat ASCII file,
* in a serialized binary file of the Policy class, or in a database. * in a serialized binary file of the Policy class, or in a database.
* *
* <p> The <code>refresh</code> method causes the policy object to * <p> The {@code refresh} method causes the policy object to
* refresh/reload its data. This operation is implementation-dependent. * refresh/reload its data. This operation is implementation-dependent.
* For example, if the policy object stores its data in configuration files, * For example, if the policy object stores its data in configuration files,
* calling <code>refresh</code> will cause it to re-read the configuration * calling {@code refresh} will cause it to re-read the configuration
* policy files. If a refresh operation is not supported, this method does * policy files. If a refresh operation is not supported, this method does
* nothing. Note that refreshed policy may not have an effect on classes * nothing. Note that refreshed policy may not have an effect on classes
* in a particular ProtectionDomain. This is dependent on the Policy * in a particular ProtectionDomain. This is dependent on the Policy
* provider's implementation of the <code>implies</code> * provider's implementation of the {@code implies}
* method and its PermissionCollection caching strategy. * method and its PermissionCollection caching strategy.
* *
* @author Roland Schemers * @author Roland Schemers
...@@ -130,17 +130,17 @@ public abstract class Policy { ...@@ -130,17 +130,17 @@ public abstract class Policy {
/** /**
* Returns the installed Policy object. This value should not be cached, * Returns the installed Policy object. This value should not be cached,
* as it may be changed by a call to <code>setPolicy</code>. * as it may be changed by a call to {@code setPolicy}.
* This method first calls * This method first calls
* <code>SecurityManager.checkPermission</code> with a * {@code SecurityManager.checkPermission} with a
* <code>SecurityPermission("getPolicy")</code> permission * {@code SecurityPermission("getPolicy")} permission
* to ensure it's ok to get the Policy object. * to ensure it's ok to get the Policy object.
* *
* @return the installed Policy. * @return the installed Policy.
* *
* @throws SecurityException * @throws SecurityException
* if a security manager exists and its * if a security manager exists and its
* <code>checkPermission</code> method doesn't allow * {@code checkPermission} method doesn't allow
* getting the Policy object. * getting the Policy object.
* *
* @see SecurityManager#checkPermission(Permission) * @see SecurityManager#checkPermission(Permission)
...@@ -246,15 +246,15 @@ public abstract class Policy { ...@@ -246,15 +246,15 @@ public abstract class Policy {
/** /**
* Sets the system-wide Policy object. This method first calls * Sets the system-wide Policy object. This method first calls
* <code>SecurityManager.checkPermission</code> with a * {@code SecurityManager.checkPermission} with a
* <code>SecurityPermission("setPolicy")</code> * {@code SecurityPermission("setPolicy")}
* permission to ensure it's ok to set the Policy. * permission to ensure it's ok to set the Policy.
* *
* @param p the new system Policy object. * @param p the new system Policy object.
* *
* @throws SecurityException * @throws SecurityException
* if a security manager exists and its * if a security manager exists and its
* <code>checkPermission</code> method doesn't allow * {@code checkPermission} method doesn't allow
* setting the Policy. * setting the Policy.
* *
* @see SecurityManager#checkPermission(Permission) * @see SecurityManager#checkPermission(Permission)
...@@ -536,7 +536,7 @@ public abstract class Policy { ...@@ -536,7 +536,7 @@ public abstract class Policy {
* Return the Provider of this Policy. * Return the Provider of this Policy.
* *
* <p> This Policy instance will only have a Provider if it * <p> This Policy instance will only have a Provider if it
* was obtained via a call to <code>Policy.getInstance</code>. * was obtained via a call to {@code Policy.getInstance}.
* Otherwise this method returns null. * Otherwise this method returns null.
* *
* @return the Provider of this Policy, or null. * @return the Provider of this Policy, or null.
...@@ -551,7 +551,7 @@ public abstract class Policy { ...@@ -551,7 +551,7 @@ public abstract class Policy {
* Return the type of this Policy. * Return the type of this Policy.
* *
* <p> This Policy instance will only have a type if it * <p> This Policy instance will only have a type if it
* was obtained via a call to <code>Policy.getInstance</code>. * was obtained via a call to {@code Policy.getInstance}.
* Otherwise this method returns null. * Otherwise this method returns null.
* *
* @return the type of this Policy, or null. * @return the type of this Policy, or null.
...@@ -566,7 +566,7 @@ public abstract class Policy { ...@@ -566,7 +566,7 @@ public abstract class Policy {
* Return Policy parameters. * Return Policy parameters.
* *
* <p> This Policy instance will only have parameters if it * <p> This Policy instance will only have parameters if it
* was obtained via a call to <code>Policy.getInstance</code>. * was obtained via a call to {@code Policy.getInstance}.
* Otherwise this method returns null. * Otherwise this method returns null.
* *
* @return Policy parameters, or null. * @return Policy parameters, or null.
...@@ -583,10 +583,10 @@ public abstract class Policy { ...@@ -583,10 +583,10 @@ public abstract class Policy {
* *
* <p> Applications are discouraged from calling this method * <p> Applications are discouraged from calling this method
* since this operation may not be supported by all policy implementations. * since this operation may not be supported by all policy implementations.
* Applications should solely rely on the <code>implies</code> method * Applications should solely rely on the {@code implies} method
* to perform policy checks. If an application absolutely must call * to perform policy checks. If an application absolutely must call
* a getPermissions method, it should call * a getPermissions method, it should call
* <code>getPermissions(ProtectionDomain)</code>. * {@code getPermissions(ProtectionDomain)}.
* *
* <p> The default implementation of this method returns * <p> The default implementation of this method returns
* Policy.UNSUPPORTED_EMPTY_COLLECTION. This method can be * Policy.UNSUPPORTED_EMPTY_COLLECTION. This method can be
...@@ -613,15 +613,15 @@ public abstract class Policy { ...@@ -613,15 +613,15 @@ public abstract class Policy {
* *
* <p> Applications are discouraged from calling this method * <p> Applications are discouraged from calling this method
* since this operation may not be supported by all policy implementations. * since this operation may not be supported by all policy implementations.
* Applications should rely on the <code>implies</code> method * Applications should rely on the {@code implies} method
* to perform policy checks. * to perform policy checks.
* *
* <p> The default implementation of this method first retrieves * <p> The default implementation of this method first retrieves
* the permissions returned via <code>getPermissions(CodeSource)</code> * the permissions returned via {@code getPermissions(CodeSource)}
* (the CodeSource is taken from the specified ProtectionDomain), * (the CodeSource is taken from the specified ProtectionDomain),
* as well as the permissions located inside the specified ProtectionDomain. * as well as the permissions located inside the specified ProtectionDomain.
* All of these permissions are then combined and returned in a new * All of these permissions are then combined and returned in a new
* PermissionCollection object. If <code>getPermissions(CodeSource)</code> * PermissionCollection object. If {@code getPermissions(CodeSource)}
* returns Policy.UNSUPPORTED_EMPTY_COLLECTION, then this method * returns Policy.UNSUPPORTED_EMPTY_COLLECTION, then this method
* returns the permissions contained inside the specified ProtectionDomain * returns the permissions contained inside the specified ProtectionDomain
* in a new PermissionCollection object. * in a new PermissionCollection object.
...@@ -733,7 +733,7 @@ public abstract class Policy { ...@@ -733,7 +733,7 @@ public abstract class Policy {
/** /**
* Refreshes/reloads the policy configuration. The behavior of this method * Refreshes/reloads the policy configuration. The behavior of this method
* depends on the implementation. For example, calling <code>refresh</code> * depends on the implementation. For example, calling {@code refresh}
* on a file-based policy will cause the file to be re-read. * on a file-based policy will cause the file to be re-read.
* *
* <p> The default implementation of this method does nothing. * <p> The default implementation of this method does nothing.
...@@ -794,8 +794,8 @@ public abstract class Policy { ...@@ -794,8 +794,8 @@ public abstract class Policy {
/** /**
* This class represents a read-only empty PermissionCollection object that * This class represents a read-only empty PermissionCollection object that
* is returned from the <code>getPermissions(CodeSource)</code> and * is returned from the {@code getPermissions(CodeSource)} and
* <code>getPermissions(ProtectionDomain)</code> * {@code getPermissions(ProtectionDomain)}
* methods in the Policy class when those operations are not * methods in the Policy class when those operations are not
* supported by the Policy implementation. * supported by the Policy implementation.
*/ */
......
src/share/classes/java/security/PolicySpi.java
浏览文件 @ fe6c9f2d
/* /*
* Copyright (c) 2005, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2005, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
...@@ -28,15 +28,15 @@ package java.security; ...@@ -28,15 +28,15 @@ package java.security;
/** /**
* This class defines the <i>Service Provider Interface</i> (<b>SPI</b>) * This class defines the <i>Service Provider Interface</i> (<b>SPI</b>)
* for the <code>Policy</code> class. * for the {@code Policy} class.
* All the abstract methods in this class must be implemented by each * All the abstract methods in this class must be implemented by each
* service provider who wishes to supply a Policy implementation. * service provider who wishes to supply a Policy implementation.
* *
* <p> Subclass implementations of this abstract class must provide * <p> Subclass implementations of this abstract class must provide
* a public constructor that takes a <code>Policy.Parameters</code> * a public constructor that takes a {@code Policy.Parameters}
* object as an input parameter. This constructor also must throw * object as an input parameter. This constructor also must throw
* an IllegalArgumentException if it does not understand the * an IllegalArgumentException if it does not understand the
* <code>Policy.Parameters</code> input. * {@code Policy.Parameters} input.
* *
* *
* @since 1.6 * @since 1.6
...@@ -59,7 +59,7 @@ public abstract class PolicySpi { ...@@ -59,7 +59,7 @@ public abstract class PolicySpi {
/** /**
* Refreshes/reloads the policy configuration. The behavior of this method * Refreshes/reloads the policy configuration. The behavior of this method
* depends on the implementation. For example, calling <code>refresh</code> * depends on the implementation. For example, calling {@code refresh}
* on a file-based policy will cause the file to be re-read. * on a file-based policy will cause the file to be re-read.
* *
* <p> The default implementation of this method does nothing. * <p> The default implementation of this method does nothing.
......
src/share/classes/java/security/PrivilegedAction.java
浏览文件 @ fe6c9f2d
/* /*
* Copyright (c) 1998, 2004, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1998, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
...@@ -28,10 +28,10 @@ package java.security; ...@@ -28,10 +28,10 @@ package java.security;
/** /**
* A computation to be performed with privileges enabled. The computation is * A computation to be performed with privileges enabled. The computation is
* performed by invoking <code>AccessController.doPrivileged</code> on the * performed by invoking {@code AccessController.doPrivileged} on the
* <code>PrivilegedAction</code> object. This interface is used only for * {@code PrivilegedAction} object. This interface is used only for
* computations that do not throw checked exceptions; computations that * computations that do not throw checked exceptions; computations that
* throw checked exceptions must use <code>PrivilegedExceptionAction</code> * throw checked exceptions must use {@code PrivilegedExceptionAction}
* instead. * instead.
* *
* @see AccessController * @see AccessController
...@@ -42,11 +42,11 @@ package java.security; ...@@ -42,11 +42,11 @@ package java.security;
public interface PrivilegedAction<T> { public interface PrivilegedAction<T> {
/** /**
* Performs the computation. This method will be called by * Performs the computation. This method will be called by
* <code>AccessController.doPrivileged</code> after enabling privileges. * {@code AccessController.doPrivileged} after enabling privileges.
* *
* @return a class-dependent value that may represent the results of the * @return a class-dependent value that may represent the results of the
* computation. Each class that implements * computation. Each class that implements
* <code>PrivilegedAction</code> * {@code PrivilegedAction}
* should document what (if anything) this value represents. * should document what (if anything) this value represents.
* @see AccessController#doPrivileged(PrivilegedAction) * @see AccessController#doPrivileged(PrivilegedAction)
* @see AccessController#doPrivileged(PrivilegedAction, * @see AccessController#doPrivileged(PrivilegedAction,
......
src/share/classes/java/security/PrivilegedActionException.java
浏览文件 @ fe6c9f2d
/* /*
* Copyright (c) 1998, 2001, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1998, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
...@@ -27,13 +27,13 @@ package java.security; ...@@ -27,13 +27,13 @@ package java.security;
/** /**
* This exception is thrown by * This exception is thrown by
* <code>doPrivileged(PrivilegedExceptionAction)</code> and * {@code doPrivileged(PrivilegedExceptionAction)} and
* <code>doPrivileged(PrivilegedExceptionAction, * {@code doPrivileged(PrivilegedExceptionAction,
* AccessControlContext context)</code> to indicate * AccessControlContext context)} to indicate
* that the action being performed threw a checked exception. The exception * that the action being performed threw a checked exception. The exception
* thrown by the action can be obtained by calling the * thrown by the action can be obtained by calling the
* <code>getException</code> method. In effect, an * {@code getException} method. In effect, an
* <code>PrivilegedActionException</code> is a "wrapper" * {@code PrivilegedActionException} is a "wrapper"
* for an exception thrown by a privileged action. * for an exception thrown by a privileged action.
* *
* <p>As of release 1.4, this exception has been retrofitted to conform to * <p>As of release 1.4, this exception has been retrofitted to conform to
...@@ -69,14 +69,14 @@ public class PrivilegedActionException extends Exception { ...@@ -69,14 +69,14 @@ public class PrivilegedActionException extends Exception {
/** /**
* Returns the exception thrown by the privileged computation that * Returns the exception thrown by the privileged computation that
* resulted in this <code>PrivilegedActionException</code>. * resulted in this {@code PrivilegedActionException}.
* *
* <p>This method predates the general-purpose exception chaining facility. * <p>This method predates the general-purpose exception chaining facility.
* The {@link Throwable#getCause()} method is now the preferred means of * The {@link Throwable#getCause()} method is now the preferred means of
* obtaining this information. * obtaining this information.
* *
* @return the exception thrown by the privileged computation that * @return the exception thrown by the privileged computation that
* resulted in this <code>PrivilegedActionException</code>. * resulted in this {@code PrivilegedActionException}.
* @see PrivilegedExceptionAction * @see PrivilegedExceptionAction
* @see AccessController#doPrivileged(PrivilegedExceptionAction) * @see AccessController#doPrivileged(PrivilegedExceptionAction)
* @see AccessController#doPrivileged(PrivilegedExceptionAction, * @see AccessController#doPrivileged(PrivilegedExceptionAction,
...@@ -89,7 +89,7 @@ public class PrivilegedActionException extends Exception { ...@@ -89,7 +89,7 @@ public class PrivilegedActionException extends Exception {
/** /**
* Returns the cause of this exception (the exception thrown by * Returns the cause of this exception (the exception thrown by
* the privileged computation that resulted in this * the privileged computation that resulted in this
* <code>PrivilegedActionException</code>). * {@code PrivilegedActionException}).
* *
* @return the cause of this exception. * @return the cause of this exception.
* @since 1.4 * @since 1.4
......
src/share/classes/java/security/PrivilegedExceptionAction.java
浏览文件 @ fe6c9f2d
/* /*
* Copyright (c) 1998, 2004, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1998, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
...@@ -29,11 +29,11 @@ package java.security; ...@@ -29,11 +29,11 @@ package java.security;
/** /**
* A computation to be performed with privileges enabled, that throws one or * A computation to be performed with privileges enabled, that throws one or
* more checked exceptions. The computation is performed by invoking * more checked exceptions. The computation is performed by invoking
* <code>AccessController.doPrivileged</code> on the * {@code AccessController.doPrivileged} on the
* <code>PrivilegedExceptionAction</code> object. This interface is * {@code PrivilegedExceptionAction} object. This interface is
* used only for computations that throw checked exceptions; * used only for computations that throw checked exceptions;
* computations that do not throw * computations that do not throw
* checked exceptions should use <code>PrivilegedAction</code> instead. * checked exceptions should use {@code PrivilegedAction} instead.
* *
* @see AccessController * @see AccessController
* @see AccessController#doPrivileged(PrivilegedExceptionAction) * @see AccessController#doPrivileged(PrivilegedExceptionAction)
...@@ -45,14 +45,14 @@ package java.security; ...@@ -45,14 +45,14 @@ package java.security;
public interface PrivilegedExceptionAction<T> { public interface PrivilegedExceptionAction<T> {
/** /**
* Performs the computation. This method will be called by * Performs the computation. This method will be called by
* <code>AccessController.doPrivileged</code> after enabling privileges. * {@code AccessController.doPrivileged} after enabling privileges.
* *
* @return a class-dependent value that may represent the results of the * @return a class-dependent value that may represent the results of the
* computation. Each class that implements * computation. Each class that implements
* <code>PrivilegedExceptionAction</code> should document what * {@code PrivilegedExceptionAction} should document what
* (if anything) this value represents. * (if anything) this value represents.
* @throws Exception an exceptional condition has occurred. Each class * @throws Exception an exceptional condition has occurred. Each class
* that implements <code>PrivilegedExceptionAction</code> should * that implements {@code PrivilegedExceptionAction} should
* document the exceptions that its run method can throw. * document the exceptions that its run method can throw.
* @see AccessController#doPrivileged(PrivilegedExceptionAction) * @see AccessController#doPrivileged(PrivilegedExceptionAction)
* @see AccessController#doPrivileged(PrivilegedExceptionAction,AccessControlContext) * @see AccessController#doPrivileged(PrivilegedExceptionAction,AccessControlContext)
......
src/share/classes/java/security/ProtectionDomain.java
浏览文件 @ fe6c9f2d
...@@ -119,7 +119,7 @@ public class ProtectionDomain { ...@@ -119,7 +119,7 @@ public class ProtectionDomain {
/** /**
* Creates a new ProtectionDomain with the given CodeSource and * Creates a new ProtectionDomain with the given CodeSource and
* Permissions. If the permissions object is not null, then * Permissions. If the permissions object is not null, then
* <code>setReadOnly())</code> will be called on the passed in * {@code setReadOnly())} will be called on the passed in
* Permissions object. The only permissions granted to this domain * Permissions object. The only permissions granted to this domain
* are the ones specified; the current Policy will not be consulted. * are the ones specified; the current Policy will not be consulted.
* *
...@@ -145,7 +145,7 @@ public class ProtectionDomain { ...@@ -145,7 +145,7 @@ public class ProtectionDomain {
/** /**
* Creates a new ProtectionDomain qualified by the given CodeSource, * Creates a new ProtectionDomain qualified by the given CodeSource,
* Permissions, ClassLoader and array of Principals. If the * Permissions, ClassLoader and array of Principals. If the
* permissions object is not null, then <code>setReadOnly()</code> * permissions object is not null, then {@code setReadOnly()}
* will be called on the passed in Permissions object. * will be called on the passed in Permissions object.
* The permissions granted to this domain are dynamic; they include * The permissions granted to this domain are dynamic; they include
* both the static permissions passed to this constructor, and any * both the static permissions passed to this constructor, and any
...@@ -155,7 +155,7 @@ public class ProtectionDomain { ...@@ -155,7 +155,7 @@ public class ProtectionDomain {
* This constructor is typically used by * This constructor is typically used by
* {@link SecureClassLoader ClassLoaders} * {@link SecureClassLoader ClassLoaders}
* and {@link DomainCombiner DomainCombiners} which delegate to * and {@link DomainCombiner DomainCombiners} which delegate to
* <code>Policy</code> to actively associate the permissions granted to * {@code Policy} to actively associate the permissions granted to
* this domain. This constructor affords the * this domain. This constructor affords the
* Policy provider the opportunity to augment the supplied * Policy provider the opportunity to augment the supplied
* PermissionCollection to reflect policy changes. * PermissionCollection to reflect policy changes.
......
src/share/classes/java/security/Provider.java
浏览文件 @ fe6c9f2d
/* /*
* Copyright (c) 1996, 2011, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1996, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
...@@ -62,20 +62,20 @@ import java.lang.reflect.*; ...@@ -62,20 +62,20 @@ import java.lang.reflect.*;
* security token. A {@link ProviderException} should be used to indicate * security token. A {@link ProviderException} should be used to indicate
* such errors. * such errors.
* *
* <p>The service type <code>Provider</code> is reserved for use by the * <p>The service type {@code Provider} is reserved for use by the
* security framework. Services of this type cannot be added, removed, * security framework. Services of this type cannot be added, removed,
* or modified by applications. * or modified by applications.
* The following attributes are automatically placed in each Provider object: * The following attributes are automatically placed in each Provider object:
* <table cellspacing=4> * <table cellspacing=4>
* <tr><th>Name</th><th>Value</th> * <tr><th>Name</th><th>Value</th>
* <tr><td><code>Provider.id name</code></td> * <tr><td>{@code Provider.id name}</td>
* <td><code>String.valueOf(provider.getName())</code></td> * <td>{@code String.valueOf(provider.getName())}</td>
* <tr><td><code>Provider.id version</code></td> * <tr><td>{@code Provider.id version}</td>
* <td><code>String.valueOf(provider.getVersion())</code></td> * <td>{@code String.valueOf(provider.getVersion())}</td>
* <tr><td><code>Provider.id info</code></td> * <tr><td>{@code Provider.id info}</td>
<td><code>String.valueOf(provider.getInfo())</code></td> <td>{@code String.valueOf(provider.getInfo())}</td>
* <tr><td><code>Provider.id className</code></td> * <tr><td>{@code Provider.id className}</td>
* <td><code>provider.getClass().getName()</code></td> * <td>{@code provider.getClass().getName()}</td>
* </table> * </table>
* *
* @author Benjamin Renaud * @author Benjamin Renaud
...@@ -185,18 +185,18 @@ public abstract class Provider extends Properties { ...@@ -185,18 +185,18 @@ public abstract class Provider extends Properties {
* used to look up facilities implemented by the provider. * used to look up facilities implemented by the provider.
* *
* <p>First, if there is a security manager, its * <p>First, if there is a security manager, its
* <code>checkSecurityAccess</code> method is called with the string * {@code checkSecurityAccess} method is called with the string
* <code>"clearProviderProperties."+name</code> (where <code>name</code> * {@code "clearProviderProperties."+name} (where {@code name}
* is the provider name) to see if it's ok to clear this provider. * is the provider name) to see if it's ok to clear this provider.
* If the default implementation of <code>checkSecurityAccess</code> * If the default implementation of {@code checkSecurityAccess}
* is used (that is, that method is not overriden), then this results in * is used (that is, that method is not overriden), then this results in
* a call to the security manager's <code>checkPermission</code> method * a call to the security manager's {@code checkPermission} method
* with a <code>SecurityPermission("clearProviderProperties."+name)</code> * with a {@code SecurityPermission("clearProviderProperties."+name)}
* permission. * permission.
* *
* @throws SecurityException * @throws SecurityException
* if a security manager exists and its <code>{@link * if a security manager exists and its {@link
* java.lang.SecurityManager#checkSecurityAccess}</code> method * java.lang.SecurityManager#checkSecurityAccess} method
* denies access to clear this provider * denies access to clear this provider
* *
* @since 1.2 * @since 1.2
...@@ -292,17 +292,17 @@ public abstract class Provider extends Properties { ...@@ -292,17 +292,17 @@ public abstract class Provider extends Properties {
} }
/** /**
* Sets the <code>key</code> property to have the specified * Sets the {@code key} property to have the specified
* <code>value</code>. * {@code value}.
* *
* <p>First, if there is a security manager, its * <p>First, if there is a security manager, its
* <code>checkSecurityAccess</code> method is called with the string * {@code checkSecurityAccess} method is called with the string
* <code>"putProviderProperty."+name</code>, where <code>name</code> is the * {@code "putProviderProperty."+name}, where {@code name} is the
* provider name, to see if it's ok to set this provider's property values. * provider name, to see if it's ok to set this provider's property values.
* If the default implementation of <code>checkSecurityAccess</code> * If the default implementation of {@code checkSecurityAccess}
* is used (that is, that method is not overriden), then this results in * is used (that is, that method is not overriden), then this results in
* a call to the security manager's <code>checkPermission</code> method * a call to the security manager's {@code checkPermission} method
* with a <code>SecurityPermission("putProviderProperty."+name)</code> * with a {@code SecurityPermission("putProviderProperty."+name)}
* permission. * permission.
* *
* @param key the property key. * @param key the property key.
...@@ -310,11 +310,11 @@ public abstract class Provider extends Properties { ...@@ -310,11 +310,11 @@ public abstract class Provider extends Properties {
* @param value the property value. * @param value the property value.
* *
* @return the previous value of the specified property * @return the previous value of the specified property
* (<code>key</code>), or null if it did not have one. * ({@code key}), or null if it did not have one.
* *
* @throws SecurityException * @throws SecurityException
* if a security manager exists and its <code>{@link * if a security manager exists and its {@link
* java.lang.SecurityManager#checkSecurityAccess}</code> method * java.lang.SecurityManager#checkSecurityAccess} method
* denies access to set property values. * denies access to set property values.
* *
* @since 1.2 * @since 1.2
...@@ -329,18 +329,18 @@ public abstract class Provider extends Properties { ...@@ -329,18 +329,18 @@ public abstract class Provider extends Properties {
} }
/** /**
* Removes the <code>key</code> property (and its corresponding * Removes the {@code key} property (and its corresponding
* <code>value</code>). * {@code value}).
* *
* <p>First, if there is a security manager, its * <p>First, if there is a security manager, its
* <code>checkSecurityAccess</code> method is called with the string * {@code checkSecurityAccess} method is called with the string
* <code>"removeProviderProperty."+name</code>, where <code>name</code> is * {@code "removeProviderProperty."+name}, where {@code name} is
* the provider name, to see if it's ok to remove this provider's * the provider name, to see if it's ok to remove this provider's
* properties. If the default implementation of * properties. If the default implementation of
* <code>checkSecurityAccess</code> is used (that is, that method is not * {@code checkSecurityAccess} is used (that is, that method is not
* overriden), then this results in a call to the security manager's * overriden), then this results in a call to the security manager's
* <code>checkPermission</code> method with a * {@code checkPermission} method with a
* <code>SecurityPermission("removeProviderProperty."+name)</code> * {@code SecurityPermission("removeProviderProperty."+name)}
* permission. * permission.
* *
* @param key the key for the property to be removed. * @param key the key for the property to be removed.
...@@ -349,8 +349,8 @@ public abstract class Provider extends Properties { ...@@ -349,8 +349,8 @@ public abstract class Provider extends Properties {
* or null if the key did not have a mapping. * or null if the key did not have a mapping.
* *
* @throws SecurityException * @throws SecurityException
* if a security manager exists and its <code>{@link * if a security manager exists and its {@link
* java.lang.SecurityManager#checkSecurityAccess}</code> method * java.lang.SecurityManager#checkSecurityAccess} method
* denies access to remove this provider's properties. * denies access to remove this provider's properties.
* *
* @since 1.2 * @since 1.2
...@@ -662,9 +662,9 @@ public abstract class Provider extends Properties { ...@@ -662,9 +662,9 @@ public abstract class Provider extends Properties {
* the service added via {@link #putService putService()} is returned. * the service added via {@link #putService putService()} is returned.
* *
* @param type the type of {@link Service service} requested * @param type the type of {@link Service service} requested
* (for example, <code>MessageDigest</code>) * (for example, {@code MessageDigest})
* @param algorithm the case insensitive algorithm name (or alternate * @param algorithm the case insensitive algorithm name (or alternate
* alias) of the service requested (for example, <code>SHA-1</code>) * alias) of the service requested (for example, {@code SHA-1})
* *
* @return the service describing this Provider's matching service * @return the service describing this Provider's matching service
* or null if no such service exists * or null if no such service exists
...@@ -739,20 +739,20 @@ public abstract class Provider extends Properties { ...@@ -739,20 +739,20 @@ public abstract class Provider extends Properties {
* Java Cryptography Architecture API Specification &amp; Reference </a>. * Java Cryptography Architecture API Specification &amp; Reference </a>.
* *
* <p>Also, if there is a security manager, its * <p>Also, if there is a security manager, its
* <code>checkSecurityAccess</code> method is called with the string * {@code checkSecurityAccess} method is called with the string
* <code>"putProviderProperty."+name</code>, where <code>name</code> is * {@code "putProviderProperty."+name}, where {@code name} is
* the provider name, to see if it's ok to set this provider's property * the provider name, to see if it's ok to set this provider's property
* values. If the default implementation of <code>checkSecurityAccess</code> * values. If the default implementation of {@code checkSecurityAccess}
* is used (that is, that method is not overriden), then this results in * is used (that is, that method is not overriden), then this results in
* a call to the security manager's <code>checkPermission</code> method with * a call to the security manager's {@code checkPermission} method with
* a <code>SecurityPermission("putProviderProperty."+name)</code> * a {@code SecurityPermission("putProviderProperty."+name)}
* permission. * permission.
* *
* @param s the Service to add * @param s the Service to add
* *
* @throws SecurityException * @throws SecurityException
* if a security manager exists and its <code>{@link * if a security manager exists and its {@link
* java.lang.SecurityManager#checkSecurityAccess}</code> method denies * java.lang.SecurityManager#checkSecurityAccess} method denies
* access to set property values. * access to set property values.
* @throws NullPointerException if s is null * @throws NullPointerException if s is null
* *
...@@ -830,21 +830,21 @@ public abstract class Provider extends Properties { ...@@ -830,21 +830,21 @@ public abstract class Provider extends Properties {
* from this provider's Hashtable. * from this provider's Hashtable.
* *
* <p>Also, if there is a security manager, its * <p>Also, if there is a security manager, its
* <code>checkSecurityAccess</code> method is called with the string * {@code checkSecurityAccess} method is called with the string
* <code>"removeProviderProperty."+name</code>, where <code>name</code> is * {@code "removeProviderProperty."+name}, where {@code name} is
* the provider name, to see if it's ok to remove this provider's * the provider name, to see if it's ok to remove this provider's
* properties. If the default implementation of * properties. If the default implementation of
* <code>checkSecurityAccess</code> is used (that is, that method is not * {@code checkSecurityAccess} is used (that is, that method is not
* overriden), then this results in a call to the security manager's * overriden), then this results in a call to the security manager's
* <code>checkPermission</code> method with a * {@code checkPermission} method with a
* <code>SecurityPermission("removeProviderProperty."+name)</code> * {@code SecurityPermission("removeProviderProperty."+name)}
* permission. * permission.
* *
* @param s the Service to be removed * @param s the Service to be removed
* *
* @throws SecurityException * @throws SecurityException
* if a security manager exists and its <code>{@link * if a security manager exists and its {@link
* java.lang.SecurityManager#checkSecurityAccess}</code> method denies * java.lang.SecurityManager#checkSecurityAccess} method denies
* access to remove this provider's properties. * access to remove this provider's properties.
* @throws NullPointerException if s is null * @throws NullPointerException if s is null
* *
...@@ -1122,7 +1122,7 @@ public abstract class Provider extends Properties { ...@@ -1122,7 +1122,7 @@ public abstract class Provider extends Properties {
} }
/** /**
* Get the type of this service. For example, <code>MessageDigest</code>. * Get the type of this service. For example, {@code MessageDigest}.
* *
* @return the type of this service * @return the type of this service
*/ */
...@@ -1132,7 +1132,7 @@ public abstract class Provider extends Properties { ...@@ -1132,7 +1132,7 @@ public abstract class Provider extends Properties {
/** /**
* Return the name of the algorithm of this service. For example, * Return the name of the algorithm of this service. For example,
* <code>SHA-1</code>. * {@code SHA-1}.
* *
* @return the algorithm of this service * @return the algorithm of this service
*/ */
......
src/share/classes/java/security/ProviderException.java
浏览文件 @ fe6c9f2d
/* /*
* Copyright (c) 1996, 2003, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1996, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
...@@ -58,13 +58,13 @@ public class ProviderException extends RuntimeException { ...@@ -58,13 +58,13 @@ public class ProviderException extends RuntimeException {
} }
/** /**
* Creates a <code>ProviderException</code> with the specified * Creates a {@code ProviderException} with the specified
* detail message and cause. * detail message and cause.
* *
* @param message the detail message (which is saved for later retrieval * @param message the detail message (which is saved for later retrieval
* by the {@link #getMessage()} method). * by the {@link #getMessage()} method).
* @param cause the cause (which is saved for later retrieval by the * @param cause the cause (which is saved for later retrieval by the
* {@link #getCause()} method). (A <tt>null</tt> value is permitted, * {@link #getCause()} method). (A {@code null} value is permitted,
* and indicates that the cause is nonexistent or unknown.) * and indicates that the cause is nonexistent or unknown.)
* @since 1.5 * @since 1.5
*/ */
...@@ -73,13 +73,13 @@ public class ProviderException extends RuntimeException { ...@@ -73,13 +73,13 @@ public class ProviderException extends RuntimeException {
} }
/** /**
* Creates a <code>ProviderException</code> with the specified cause * Creates a {@code ProviderException} with the specified cause
* and a detail message of <tt>(cause==null ? null : cause.toString())</tt> * and a detail message of {@code (cause==null ? null : cause.toString())}
* (which typically contains the class and detail message of * (which typically contains the class and detail message of
* <tt>cause</tt>). * {@code cause}).
* *
* @param cause the cause (which is saved for later retrieval by the * @param cause the cause (which is saved for later retrieval by the
* {@link #getCause()} method). (A <tt>null</tt> value is permitted, * {@link #getCause()} method). (A {@code null} value is permitted,
* and indicates that the cause is nonexistent or unknown.) * and indicates that the cause is nonexistent or unknown.)
* @since 1.5 * @since 1.5
*/ */
......
src/share/classes/java/security/PublicKey.java
浏览文件 @ fe6c9f2d
/* /*
* Copyright (c) 1996, 2001, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1996, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
...@@ -32,7 +32,7 @@ package java.security; ...@@ -32,7 +32,7 @@ package java.security;
* *
* Note: The specialized public key interfaces extend this interface. * Note: The specialized public key interfaces extend this interface.
* See, for example, the DSAPublicKey interface in * See, for example, the DSAPublicKey interface in
* <code>java.security.interfaces</code>. * {@code java.security.interfaces}.
* *
* @see Key * @see Key
* @see PrivateKey * @see PrivateKey
......
src/share/classes/java/security/SecureClassLoader.java
浏览文件 @ fe6c9f2d
/* /*
* Copyright (c) 1997, 2011, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
...@@ -63,12 +63,12 @@ public class SecureClassLoader extends ClassLoader { ...@@ -63,12 +63,12 @@ public class SecureClassLoader extends ClassLoader {
* class loader for delegation. * class loader for delegation.
* *
* <p>If there is a security manager, this method first * <p>If there is a security manager, this method first
* calls the security manager's <code>checkCreateClassLoader</code> * calls the security manager's {@code checkCreateClassLoader}
* method to ensure creation of a class loader is allowed. * method to ensure creation of a class loader is allowed.
* <p> * <p>
* @param parent the parent ClassLoader * @param parent the parent ClassLoader
* @exception SecurityException if a security manager exists and its * @exception SecurityException if a security manager exists and its
* <code>checkCreateClassLoader</code> method doesn't allow * {@code checkCreateClassLoader} method doesn't allow
* creation of a class loader. * creation of a class loader.
* @see SecurityManager#checkCreateClassLoader * @see SecurityManager#checkCreateClassLoader
*/ */
...@@ -87,11 +87,11 @@ public class SecureClassLoader extends ClassLoader { ...@@ -87,11 +87,11 @@ public class SecureClassLoader extends ClassLoader {
* loader for delegation. * loader for delegation.
* *
* <p>If there is a security manager, this method first * <p>If there is a security manager, this method first
* calls the security manager's <code>checkCreateClassLoader</code> * calls the security manager's {@code checkCreateClassLoader}
* method to ensure creation of a class loader is allowed. * method to ensure creation of a class loader is allowed.
* *
* @exception SecurityException if a security manager exists and its * @exception SecurityException if a security manager exists and its
* <code>checkCreateClassLoader</code> method doesn't allow * {@code checkCreateClassLoader} method doesn't allow
* creation of a class loader. * creation of a class loader.
* @see SecurityManager#checkCreateClassLoader * @see SecurityManager#checkCreateClassLoader
*/ */
...@@ -113,22 +113,22 @@ public class SecureClassLoader extends ClassLoader { ...@@ -113,22 +113,22 @@ public class SecureClassLoader extends ClassLoader {
* If a non-null CodeSource is supplied a ProtectionDomain is * If a non-null CodeSource is supplied a ProtectionDomain is
* constructed and associated with the class being defined. * constructed and associated with the class being defined.
* <p> * <p>
* @param name the expected name of the class, or <code>null</code> * @param name the expected name of the class, or {@code null}
* if not known, using '.' and not '/' as the separator * if not known, using '.' and not '/' as the separator
* and without a trailing ".class" suffix. * and without a trailing ".class" suffix.
* @param b the bytes that make up the class data. The bytes in * @param b the bytes that make up the class data. The bytes in
* positions <code>off</code> through <code>off+len-1</code> * positions {@code off} through {@code off+len-1}
* should have the format of a valid class file as defined by * should have the format of a valid class file as defined by
* <cite>The Java&trade; Virtual Machine Specification</cite>. * <cite>The Java&trade; Virtual Machine Specification</cite>.
* @param off the start offset in <code>b</code> of the class data * @param off the start offset in {@code b} of the class data
* @param len the length of the class data * @param len the length of the class data
* @param cs the associated CodeSource, or <code>null</code> if none * @param cs the associated CodeSource, or {@code null} if none
* @return the <code>Class</code> object created from the data, * @return the {@code Class} object created from the data,
* and optional CodeSource. * and optional CodeSource.
* @exception ClassFormatError if the data did not contain a valid class * @exception ClassFormatError if the data did not contain a valid class
* @exception IndexOutOfBoundsException if either <code>off</code> or * @exception IndexOutOfBoundsException if either {@code off} or
* <code>len</code> is negative, or if * {@code len} is negative, or if
* <code>off+len</code> is greater than <code>b.length</code>. * {@code off+len} is greater than {@code b.length}.
* *
* @exception SecurityException if an attempt is made to add this class * @exception SecurityException if an attempt is made to add this class
* to a package that contains classes that were signed by * to a package that contains classes that were signed by
...@@ -143,22 +143,22 @@ public class SecureClassLoader extends ClassLoader { ...@@ -143,22 +143,22 @@ public class SecureClassLoader extends ClassLoader {
} }
/** /**
* Converts a {@link java.nio.ByteBuffer <tt>ByteBuffer</tt>} * Converts a {@link java.nio.ByteBuffer ByteBuffer}
* into an instance of class <tt>Class</tt>, with an optional CodeSource. * into an instance of class {@code Class}, with an optional CodeSource.
* Before the class can be used it must be resolved. * Before the class can be used it must be resolved.
* <p> * <p>
* If a non-null CodeSource is supplied a ProtectionDomain is * If a non-null CodeSource is supplied a ProtectionDomain is
* constructed and associated with the class being defined. * constructed and associated with the class being defined.
* <p> * <p>
* @param name the expected name of the class, or <code>null</code> * @param name the expected name of the class, or {@code null}
* if not known, using '.' and not '/' as the separator * if not known, using '.' and not '/' as the separator
* and without a trailing ".class" suffix. * and without a trailing ".class" suffix.
* @param b the bytes that make up the class data. The bytes from positions * @param b the bytes that make up the class data. The bytes from positions
* <tt>b.position()</tt> through <tt>b.position() + b.limit() -1</tt> * {@code b.position()} through {@code b.position() + b.limit() -1}
* should have the format of a valid class file as defined by * should have the format of a valid class file as defined by
* <cite>The Java&trade; Virtual Machine Specification</cite>. * <cite>The Java&trade; Virtual Machine Specification</cite>.
* @param cs the associated CodeSource, or <code>null</code> if none * @param cs the associated CodeSource, or {@code null} if none
* @return the <code>Class</code> object created from the data, * @return the {@code Class} object created from the data,
* and optional CodeSource. * and optional CodeSource.
* @exception ClassFormatError if the data did not contain a valid class * @exception ClassFormatError if the data did not contain a valid class
* @exception SecurityException if an attempt is made to add this class * @exception SecurityException if an attempt is made to add this class
......
src/share/classes/java/security/SecureRandom.java
浏览文件 @ fe6c9f2d
...@@ -50,7 +50,7 @@ import sun.security.jca.GetInstance.Instance; ...@@ -50,7 +50,7 @@ import sun.security.jca.GetInstance.Instance;
* <i>RFC 1750: Randomness Recommendations for Security</i></a>. * <i>RFC 1750: Randomness Recommendations for Security</i></a>.
* *
* <p>A caller obtains a SecureRandom instance via the * <p>A caller obtains a SecureRandom instance via the
* no-argument constructor or one of the <code>getInstance</code> methods: * no-argument constructor or one of the {@code getInstance} methods:
* *
* <pre> * <pre>
* SecureRandom random = new SecureRandom(); * SecureRandom random = new SecureRandom();
...@@ -71,15 +71,15 @@ import sun.security.jca.GetInstance.Instance; ...@@ -71,15 +71,15 @@ import sun.security.jca.GetInstance.Instance;
* random.nextBytes(bytes); * random.nextBytes(bytes);
* </pre> * </pre>
* *
* <p> Callers may also invoke the <code>generateSeed</code> method * <p> Callers may also invoke the {@code generateSeed} method
* to generate a given number of seed bytes (to seed other random number * to generate a given number of seed bytes (to seed other random number
* generators, for example): * generators, for example):
* <pre> * <pre>
* byte seed[] = random.generateSeed(20); * byte seed[] = random.generateSeed(20);
* </pre> * </pre>
* *
* Note: Depending on the implementation, the <code>generateSeed</code> and * Note: Depending on the implementation, the {@code generateSeed} and
* <code>nextBytes</code> methods may block as entropy is being gathered, * {@code nextBytes} methods may block as entropy is being gathered,
* for example, if they need to read from /dev/random on various Unix-like * for example, if they need to read from /dev/random on various Unix-like
* operating systems. * operating systems.
* *
...@@ -140,16 +140,16 @@ public class SecureRandom extends java.util.Random { ...@@ -140,16 +140,16 @@ public class SecureRandom extends java.util.Random {
* for information about standard RNG algorithm names. * for information about standard RNG algorithm names.
* *
* <p> The returned SecureRandom object has not been seeded. To seed the * <p> The returned SecureRandom object has not been seeded. To seed the
* returned object, call the <code>setSeed</code> method. * returned object, call the {@code setSeed} method.
* If <code>setSeed</code> is not called, the first call to * If {@code setSeed} is not called, the first call to
* <code>nextBytes</code> will force the SecureRandom object to seed itself. * {@code nextBytes} will force the SecureRandom object to seed itself.
* This self-seeding will not occur if <code>setSeed</code> was * This self-seeding will not occur if {@code setSeed} was
* previously called. * previously called.
*/ */
public SecureRandom() { public SecureRandom() {
/* /*
* This call to our superclass constructor will result in a call * This call to our superclass constructor will result in a call
* to our own <code>setSeed</code> method, which will return * to our own {@code setSeed} method, which will return
* immediately when it is passed zero. * immediately when it is passed zero.
*/ */
super(0); super(0);
...@@ -250,10 +250,10 @@ public class SecureRandom extends java.util.Random { ...@@ -250,10 +250,10 @@ public class SecureRandom extends java.util.Random {
* the {@link Security#getProviders() Security.getProviders()} method. * the {@link Security#getProviders() Security.getProviders()} method.
* *
* <p> The returned SecureRandom object has not been seeded. To seed the * <p> The returned SecureRandom object has not been seeded. To seed the
* returned object, call the <code>setSeed</code> method. * returned object, call the {@code setSeed} method.
* If <code>setSeed</code> is not called, the first call to * If {@code setSeed} is not called, the first call to
* <code>nextBytes</code> will force the SecureRandom object to seed itself. * {@code nextBytes} will force the SecureRandom object to seed itself.
* This self-seeding will not occur if <code>setSeed</code> was * This self-seeding will not occur if {@code setSeed} was
* previously called. * previously called.
* *
* @param algorithm the name of the RNG algorithm. * @param algorithm the name of the RNG algorithm.
...@@ -293,10 +293,10 @@ public class SecureRandom extends java.util.Random { ...@@ -293,10 +293,10 @@ public class SecureRandom extends java.util.Random {
* the {@link Security#getProviders() Security.getProviders()} method. * the {@link Security#getProviders() Security.getProviders()} method.
* *
* <p> The returned SecureRandom object has not been seeded. To seed the * <p> The returned SecureRandom object has not been seeded. To seed the
* returned object, call the <code>setSeed</code> method. * returned object, call the {@code setSeed} method.
* If <code>setSeed</code> is not called, the first call to * If {@code setSeed} is not called, the first call to
* <code>nextBytes</code> will force the SecureRandom object to seed itself. * {@code nextBytes} will force the SecureRandom object to seed itself.
* This self-seeding will not occur if <code>setSeed</code> was * This self-seeding will not occur if {@code setSeed} was
* previously called. * previously called.
* *
* @param algorithm the name of the RNG algorithm. * @param algorithm the name of the RNG algorithm.
...@@ -341,10 +341,10 @@ public class SecureRandom extends java.util.Random { ...@@ -341,10 +341,10 @@ public class SecureRandom extends java.util.Random {
* does not have to be registered in the provider list. * does not have to be registered in the provider list.
* *
* <p> The returned SecureRandom object has not been seeded. To seed the * <p> The returned SecureRandom object has not been seeded. To seed the
* returned object, call the <code>setSeed</code> method. * returned object, call the {@code setSeed} method.
* If <code>setSeed</code> is not called, the first call to * If {@code setSeed} is not called, the first call to
* <code>nextBytes</code> will force the SecureRandom object to seed itself. * {@code nextBytes} will force the SecureRandom object to seed itself.
* This self-seeding will not occur if <code>setSeed</code> was * This self-seeding will not occur if {@code setSeed} was
* previously called. * previously called.
* *
* @param algorithm the name of the RNG algorithm. * @param algorithm the name of the RNG algorithm.
...@@ -395,7 +395,7 @@ public class SecureRandom extends java.util.Random { ...@@ -395,7 +395,7 @@ public class SecureRandom extends java.util.Random {
* Returns the name of the algorithm implemented by this SecureRandom * Returns the name of the algorithm implemented by this SecureRandom
* object. * object.
* *
* @return the name of the algorithm or <code>unknown</code> * @return the name of the algorithm or {@code unknown}
* if the algorithm name cannot be determined. * if the algorithm name cannot be determined.
* @since 1.5 * @since 1.5
*/ */
...@@ -418,12 +418,12 @@ public class SecureRandom extends java.util.Random { ...@@ -418,12 +418,12 @@ public class SecureRandom extends java.util.Random {
/** /**
* Reseeds this random object, using the eight bytes contained * Reseeds this random object, using the eight bytes contained
* in the given <code>long seed</code>. The given seed supplements, * in the given {@code long seed}. The given seed supplements,
* rather than replaces, the existing seed. Thus, repeated calls * rather than replaces, the existing seed. Thus, repeated calls
* are guaranteed never to reduce randomness. * are guaranteed never to reduce randomness.
* *
* <p>This method is defined for compatibility with * <p>This method is defined for compatibility with
* <code>java.util.Random</code>. * {@code java.util.Random}.
* *
* @param seed the seed. * @param seed the seed.
* *
...@@ -445,10 +445,10 @@ public class SecureRandom extends java.util.Random { ...@@ -445,10 +445,10 @@ public class SecureRandom extends java.util.Random {
/** /**
* Generates a user-specified number of random bytes. * Generates a user-specified number of random bytes.
* *
* <p> If a call to <code>setSeed</code> had not occurred previously, * <p> If a call to {@code setSeed} had not occurred previously,
* the first call to this method forces this SecureRandom object * the first call to this method forces this SecureRandom object
* to seed itself. This self-seeding will not occur if * to seed itself. This self-seeding will not occur if
* <code>setSeed</code> was previously called. * {@code setSeed} was previously called.
* *
* @param bytes the array to be filled in with random bytes. * @param bytes the array to be filled in with random bytes.
*/ */
...@@ -460,15 +460,15 @@ public class SecureRandom extends java.util.Random { ...@@ -460,15 +460,15 @@ public class SecureRandom extends java.util.Random {
/** /**
* Generates an integer containing the user-specified number of * Generates an integer containing the user-specified number of
* pseudo-random bits (right justified, with leading zeros). This * pseudo-random bits (right justified, with leading zeros). This
* method overrides a <code>java.util.Random</code> method, and serves * method overrides a {@code java.util.Random} method, and serves
* to provide a source of random bits to all of the methods inherited * to provide a source of random bits to all of the methods inherited
* from that class (for example, <code>nextInt</code>, * from that class (for example, {@code nextInt},
* <code>nextLong</code>, and <code>nextFloat</code>). * {@code nextLong}, and {@code nextFloat}).
* *
* @param numBits number of pseudo-random bits to be generated, where * @param numBits number of pseudo-random bits to be generated, where
* {@code 0 <= numBits <= 32}. * {@code 0 <= numBits <= 32}.
* *
* @return an <code>int</code> containing the user-specified number * @return an {@code int} containing the user-specified number
* of pseudo-random bits (right justified, with leading zeros). * of pseudo-random bits (right justified, with leading zeros).
*/ */
@Override @Override
...@@ -492,8 +492,8 @@ public class SecureRandom extends java.util.Random { ...@@ -492,8 +492,8 @@ public class SecureRandom extends java.util.Random {
* *
* <p>This method is only included for backwards compatibility. * <p>This method is only included for backwards compatibility.
* The caller is encouraged to use one of the alternative * The caller is encouraged to use one of the alternative
* <code>getInstance</code> methods to obtain a SecureRandom object, and * {@code getInstance} methods to obtain a SecureRandom object, and
* then call the <code>generateSeed</code> method to obtain seed bytes * then call the {@code generateSeed} method to obtain seed bytes
* from that object. * from that object.
* *
* @param numBytes the number of seed bytes to generate. * @param numBytes the number of seed bytes to generate.
......
src/share/classes/java/security/SecureRandomSpi.java
浏览文件 @ fe6c9f2d
/* /*
* Copyright (c) 1998, 2005, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1998, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
...@@ -27,7 +27,7 @@ package java.security; ...@@ -27,7 +27,7 @@ package java.security;
/** /**
* This class defines the <i>Service Provider Interface</i> (<b>SPI</b>) * This class defines the <i>Service Provider Interface</i> (<b>SPI</b>)
* for the <code>SecureRandom</code> class. * for the {@code SecureRandom} class.
* All the abstract methods in this class must be implemented by each * All the abstract methods in this class must be implemented by each
* service provider who wishes to supply the implementation * service provider who wishes to supply the implementation
* of a cryptographically strong pseudo-random number generator. * of a cryptographically strong pseudo-random number generator.
...@@ -53,10 +53,10 @@ public abstract class SecureRandomSpi implements java.io.Serializable { ...@@ -53,10 +53,10 @@ public abstract class SecureRandomSpi implements java.io.Serializable {
/** /**
* Generates a user-specified number of random bytes. * Generates a user-specified number of random bytes.
* *
* <p> If a call to <code>engineSetSeed</code> had not occurred previously, * <p> If a call to {@code engineSetSeed} had not occurred previously,
* the first call to this method forces this SecureRandom implementation * the first call to this method forces this SecureRandom implementation
* to seed itself. This self-seeding will not occur if * to seed itself. This self-seeding will not occur if
* <code>engineSetSeed</code> was previously called. * {@code engineSetSeed} was previously called.
* *
* @param bytes the array to be filled in with random bytes. * @param bytes the array to be filled in with random bytes.
*/ */
......
src/share/classes/java/security/Security.java
浏览文件 @ fe6c9f2d
/* /*
* Copyright (c) 1996, 2012, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1996, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
...@@ -298,7 +298,7 @@ public final class Security { ...@@ -298,7 +298,7 @@ public final class Security {
* property in the master file of the "SUN" Cryptographic Service * property in the master file of the "SUN" Cryptographic Service
* Provider in order to determine how to parse algorithm-specific * Provider in order to determine how to parse algorithm-specific
* parameters. Use the new provider-based and algorithm-independent * parameters. Use the new provider-based and algorithm-independent
* <code>AlgorithmParameters</code> and <code>KeyFactory</code> engine * {@code AlgorithmParameters} and {@code KeyFactory} engine
* classes (introduced in the J2SE version 1.2 platform) instead. * classes (introduced in the J2SE version 1.2 platform) instead.
*/ */
@Deprecated @Deprecated
...@@ -321,21 +321,21 @@ public final class Security { ...@@ -321,21 +321,21 @@ public final class Security {
* *
* <p>If the given provider is installed at the requested position, * <p>If the given provider is installed at the requested position,
* the provider that used to be at that position, and all providers * the provider that used to be at that position, and all providers
* with a position greater than <code>position</code>, are shifted up * with a position greater than {@code position}, are shifted up
* one position (towards the end of the list of installed providers). * one position (towards the end of the list of installed providers).
* *
* <p>A provider cannot be added if it is already installed. * <p>A provider cannot be added if it is already installed.
* *
* <p>First, if there is a security manager, its * <p>First, if there is a security manager, its
* <code>checkSecurityAccess</code> * {@code checkSecurityAccess}
* method is called with the string * method is called with the string
* <code>"insertProvider."+provider.getName()</code> * {@code "insertProvider."+provider.getName()}
* to see if it's ok to add a new provider. * to see if it's ok to add a new provider.
* If the default implementation of <code>checkSecurityAccess</code> * If the default implementation of {@code checkSecurityAccess}
* is used (i.e., that method is not overriden), then this will result in * is used (i.e., that method is not overriden), then this will result in
* a call to the security manager's <code>checkPermission</code> method * a call to the security manager's {@code checkPermission} method
* with a * with a
* <code>SecurityPermission("insertProvider."+provider.getName())</code> * {@code SecurityPermission("insertProvider."+provider.getName())}
* permission. * permission.
* *
* @param provider the provider to be added. * @param provider the provider to be added.
...@@ -349,8 +349,8 @@ public final class Security { ...@@ -349,8 +349,8 @@ public final class Security {
* *
* @throws NullPointerException if provider is null * @throws NullPointerException if provider is null
* @throws SecurityException * @throws SecurityException
* if a security manager exists and its <code>{@link * if a security manager exists and its {@link
* java.lang.SecurityManager#checkSecurityAccess}</code> method * java.lang.SecurityManager#checkSecurityAccess} method
* denies access to add a new provider * denies access to add a new provider
* *
* @see #getProvider * @see #getProvider
...@@ -374,15 +374,15 @@ public final class Security { ...@@ -374,15 +374,15 @@ public final class Security {
* Adds a provider to the next position available. * Adds a provider to the next position available.
* *
* <p>First, if there is a security manager, its * <p>First, if there is a security manager, its
* <code>checkSecurityAccess</code> * {@code checkSecurityAccess}
* method is called with the string * method is called with the string
* <code>"insertProvider."+provider.getName()</code> * {@code "insertProvider."+provider.getName()}
* to see if it's ok to add a new provider. * to see if it's ok to add a new provider.
* If the default implementation of <code>checkSecurityAccess</code> * If the default implementation of {@code checkSecurityAccess}
* is used (i.e., that method is not overriden), then this will result in * is used (i.e., that method is not overriden), then this will result in
* a call to the security manager's <code>checkPermission</code> method * a call to the security manager's {@code checkPermission} method
* with a * with a
* <code>SecurityPermission("insertProvider."+provider.getName())</code> * {@code SecurityPermission("insertProvider."+provider.getName())}
* permission. * permission.
* *
* @param provider the provider to be added. * @param provider the provider to be added.
...@@ -393,8 +393,8 @@ public final class Security { ...@@ -393,8 +393,8 @@ public final class Security {
* *
* @throws NullPointerException if provider is null * @throws NullPointerException if provider is null
* @throws SecurityException * @throws SecurityException
* if a security manager exists and its <code>{@link * if a security manager exists and its {@link
* java.lang.SecurityManager#checkSecurityAccess}</code> method * java.lang.SecurityManager#checkSecurityAccess} method
* denies access to add a new provider * denies access to add a new provider
* *
* @see #getProvider * @see #getProvider
...@@ -423,20 +423,20 @@ public final class Security { ...@@ -423,20 +423,20 @@ public final class Security {
* if name is null. * if name is null.
* *
* <p>First, if there is a security manager, its * <p>First, if there is a security manager, its
* <code>checkSecurityAccess</code> * {@code checkSecurityAccess}
* method is called with the string <code>"removeProvider."+name</code> * method is called with the string {@code "removeProvider."+name}
* to see if it's ok to remove the provider. * to see if it's ok to remove the provider.
* If the default implementation of <code>checkSecurityAccess</code> * If the default implementation of {@code checkSecurityAccess}
* is used (i.e., that method is not overriden), then this will result in * is used (i.e., that method is not overriden), then this will result in
* a call to the security manager's <code>checkPermission</code> method * a call to the security manager's {@code checkPermission} method
* with a <code>SecurityPermission("removeProvider."+name)</code> * with a {@code SecurityPermission("removeProvider."+name)}
* permission. * permission.
* *
* @param name the name of the provider to remove. * @param name the name of the provider to remove.
* *
* @throws SecurityException * @throws SecurityException
* if a security manager exists and its <code>{@link * if a security manager exists and its {@link
* java.lang.SecurityManager#checkSecurityAccess}</code> method * java.lang.SecurityManager#checkSecurityAccess} method
* denies * denies
* access to remove the provider * access to remove the provider
* *
...@@ -689,7 +689,7 @@ public final class Security { ...@@ -689,7 +689,7 @@ public final class Security {
* an instance of an implementation of the requested algorithm * an instance of an implementation of the requested algorithm
* and type, and the second object in the array identifies the provider * and type, and the second object in the array identifies the provider
* of that implementation. * of that implementation.
* The <code>provider</code> argument can be null, in which case all * The {@code provider} argument can be null, in which case all
* configured providers will be searched in order of preference. * configured providers will be searched in order of preference.
*/ */
static Object[] getImpl(String algorithm, String type, String provider) static Object[] getImpl(String algorithm, String type, String provider)
...@@ -720,7 +720,7 @@ public final class Security { ...@@ -720,7 +720,7 @@ public final class Security {
* an instance of an implementation of the requested algorithm * an instance of an implementation of the requested algorithm
* and type, and the second object in the array identifies the provider * and type, and the second object in the array identifies the provider
* of that implementation. * of that implementation.
* The <code>provider</code> argument cannot be null. * The {@code provider} argument cannot be null.
*/ */
static Object[] getImpl(String algorithm, String type, Provider provider) static Object[] getImpl(String algorithm, String type, Provider provider)
throws NoSuchAlgorithmException { throws NoSuchAlgorithmException {
...@@ -739,8 +739,8 @@ public final class Security { ...@@ -739,8 +739,8 @@ public final class Security {
* Gets a security property value. * Gets a security property value.
* *
* <p>First, if there is a security manager, its * <p>First, if there is a security manager, its
* <code>checkPermission</code> method is called with a * {@code checkPermission} method is called with a
* <code>java.security.SecurityPermission("getProperty."+key)</code> * {@code java.security.SecurityPermission("getProperty."+key)}
* permission to see if it's ok to retrieve the specified * permission to see if it's ok to retrieve the specified
* security property value.. * security property value..
* *
...@@ -749,8 +749,8 @@ public final class Security { ...@@ -749,8 +749,8 @@ public final class Security {
* @return the value of the security property corresponding to key. * @return the value of the security property corresponding to key.
* *
* @throws SecurityException * @throws SecurityException
* if a security manager exists and its <code>{@link * if a security manager exists and its {@link
* java.lang.SecurityManager#checkPermission}</code> method * java.lang.SecurityManager#checkPermission} method
* denies * denies
* access to retrieve the specified security property value * access to retrieve the specified security property value
* @throws NullPointerException is key is null * @throws NullPointerException is key is null
...@@ -774,8 +774,8 @@ public final class Security { ...@@ -774,8 +774,8 @@ public final class Security {
* Sets a security property value. * Sets a security property value.
* *
* <p>First, if there is a security manager, its * <p>First, if there is a security manager, its
* <code>checkPermission</code> method is called with a * {@code checkPermission} method is called with a
* <code>java.security.SecurityPermission("setProperty."+key)</code> * {@code java.security.SecurityPermission("setProperty."+key)}
* permission to see if it's ok to set the specified * permission to see if it's ok to set the specified
* security property value. * security property value.
* *
...@@ -784,8 +784,8 @@ public final class Security { ...@@ -784,8 +784,8 @@ public final class Security {
* @param datum the value of the property to be set. * @param datum the value of the property to be set.
* *
* @throws SecurityException * @throws SecurityException
* if a security manager exists and its <code>{@link * if a security manager exists and its {@link
* java.lang.SecurityManager#checkPermission}</code> method * java.lang.SecurityManager#checkPermission} method
* denies access to set the specified security property value * denies access to set the specified security property value
* @throws NullPointerException if key or datum is null * @throws NullPointerException if key or datum is null
* *
......
src/share/classes/java/security/SecurityPermission.java
浏览文件 @ fe6c9f2d
/* /*
* Copyright (c) 1997, 2006, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
...@@ -57,7 +57,7 @@ import java.util.StringTokenizer; ...@@ -57,7 +57,7 @@ import java.util.StringTokenizer;
* <td>createAccessControlContext</td> * <td>createAccessControlContext</td>
* <td>Creation of an AccessControlContext</td> * <td>Creation of an AccessControlContext</td>
* <td>This allows someone to instantiate an AccessControlContext * <td>This allows someone to instantiate an AccessControlContext
* with a <code>DomainCombiner</code>. Extreme care must be taken when * with a {@code DomainCombiner}. Extreme care must be taken when
* granting this permission. Malicious code could create a DomainCombiner * granting this permission. Malicious code could create a DomainCombiner
* that augments the set of permissions granted to code, and even grant the * that augments the set of permissions granted to code, and even grant the
* code {@link java.security.AllPermission}.</td> * code {@link java.security.AllPermission}.</td>
...@@ -67,7 +67,7 @@ import java.util.StringTokenizer; ...@@ -67,7 +67,7 @@ import java.util.StringTokenizer;
* <td>getDomainCombiner</td> * <td>getDomainCombiner</td>
* <td>Retrieval of an AccessControlContext's DomainCombiner</td> * <td>Retrieval of an AccessControlContext's DomainCombiner</td>
* <td>This allows someone to retrieve an AccessControlContext's * <td>This allows someone to retrieve an AccessControlContext's
* <code>DomainCombiner</code>. Since DomainCombiners may contain * {@code DomainCombiner}. Since DomainCombiners may contain
* sensitive information, this could potentially lead to a privacy leak.</td> * sensitive information, this could potentially lead to a privacy leak.</td>
* </tr> * </tr>
* *
...@@ -76,7 +76,7 @@ import java.util.StringTokenizer; ...@@ -76,7 +76,7 @@ import java.util.StringTokenizer;
* <td>Retrieval of the system-wide security policy (specifically, of the * <td>Retrieval of the system-wide security policy (specifically, of the
* currently-installed Policy object)</td> * currently-installed Policy object)</td>
* <td>This allows someone to query the policy via the * <td>This allows someone to query the policy via the
* <code>getPermissions</code> call, * {@code getPermissions} call,
* which discloses which permissions would be granted to a given CodeSource. * which discloses which permissions would be granted to a given CodeSource.
* While revealing the policy does not compromise the security of * While revealing the policy does not compromise the security of
* the system, it does provide malicious code with additional information * the system, it does provide malicious code with additional information
...@@ -303,8 +303,8 @@ public final class SecurityPermission extends BasicPermission { ...@@ -303,8 +303,8 @@ public final class SecurityPermission extends BasicPermission {
* *
* @param name the name of the SecurityPermission * @param name the name of the SecurityPermission
* *
* @throws NullPointerException if <code>name</code> is <code>null</code>. * @throws NullPointerException if {@code name} is {@code null}.
* @throws IllegalArgumentException if <code>name</code> is empty. * @throws IllegalArgumentException if {@code name} is empty.
*/ */
public SecurityPermission(String name) public SecurityPermission(String name)
...@@ -320,8 +320,8 @@ public final class SecurityPermission extends BasicPermission { ...@@ -320,8 +320,8 @@ public final class SecurityPermission extends BasicPermission {
* @param name the name of the SecurityPermission * @param name the name of the SecurityPermission
* @param actions should be null. * @param actions should be null.
* *
* @throws NullPointerException if <code>name</code> is <code>null</code>. * @throws NullPointerException if {@code name} is {@code null}.
* @throws IllegalArgumentException if <code>name</code> is empty. * @throws IllegalArgumentException if {@code name} is empty.
*/ */
public SecurityPermission(String name, String actions) public SecurityPermission(String name, String actions)
......
src/share/classes/java/security/Signature.java
浏览文件 @ fe6c9f2d
...@@ -53,10 +53,10 @@ import sun.security.jca.GetInstance.Instance; ...@@ -53,10 +53,10 @@ import sun.security.jca.GetInstance.Instance;
* *
* <p> The signature algorithm can be, among others, the NIST standard * <p> The signature algorithm can be, among others, the NIST standard
* DSA, using DSA and SHA-1. The DSA algorithm using the * DSA, using DSA and SHA-1. The DSA algorithm using the
* SHA-1 message digest algorithm can be specified as <tt>SHA1withDSA</tt>. * SHA-1 message digest algorithm can be specified as {@code SHA1withDSA}.
* In the case of RSA, there are multiple choices for the message digest * In the case of RSA, there are multiple choices for the message digest
* algorithm, so the signing algorithm could be specified as, for example, * algorithm, so the signing algorithm could be specified as, for example,
* <tt>MD2withRSA</tt>, <tt>MD5withRSA</tt>, or <tt>SHA1withRSA</tt>. * {@code MD2withRSA}, {@code MD5withRSA}, or {@code SHA1withRSA}.
* The algorithm name must be specified, as there is no default. * The algorithm name must be specified, as there is no default.
* *
* <p> A Signature object can be used to generate and verify digital * <p> A Signature object can be used to generate and verify digital
...@@ -92,18 +92,18 @@ import sun.security.jca.GetInstance.Instance; ...@@ -92,18 +92,18 @@ import sun.security.jca.GetInstance.Instance;
* </ol> * </ol>
* *
* <p>Note that this class is abstract and extends from * <p>Note that this class is abstract and extends from
* <code>SignatureSpi</code> for historical reasons. * {@code SignatureSpi} for historical reasons.
* Application developers should only take notice of the methods defined in * Application developers should only take notice of the methods defined in
* this <code>Signature</code> class; all the methods in * this {@code Signature} class; all the methods in
* the superclass are intended for cryptographic service providers who wish to * the superclass are intended for cryptographic service providers who wish to
* supply their own implementations of digital signature algorithms. * supply their own implementations of digital signature algorithms.
* *
* <p> Every implementation of the Java platform is required to support the * <p> Every implementation of the Java platform is required to support the
* following standard <code>Signature</code> algorithms: * following standard {@code Signature} algorithms:
* <ul> * <ul>
* <li><tt>SHA1withDSA</tt></li> * <li>{@code SHA1withDSA}</li>
* <li><tt>SHA1withRSA</tt></li> * <li>{@code SHA1withRSA}</li>
* <li><tt>SHA256withRSA</tt></li> * <li>{@code SHA256withRSA}</li>
* </ul> * </ul>
* These algorithms are described in the <a href= * These algorithms are described in the <a href=
* "{@docRoot}/../technotes/guides/security/StandardNames.html#Signature"> * "{@docRoot}/../technotes/guides/security/StandardNames.html#Signature">
...@@ -461,7 +461,7 @@ public abstract class Signature extends SignatureSpi { ...@@ -461,7 +461,7 @@ public abstract class Signature extends SignatureSpi {
* extension field implies that the public key in * extension field implies that the public key in
* the certificate and its corresponding private key are not * the certificate and its corresponding private key are not
* supposed to be used for digital signatures, an * supposed to be used for digital signatures, an
* <code>InvalidKeyException</code> is thrown. * {@code InvalidKeyException} is thrown.
* *
* @param certificate the certificate of the identity whose signature is * @param certificate the certificate of the identity whose signature is
* going to be verified. * going to be verified.
...@@ -538,10 +538,10 @@ public abstract class Signature extends SignatureSpi { ...@@ -538,10 +538,10 @@ public abstract class Signature extends SignatureSpi {
* *
* <p>A call to this method resets this signature object to the state * <p>A call to this method resets this signature object to the state
* it was in when previously initialized for signing via a * it was in when previously initialized for signing via a
* call to <code>initSign(PrivateKey)</code>. That is, the object is * call to {@code initSign(PrivateKey)}. That is, the object is
* reset and available to generate another signature from the same * reset and available to generate another signature from the same
* signer, if desired, via new calls to <code>update</code> and * signer, if desired, via new calls to {@code update} and
* <code>sign</code>. * {@code sign}.
* *
* @return the signature bytes of the signing operation's result. * @return the signature bytes of the signing operation's result.
* *
...@@ -559,28 +559,28 @@ public abstract class Signature extends SignatureSpi { ...@@ -559,28 +559,28 @@ public abstract class Signature extends SignatureSpi {
/** /**
* Finishes the signature operation and stores the resulting signature * Finishes the signature operation and stores the resulting signature
* bytes in the provided buffer <code>outbuf</code>, starting at * bytes in the provided buffer {@code outbuf}, starting at
* <code>offset</code>. * {@code offset}.
* The format of the signature depends on the underlying * The format of the signature depends on the underlying
* signature scheme. * signature scheme.
* *
* <p>This signature object is reset to its initial state (the state it * <p>This signature object is reset to its initial state (the state it
* was in after a call to one of the <code>initSign</code> methods) and * was in after a call to one of the {@code initSign} methods) and
* can be reused to generate further signatures with the same private key. * can be reused to generate further signatures with the same private key.
* *
* @param outbuf buffer for the signature result. * @param outbuf buffer for the signature result.
* *
* @param offset offset into <code>outbuf</code> where the signature is * @param offset offset into {@code outbuf} where the signature is
* stored. * stored.
* *
* @param len number of bytes within <code>outbuf</code> allotted for the * @param len number of bytes within {@code outbuf} allotted for the
* signature. * signature.
* *
* @return the number of bytes placed into <code>outbuf</code>. * @return the number of bytes placed into {@code outbuf}.
* *
* @exception SignatureException if this signature object is not * @exception SignatureException if this signature object is not
* initialized properly, if this signature algorithm is unable to * initialized properly, if this signature algorithm is unable to
* process the input data provided, or if <code>len</code> is less * process the input data provided, or if {@code len} is less
* than the actual signature length. * than the actual signature length.
* *
* @since 1.2 * @since 1.2
...@@ -606,9 +606,9 @@ public abstract class Signature extends SignatureSpi { ...@@ -606,9 +606,9 @@ public abstract class Signature extends SignatureSpi {
* *
* <p>A call to this method resets this signature object to the state * <p>A call to this method resets this signature object to the state
* it was in when previously initialized for verification via a * it was in when previously initialized for verification via a
* call to <code>initVerify(PublicKey)</code>. That is, the object is * call to {@code initVerify(PublicKey)}. That is, the object is
* reset and available to verify another signature from the identity * reset and available to verify another signature from the identity
* whose public key was specified in the call to <code>initVerify</code>. * whose public key was specified in the call to {@code initVerify}.
* *
* @param signature the signature bytes to be verified. * @param signature the signature bytes to be verified.
* *
...@@ -633,9 +633,9 @@ public abstract class Signature extends SignatureSpi { ...@@ -633,9 +633,9 @@ public abstract class Signature extends SignatureSpi {
* *
* <p>A call to this method resets this signature object to the state * <p>A call to this method resets this signature object to the state
* it was in when previously initialized for verification via a * it was in when previously initialized for verification via a
* call to <code>initVerify(PublicKey)</code>. That is, the object is * call to {@code initVerify(PublicKey)}. That is, the object is
* reset and available to verify another signature from the identity * reset and available to verify another signature from the identity
* whose public key was specified in the call to <code>initVerify</code>. * whose public key was specified in the call to {@code initVerify}.
* *
* *
* @param signature the signature bytes to be verified. * @param signature the signature bytes to be verified.
...@@ -648,11 +648,11 @@ public abstract class Signature extends SignatureSpi { ...@@ -648,11 +648,11 @@ public abstract class Signature extends SignatureSpi {
* initialized properly, the passed-in signature is improperly * initialized properly, the passed-in signature is improperly
* encoded or of the wrong type, if this signature algorithm is unable to * encoded or of the wrong type, if this signature algorithm is unable to
* process the input data provided, etc. * process the input data provided, etc.
* @exception IllegalArgumentException if the <code>signature</code> * @exception IllegalArgumentException if the {@code signature}
* byte array is null, or the <code>offset</code> or <code>length</code> * byte array is null, or the {@code offset} or {@code length}
* is less than 0, or the sum of the <code>offset</code> and * is less than 0, or the sum of the {@code offset} and
* <code>length</code> is greater than the length of the * {@code length} is greater than the length of the
* <code>signature</code> byte array. * {@code signature} byte array.
* @since 1.4 * @since 1.4
*/ */
public final boolean verify(byte[] signature, int offset, int length) public final boolean verify(byte[] signature, int offset, int length)
...@@ -722,8 +722,8 @@ public abstract class Signature extends SignatureSpi { ...@@ -722,8 +722,8 @@ public abstract class Signature extends SignatureSpi {
/** /**
* Updates the data to be signed or verified using the specified * Updates the data to be signed or verified using the specified
* ByteBuffer. Processes the <code>data.remaining()</code> bytes * ByteBuffer. Processes the {@code data.remaining()} bytes
* starting at at <code>data.position()</code>. * starting at at {@code data.position()}.
* Upon return, the buffer's position will be equal to its limit; * Upon return, the buffer's position will be equal to its limit;
* its limit will not have changed. * its limit will not have changed.
* *
...@@ -790,7 +790,7 @@ public abstract class Signature extends SignatureSpi { ...@@ -790,7 +790,7 @@ public abstract class Signature extends SignatureSpi {
* @param param the string identifier of the parameter. * @param param the string identifier of the parameter.
* @param value the parameter value. * @param value the parameter value.
* *
* @exception InvalidParameterException if <code>param</code> is an * @exception InvalidParameterException if {@code param} is an
* invalid parameter for this signature algorithm engine, * invalid parameter for this signature algorithm engine,
* the parameter is already set * the parameter is already set
* and cannot be set again, a security exception occurs, and so on. * and cannot be set again, a security exception occurs, and so on.
...@@ -856,7 +856,7 @@ public abstract class Signature extends SignatureSpi { ...@@ -856,7 +856,7 @@ public abstract class Signature extends SignatureSpi {
* @return the object that represents the parameter value, or null if * @return the object that represents the parameter value, or null if
* there is none. * there is none.
* *
* @exception InvalidParameterException if <code>param</code> is an invalid * @exception InvalidParameterException if {@code param} is an invalid
* parameter for this engine, or another exception occurs while * parameter for this engine, or another exception occurs while
* trying to get this parameter. * trying to get this parameter.
* *
...@@ -876,7 +876,7 @@ public abstract class Signature extends SignatureSpi { ...@@ -876,7 +876,7 @@ public abstract class Signature extends SignatureSpi {
* @return a clone if the implementation is cloneable. * @return a clone if the implementation is cloneable.
* *
* @exception CloneNotSupportedException if this is called * @exception CloneNotSupportedException if this is called
* on an implementation that does not support <code>Cloneable</code>. * on an implementation that does not support {@code Cloneable}.
*/ */
public Object clone() throws CloneNotSupportedException { public Object clone() throws CloneNotSupportedException {
if (this instanceof Cloneable) { if (this instanceof Cloneable) {
...@@ -940,7 +940,7 @@ public abstract class Signature extends SignatureSpi { ...@@ -940,7 +940,7 @@ public abstract class Signature extends SignatureSpi {
* @return a clone if the delegate is cloneable. * @return a clone if the delegate is cloneable.
* *
* @exception CloneNotSupportedException if this is called on a * @exception CloneNotSupportedException if this is called on a
* delegate that does not support <code>Cloneable</code>. * delegate that does not support {@code Cloneable}.
*/ */
public Object clone() throws CloneNotSupportedException { public Object clone() throws CloneNotSupportedException {
chooseFirstProvider(); chooseFirstProvider();
......
src/share/classes/java/security/SignatureException.java
浏览文件 @ fe6c9f2d
/* /*
* Copyright (c) 1996, 2003, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1996, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
...@@ -56,13 +56,13 @@ public class SignatureException extends GeneralSecurityException { ...@@ -56,13 +56,13 @@ public class SignatureException extends GeneralSecurityException {
} }
/** /**
* Creates a <code>SignatureException</code> with the specified * Creates a {@code SignatureException} with the specified
* detail message and cause. * detail message and cause.
* *
* @param message the detail message (which is saved for later retrieval * @param message the detail message (which is saved for later retrieval
* by the {@link #getMessage()} method). * by the {@link #getMessage()} method).
* @param cause the cause (which is saved for later retrieval by the * @param cause the cause (which is saved for later retrieval by the
* {@link #getCause()} method). (A <tt>null</tt> value is permitted, * {@link #getCause()} method). (A {@code null} value is permitted,
* and indicates that the cause is nonexistent or unknown.) * and indicates that the cause is nonexistent or unknown.)
* @since 1.5 * @since 1.5
*/ */
...@@ -71,13 +71,13 @@ public class SignatureException extends GeneralSecurityException { ...@@ -71,13 +71,13 @@ public class SignatureException extends GeneralSecurityException {
} }
/** /**
* Creates a <code>SignatureException</code> with the specified cause * Creates a {@code SignatureException} with the specified cause
* and a detail message of <tt>(cause==null ? null : cause.toString())</tt> * and a detail message of {@code (cause==null ? null : cause.toString())}
* (which typically contains the class and detail message of * (which typically contains the class and detail message of
* <tt>cause</tt>). * {@code cause}).
* *
* @param cause the cause (which is saved for later retrieval by the * @param cause the cause (which is saved for later retrieval by the
* {@link #getCause()} method). (A <tt>null</tt> value is permitted, * {@link #getCause()} method). (A {@code null} value is permitted,
* and indicates that the cause is nonexistent or unknown.) * and indicates that the cause is nonexistent or unknown.)
* @since 1.5 * @since 1.5
*/ */
......
src/share/classes/java/security/SignatureSpi.java
浏览文件 @ fe6c9f2d
/* /*
* Copyright (c) 1997, 2006, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
...@@ -35,7 +35,7 @@ import sun.security.jca.JCAUtil; ...@@ -35,7 +35,7 @@ import sun.security.jca.JCAUtil;
/** /**
* This class defines the <i>Service Provider Interface</i> (<b>SPI</b>) * This class defines the <i>Service Provider Interface</i> (<b>SPI</b>)
* for the <code>Signature</code> class, which is used to provide the * for the {@code Signature} class, which is used to provide the
* functionality of a digital signature algorithm. Digital signatures are used * functionality of a digital signature algorithm. Digital signatures are used
* for authentication and integrity assurance of digital data. * for authentication and integrity assurance of digital data.
*. *.
...@@ -130,8 +130,8 @@ public abstract class SignatureSpi { ...@@ -130,8 +130,8 @@ public abstract class SignatureSpi {
/** /**
* Updates the data to be signed or verified using the specified * Updates the data to be signed or verified using the specified
* ByteBuffer. Processes the <code>data.remaining()</code> bytes * ByteBuffer. Processes the {@code data.remaining()} bytes
* starting at at <code>data.position()</code>. * starting at at {@code data.position()}.
* Upon return, the buffer's position will be equal to its limit; * Upon return, the buffer's position will be equal to its limit;
* its limit will not have changed. * its limit will not have changed.
* *
...@@ -183,14 +183,14 @@ public abstract class SignatureSpi { ...@@ -183,14 +183,14 @@ public abstract class SignatureSpi {
/** /**
* Finishes this signature operation and stores the resulting signature * Finishes this signature operation and stores the resulting signature
* bytes in the provided buffer <code>outbuf</code>, starting at * bytes in the provided buffer {@code outbuf}, starting at
* <code>offset</code>. * {@code offset}.
* The format of the signature depends on the underlying * The format of the signature depends on the underlying
* signature scheme. * signature scheme.
* *
* <p>The signature implementation is reset to its initial state * <p>The signature implementation is reset to its initial state
* (the state it was in after a call to one of the * (the state it was in after a call to one of the
* <code>engineInitSign</code> methods) * {@code engineInitSign} methods)
* and can be reused to generate further signatures with the same private * and can be reused to generate further signatures with the same private
* key. * key.
* *
...@@ -200,10 +200,10 @@ public abstract class SignatureSpi { ...@@ -200,10 +200,10 @@ public abstract class SignatureSpi {
* *
* @param outbuf buffer for the signature result. * @param outbuf buffer for the signature result.
* *
* @param offset offset into <code>outbuf</code> where the signature is * @param offset offset into {@code outbuf} where the signature is
* stored. * stored.
* *
* @param len number of bytes within <code>outbuf</code> allotted for the * @param len number of bytes within {@code outbuf} allotted for the
* signature. * signature.
* Both this default implementation and the SUN provider do not * Both this default implementation and the SUN provider do not
* return partial digests. If the value of this parameter is less * return partial digests. If the value of this parameter is less
...@@ -212,11 +212,11 @@ public abstract class SignatureSpi { ...@@ -212,11 +212,11 @@ public abstract class SignatureSpi {
* This parameter is ignored if its value is greater than or equal to * This parameter is ignored if its value is greater than or equal to
* the actual signature length. * the actual signature length.
* *
* @return the number of bytes placed into <code>outbuf</code> * @return the number of bytes placed into {@code outbuf}
* *
* @exception SignatureException if the engine is not * @exception SignatureException if the engine is not
* initialized properly, if this signature algorithm is unable to * initialized properly, if this signature algorithm is unable to
* process the input data provided, or if <code>len</code> is less * process the input data provided, or if {@code len} is less
* than the actual signature length. * than the actual signature length.
* *
* @since 1.2 * @since 1.2
...@@ -293,7 +293,7 @@ public abstract class SignatureSpi { ...@@ -293,7 +293,7 @@ public abstract class SignatureSpi {
* *
* @param value the parameter value. * @param value the parameter value.
* *
* @exception InvalidParameterException if <code>param</code> is an * @exception InvalidParameterException if {@code param} is an
* invalid parameter for this signature algorithm engine, * invalid parameter for this signature algorithm engine,
* the parameter is already set * the parameter is already set
* and cannot be set again, a security exception occurs, and so on. * and cannot be set again, a security exception occurs, and so on.
...@@ -362,7 +362,7 @@ public abstract class SignatureSpi { ...@@ -362,7 +362,7 @@ public abstract class SignatureSpi {
* @return the object that represents the parameter value, or null if * @return the object that represents the parameter value, or null if
* there is none. * there is none.
* *
* @exception InvalidParameterException if <code>param</code> is an * @exception InvalidParameterException if {@code param} is an
* invalid parameter for this engine, or another exception occurs while * invalid parameter for this engine, or another exception occurs while
* trying to get this parameter. * trying to get this parameter.
* *
...@@ -378,7 +378,7 @@ public abstract class SignatureSpi { ...@@ -378,7 +378,7 @@ public abstract class SignatureSpi {
* @return a clone if the implementation is cloneable. * @return a clone if the implementation is cloneable.
* *
* @exception CloneNotSupportedException if this is called * @exception CloneNotSupportedException if this is called
* on an implementation that does not support <code>Cloneable</code>. * on an implementation that does not support {@code Cloneable}.
*/ */
public Object clone() throws CloneNotSupportedException { public Object clone() throws CloneNotSupportedException {
if (this instanceof Cloneable) { if (this instanceof Cloneable) {
......
src/share/classes/java/security/acl/AclEntry.java
浏览文件 @ fe6c9f2d
/* /*
* Copyright (c) 1996, 2004, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1996, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
...@@ -84,7 +84,7 @@ public interface AclEntry extends Cloneable { ...@@ -84,7 +84,7 @@ public interface AclEntry extends Cloneable {
* specified in the entry. * specified in the entry.
* *
* Note: ACL entries are by default positive. An entry becomes a * Note: ACL entries are by default positive. An entry becomes a
* negative entry only if this <code>setNegativePermissions</code> * negative entry only if this {@code setNegativePermissions}
* method is called on it. * method is called on it.
*/ */
public void setNegativePermissions(); public void setNegativePermissions();
......
src/share/classes/java/security/acl/package-info.java 0 → 100644
浏览文件 @ fe6c9f2d
此差异已折叠。
src/share/classes/java/security/cert/package-info.java 0 → 100644
浏览文件 @ fe6c9f2d
此差异已折叠。
src/share/classes/java/security/package-info.java 0 → 100644
浏览文件 @ fe6c9f2d
此差异已折叠。
src/share/classes/java/security/package.html 已删除 100644 → 0
浏览文件 @ 09d88156
此差异已折叠。
src/share/classes/java/security/spec/package-info.java 0 → 100644
浏览文件 @ fe6c9f2d
此差异已折叠。
Markdown is supported
0% 或 .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑！
想要评论请 注册 或