package zbooksoft.fams.common; import java.math.BigDecimal; import java.util.Map; /** * 平台表单数据Map读写工具:表单字段是大写列名,平台追加的系统字段是小写,读写都需兼容两种写法 * @author ycq * @date 2026-10-16 */ public final class FormDataUtils { private FormDataUtils() { } /** * 读取字段的字符串值,空值返回空串 * @param formData 表单数据 * @param column 列名 * @return 去掉首尾空白的字符串 */ public static String getString(Map formData, String column) { Object value = getValue(formData, column); return value == null ? "" : String.valueOf(value).trim(); } /** * 读取Long值,空串或非数字返回null * @param formData 表单数据 * @param column 列名 * @return Long值 */ public static Long getLong(Map formData, String column) { return toLong(getValue(formData, column)); } /** * 写入字段,表单里已有小写同名key时一并覆盖,避免平台读到旧值 * @param formData 表单数据 * @param column 列名(大写) * @param value 值 */ public static void put(Map formData, String column, Object value) { String upper = column.toUpperCase(); String lower = column.toLowerCase(); formData.put(upper, value); if (formData.containsKey(lower)) { formData.put(lower, value); } } /** * 判断字段是否为空 * @param formData 表单数据 * @param column 列名 * @return 空返回true */ public static boolean isBlank(Map formData, String column) { return getString(formData, column).isEmpty(); } /** * 把任意对象转换为Long,空串或非数字返回null * @param value 原始值 * @return Long值 */ public static Long toLong(Object value) { if (value == null) { return null; } if (value instanceof Number) { return ((Number) value).longValue(); } String text = String.valueOf(value).trim(); if (text.isEmpty()) { return null; } try { return new BigDecimal(text).longValue(); } catch (NumberFormatException e) { return null; } } /** * 把任意对象转换为Integer,空串或非数字返回null * @param value 原始值 * @return Integer值 */ public static Integer toInteger(Object value) { Long result = toLong(value); return result == null ? null : result.intValue(); } /** * 把任意对象转换为去空白字符串,null返回空串 * @param value 原始值 * @return 字符串 */ public static String toText(Object value) { return value == null ? "" : String.valueOf(value).trim(); } private static Object getValue(Map formData, String column) { if (formData == null) { return null; } if (formData.containsKey(column)) { return formData.get(column); } if (formData.containsKey(column.toUpperCase())) { return formData.get(column.toUpperCase()); } return formData.get(column.toLowerCase()); } }