mybatis插入数据时ID为空引发的NULLPointerException及解决方案
在使用MyBatis进行数据库插入操作时,若主键ID未赋值为NULL,则可能抛出NullPointerException异常。本文将通过一个案例分析问题根源并提供解决方案。
问题描述:
开发者在使用MyBatis插入数据时遇到NullPointerException,错误信息指向tmdddicsetmapper.xml文件的insertTmDdDicSetV1方法。请求数据未包含ID字段,而TmDdDicSet实体类定义了ID字段,且tmdddicsetmapper.xml中的插入语句使用了动态sql,根据ID是否为NULL决定是否插入该字段。由于传入的TmDdDicSet对象ID属性为NULL,导致MyBatis构建sql语句时出现空指针异常。错误信息及代码片段如下:
tmdddicset [id= null, dictypecode= 1, diccode= 2, dicname= 3, recordstarttime= 2023-03-15 15:00:00, recordstopflag= 1, recordstoptime= 2023-03-15 15:00:00] id == null
<insert id="insertTmDdDicSetV1" keyProperty="ID" parameterType="TmDdDicSet" useGeneratedKeys="true"> INSERT INTO tm_dd_dicset <trim prefix="(" suffix=")" suffixOverrides=","> <if test="ID != null"> ID, </if> <if test="DicTypeCode != null"> DicTypeCode, </if> ... </trim> <trim prefix="values (" suffix=")" suffixOverrides=","> <if test="ID != null"> #{ID,jdbcType=VARCHAR}, </if> <if test="DicTypeCode != null"> #{DicTypeCode,jdbcType=VARCHAR}, </if> ... </trim> </insert>
解决方案:
根本原因在于数据库表tm_dd_dicset的主键ID字段未设置自增属性,导致MyBatis插入数据时必须提供ID值。代码中未提供ID值,因此ID属性始终为NULL。
解决方法如下:
-
数据库设置自增主键: 推荐方法是修改数据库表结构,为ID字段添加自增约束(例如mysql的AUTO_INCREMENT)。这样,MyBatis的useGeneratedKeys=”true”和keyProperty=”ID”属性将生效,MyBatis会自动获取数据库生成的ID并赋值给TmDdDicSet对象的ID属性。
-
手动设置ID: 若无法修改数据库表结构,则需在代码中手动生成并设置ID值。可以使用UUID、雪花算法等生成唯一ID,并在插入数据前将生成的ID赋值给TmDdDicSet对象的ID属性。
选择哪种方法取决于实际情况和项目需求。 通过以上方法,即可有效解决MyBatis插入数据时ID为NULL导致的NullPointerException问题。