/** 
 * 查詢單個(gè)結(jié)果，保存為 Map<String, Object> 結(jié)構(gòu)。如果查詢不到任何數(shù)據(jù)返回 null。 
 * 
 * @param conn 
 *   數(shù)據(jù)庫連接對(duì)象 
 * @param sql 
 *   SQL 語句，可以帶有 ? 的占位符 
 * @param params 
 *   插入到 SQL 中的參數(shù)，可單個(gè)可多個(gè)可不填 
 * @return Map<String, Object> 結(jié)構(gòu)的結(jié)果。如果查詢不到任何數(shù)據(jù)返回 null。 
 */ 
public static Map<String, Object> query(Connection conn, String sql, Object... params) { 
 Map<String, Object> map = null; 
 printRealSql(sql, params); // 打印真實(shí) SQL 的函數(shù) 
  
 try (PreparedStatement ps = conn.prepareStatement(sql);) { 
  if(params != null) 
   for (int i = 0; i < params.length; i++) 
    ps.setObject(i + 1, params[i]); 
   
  try (ResultSet rs = ps.executeQuery();) { 
   if (rs.isBeforeFirst()) { 
    map = getResultMap(rs); 
   } else { 
    LOGGER.info("查詢 SQL：{0} 沒有符合的記錄！", sql); 
   } 
  } 
 } catch (SQLException e) { 
  LOGGER.warning(e); 
 } 
  
 return map; 
} 

printRealSql(sql, params); // 打印真實(shí) SQL 的函數(shù) 

/** 
 * 在開發(fā)過程，SQL語句有可能寫錯(cuò)，如果能把運(yùn)行時(shí)出錯(cuò)的 SQL 語句直接打印出來，那對(duì)排錯(cuò)非常方便，因?yàn)槠淇梢灾苯涌截惖綌?shù)據(jù)庫客戶端進(jìn)行調(diào)試。 
 * 
 * @param sql 
 *   SQL 語句，可以帶有 ? 的占位符 
 * @param params 
 *   插入到 SQL 中的參數(shù)，可單個(gè)可多個(gè)可不填 
 * @return 實(shí)際 sql 語句 
 */ 
public static String printRealSql(String sql, Object[] params) { 
 if(params == null || params.length == 0) { 
  LOGGER.info("The SQL is------------>\n" + sql); 
  return sql; 
 } 
  
 if (!match(sql, params)) { 
  LOGGER.info("SQL 語句中的占位符與參數(shù)個(gè)數(shù)不匹配。SQL：" + sql); 
  return null; 
 } 
 
 int cols = params.length; 
 Object[] values = new Object[cols]; 
 System.arraycopy(params, 0, values, 0, cols); 
 
 for (int i = 0; i < cols; i++) { 
  Object value = values[i]; 
  if (value instanceof Date) { 
   values[i] = "'" + value + "'"; 
  } else if (value instanceof String) { 
   values[i] = "'" + value + "'"; 
  } else if (value instanceof Boolean) { 
   values[i] = (Boolean) value ? 1 : 0; 
  } 
 } 
  
 String statement = String.format(sql.replaceAll("\\?", "%s"), values); 
 
 LOGGER.info("The SQL is------------>\n" + statement); 
 
 ConnectionMgr.addSql(statement); // 用來保存日志 
  
 return statement; 
} 
 
/** 
 * ? 和參數(shù)的實(shí)際個(gè)數(shù)是否匹配 
 * 
 * @param sql 
 *   SQL 語句，可以帶有 ? 的占位符 
 * @param params 
 *   插入到 SQL 中的參數(shù)，可單個(gè)可多個(gè)可不填 
 * @return true 表示為 ? 和參數(shù)的實(shí)際個(gè)數(shù)匹配 
 */ 
private static boolean match(String sql, Object[] params) { 
 if(params == null || params.length == 0) return true; // 沒有參數(shù)，完整輸出 
  
 Matcher m = Pattern.compile("(\\?)").matcher(sql); 
 int count = 0; 
 while (m.find()) { 
  count++; 
 } 
  
 return count == params.length; 
}