01: /*
02: * Copyright 2002-2005 the original author or authors.
03: *
04: * Licensed under the Apache License, Version 2.0 (the "License");
05: * you may not use this file except in compliance with the License.
06: * You may obtain a copy of the License at
07: *
08: * http://www.apache.org/licenses/LICENSE-2.0
09: *
10: * Unless required by applicable law or agreed to in writing, software
11: * distributed under the License is distributed on an "AS IS" BASIS,
12: * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13: * See the License for the specific language governing permissions and
14: * limitations under the License.
15: */
16:
17: package org.springframework.jdbc;
18:
19: import java.sql.SQLException;
20:
21: import org.springframework.dao.InvalidDataAccessResourceUsageException;
22:
23: /**
24: * Exception thrown when a ResultSet has been accessed in an invalid fashion.
25: * Such exceptions always have a <code>java.sql.SQLException</code> root cause.
26: *
27: * <p>This typically happens when an invalid ResultSet column index or name
28: * has been specified. Also thrown by disconnected SqlRowSets.
29: *
30: * @author Juergen Hoeller
31: * @since 1.2
32: * @see BadSqlGrammarException
33: * @see org.springframework.jdbc.support.rowset.SqlRowSet
34: */
35: public class InvalidResultSetAccessException extends
36: InvalidDataAccessResourceUsageException {
37:
38: private String sql;
39:
40: /**
41: * Constructor for InvalidResultSetAccessException.
42: * @param task name of current task
43: * @param sql the offending SQL statement
44: * @param ex the root cause
45: */
46: public InvalidResultSetAccessException(String task, String sql,
47: SQLException ex) {
48: super (
49: task + "; invalid ResultSet access for SQL [" + sql
50: + "]", ex);
51: this .sql = sql;
52: }
53:
54: /**
55: * Constructor for InvalidResultSetAccessException.
56: * @param ex the root cause
57: */
58: public InvalidResultSetAccessException(SQLException ex) {
59: super (ex.getMessage(), ex);
60: }
61:
62: /**
63: * Return the wrapped SQLException.
64: */
65: public SQLException getSQLException() {
66: return (SQLException) getCause();
67: }
68:
69: /**
70: * Return the SQL that caused the problem.
71: * @return the offending SQL, if known
72: */
73: public String getSql() {
74: return sql;
75: }
76:
77: }
|