OAF_VO系列3 - Binding Style绑定方式

在OAF VO开发中，Binding Style主要用于对VO的where clause做动态传值，总共有三种方式

1.       Oracle Named

2.       Oracle Positional

3.       JDBC Positional

Oracle Positional

Oracle Positional 是最常用的一种方式，Oracle文档的介绍是

This style represents parameters as colons followed by numbers, as in the following code fragment:WHERE bar = :1 AND foo = :2 In this style, the numbers are just for easier readability: Parameters are passed into the view object in the order in which the numbers occur. The above fragment, for example, is equivalent to WHERE bar = :70 AND foo = :3

简单来说,这种方式中的参数都是以‘:’和数字来声明的，比如：WHERE bar = :1 AND foo = :2。这种方式来说，数字只是用来增加可读性，参数只会根据数字在VO Sql Statement中出现的顺序传入到View Object中，而不会根据数字的大小而传入。比如，上面的代码片段和下面这个是一样的效果WHERE bar = :70 AND foo = :3，下面会在实现中具体介绍。

如何在VO使用Oracle Positional绑定方式

首先，我们需要在VO定义界面上进行设置，

1.       Binding Style 设成 Oracle Positional

2.       在VO SQL Statement 中的where clause里面使用 ‘:’加上数字作为参数，比如 :1.

在VO上设置完之后，我们需要执行VO查询之前，使用vo.setWhereClauseParam(int index, Object value)对VO的绑定参数进行赋值，如下面的代码。

public void initShipToLocation(String org_id)

{

RcvShipToLocationVOImpl vo =this.getRcvShipToLocationVO1();

vo.setWhereClause(null);

vo.setWhereClauseParam(0, new Number(Integer.parseInt(org_id)));

}

 

 

使用Oracle Positional 绑定方式需要注意的问题

1.         在使用vo.setWhereClauseParam(int index, Object value)进行赋值的时候， index一定是从0开始的,接着就是1,2,3，…… .但是在VO SQL Statement中，参数却不是必须从0开始，而且后面的参数的数值也不必比前面的大。比如下面的也是可以的，

但是在使用vo.setWhereClauseParam（）给VO绑定参数值的时候一定要使用0和1作为index,而且index必须和绑定参数在VO SQL Statement中出现的顺序对应的类型一致，比如

public void initShipToLocation(String org_id)

{

RcvShipToLocationVOImpl vo =this.getRcvShipToLocationVO1();

vo.setWhereClause(null);

vo.setWhereClauseParam(0, new Number(Integer.parseInt(org_id)));

vo.setWhereClauseParam(1, "hello");

}

如果使用了其它的任何的Index，就会抛出下面的异常（无效的列索引）

oracle.apps.fnd.framework.OAException: oracle.jbo.SQLStmtException: JBO-27122:Invalid column index …..

2.         如果在VO SQL Statement中使用了：加数字作为绑定参数，并且在给VO设置绑定值的时候使用了vo.setWhereClauseParam（），那么一定要保证VO的绑定方式(Binding Style)为 Oracle Positional,否则可能会出现下面的异常(无效的列类型)

oracle.apps.fnd.framework.OAException: oracle.jbo.SQLStmtException: JBO-27122:Invalid column type …..

3.         如果VO SQL Statement中两个或多个绑定参数每次一定是一样的值传入，在VO SQL Statement虽然可以使用相同的数字作为绑定参数，但在使用vo.setWhereClauseParam（）设置绑定值的时候也要分别设值，而且建议不要使用相同的数字作为绑定参数。

public void initShipToLocation(String org_id)

{

RcvShipToLocationVOImpl vo =this.getRcvShipToLocationVO1();

vo.setWhereClause(null);

vo.setWhereClauseParam(1, "hello");

vo.setWhereClauseParam(2, "hello");

vo.setWhereClauseParam(0, new Number(Integer.parseInt(org_id)));

}

否则VO在执行查询的时候会报下面的错误

java.sql.SQLException: 索引中丢失  IN 或 OUT参数:: 8

Oracle Named

Oracle Named 绑定方式是VO定义中的默认方式，也是非常常用的一种方式，Oracle文档的介绍是

This style represents parameters as colons followed by identifiers, as in the following code fragment:WHERE bar = :barparam AND foo = :fooparam Unlike the positional styles, the names of the parameters are actually used when the application fills the parameter values.

顾名思义，Oracle Named方式就是‘：’和名字的方式来表示参数，而不是像Oracle Positional用数字.这种方式的好处就是相同的参数可以使用同一个名字，在VO初始化参数的时候对相同名字的参数只用初始化一次就可以了，在下面的实现中会具体介绍.

如何在VO使用Oracle Named绑定方式

首先，我们需要在VO定义界面上进行设置，

1.       在Bind Variable 页面上定义要在VO SQL Statement中使用的绑定参数的名字，类型和默认值。

2.       在VO SQL Statement页面上设置Binding Style为 Oracle Named.

3.       在VO SQL Statement 中的where clause里面使用 ‘:’加上Bind Variable中定义的Bind variable作为参数，比如 :inv_org_id,而且这些参数我们可以使用多次。

在VO定义上设置完之后，我们需要执行VO查询之前，使用vo.setNamedWhereClauseParam(String name, Object value)对VO的绑定参数进行赋值，如下面的代码。

public void initRcvSubinventory(String orgId, String itemId, String receiptSourceCode)

{

RcvSubinventoryLovImpl vo =this.getRcvSubinventoryLov1();

vo.setWhereClause(null);

vo.setWhereClauseParams(null);

vo.setNamedWhereClauseParam("inv_org_id", orgId);

vo.setNamedWhereClauseParam("rcv_item_id", itemId);

vo.setNamedWhereClauseParam("receipt_source_code", receiptSourceCode);

}

使用Oracle Named 绑定方式需要注意的问题

1.       在使用Oracle Named绑定方式的时候一定要声明Bind Variable,如果没有声明就在VO SQL Statement中使用，在运行时就会出现下面的错误.

(oracle.jbo.SQLStmtException) JBO-27122: SQL error during statement preparation.

## Detail 0 ##

(java.sql.SQLException) Missing IN or OUT parameter at index:: 1

2.       相反，如果定义了Bind Variable, 但是在VO SQL Statement中没有使用他，或者定义的类型错误，在运行时就会抛出下面的错误

oracle.jbo.SQLStmtException: JBO-27122: SQL error during statement preparation.

## Detail 0 ##

java.sql.SQLException: Attempt to set a parameter name that does not occur in the

SQL: inv_org_id

3.       如果在定义Bind Variable的时候没有指定默认值，而且在运行时没有使用vo.setNamedWhereClauseParam()初始化Bind Variable,那么Bind Variable默认将会使用NULL值.但一般情况下，NULL不是用户需要的，请记得设置默认值或者运行时为Bind Variable指定值。

JDBC Positional

这种绑定方式在EBS OAF开发中是不常见的，因为Oracle文档中是这么介绍的

This style represents parameters as question marks, as in the following code fragment:WHERE foo = ? AND bar = ?. This should be used only if you are working with non-oracle database.

因为EBS应该没有使用非ORACLE数据库的，所以应该在OAF开发中是用不到的，但是在ADF开发中应该是用得到的，但这个不在我们今天讨论的范围之内。

参考：Tavor - http://blog.csdn.net/tavor/article/details/17199223