2.??BM????

通常，一个典型的查询界面会列出一些字段，让用户输入条件，然后根据用户输入，列出符合条件的结果。BM的<query-fields<部分可以定义哪些字段是可用于查询的，以及查询条件是什么。在本例中：

    <bm:query-fields>
        <bm:query-field field="empno" queryOperator="="/>
        <bm:query-field field="deptno" queryOperator="="/>
        <bm:query-field field="employee_name" queryOperator="like"/>
        <bm:query-field name="hiredate_from" dataType="java.sql.Date" queryExpression="e.hiredate &gt; ${@hiredate_from}"/>
        <bm:query-field name="hiredate_to" dataType="java.sql.Date" queryExpression="e.hiredate &lt;= ${@hiredate_to}"/>
    </bm:query-fields>
		    

这里定义了5个查询字段。以第二个为例，指定字段deptno为查询参数，查询操作符为"="，即查询条件为deptno=（用户输入的值）。为测试这个查询字段的效果，我们在浏览器中输入：

		    [Web目录]/autocrud/test.emp_for_query/query?deptno=10
		    

可以看到，返回的查询结果是只包含deptno=10的emp记录：

{"result":{"record":[{"hiredate":"2011-07-26 00:00:00","comm":100,"empno":110,"job":"MANAGER","deptno":10,"manager_name":"BLAKE","department_name":"ACCOUNTING","mgr":7698,"sal":3000,"employee_name":"jack"},{"hiredate":"2011-06-20 00:00:00","comm":0,"empno":3287,"job":"mas","deptno":10,"manager_name":"test","department_name":"ACCOUNTING","mgr":3287,"sal":3000,"employee_name":"test"},{"hiredate":"1981-06-09 00:00:00","comm":550,"empno":7782,"job":"MANAGER","deptno":10,"manager_name":"dsf","department_name":"ACCOUNTING","mgr":7839,"sal":2695,"employee_name":"CLARK"},{"hiredate":"1982-01-23 00:00:00","empno":7934,"job":"1","deptno":10,"manager_name":"CLARK","department_name":"ACCOUNTING","mgr":7782,"sal":1300,"employee_name":"a%bc"},{"hiredate":"2011-07-26 00:00:00","comm":40,"empno":8000,"job":"masjs","deptno":10,"department_name":"ACCOUNTING","mgr":2,"sal":300,"employee_name":"sdf"}]},"success":true}		    
		    

如果再加上hiredate_from参数：

			[Web目录]autocrud/test.emp_for_query/query?deptno=10&hiredate_from=2011-1-1
		    

可以看到，返回结果进一步筛选，只返回deptno=10，并且hiredate在2011-1-1之前的记录。

{"result":{"record":[{"hiredate":"2011-07-26 00:00:00","comm":100,"empno":110,"job":"MANAGER","deptno":10,"manager_name":"BLAKE","department_name":"ACCOUNTING","mgr":7698,"sal":3000,"employee_name":"jack"},{"hiredate":"2011-06-20 00:00:00","comm":0,"empno":3287,"job":"mas","deptno":10,"manager_name":"test","department_name":"ACCOUNTING","mgr":3287,"sal":3000,"employee_name":"test"},{"hiredate":"1981-06-09 00:00:00","comm":550,"empno":7782,"job":"MANAGER","deptno":10,"manager_name":"dsf","department_name":"ACCOUNTING","mgr":7839,"sal":2695,"employee_name":"CLARK"},{"hiredate":"1982-01-23 00:00:00","empno":7934,"job":"1","deptno":10,"manager_name":"CLARK","department_name":"ACCOUNTING","mgr":7782,"sal":1300,"employee_name":"a%bc"},{"hiredate":"2011-07-26 00:00:00","comm":40,"empno":8000,"job":"masjs","deptno":10,"department_name":"ACCOUNTING","mgr":2,"sal":300,"employee_name":"sdf"}]},"success":true}		    
		    

每个<query-field>定义一个可以查询的字段。如果该字段是BM中已经定义过的字段，就设置field属性为字段的名称，例如<query-field field="deptno" />。如果查询参数的名字并不直接对应BM中已定义的字段，如上例中，我们要对hiredate字段进行区间查询，可能会输入hiredate_from和hiredate_to两个值，分别代表区间的上下限，而BM中并没有一个叫hiredate_from的字段。这时，就直接设置query-field的name属性。如果该参数不是字符串类型，还应设置datatype属性。

如果查询条件是简单的字段+操作符模式，可以设置query-field的queryOperator="操作符"。例如，queryOperator="="，代表字段="输入的值"；queryOperator=">="，代表字段>=输入的值。

如果查询条件比较复杂，不能简单地用某字段＝某值的方式来表达，可以用queryExpression来设定任意的SQL表达式或子查询语句。例如：

        <bm:query-field name="hiredate_from" dataType="java.sql.Date" queryExpression="e.hiredate &gt; ${@hiredate_from}"/>
		    

这个配置表示，如果用户提交参数中包含hiredate_from，就拼接 "hiredate > (用户输入的hiredate值) "这样一个查询条件。其中，${@hiredate_from}表示用户输入的名为hiredate_from的参数值，其完整XPath路径是${/parameter/@hiredate_from}，对于SQL查询操作来说，缺省的传入参数是/parameter，所以可以用相对路径@hiredate_from来表示。 在queryExpression中，如需使用基表字段，应注意使用别名，以避免多表关联时不同表存在同名字段，而引起的SQL错误。

再举一个自定义查询字段的例子，假设希望查到是管理者的员工，而管理者就是至少有一个员工的直接上级是其本人的员工。这个查询无法直接通过对基表字段的筛选来完成，需要使用SQL子查询，例如：

		    select ... from emp e where exists ( select 1 from emp e1 where e1.mgr = e.empno )
		    

那么，我们可以定义一个名为is_manager的参数，如果这个参数传递了值，就在构造上述子查询条件：

        <bm:query-field name="is_manager" queryExpression="exists ( select 1 from emp e1 where e1.mgr = e.empno )"/>
		    

很多时候，我们需要对查询SQL添加一些限制性的条件。例如，当前用户只能看他所在的部门的员工，或者只列出状态不等于作废的订单。不论用户输入什么查询参数，这些限制条件都是必须加上的。这时，我们可以配置BM的<data-filters>标记，添加必需的数据筛选条件：

		    <bm:data-filters>
		        <bm:data-filter enforceOperations="query" expression="e.hiredate is not null"/>
		    </bm:data-filters>
		    

这表示，在执行查询的时候，e.hiredate is not null这个条件将会被无条件地加上。如果我们传递一个deptno=10的查询条件，可以看到对该BM执行query操作时候，实际拼接的SQL语句是：

			SELECT e.empno,e.ename AS employee_name,e.job,e.mgr,e.hiredate,e.deptno,e.sal,e.comm,d.dname AS department_name,m.ename AS manager_name
			FROM EMP e
				LEFT OUTER JOIN dept d ON e.deptno = d.deptno
				LEFT OUTER JOIN EMP m ON e.mgr = m.empno and m.deptno is not null
			WHERE e.hiredate is not null AND e.deptno = ?
		    

如果有多个限制条件，可以设置多个data-filter标记，每一个data-filter设置的expression属性会用and连接起来，再与可选查询条件做and连接，形成最终的where从句。

缺省状况下，限制条件会被拼接到所有可包含where从句的SQL操作中，包括update，delete。这样可以实现比较严密的记录级权限控制。例如，要求用户只能操作自己创建的订单，可以设置created_by=${/session/@user_id}。即使用户执行update操作，提交了一个别人创建的订单号，后台所执行的SQL语句将类似于：

		    update ord_order set .... where order_id=${/parameter/@order_id} and created_by=${/session/@user_id}
		    

由于where从句的表达式不成立（其他人创建的订单，created_by不等于当前用户id），最终也不会有记录被更新。

如果希望某些限制条件只在特定操作时执行，例如只在select中出现，不在update中出现，或者只在select,update中出现，不在delete中出现，那么可以用enforceOperations属性，设定该data-filter希望被使用的操作，用逗号分隔每一个操作，如：enforceOperations="query,update"

在以autocrud方式执行BM的查询时，可通过传递特定的参数，来控制查询结果是否要分页，以及分页的配置

例如，在浏览器中输入以下地址：

	            [Web目录]/autocrud/test.emp_for_query/query?pagenum=2&pagesize=3&_autocount=true	
			    

即表示，按每页3条记录，返回第2页的数据，并自动统计记录总数。返回结果如下：

				{"result":
					{"record":
						[
							{"hiredate":"1981-02-22 00:00:00","comm":500,"empno":7521,"job":"SALESMAN","deptno":30,"manager_name":"BLAKE","department_name":"SALES","mgr":7698,"sal":1375,"employee_name":"WARD"},
							{"hiredate":"2007-09-01 00:00:00","comm":1400,"empno":7654,"job":"SALESMAN","deptno":30,"manager_name":"BLAKE","department_name":"SALES","mgr":7698,"sal":1250,"employee_name":"MARTIN"},
							{"hiredate":"1981-09-08 00:00:00","comm":0,"empno":7844,"job":"SALESMAN","deptno":30,"manager_name":"BLAKE","department_name":"SALES","mgr":7698,"sal":1650,"employee_name":"TURNER"}
						],
					"totalCount":17
					},
				 "success":true
				}
			    

例如，在浏览器中输入以下地址：

	            [Web目录]/autocrud/test.emp_for_query/query?ORDER_FIELD=employee_name&ORDER_TYPE=desc	
			    

查看执行日志，生成的SQL将是：

				SELECT e.empno,e.ename AS employee_name,e.job,e.mgr,e.hiredate,e.deptno,e.sal,e.comm,d.dname AS department_name,m.ename AS manager_name
				FROM EMP e
					LEFT OUTER JOIN dept d ON e.deptno = d.deptno
					LEFT OUTER JOIN EMP m ON e.mgr = m.empno and m.deptno is not null
				WHERE e.hiredate is not null
				ORDER BY ename desc
			    

此外，也可以在BM上设置defaultOrderBy属性，如果客户端没有传递排序相关的参数，就使用这个属性设置的表达式，来构造order by部分。例如：

				<bm:model defaultOrderBy="deptno asc,employee_name desc">
				...
				</bm:model>
			    

这样，如果直接访问该BM的/query方法，生成的的SQL将包含：ORDER BY deptno asc,employee_name desc

和常规BM一样，自定义SQL也可以定义query-fields及data-filters，来使用可选查询参数和必须的限制条件。所不同的是，如果使用了这些设置，在SQL语句中不能直接出现where部分，而是要用#WHERE_CLAUSE#来标记SQL语句中准备放入where从句的位置。Aurora将根据data-filters和query-fields的设置，先后添加必需的数据筛选条件，以及可选的查询条件，自动生成where部分，再替代#WHERE_CLAUSE#。

在自定义SQL中，如果希望能够像常规BM一样，根据客户端传递的参数来动态排序，就在SQL语句中使用#ORDER_BY_CLAUSE#来标记order by从句放置的地方。如果查询参数中传递了ORDER_FIELD,ORDER_TYPE字段，或者设置了BM的defaultOrderBy属性，Aurora将会自动生成order by从句，替换#ORDER_BY_CLAUSE#标记。

如果访问地址：

			[Web目录]/autocrud/test.emp_summary/query?deptno=10&ORDER_FIELD=total_employee&ORDER_TYPE=asc
			

生成的SQL将是：

		     select  
		      decode(grouping(e.job),0,d.dname,1,d.dname||' Total:') as department_name,
		      e.job,
		      count(e.empno) as total_employee, 
		      sum(e.sal) as total_salary
		    from   emp e, dept d
		     WHERE e.deptno = d.deptno AND d.deptno=?
		    group by    rollup(d.dname, e.job)
		    ORDER BY total_employee asc
			

其中，#WHERE_CLAUSE#和#ORDER_BY_CLAUSE#经过框架自动处理，将被替代为实际的SQL语句。