1 /* |
1 /* |
2 * Copyright (c) 2000, 2003, Oracle and/or its affiliates. All rights reserved. |
2 * Copyright (c) 2000, 2013, Oracle and/or its affiliates. All rights reserved. |
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. |
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. |
4 * |
4 * |
5 * This code is free software; you can redistribute it and/or modify it |
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 |
6 * under the terms of the GNU General Public License version 2 only, as |
7 * published by the Free Software Foundation. Oracle designates this |
7 * published by the Free Software Foundation. Oracle designates this |
27 |
27 |
28 import java.security.GeneralSecurityException; |
28 import java.security.GeneralSecurityException; |
29 |
29 |
30 /** |
30 /** |
31 * An exception indicating one of a variety of problems retrieving |
31 * An exception indicating one of a variety of problems retrieving |
32 * certificates and CRLs from a <code>CertStore</code>. |
32 * certificates and CRLs from a {@code CertStore}. |
33 * <p> |
33 * <p> |
34 * A <code>CertStoreException</code> provides support for wrapping |
34 * A {@code CertStoreException} provides support for wrapping |
35 * exceptions. The {@link #getCause getCause} method returns the throwable, |
35 * exceptions. The {@link #getCause getCause} method returns the throwable, |
36 * if any, that caused this exception to be thrown. |
36 * if any, that caused this exception to be thrown. |
37 * <p> |
37 * <p> |
38 * <b>Concurrent Access</b> |
38 * <b>Concurrent Access</b> |
39 * <p> |
39 * <p> |
51 public class CertStoreException extends GeneralSecurityException { |
51 public class CertStoreException extends GeneralSecurityException { |
52 |
52 |
53 private static final long serialVersionUID = 2395296107471573245L; |
53 private static final long serialVersionUID = 2395296107471573245L; |
54 |
54 |
55 /** |
55 /** |
56 * Creates a <code>CertStoreException</code> with <code>null</code> as |
56 * Creates a {@code CertStoreException} with {@code null} as |
57 * its detail message. |
57 * its detail message. |
58 */ |
58 */ |
59 public CertStoreException() { |
59 public CertStoreException() { |
60 super(); |
60 super(); |
61 } |
61 } |
62 |
62 |
63 /** |
63 /** |
64 * Creates a <code>CertStoreException</code> with the given detail |
64 * Creates a {@code CertStoreException} with the given detail |
65 * message. A detail message is a <code>String</code> that describes this |
65 * message. A detail message is a {@code String} that describes this |
66 * particular exception. |
66 * particular exception. |
67 * |
67 * |
68 * @param msg the detail message |
68 * @param msg the detail message |
69 */ |
69 */ |
70 public CertStoreException(String msg) { |
70 public CertStoreException(String msg) { |
71 super(msg); |
71 super(msg); |
72 } |
72 } |
73 |
73 |
74 /** |
74 /** |
75 * Creates a <code>CertStoreException</code> that wraps the specified |
75 * Creates a {@code CertStoreException} that wraps the specified |
76 * throwable. This allows any exception to be converted into a |
76 * throwable. This allows any exception to be converted into a |
77 * <code>CertStoreException</code>, while retaining information about the |
77 * {@code CertStoreException}, while retaining information about the |
78 * cause, which may be useful for debugging. The detail message is |
78 * cause, which may be useful for debugging. The detail message is |
79 * set to (<code>cause==null ? null : cause.toString()</code>) (which |
79 * set to ({@code cause==null ? null : cause.toString()}) (which |
80 * typically contains the class and detail message of cause). |
80 * typically contains the class and detail message of cause). |
81 * |
81 * |
82 * @param cause the cause (which is saved for later retrieval by the |
82 * @param cause the cause (which is saved for later retrieval by the |
83 * {@link #getCause getCause()} method). (A <code>null</code> value is |
83 * {@link #getCause getCause()} method). (A {@code null} value is |
84 * permitted, and indicates that the cause is nonexistent or unknown.) |
84 * permitted, and indicates that the cause is nonexistent or unknown.) |
85 */ |
85 */ |
86 public CertStoreException(Throwable cause) { |
86 public CertStoreException(Throwable cause) { |
87 super(cause); |
87 super(cause); |
88 } |
88 } |
89 |
89 |
90 /** |
90 /** |
91 * Creates a <code>CertStoreException</code> with the specified detail |
91 * Creates a {@code CertStoreException} with the specified detail |
92 * message and cause. |
92 * message and cause. |
93 * |
93 * |
94 * @param msg the detail message |
94 * @param msg the detail message |
95 * @param cause the cause (which is saved for later retrieval by the |
95 * @param cause the cause (which is saved for later retrieval by the |
96 * {@link #getCause getCause()} method). (A <code>null</code> value is |
96 * {@link #getCause getCause()} method). (A {@code null} value is |
97 * permitted, and indicates that the cause is nonexistent or unknown.) |
97 * permitted, and indicates that the cause is nonexistent or unknown.) |
98 */ |
98 */ |
99 public CertStoreException(String msg, Throwable cause) { |
99 public CertStoreException(String msg, Throwable cause) { |
100 super(msg, cause); |
100 super(msg, cause); |
101 } |
101 } |