48 * exactly those methods specified in its ancestor classes, and |
48 * exactly those methods specified in its ancestor classes, and |
49 * overrides them all. Moreover, this class catches all exceptions |
49 * overrides them all. Moreover, this class catches all exceptions |
50 * that are not thrown by its ancestor classes. In particular, the |
50 * that are not thrown by its ancestor classes. In particular, the |
51 * <code>skip</code> method skips, and the <code>available</code> |
51 * <code>skip</code> method skips, and the <code>available</code> |
52 * method counts only data that have been processed by the encapsulated Cipher. |
52 * method counts only data that have been processed by the encapsulated Cipher. |
|
53 * This class may catch BadPaddingException and other exceptions thrown by |
|
54 * failed integrity checks during decryption. These exceptions are not |
|
55 * re-thrown, so the client may not be informed that integrity checks |
|
56 * failed. Because of this behavior, this class may not be suitable |
|
57 * for use with decryption in an authenticated mode of operation (e.g. GCM). |
|
58 * Applications that require authenticated encryption can use the Cipher API |
|
59 * directly as an alternative to using this class. |
53 * |
60 * |
54 * <p> It is crucial for a programmer using this class not to use |
61 * <p> It is crucial for a programmer using this class not to use |
55 * methods that are not defined or overridden in this class (such as a |
62 * methods that are not defined or overridden in this class (such as a |
56 * new method or constructor that is later added to one of the super |
63 * new method or constructor that is later added to one of the super |
57 * classes), because the design and implementation of those methods |
64 * classes), because the design and implementation of those methods |