普元EOS中的命名sql的使用注意事项

普元EOS中的命名sql的使用注意事项：

 

所谓的命名sql其实也就是数据库里的sql语句，普元EOS里做了一定的封装，以方便在程序中的使用。

命名SQL的基本元素包括：  

    1. <parameterMap> parameterMap负责将对象属性映射成statement的参数。

    2. <resultMap> resultMap负责将结果集的列值映射成对象的属性值

    3. <statement>(Mapped Statement)元素是个通用声明，可以用于任何类型的sql语句，

但具体的statement类型(即<insert>、<update>、<delete>、<select>、<procedure>)

提供了更直观的XML DTD，因此强烈推荐使用。

下表总结了statement类型及其属性：

Statement类型	属性
<statement>	id、parameterClass、resultClass、parameterMap、resultMap
<insert>	id、parameterClass、parameterMap
<update>	id、parameterClass、parameterMap
<delete>	id、parameterClass、parameterMap
<select>	id、parameterClass、resultClass、parameterMap、resultMap
<procedure>	id、parameterClass、resultClass、parameterMap、resultMap

在实际的使用过程中通常都是忽略了<statement>，而直接使<insert>,<update>,<delete>,<select>,<procedure>

《一》对于各个statement的用法举例：

PS: 

(1)如果在脚本或样式表中使用特殊字符（例如< 或&）或实体引用（例如< 或&），则需要将脚本或样式表的内容标记为CDATA（字符数

     据）节，如果不使用CDATA的话就必须使用相应的实体来代替，例如<必须用&lt;来替换

(2) 命名Sql中参数用##包起来，生成的是PreparedStatement，还可以使用$$把参数包起来，这样生成的是Statement，就是说在执行sql时

     会先把参数放入到sql中，一般用在like或in操作中。对于in操作写命名Sql时，参数不能写成in(#field#)的方式，而应该写成

      in  ($filed$)的方式，原因是in操作不支持preparedStatement。

     <updateid="saveExamineInfo"parameterClass="java.util.HashMap"  >

            <![CDATA[

                    UPDATE $mainTableName$ T SET T.MAIN_CHECK1 = '$mainCheck1$' ,T.MAIN_CHECK2 = '$mainCheck2$'  

                    WHERE T.MAIN_ID = $mainId$ 

             ]]></update>

 

     <deleteid="deleteTemplate"parameterClass="java.util.HashMap">

           <![CDATA[

                  delete from IPTSM_TEMPLATEINFO where no = $no$

           ]]></delete>

 

     <selectid="getTemplateInfo"parameterClass="java.util.Map" resultClass="commonj.sdo.DataObject"  ">

         <![CDATA[

              SELECT NO,IDENTIFY,TITLE, FILENAME,TO_CHAR(MODIFYDATE,'yyyy-MM-dd HH24:mi:ss') MODIFYDATE

              from  IPTSM_TEMPLATEINFO  where identify = '$identify$'   AND  TITLE LIKE '%$title$%' order by  MODIFYDATE desc]]>

      </select>

 

     <procedure id="swapEmailAddresses" parameterMap="swapParameters">

             {call swap_email_address (?, ?)}

    </procedure>

将常用的或很复杂的工作，预先用SQL语句写好并用一个指定的名称存储起来,   那么以后要叫数据库提供与已定义好的存储过程的功能相同的服务时,只需调用execute,即可自动完成命令。

   存储过程的优点：

     1.存储过程只在创造时进行编译，以后每次执行存储过程都不需再重新编译，而一般SQL语句每执行一次就编译一次,所以使用存储过程 

        可提高数据库执行速度。

     2.当对数据库进行复杂操作时(如对多个表进行Update,Insert,Query,Delete时），可将此复杂操作用存储过程封装起来与数据库提供的

        事务处理结合一起使用。

     3.存储过程可以重复使用,可减少数据库开发人员的工作量

     4.安全性高,可设定只有某此用户才具有对指定存储过程的使用权

 

《二》parameterMap

parameterMap负责将对象属性映射成statement的参数。

     <parameterMap  id="parameterMapName"class="commonj.sdo.DataObject">

           <parameter property ="propertyName"

                    [jdbcType="VARCHAR"]属性javaType用于显式地指定被赋值参数的类型。如果没有提供类型将被假定为Object类型。

                      [javaType="string"]属性javaType用于显式地指定被赋值参数的类型。如果没有提供类型将被假定为Object类型。

                       [nullValue="NUMERIC"]属性nullValue的值可以是对于property类型来说任意的合法值，用于指定NULL的替换值。就是说，

                                                           当属性值等于指定值时，相应的字段将赋值NULL。这个特性允许在应用中给不支持null的数据类型

                                                         （即int，double，float等）赋值null。

                />

             <parameter ...... />

            <parameter ...... />

           </parameterMap>

括号[]是可选的属性。一个parameterMap可包含任意多的parameter元素。后面讨论parameter的各个属性。

《三》resultMap

在命名SQL框架中，Result Map是极其重要的组件。在执行查询Mapped Statement时，resultMap负责将结果集的列值映射成对象的属性值。resultMap的结构如下：

     <resultMap id="resultMapName"class="commonj.sdo.DataObject">

         <result property="propertyName"column="COLUMN_NAME"[columnIndex="1"]

                [javaType="int"] [jdbcType="NUMERIC"] [nullValue="-999999"] />

         <result .../>

         <result .../>

     </resultMap>

括号[]中是可选的属性。resultMap的id属性是唯一标识。ResultMap的class属性用于指定DataObject的类型名称（包括URI）。resultMap可以包括任意多的属性映射，将查询结果集的列值映射成DataObject的属性。属性的映射按它们在resultMap中定义的顺序进行。