KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > org > apache > derby > iapi > services > io > DerbyIOException


1 /*
2
3    Derby - Class org.apache.derby.iapi.service.io.DerbyIOException
4
5    Licensed to the Apache Software Foundation (ASF) under one or more
6    contributor license agreements. See the NOTICE file distributed with
7    this work for additional information regarding copyright ownership.
8    The ASF licenses this file to you under the Apache License, Version 2.0
9    (the "License"); you may not use this file except in compliance with
10    the License. You may obtain a copy of the License at
11
12       http://www.apache.org/licenses/LICENSE-2.0
13
14    Unless required by applicable law or agreed to in writing, software
15    distributed under the License is distributed on an "AS IS" BASIS,
16    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
17    See the License for the specific language governing permissions and
18    limitations under the License.
19
20  */

21
22 package org.apache.derby.iapi.services.io;
23
24 import java.io.IOException JavaDoc;
25
26 /**
27  * A subclass of <code>IOException</code> that carries a SQL state.
28  *
29  * The original reason for adding it was to separate between
30  * <code>IOException</code>s generated by the application stream and the ones
31  * generated by the Derby wrapper streams, see for instance
32  * <code>RawToBinaryFormatStream</code>. Without this distinction, the user
33  * would not be able to easily write <code>catch</code>-blocks to handle
34  * specific errors happening when reading streams.
35  */

36 public final class DerbyIOException
37     extends IOException JavaDoc {
38
39     /** A Derby SQLState. */
40     private final String JavaDoc sqlState;
41
42     /**
43      * Create a new Derby IO exception.
44      *
45      * @param msg a string describing the error
46      * @param sqlState a Derby SQLState describing the error
47      */

48     public DerbyIOException(String JavaDoc msg, String JavaDoc sqlState) {
49         super(msg);
50         this.sqlState = sqlState;
51     }
52
53     public String JavaDoc getSQLState() {
54         return sqlState;
55     }
56 } // End class DerbyIOException
57
Popular Tags