01: /*
02:
03: Derby - Class org.apache.derby.iapi.service.io.DerbyIOException
04:
05: Licensed to the Apache Software Foundation (ASF) under one or more
06: contributor license agreements. See the NOTICE file distributed with
07: this work for additional information regarding copyright ownership.
08: The ASF licenses this file to you under the Apache License, Version 2.0
09: (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;
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 extends IOException {
37:
38: /** A Derby SQLState. */
39: private final String sqlState;
40:
41: /**
42: * Create a new Derby IO exception.
43: *
44: * @param msg a string describing the error
45: * @param sqlState a Derby SQLState describing the error
46: */
47: public DerbyIOException(String msg, String sqlState) {
48: super (msg);
49: this .sqlState = sqlState;
50: }
51:
52: public String getSQLState() {
53: return sqlState;
54: }
55: } // End class DerbyIOException
|