Java ResultSet 获取列名与类型方法

本文深入解析了Java中如何通过ResultSet.getMetaData()获取数据库查询结果集的列元信息，重点介绍了如何按从1开始的列索引调用getColumnCount()、getColumnName()、getColumnLabel()、getColumnTypeName()和getColumnType()等方法，精准提取列数、列名、显示标签、数据库类型名及JDBC标准类型码，并系统梳理了常见SQL类型（如VARCHAR、INTEGER、TIMESTAMP等）到Java类（String、Integer、LocalDateTime等）的映射规则，强调实际开发中应封装类型转换逻辑以提升健壮性与可维护性，为动态处理未知结构的结果集提供了清晰、可靠的技术路径。

可以通过 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 ResultSet 获取列名与类型方法》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！