Adding JMCR-Stable version

[Benchmarks_CSolver.git] / JMCR-Stable / real-world application / MyDerby-10.3 / java / engine / org / apache / derby / iapi / services / io / DerbyIOException.java

diff --git a/JMCR-Stable/real-world application/MyDerby-10.3/java/engine/org/apache/derby/iapi/services/io/DerbyIOException.java b/JMCR-Stable/real-world application/MyDerby-10.3/java/engine/org/apache/derby/iapi/services/io/DerbyIOException.java
new file mode 100644 (file)
index 0000000..5a5238e
--- /dev/null
+++ b/JMCR-Stable/real-world application/MyDerby-10.3/java/engine/org/apache/derby/iapi/services/io/DerbyIOException.java
@@ -0,0 +1,56 @@
+/*\r
+\r
+   Derby - Class org.apache.derby.iapi.service.io.DerbyIOException\r
+\r
+   Licensed to the Apache Software Foundation (ASF) under one or more\r
+   contributor license agreements.  See the NOTICE file distributed with\r
+   this work for additional information regarding copyright ownership.\r
+   The ASF licenses this file to you under the Apache License, Version 2.0\r
+   (the "License"); you may not use this file except in compliance with\r
+   the License.  You may obtain a copy of the License at\r
+\r
+      http://www.apache.org/licenses/LICENSE-2.0\r
+\r
+   Unless required by applicable law or agreed to in writing, software\r
+   distributed under the License is distributed on an "AS IS" BASIS,\r
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\r
+   See the License for the specific language governing permissions and\r
+   limitations under the License.\r
+\r
+ */\r
+\r
+package org.apache.derby.iapi.services.io;\r
+\r
+import java.io.IOException;\r
+\r
+/**\r
+ * A subclass of <code>IOException</code> that carries a SQL state.\r
+ *\r
+ * The original reason for adding it was to separate between\r
+ * <code>IOException</code>s generated by the application stream and the ones\r
+ * generated by the Derby wrapper streams, see for instance\r
+ * <code>RawToBinaryFormatStream</code>. Without this distinction, the user\r
+ * would not be able to easily write <code>catch</code>-blocks to handle\r
+ * specific errors happening when reading streams.\r
+ */\r
+public final class DerbyIOException\r
+    extends IOException {\r
+\r
+    /** A Derby SQLState. */\r
+    private final String sqlState;\r
+\r
+    /**\r
+     * Create a new Derby IO exception.\r
+     *\r
+     * @param msg a string describing the error\r
+     * @param sqlState a Derby SQLState describing the error\r
+     */\r
+    public DerbyIOException(String msg, String sqlState) {\r
+        super(msg);\r
+        this.sqlState = sqlState;\r
+    }\r
+\r
+    public String getSQLState() {\r
+        return sqlState;\r
+    }\r
+} // End class DerbyIOException\r