在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. OAF_VO系列3 - Binding Style绑定方式_初始化


在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开始，而且后面的参数的数值也不必比前面的大。比如下面的也是可以的，

OAF_VO系列3 - Binding Style绑定方式_oracle_02

但是在使用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（）设置绑定值的时候也要分别设值，而且建议不要使用相同的数字作为绑定参数。

OAF_VO系列3 - Binding Style绑定方式_sql_03




  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中使用的绑定参数的名字，类型和默认值。

 OAF_VO系列3 - Binding Style绑定方式_oracle_04

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

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

OAF_VO系列3 - Binding Style绑定方式_OAF_05

在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开发中应该是用得到的，但这个不在我们今天讨论的范围之内。