author | juh |
Tue, 25 Jun 2013 14:31:29 -0700 | |
changeset 18551 | 882a3948c6e6 |
parent 18156 | edb590d448c5 |
permissions | -rw-r--r-- |
2 | 1 |
/* |
18551
882a3948c6e6
8017325: Cleanup of the javadoc <code> tag in java.security.cert
juh
parents:
18156
diff
changeset
|
2 |
* Copyright (c) 2000, 2013, Oracle and/or its affiliates. All rights reserved. |
2 | 3 |
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. |
4 |
* |
|
5 |
* This code is free software; you can redistribute it and/or modify it |
|
6 |
* under the terms of the GNU General Public License version 2 only, as |
|
5506 | 7 |
* published by the Free Software Foundation. Oracle designates this |
2 | 8 |
* particular file as subject to the "Classpath" exception as provided |
5506 | 9 |
* by Oracle in the LICENSE file that accompanied this code. |
2 | 10 |
* |
11 |
* This code is distributed in the hope that it will be useful, but WITHOUT |
|
12 |
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or |
|
13 |
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License |
|
14 |
* version 2 for more details (a copy is included in the LICENSE file that |
|
15 |
* accompanied this code). |
|
16 |
* |
|
17 |
* You should have received a copy of the GNU General Public License version |
|
18 |
* 2 along with this work; if not, write to the Free Software Foundation, |
|
19 |
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. |
|
20 |
* |
|
5506 | 21 |
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA |
22 |
* or visit www.oracle.com if you need additional information or have any |
|
23 |
* questions. |
|
2 | 24 |
*/ |
25 |
||
26 |
package java.security.cert; |
|
27 |
||
1238
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
28 |
import java.io.InvalidObjectException; |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
29 |
import java.io.IOException; |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
30 |
import java.io.ObjectInputStream; |
2 | 31 |
import java.security.GeneralSecurityException; |
32 |
||
33 |
/** |
|
34 |
* An exception indicating one of a variety of problems encountered when |
|
35 |
* validating a certification path. |
|
36 |
* <p> |
|
18551
882a3948c6e6
8017325: Cleanup of the javadoc <code> tag in java.security.cert
juh
parents:
18156
diff
changeset
|
37 |
* A {@code CertPathValidatorException} provides support for wrapping |
2 | 38 |
* exceptions. The {@link #getCause getCause} method returns the throwable, |
39 |
* if any, that caused this exception to be thrown. |
|
40 |
* <p> |
|
18551
882a3948c6e6
8017325: Cleanup of the javadoc <code> tag in java.security.cert
juh
parents:
18156
diff
changeset
|
41 |
* A {@code CertPathValidatorException} may also include the |
1238
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
42 |
* certification path that was being validated when the exception was thrown, |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
43 |
* the index of the certificate in the certification path that caused the |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
44 |
* exception to be thrown, and the reason that caused the failure. Use the |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
45 |
* {@link #getCertPath getCertPath}, {@link #getIndex getIndex}, and |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
46 |
* {@link #getReason getReason} methods to retrieve this information. |
2 | 47 |
* |
48 |
* <p> |
|
49 |
* <b>Concurrent Access</b> |
|
50 |
* <p> |
|
51 |
* Unless otherwise specified, the methods defined in this class are not |
|
52 |
* thread-safe. Multiple threads that need to access a single |
|
53 |
* object concurrently should synchronize amongst themselves and |
|
54 |
* provide the necessary locking. Multiple threads each manipulating |
|
55 |
* separate objects need not synchronize. |
|
56 |
* |
|
57 |
* @see CertPathValidator |
|
58 |
* |
|
59 |
* @since 1.4 |
|
60 |
* @author Yassir Elley |
|
61 |
*/ |
|
62 |
public class CertPathValidatorException extends GeneralSecurityException { |
|
63 |
||
64 |
private static final long serialVersionUID = -3083180014971893139L; |
|
65 |
||
66 |
/** |
|
67 |
* @serial the index of the certificate in the certification path |
|
68 |
* that caused the exception to be thrown |
|
69 |
*/ |
|
70 |
private int index = -1; |
|
71 |
||
72 |
/** |
|
18551
882a3948c6e6
8017325: Cleanup of the javadoc <code> tag in java.security.cert
juh
parents:
18156
diff
changeset
|
73 |
* @serial the {@code CertPath} that was being validated when |
2 | 74 |
* the exception was thrown |
75 |
*/ |
|
76 |
private CertPath certPath; |
|
77 |
||
78 |
/** |
|
1238
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
79 |
* @serial the reason the validation failed |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
80 |
*/ |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
81 |
private Reason reason = BasicReason.UNSPECIFIED; |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
82 |
|
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
83 |
/** |
18551
882a3948c6e6
8017325: Cleanup of the javadoc <code> tag in java.security.cert
juh
parents:
18156
diff
changeset
|
84 |
* Creates a {@code CertPathValidatorException} with |
2 | 85 |
* no detail message. |
86 |
*/ |
|
87 |
public CertPathValidatorException() { |
|
1238
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
88 |
this(null, null); |
2 | 89 |
} |
90 |
||
91 |
/** |
|
18551
882a3948c6e6
8017325: Cleanup of the javadoc <code> tag in java.security.cert
juh
parents:
18156
diff
changeset
|
92 |
* Creates a {@code CertPathValidatorException} with the given |
882a3948c6e6
8017325: Cleanup of the javadoc <code> tag in java.security.cert
juh
parents:
18156
diff
changeset
|
93 |
* detail message. A detail message is a {@code String} that |
2 | 94 |
* describes this particular exception. |
95 |
* |
|
96 |
* @param msg the detail message |
|
97 |
*/ |
|
98 |
public CertPathValidatorException(String msg) { |
|
1238
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
99 |
this(msg, null); |
2 | 100 |
} |
101 |
||
102 |
/** |
|
18551
882a3948c6e6
8017325: Cleanup of the javadoc <code> tag in java.security.cert
juh
parents:
18156
diff
changeset
|
103 |
* Creates a {@code CertPathValidatorException} that wraps the |
2 | 104 |
* specified throwable. This allows any exception to be converted into a |
18551
882a3948c6e6
8017325: Cleanup of the javadoc <code> tag in java.security.cert
juh
parents:
18156
diff
changeset
|
105 |
* {@code CertPathValidatorException}, while retaining information |
2 | 106 |
* about the wrapped exception, which may be useful for debugging. The |
18551
882a3948c6e6
8017325: Cleanup of the javadoc <code> tag in java.security.cert
juh
parents:
18156
diff
changeset
|
107 |
* detail message is set to ({@code cause==null ? null : cause.toString()}) |
882a3948c6e6
8017325: Cleanup of the javadoc <code> tag in java.security.cert
juh
parents:
18156
diff
changeset
|
108 |
* (which typically contains the class and detail message of |
2 | 109 |
* cause). |
110 |
* |
|
111 |
* @param cause the cause (which is saved for later retrieval by the |
|
18551
882a3948c6e6
8017325: Cleanup of the javadoc <code> tag in java.security.cert
juh
parents:
18156
diff
changeset
|
112 |
* {@link #getCause getCause()} method). (A {@code null} value is |
2 | 113 |
* permitted, and indicates that the cause is nonexistent or unknown.) |
114 |
*/ |
|
115 |
public CertPathValidatorException(Throwable cause) { |
|
1569
54e1de48703e
6765046: CertPathValidatorException(Throwable).getMessage() always returns null since b37
mullan
parents:
1238
diff
changeset
|
116 |
this((cause == null ? null : cause.toString()), cause); |
2 | 117 |
} |
118 |
||
119 |
/** |
|
18551
882a3948c6e6
8017325: Cleanup of the javadoc <code> tag in java.security.cert
juh
parents:
18156
diff
changeset
|
120 |
* Creates a {@code CertPathValidatorException} with the specified |
2 | 121 |
* detail message and cause. |
122 |
* |
|
123 |
* @param msg the detail message |
|
124 |
* @param cause the cause (which is saved for later retrieval by the |
|
18551
882a3948c6e6
8017325: Cleanup of the javadoc <code> tag in java.security.cert
juh
parents:
18156
diff
changeset
|
125 |
* {@link #getCause getCause()} method). (A {@code null} value is |
2 | 126 |
* permitted, and indicates that the cause is nonexistent or unknown.) |
127 |
*/ |
|
128 |
public CertPathValidatorException(String msg, Throwable cause) { |
|
1238
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
129 |
this(msg, cause, null, -1); |
2 | 130 |
} |
131 |
||
132 |
/** |
|
18551
882a3948c6e6
8017325: Cleanup of the javadoc <code> tag in java.security.cert
juh
parents:
18156
diff
changeset
|
133 |
* Creates a {@code CertPathValidatorException} with the specified |
2 | 134 |
* detail message, cause, certification path, and index. |
135 |
* |
|
18551
882a3948c6e6
8017325: Cleanup of the javadoc <code> tag in java.security.cert
juh
parents:
18156
diff
changeset
|
136 |
* @param msg the detail message (or {@code null} if none) |
882a3948c6e6
8017325: Cleanup of the javadoc <code> tag in java.security.cert
juh
parents:
18156
diff
changeset
|
137 |
* @param cause the cause (or {@code null} if none) |
2 | 138 |
* @param certPath the certification path that was in the process of |
139 |
* being validated when the error was encountered |
|
140 |
* @param index the index of the certificate in the certification path |
|
141 |
* that caused the error (or -1 if not applicable). Note that |
|
18551
882a3948c6e6
8017325: Cleanup of the javadoc <code> tag in java.security.cert
juh
parents:
18156
diff
changeset
|
142 |
* the list of certificates in a {@code CertPath} is zero based. |
2 | 143 |
* @throws IndexOutOfBoundsException if the index is out of range |
18156 | 144 |
* {@code (index < -1 || (certPath != null && index >= |
145 |
* certPath.getCertificates().size()) } |
|
18551
882a3948c6e6
8017325: Cleanup of the javadoc <code> tag in java.security.cert
juh
parents:
18156
diff
changeset
|
146 |
* @throws IllegalArgumentException if {@code certPath} is |
882a3948c6e6
8017325: Cleanup of the javadoc <code> tag in java.security.cert
juh
parents:
18156
diff
changeset
|
147 |
* {@code null} and {@code index} is not -1 |
2 | 148 |
*/ |
149 |
public CertPathValidatorException(String msg, Throwable cause, |
|
150 |
CertPath certPath, int index) { |
|
1238
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
151 |
this(msg, cause, certPath, index, BasicReason.UNSPECIFIED); |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
152 |
} |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
153 |
|
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
154 |
/** |
18551
882a3948c6e6
8017325: Cleanup of the javadoc <code> tag in java.security.cert
juh
parents:
18156
diff
changeset
|
155 |
* Creates a {@code CertPathValidatorException} with the specified |
1238
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
156 |
* detail message, cause, certification path, index, and reason. |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
157 |
* |
18551
882a3948c6e6
8017325: Cleanup of the javadoc <code> tag in java.security.cert
juh
parents:
18156
diff
changeset
|
158 |
* @param msg the detail message (or {@code null} if none) |
882a3948c6e6
8017325: Cleanup of the javadoc <code> tag in java.security.cert
juh
parents:
18156
diff
changeset
|
159 |
* @param cause the cause (or {@code null} if none) |
1238
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
160 |
* @param certPath the certification path that was in the process of |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
161 |
* being validated when the error was encountered |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
162 |
* @param index the index of the certificate in the certification path |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
163 |
* that caused the error (or -1 if not applicable). Note that |
18551
882a3948c6e6
8017325: Cleanup of the javadoc <code> tag in java.security.cert
juh
parents:
18156
diff
changeset
|
164 |
* the list of certificates in a {@code CertPath} is zero based. |
1238
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
165 |
* @param reason the reason the validation failed |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
166 |
* @throws IndexOutOfBoundsException if the index is out of range |
18156 | 167 |
* {@code (index < -1 || (certPath != null && index >= |
168 |
* certPath.getCertificates().size()) } |
|
18551
882a3948c6e6
8017325: Cleanup of the javadoc <code> tag in java.security.cert
juh
parents:
18156
diff
changeset
|
169 |
* @throws IllegalArgumentException if {@code certPath} is |
882a3948c6e6
8017325: Cleanup of the javadoc <code> tag in java.security.cert
juh
parents:
18156
diff
changeset
|
170 |
* {@code null} and {@code index} is not -1 |
882a3948c6e6
8017325: Cleanup of the javadoc <code> tag in java.security.cert
juh
parents:
18156
diff
changeset
|
171 |
* @throws NullPointerException if {@code reason} is {@code null} |
1238
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
172 |
* |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
173 |
* @since 1.7 |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
174 |
*/ |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
175 |
public CertPathValidatorException(String msg, Throwable cause, |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
176 |
CertPath certPath, int index, Reason reason) { |
2 | 177 |
super(msg, cause); |
178 |
if (certPath == null && index != -1) { |
|
179 |
throw new IllegalArgumentException(); |
|
180 |
} |
|
181 |
if (index < -1 || |
|
182 |
(certPath != null && index >= certPath.getCertificates().size())) { |
|
183 |
throw new IndexOutOfBoundsException(); |
|
184 |
} |
|
1238
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
185 |
if (reason == null) { |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
186 |
throw new NullPointerException("reason can't be null"); |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
187 |
} |
2 | 188 |
this.certPath = certPath; |
189 |
this.index = index; |
|
1238
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
190 |
this.reason = reason; |
2 | 191 |
} |
192 |
||
193 |
/** |
|
194 |
* Returns the certification path that was being validated when |
|
195 |
* the exception was thrown. |
|
196 |
* |
|
18551
882a3948c6e6
8017325: Cleanup of the javadoc <code> tag in java.security.cert
juh
parents:
18156
diff
changeset
|
197 |
* @return the {@code CertPath} that was being validated when |
882a3948c6e6
8017325: Cleanup of the javadoc <code> tag in java.security.cert
juh
parents:
18156
diff
changeset
|
198 |
* the exception was thrown (or {@code null} if not specified) |
2 | 199 |
*/ |
200 |
public CertPath getCertPath() { |
|
201 |
return this.certPath; |
|
202 |
} |
|
203 |
||
204 |
/** |
|
205 |
* Returns the index of the certificate in the certification path |
|
206 |
* that caused the exception to be thrown. Note that the list of |
|
18551
882a3948c6e6
8017325: Cleanup of the javadoc <code> tag in java.security.cert
juh
parents:
18156
diff
changeset
|
207 |
* certificates in a {@code CertPath} is zero based. If no |
2 | 208 |
* index has been set, -1 is returned. |
209 |
* |
|
210 |
* @return the index that has been set, or -1 if none has been set |
|
211 |
*/ |
|
212 |
public int getIndex() { |
|
213 |
return this.index; |
|
214 |
} |
|
215 |
||
1238
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
216 |
/** |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
217 |
* Returns the reason that the validation failed. The reason is |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
218 |
* associated with the index of the certificate returned by |
4512
b3ed7ecf8f55
6909563: Javadoc build warnings in rmi, security, management
darcy
parents:
1569
diff
changeset
|
219 |
* {@link #getIndex}. |
1238
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
220 |
* |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
221 |
* @return the reason that the validation failed, or |
18551
882a3948c6e6
8017325: Cleanup of the javadoc <code> tag in java.security.cert
juh
parents:
18156
diff
changeset
|
222 |
* {@code BasicReason.UNSPECIFIED} if a reason has not been |
1238
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
223 |
* specified |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
224 |
* |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
225 |
* @since 1.7 |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
226 |
*/ |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
227 |
public Reason getReason() { |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
228 |
return this.reason; |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
229 |
} |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
230 |
|
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
231 |
private void readObject(ObjectInputStream stream) |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
232 |
throws ClassNotFoundException, IOException { |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
233 |
stream.defaultReadObject(); |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
234 |
if (reason == null) { |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
235 |
reason = BasicReason.UNSPECIFIED; |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
236 |
} |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
237 |
if (certPath == null && index != -1) { |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
238 |
throw new InvalidObjectException("certpath is null and index != -1"); |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
239 |
} |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
240 |
if (index < -1 || |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
241 |
(certPath != null && index >= certPath.getCertificates().size())) { |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
242 |
throw new InvalidObjectException("index out of range"); |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
243 |
} |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
244 |
} |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
245 |
|
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
246 |
/** |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
247 |
* The reason the validation algorithm failed. |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
248 |
* |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
249 |
* @since 1.7 |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
250 |
*/ |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
251 |
public static interface Reason extends java.io.Serializable { } |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
252 |
|
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
253 |
|
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
254 |
/** |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
255 |
* The BasicReason enumerates the potential reasons that a certification |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
256 |
* path of any type may be invalid. |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
257 |
* |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
258 |
* @since 1.7 |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
259 |
*/ |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
260 |
public static enum BasicReason implements Reason { |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
261 |
/** |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
262 |
* Unspecified reason. |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
263 |
*/ |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
264 |
UNSPECIFIED, |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
265 |
|
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
266 |
/** |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
267 |
* The certificate is expired. |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
268 |
*/ |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
269 |
EXPIRED, |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
270 |
|
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
271 |
/** |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
272 |
* The certificate is not yet valid. |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
273 |
*/ |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
274 |
NOT_YET_VALID, |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
275 |
|
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
276 |
/** |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
277 |
* The certificate is revoked. |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
278 |
*/ |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
279 |
REVOKED, |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
280 |
|
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
281 |
/** |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
282 |
* The revocation status of the certificate could not be determined. |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
283 |
*/ |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
284 |
UNDETERMINED_REVOCATION_STATUS, |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
285 |
|
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
286 |
/** |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
287 |
* The signature is invalid. |
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
288 |
*/ |
8163
d9bcc1208691
7011497: new CertPathValidatorException.BasicReason enum constant for constrained algorithm
xuelei
parents:
5506
diff
changeset
|
289 |
INVALID_SIGNATURE, |
d9bcc1208691
7011497: new CertPathValidatorException.BasicReason enum constant for constrained algorithm
xuelei
parents:
5506
diff
changeset
|
290 |
|
d9bcc1208691
7011497: new CertPathValidatorException.BasicReason enum constant for constrained algorithm
xuelei
parents:
5506
diff
changeset
|
291 |
/** |
d9bcc1208691
7011497: new CertPathValidatorException.BasicReason enum constant for constrained algorithm
xuelei
parents:
5506
diff
changeset
|
292 |
* The public key or the signature algorithm has been constrained. |
d9bcc1208691
7011497: new CertPathValidatorException.BasicReason enum constant for constrained algorithm
xuelei
parents:
5506
diff
changeset
|
293 |
*/ |
d9bcc1208691
7011497: new CertPathValidatorException.BasicReason enum constant for constrained algorithm
xuelei
parents:
5506
diff
changeset
|
294 |
ALGORITHM_CONSTRAINED |
1238
6d1f4b722acd
6465942: Add problem identification facility to the CertPathValidator framework
mullan
parents:
2
diff
changeset
|
295 |
} |
2 | 296 |
} |