EBS中Java并发程序笔记（1）

      在Oracle EBS中的Java并发程序（Java Concurrent Program）是系统功能中的一个亮点，它的出现使得用户可以在ERP系统中运行自己定义的Java程序。本文为学习笔记，所以不会介绍太多背景知识。

     使用Java并发程序的好处：

     当遇到如下2种情况的时候，用PLSQL程序包来完成将无比麻烦：

     1、将服务器上的文件通过FTP安全有效的导入到apps环境下

     2、使用JDBC连接一个非Oracle的数据库，并获取里面的数据，通过验证和转换导入到apps下的客制化表。对于上述假定，需要DBA建立透明网关，对于如此简单的需求将会做复杂的设置。

      综上所述，可以在EBS中使用Java并发程序来解决这些事情。

      如下为一个简单的例题并做简单说明：

import oracle.apps.fnd.cp.request.*;
import oracle.apps.fnd.util.*;

//如果是测试Java并发程序，则新建一个class实现JavaConcurrentProgram 这个interface

public class MainTest implements JavaConcurrentProgram {

    //实现interface中的runProgram方法
    public void runProgram(CpContext ctx) {

        //取得并发程序传入的参数列表
        ParameterList lPara = ctx.getParameterList();
        ReqCompletion lrc = ctx.getReqCompletion();
        try
        {

            //把参数名字和参数的值分别在log和output中打印出来
            while(lPara.hasMoreElements())
            {
                NameValueType nvt = lPara.nextParameter();
                ctx.getOutFile().writeln(nvt.getName() + ":" + nvt.getValue());
                ctx.getLogFile().write(nvt.getName() + ":" + nvt.getValue(), LogFile.STATEMENT);
            }

             //完成打印的步骤后，设置程序的结束状态为Normal，如果这个步骤不做，虽然程序没有错误，但是执行结果还是会报错的
            lrc.setCompletion(ReqCompletion.NORMAL, "Normal Ending");
        }
        catch(Exception e)
        {

            //如果程序出现异常，设置程序的执行结果，本来是应该设置ERROR的
            ctx.getLogFile().write(e.toString(), LogFile.STATEMENT);
            lrc.setCompletion(ReqCompletion.WARNING, "Exception Occurs!!!");
        }
    }
} 

把程序挂到EBS中后，执行结果如下图所示：

log中显示如下（因为log中程序没有换行，所以写到了一行里面）：

output中因为换行的原因，格式与log中的有一点不同，如下所示（左半部分为输入的参数的说明，右半部分则为程式打印的output）：