ArchiveException


1   /*
2    * ArchiveException.java
3    *
4    * Created on 30. Oktober 2004, 03:08
5    */
6   /*
7    * Copyright 2005 Schlichtherle IT Services
8    *
9    * Licensed under the Apache License, Version 2.0 (the "License");
10   * you may not use this file except in compliance with the License.
11   * You may obtain a copy of the License at
12   *
13   *     http://www.apache.org/licenses/LICENSE-2.0
14   *
15   * Unless required by applicable law or agreed to in writing, software
16   * distributed under the License is distributed on an "AS IS" BASIS,
17   * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
18   * See the License for the specific language governing permissions and
19   * limitations under the License.
20   */
21  
22  package de.schlichtherle.io;
23  
24  import java.io.IOException  ;
25  import java.io.OutputStreamWriter  ;
26  import java.io.PrintStream  ;
27  import java.io.PrintWriter  ;
28  import java.util.Comparator  ;
29  
30  /**
31   * Represents a chain of exceptions thrown when updating or unmounting an
32   * archive file fails for one or more reasons.
33   * 
34   * @author Christian Schlichtherle
35   * @version @version@
36   * @since TrueZIP 6.0 (refactored from the former
37   *        <code>ArchiveControllerException</code> in the package {@link de.schlichtherle.io})
38   */
39  public class ArchiveException extends ChainableIOException {
40  
41      // TODO: Make this constructor package private!
42      /**
43       * Constructs a new exception with the specified prior exception.
44       * This is used when e.g. updating all ZIP files and more than one ZIP
45       * compatible file cannot get updated. The prior exception would then be
46       * the exception for the ZIP compatible file which couldn't get updated
47       * before.
48       *
49       * @param  priorException An exception that happened before and that was
50       *         caught. This is <b>not</b> a cause! May be <tt>null</tt>.
51       */
52      public ArchiveException(ArchiveException priorException) {
53          super(priorException);
54      }
55  
56      // TODO: Make this constructor package private!
57      /**
58       * Constructs a new exception with the specified prior exception
59       * and a message.
60       * This is used when e.g. updating all ZIP files and more than one ZIP
61       * compatible file cannot get updated. The prior exception would then be
62       * the exception for the ZIP compatible file which couldn't get updated
63       * before.
64       *
65       * @param  priorException An exception that happened before and that was
66       *         caught. This is <b>not</b> a cause! May be <tt>null</tt>.
67       * @param  message The message for this exception.
68       */
69      public ArchiveException(
70              ArchiveException priorException,
71              String   message) {
72          super(priorException, message);
73      }
74      
75      // TODO: Make this constructor package private!
76      /**
77       * Constructs a new exception with the specified prior exception and the
78       * cause.
79       * This is used when e.g. updating all ZIP files and more than one ZIP
80       * compatible file cannot get updated. The prior exception would then be
81       * the exception for the ZIP compatible file which couldn't get updated
82       * before.
83       *
84       * @param  priorException An exception that happened before and that was
85       *         caught. This is <b>not</b> a cause! May be <tt>null</tt>.
86       * @param  cause The cause (which is saved for later retrieval by the
87       *         {@link #getCause()} method).  (A <tt>null</tt> value is
88       *         permitted, and indicates that the cause is nonexistent or
89       *         unknown.).
90       */
91      public ArchiveException(
92              ArchiveException priorException,
93              IOException   cause) {
94          super(priorException, cause);
95      }
96  
97      // TODO: Make this constructor package private!
98      /**
99       * Constructs a new exception with the specified prior exception,
100      * a message and a cause.
101      * This is used when e.g. updating all ZIP files and more than one ZIP
102      * compatible file cannot get updated. The prior exception would then be
103      * the exception for the ZIP compatible file which couldn't get updated
104      * before.
105      *
106      * @param  priorException An exception that happened before and that was
107      *         caught. This is <b>not</b> a cause! May be <tt>null</tt>.
108      * @param  message The message for this exception.
109      * @param  cause The cause (which is saved for later retrieval by the
110      *         {@link #getCause()} method).  (A <tt>null</tt> value is
111      *         permitted, and indicates that the cause is nonexistent or
112      *         unknown.).
113      */
114     public ArchiveException(
115             ArchiveException priorException,
116             String   message,
117             IOException   cause) {
118         super(priorException, message, cause);
119     }
120 }
121
A to Z: JavaDoc & Examples Daily Java News & Articles Open Source Projects Open Source Codes Free Computer Books Remove Frame
Popular Tags