可通过resultset.getmetadata()获取元数据,按列索引(从1开始)调用getcolumncount()、getcolumnname()、getcolumnlabel()、getcolumntypename()、getcolumntype()等方法获取列数、列名、标签名、数据库类型名及jdbc类型码,并依映射关系转为对应java类型。

可以通过 ResultSet.getMetaData() 获取 ResultSetMetaData 对象,再调用其方法逐列读取列名、SQL 类型、Java 类型等元信息。关键在于列索引从 1 开始,且需注意数据库类型与 Java 类型的映射关系。
获取列名和 SQL 类型
ResultSetMetaData 提供了按列序号访问列定义的能力:
-
getColumnCount():返回结果集中列的总数 -
getColumnName(int column):返回第column列的原始列名(如 SQL 中写的SELECT name AS username,这里返回"username") -
getColumnLabel(int column):更推荐使用,它返回显示用的标签名(通常与getColumnName一致,但对别名更可靠) -
getColumnTypeName(int column):返回数据库底层类型名(如"VARCHAR"、"BIGINT"、"TIMESTAMP") -
getColumnType(int column):返回java.sql.Types中定义的整型常量(如Types.VARCHAR、Types.INTEGER)
映射 SQL 类型到 Java 类型
getColumnType() 返回的是 JDBC 标准类型码,需手动转换为对应 Java 类。常用映射示例如下:
-
Types.VARCHAR,Types.CHAR,Types.LONGVARCHAR→String.class -
Types.INTEGER,Types.SMALLINT,Types.TINYINT→Integer.class -
Types.BIGINT→Long.class -
Types.DECIMAL,Types.NUMERIC→BigDecimal.class -
Types.DATE→java.sql.Date.class(或转为LocalDate) -
Types.TIMESTAMP→java.sql.Timestamp.class(或转为LocalDateTime) -
Types.BOOLEAN→Boolean.class -
Types.BINARY,Types.VARBINARY→byte[].class
实际中建议封装一个工具方法,根据 getColumnType() 返回值查表返回对应 Class 对象。
完整示例代码
以下是一个安全遍历元数据并打印列信息的片段:
ResultSet rs = stmt.executeQuery("SELECT id, name, created_at FROM user");
ResultSetMetaData meta = rs.getMetaData();
int columnCount = meta.getColumnCount();
for (int i = 1; i
<p><font color="red">注意</font>:<code>getColumnClassName()</code> 并非所有驱动都准确实现(如 MySQL Connector/J 会返回 <code>java.lang.String</code> 即使是数值列),因此更稳妥的方式仍是依据 <code>getColumnType()</code> + 映射表判断。</p>
<h3>注意事项与避坑点</h3>
- 列索引必须从
1开始,传入0或超出范围会抛SQLException - 某些数据库(如 PostgreSQL)对大小写敏感,
getColumnLabel()返回的名称可能含双引号,解析别名时建议忽略引号或统一转小写 - 动态查询(如
SELECT *)下,列顺序和数量不确定,务必依赖元数据而非硬编码索引 - 如果 ResultSet 已关闭,调用
getMetaData()会抛异常,确保在rs.next()循环前或过程中调用 - 部分老版本驱动对
TIME、ARRAY、JSON等类型支持不完善,需结合数据库文档测试验证
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











