2604

Committed 03 Jan 2025 10:00AM UTC coverage: 87.524% (+0.3%) from 87.177%

Build # 2604

Build Type

Pull #3146

github

Committed by

web-flow

Commit Message

Merge 60c1f5fea into 8ac3920af

Pull Request Pull Request #3146: Shared ambiguity instance

Run Details

3633 of 4401 branches covered (82.55%)

4 of 4 new or added lines in 1 file covered. (100.0%)

254 existing lines in 22 files now uncovered.

9569 of 10933 relevant lines covered (87.52%)

0.88 hits per line

Source File
Press 'n' to go to next uncovered line, 'b' for previous

87.5

/src/main/java/org/apache/ibatis/type/BaseTypeHandler.java

/*
 *    Copyright 2009-2024 the original author or authors.
 *
 *    Licensed under the Apache License, Version 2.0 (the "License");
 *    you may not use this file except in compliance with the License.
 *    You may obtain a copy of the License at
 *
 *       https://www.apache.org/licenses/LICENSE-2.0
 *
 *    Unless required by applicable law or agreed to in writing, software
 *    distributed under the License is distributed on an "AS IS" BASIS,
 *    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 *    See the License for the specific language governing permissions and
 *    limitations under the License.
 */
package org.apache.ibatis.type;

import java.sql.CallableStatement;
import java.sql.PreparedStatement;
import java.sql.ResultSet;
import java.sql.SQLException;

import org.apache.ibatis.executor.result.ResultMapException;
import org.apache.ibatis.session.Configuration;

/**
 * The base {@link TypeHandler} for references a generic type.
 * <p>
 * Important: Since 3.5.0, This class never call the {@link ResultSet#wasNull()} and {@link CallableStatement#wasNull()}
 * method for handling the SQL {@code NULL} value. In other words, {@code null} value handling should be performed on
 * subclass.
 *
 * @author Clinton Begin
 * @author Simone Tripodi
 * @author Kzuki Shimizu
 */
public abstract class BaseTypeHandler<T> extends TypeReference<T> implements TypeHandler<T> {

  /**
   * @deprecated Since 3.5.0 - See https://github.com/mybatis/mybatis-3/issues/1203. This field will remove future.
   */
  @Deprecated
  protected Configuration configuration;

  /**
   * Sets the configuration.
   *
   * @param c
   *          the new configuration
   *
   * @deprecated Since 3.5.0 - See https://github.com/mybatis/mybatis-3/issues/1203. This property will remove future.
   */
  @Deprecated
  public void setConfiguration(Configuration c) {
    this.configuration = c;
  }

  @Override
  public void setParameter(PreparedStatement ps, int i, T parameter, JdbcType jdbcType) throws SQLException {
    if (parameter == null) {
      if (jdbcType == null) {
        throw new TypeException("JDBC requires that the JdbcType must be specified for all nullable parameters.");
      }
      try {
        ps.setNull(i, jdbcType.TYPE_CODE);
      } catch (SQLException e) {
        throw new TypeException("Error setting null for parameter #" + i + " with JdbcType " + jdbcType + " . "
            + "Try setting a different JdbcType for this parameter or a different jdbcTypeForNull configuration property. "
            + "Cause: " + e, e);
      }
    } else {
      try {
        setNonNullParameter(ps, i, parameter, jdbcType);
      } catch (Exception e) {
        throw new TypeException("Error setting non null for parameter #" + i + " with JdbcType " + jdbcType + " . "
            + "Try setting a different JdbcType for this parameter or a different configuration property. " + "Cause: "
            + e, e);
      }
    }
  }

  @Override
  public T getResult(ResultSet rs, String columnName) throws SQLException {
    try {
      return getNullableResult(rs, columnName);
    } catch (Exception e) {
      throw new ResultMapException("Error attempting to get column '" + columnName + "' from result set.  Cause: " + e,
          e);
    }
  }

  @Override
  public T getResult(ResultSet rs, int columnIndex) throws SQLException {
    try {
      return getNullableResult(rs, columnIndex);
    } catch (Exception e) {
      throw new ResultMapException("Error attempting to get column #" + columnIndex + " from result set.  Cause: " + e,
          e);
    }
  }

  @Override
  public T getResult(CallableStatement cs, int columnIndex) throws SQLException {
    try {
      return getNullableResult(cs, columnIndex);
    } catch (Exception e) {
      throw new ResultMapException(
          "Error attempting to get column #" + columnIndex + " from callable statement.  Cause: " + e, e);
    }
  }

  public abstract void setNonNullParameter(PreparedStatement ps, int i, T parameter, JdbcType jdbcType)
      throws SQLException;

  /**
   * Gets the nullable result.
   *
   * @param rs
   *          the rs
   * @param columnName
   *          Column name, when configuration <code>useColumnLabel</code> is <code>false</code>
   *
   * @return the nullable result
   *
   * @throws SQLException
   *           the SQL exception
   */
  public abstract T getNullableResult(ResultSet rs, String columnName) throws SQLException;

  public abstract T getNullableResult(ResultSet rs, int columnIndex) throws SQLException;

  public abstract T getNullableResult(CallableStatement cs, int columnIndex) throws SQLException;

}

1	/*
2	* Copyright 2009-2024 the original author or authors.
3	*
4	* Licensed under the Apache License, Version 2.0 (the "License");
5	* you may not use this file except in compliance with the License.
6	* You may obtain a copy of the License at
7	*
8	* https://www.apache.org/licenses/LICENSE-2.0
9	*
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	package org.apache.ibatis.type;
17
18	import java.sql.CallableStatement;
19	import java.sql.PreparedStatement;
20	import java.sql.ResultSet;
21	import java.sql.SQLException;
22
23	import org.apache.ibatis.executor.result.ResultMapException;
24	import org.apache.ibatis.session.Configuration;
25
26	/**
27	* The base {@link TypeHandler} for references a generic type.
28	* <p>
29	* Important: Since 3.5.0, This class never call the {@link ResultSet#wasNull()} and {@link CallableStatement#wasNull()}
30	* method for handling the SQL {@code NULL} value. In other words, {@code null} value handling should be performed on
31	* subclass.
32	*
33	* @author Clinton Begin
34	* @author Simone Tripodi
35	* @author Kzuki Shimizu
36	*/
37	public abstract class BaseTypeHandler<T> extends TypeReference<T> implements TypeHandler<T> {	1✔
38
39	/**
40	* @deprecated Since 3.5.0 - See https://github.com/mybatis/mybatis-3/issues/1203. This field will remove future.
41	*/
42	@Deprecated
43	protected Configuration configuration;
44
45	/**
46	* Sets the configuration.
47	*
48	* @param c
49	* the new configuration
50	*
51	* @deprecated Since 3.5.0 - See https://github.com/mybatis/mybatis-3/issues/1203. This property will remove future.
52	*/
53	@Deprecated
54	public void setConfiguration(Configuration c) {
UNCOV 55	this.configuration = c;	×
56	}	×
57
58	@Override
59	public void setParameter(PreparedStatement ps, int i, T parameter, JdbcType jdbcType) throws SQLException {
60	if (parameter == null) {	1✔
61	if (jdbcType == null) {	1!
UNCOV 62	throw new TypeException("JDBC requires that the JdbcType must be specified for all nullable parameters.");	×
63	}
64	try {
65	ps.setNull(i, jdbcType.TYPE_CODE);	1✔
66	} catch (SQLException e) {	1✔
67	throw new TypeException("Error setting null for parameter #" + i + " with JdbcType " + jdbcType + " . "	1✔
68	+ "Try setting a different JdbcType for this parameter or a different jdbcTypeForNull configuration property. "
69	+ "Cause: " + e, e);
70	}	1✔
71	} else {
72	try {
73	setNonNullParameter(ps, i, parameter, jdbcType);	1✔
74	} catch (Exception e) {	1✔
75	throw new TypeException("Error setting non null for parameter #" + i + " with JdbcType " + jdbcType + " . "	1✔
76	+ "Try setting a different JdbcType for this parameter or a different configuration property. " + "Cause: "
77	+ e, e);
78	}	1✔
79	}
80	}	1✔
81
82	@Override
83	public T getResult(ResultSet rs, String columnName) throws SQLException {
84	try {
85	return getNullableResult(rs, columnName);	1✔
86	} catch (Exception e) {	1✔
87	throw new ResultMapException("Error attempting to get column '" + columnName + "' from result set. Cause: " + e,	1✔
88	e);
89	}
90	}
91
92	@Override
93	public T getResult(ResultSet rs, int columnIndex) throws SQLException {
94	try {
95	return getNullableResult(rs, columnIndex);	1✔
96	} catch (Exception e) {	1✔
97	throw new ResultMapException("Error attempting to get column #" + columnIndex + " from result set. Cause: " + e,	1✔
98	e);
99	}
100	}
101
102	@Override
103	public T getResult(CallableStatement cs, int columnIndex) throws SQLException {
104	try {
105	return getNullableResult(cs, columnIndex);	1✔
106	} catch (Exception e) {	1✔
107	throw new ResultMapException(	1✔
108	"Error attempting to get column #" + columnIndex + " from callable statement. Cause: " + e, e);
109	}
110	}
111
112	public abstract void setNonNullParameter(PreparedStatement ps, int i, T parameter, JdbcType jdbcType)
113	throws SQLException;
114
115	/**
116	* Gets the nullable result.
117	*
118	* @param rs
119	* the rs
120	* @param columnName
121	* Column name, when configuration <code>useColumnLabel</code> is <code>false</code>
122	*
123	* @return the nullable result
124	*
125	* @throws SQLException
126	* the SQL exception
127	*/
128	public abstract T getNullableResult(ResultSet rs, String columnName) throws SQLException;
129
130	public abstract T getNullableResult(ResultSet rs, int columnIndex) throws SQLException;
131
132	public abstract T getNullableResult(CallableStatement cs, int columnIndex) throws SQLException;
133
134	}

mybatis / mybatis-3 / 2604

Source File Press 'n' to go to next uncovered line, 'b' for previous

Source File
Press 'n' to go to next uncovered line, 'b' for previous