日期:2014-05-16  浏览次数:20884 次

ECSide核心模块介绍之:EasyDataAccess,数据存取模块.
ECSide 里加入了 easyList特性。可以通过在xml里配制sql语句来快速的展现列表。

最近我将该功能模块进行了重构,使其可以脱离ecside来使用,从而可以用来简化其他的数据库操作。

具体用法结合下面的例子来讲解:

示例 :
对 USER_INFO 表进行查询。 查询条件为 USERNAME GENDER。

第1步:定义spring文件:
    <bean id="testQuery1" class="org.ecside.easyda.DataAccessModel">
    <!-- 注入一个标准的数据源 -->
	<property name="dataSource" ref="test_datasource" />
        <property name="sqls">
            <map>
	     <!-- 这个key的名字随便取 -->
                <entry key="queryInfoByNameGender" >
			<value>
				select * from user_info 
				where 1=1 
				#{IF:USERNAME!=EMPTY} and username like #{USERNAME} #{/IF}
				#{IF:GENDER!=EMPTY} and gender=#{GENDER} #{/IF}
			</value>
		</entry>

            </map>
        </property>
    </bean>

第2步,在适当的位置(如BO中)执行下列java代码

// 这里也可以使用 Ioc 注入。
DataAccessModel dam=(DataAccessModel)factory.getBean("testQuery1");
//parameterMap为传入参数,key为USERNAME GENDER。
List list=(List)dam.executeQuery("queryInfoByNameGender", parameterMap);

ok,执行完了,执行的每条结果会放入MAP,所有的MAP最后放入LIST
Map的Key是SQL语句执行结果的各个列的名字。

其中 #{USERNAME} #{GENDER} 为参数在传入的参数Map中的key.

其中 #{IF..} 字句用来拼装SQL.。
其语义为 如果满足条件 就把IF内的字符串拼接到有效的SQL语句中。
支持简单的条件:
A<B :   #{IF:A#{_L}B}....{/IF}
A>B :   #{IF:A#{_G}B}....{/IF}
A=B :   #{IF:A=B}....{/IF}
A!=B :   #{IF:A!=B}....{/IF}
A<=B :   #{IF:A#{_L}=B}....{/IF}
A>=B :   #{IF:A#{_G}=B}....{/IF}

A为参数(的KEY), B为数值,可以是EMPTY NULL 字符串 数字 等如
#{IF:USERNAME!='admin'}....{/IF}
#{IF:AGE #{_L}= 18}....{/IF}

注意 < >于号出现在 sql语句中时也请使用 #{_L} #{_G}
#{IF:A=B}....{/IF} 内部 可以是任何语句,也可以使用任何参数。不一定非要是A.
例如 这样也是可以的
#{IF:USERROLE='1'}  and (GENDER = ${XXXX} or AGE ${_L} 25 {/IF}

传入参数可以使用组件中提供的getParameterMap方法从request中自动生成,相应的代码很简单:
	public static Map getParameterMap(HttpServletRequest request) {
		Map parameterMap = new HashMap();
		Enumeration names = request.getParameterNames();
		while (names.hasMoreElements()) {
			String name = (String) names.nextElement();
			String[] s = request.getParameterValues(name);
			if (s != null) {
				if (s.length == 1) {
					parameterMap.put(name, request.getParameterValues(name)[0]);
				} else {
					parameterMap.put(name, request.getParameterValues(name));
				}
			}
		}
		return parameterMap;
	}


如果查询叶面的input区域是
姓名:<input type="text" name="i_user_name">
性别:<input type="text" name="i_user_gender">
通过 getParameterMap 取得参数map后,如果想直接调用sql

那么sql需要改动为
<entry key="queryInfoByNameGender" >
	<value>
		select * from user_info 
		where 1=1 
		#{IF:i_user_name!=EMPTY} and username like #{i_user_name} #{/IF}
		#{IF:i_user_gender!=EMPTY} and gender=#{i_user_gender} #{/IF}
	</value>
</entry>



一个DataAccessModel bean里可以写入多个sql.
可以是 delete update insert select  {call...
例如下面这个
    <bean id="myEasyDA" class="demo.MyDataAccessModel">
		<property name="dataSource" ref="test_datasource" />
        <property name="sqls">
            <map>
	      <entry key="baseInfo1" >
			<value>
				{call CM_CUST_REAL_INFO_P(
					#{I_SERVICE_KIND},
					#{I_SERVICE_NO},
					#{I_CITY_CODE},
					#{I_SERVICE_ID},
					#{I_CUSTOMER_ID},

					#{OUT:OUT_F_CUST_NAME},
					#{OUT:OUT_F_GENDER},
					#{OUT:OUT_F_DUTY},
					#{OUT:OUT_F_PRODUCT_NAME},
					#{OUT:OUT_F_POINT_VALUE},
					#{OUT:OUT_F_STATUS},
					#{OUT:ON_FLAG},
					#{OUT:OS_PROMPT}
				)}
			</value>
		</entry>
                <entry key="updateUser" >
					<value&