Java通过Jolt调用Tuxedo服务

Java通过Jolt调用Tuxedo服务

草木瓜 2006-6-1

------------------------
一、简介
------------------------

外部应用访问Tuxedo服务是很经常的事,一般有两种方法WTC和Jolt,网上很多关于Jolt调用Tuxedo服务
文章,描述的太多笼统,其实通过Jolt并不是很复杂的事情,这里使用Eclipse3.1+Jolt+WebLogic8.1
+Tuxedo9.0环境描述调用服务的全过程。

Jolt是Bea Tuxedo自带的jar组件,在Tuxedo9.0的安装过程中可以看到安装的Jolt组件。

调用服务理论步骤是这样的:

1.先准备Tuxedo服务端代码
2.在Tuxedo中配置Jolt相关文件
3.启动Tuxedo服务
4.配置WebLogic服务与Tuxedo Jolt相关的参数
5.配置Eclipse3.1启动WebLogic服务
6.编写Eclipse Servlet代码,运行调用服务。

本例使用了《Windows Tuxedo的安装配置-数据库补充》一文中的Tuxedo数据服务文件,所以在启动
Tuxedo服务前,必须先启动数据库实例,因为在tpsvinit()里面就配置了数据连接。关于Tuxedo配置
要点需参阅《Tuxedo的安装配置-...》的四篇文章。

------------------------
二、Tuxedo服务文件全代码
------------------------

这里把server.pc服务文件代码再次列出。其中包括三个服务DBREAD(读数据库)和TOUPPER(转换大写)。
本例不使用TOUPPER,所以不用理会那段代码。

其中liwei/liwei@windb连接的表tuxedo_test,结构如下:

CREATE TABLE TUXEDO_TEST(
ID                        NUMBER(2),
NAME                      VARCHAR2(10)
)

ID            NAME
------------------------
1             aaaaaaa
2             bbbbbbb

#include <stdio></stdio>
#include <ctype></ctype>
#include <atmi></atmi> /* TUXEDO Header File */
#include <userlog></userlog> /* TUXEDO Header File */

EXEC SQL BEGIN DECLARE SECTION;
VARCHAR ora_no[2];
int ora_id;
VARCHAR ora_value[10];
VARCHAR ora_cn[30];
EXEC SQL END DECLARE SECTION;
EXEC SQL INCLUDE sqlca;

tpsvrinit()
{
  strcpy(ora_cn.arr,"liwei/liwei@windb");
  ora_cn.len = strlen(ora_cn.arr);
  ora_cn.arr[ora_cn.len]='\0';

  //EXEC SQL WHENEVER SQLERROR GOTO cnError;
  EXEC SQL CONNECT :ora_cn;
  return(0);
}
tpsrvdone()
{
  EXEC SQL COMMIT WORK RELEASE;
}

DBREAD(TPSVCINFO *rqst)
{
 
 strcpy(ora_no.arr,(char *)rqst->data);
 ora_no.len=strlen(ora_no.arr);
 ora_no.arr[ora_no.len]='\0';

 userlog("ERRSRV: %s",ora_no.arr);
 EXEC SQL select name into :ora_value from tuxedo_test where id=:ora_no;
 if(sqlca.sqlcode!=0)
 {
  userlog("ERRSRV: select name from tuxedo_test where id=, sqlcode=%ld , sqlerr=\n",sqlca.sqlcode);
  strcpy(rqst->data,sqlca.sqlerrm.sqlerrmc);
  tpreturn(TPFAIL, 0, rqst->data, 0L, 0);
 }

 /* Return the transformed buffer to the requestor. */
 strset(rqst->data,"");
 strcpy(rqst->data,ora_value.arr);
 tpreturn(TPSUCCESS, 0, rqst->data, 0L, 0);
}

TOUPPER(TPSVCINFO *rqst)
{

 int i;

 for(i = 0; i < rqst->len-1; i++)
  rqst->data[i] = toupper(rqst->data[i]);

 /* Return the transformed buffer to the requestor. */
 tpreturn(TPSUCCESS, 0, rqst->data, 0L, 0);
}

------------------------
三、编译服务
------------------------

编译命令的注意事项,以前Tuxedo系列文章都提过。

proc server.pc include=%TUXDIR%\include
buildserver -o server -f server.c -s DBREAD -s TOUPPER -v -l orasql9.lib

------------------------
四、配置Tuxedo服务的config文件
------------------------

完全文件如下:

#Liwei

*RESOURCES
IPCKEY  123456
DOMAINID liweiapp
MASTER  lw
MAXACCESSERS 150
MAXSERVERS 100
MAXSERVICES 100
MODEL  SHM
LDBAL  N

*MACHINES
LWYM
 LMID = lw
 TUXDIR = "E:\bea\tuxedo9.0"
 TUXCONFIG = "G:\Liwei\Tuxedo\dbread\tuxconfig"
 APPDIR = "G:\Liwei\Tuxedo\dbread"
 MAXWSCLIENTS=1
 TLOGDEVICE = "G:\Liwei\Tuxedo\dbread\TLOG"
 TLOGNAME=TLOG
 TLOGSIZE = 100
 
*GROUPS

APPGRP LMID=lw GRPNO = 1

#OPENINFO="Oracle_XA:Oracle_XA+Acc=P/liwei/liwei+SqlNet=linux+SesTm=600+MaxCur=5+LogDir=."
#TMSNAME="TMS_ORA9i" TMSCOUNT=2

JSLGRP  LMID=lw GRPNO = 2             
JREPGRP LMID=lw GRPNO = 3             

*SERVERS
server SRVGRP=APPGRP SRVID=1

#WSL SRVGRP=APPGRP SRVID =300
#CLOPT="-A -- -n //192.168.0.166:8888 -d/dev/tcp -m1 -M5 -x 10"

JSL SRVGRP=JSLGRP SRVID=301
CLOPT="-A -- -n //192.168.0.166:9878 -M 10 -x 10 -m 2"

JREPSVR SRVGRP=JREPGRP SRVID=302
CLOPT="-A -- -W -P E:\bea\tuxedo9.0\udataobj\jolt\repository\jrepository"

*SERVICES
DBREAD
TOUPPER

细心一看,这个config文件比在*GROUPS和*SERVERS各加了两项对应内容:

JSLGRP  LMID=lw GRPNO = 2             
JREPGRP LMID=lw GRPNO = 3    

JSL SRVGRP=JSLGRP SRVID=301
CLOPT="-A -- -n //192.168.0.166:9878 -M 10 -x 10 -m 2"
JREPSVR SRVGRP=JREPGRP SRVID=302
CLOPT="-A -- -W -P E:\bea\tuxedo9.0\udataobj\jolt\repository\jrepository"

这两项是用于jolt的访问接口。JSL和JREPSVR必须是独自的GROUP,由于外部调用通过JSL和JREPSVR直接于
Tuxedo服务通信,WSL就没用了。JSL的主机地址是Tuxedo服务器地址,端口是随意指定的,不要与其他重复
即可,一般设置的大一点。在config里面加入这此内容后,config文件就Ok了。

------------------------
五、配置jrepository文件
------------------------

直接打开E:\bea\tuxedo9.0\udataobj\jolt\repository\jrepository文件添加以下内容:

add SVC/DBREAD:vs=1:ex=1:bt=STRING:\
 bp:pn=STRING:pt=string:pf=167772161:pa=rw:ep:
add PKG/SIMPSERV:DBREAD:

这个文件如果没有DBREAD配置,调用会提示DBREAD not avaliable,DBREAD配置错误,会提示DBREAD has
been modifed ...

对这个文件操作还有以下两种方式:

方式一:在IE打开E:\bea\tuxedo9.0\udataobj\jolt\RE.html,是个java applet,里面是图形界面,添加
 完服务,设置好参数即可。具体方法可以查阅网上资料,有图文解说的。
方式二:在命令行键入Java bea.jolt.admin.jbld //192.168.0.166:9878 services.rep,其中//192..要与
JSL的设置一致。services.rep是随意的一个文件,不过文件内容绝对不随意,如下:

service=DBREAD
inbuf=STRING
outbuf=STRING
export=true
param=STRING
type=string
access=inout

要执行这个命令设置jdk环境变量是必不可少的,PATH,CLASSPATH。我的CLASSPATH加入了以下内容,
E:\bea\tuxedo9.0\udataobj\jolt\joltwls.jar;
E:\bea\tuxedo9.0\udataobj\jolt\joltjse.jar;
E:\bea\tuxedo9.0\udataobj\jolt\jolt.jar;
E:\bea\tuxedo9.0\udataobj\jolt\joltadmin.jar
个人认为对于这个java命令joltadmin是必须的,其他三个没用,不过没有亲自尝试。

方式一,二修改后,jrepository文件会显得比较乱,所以我不喜欢!最好是自已手工修改。


------------------------
六、编译启动服务
------------------------

当然,数据库必须要有了,编译config后,启动tuxedo服务。
tmloadcf -y config
tmboot -y

提示如下:

exec BBL -A :
        process id=3520 ... Started.

Booting server processes ...

exec server -A :
        process id=3812 ... Started.
exec JSL -A -- -n //192.168.0.166:9878 -M 10 -x 10 -m 2 :
        process id=252 ... Started.
exec JREPSVR -A -- -W -P E:\bea\tuxedo9.0\udataobj\jolt\repository\jrepository :

        process id=2920 ... Started.
4 processes started.


------------------------
七、配置Eclipse3.1
------------------------

我们要在Eclipse里面启动WebLogic服务,《Eclipse3.1 Web开发配置》一文中已经说明了,如何配置
WebLogic8.1的服务器,这里对WebLogic的服务本身也要做此必要的配置。

打开选用的WebLogic8.1服务路径,编辑config.xml文件,本机位置G:\Liwei\WebLogic\WebServer\config.xml。
加入如下内容:

    <joltconnectionpool failoveraddresses="//192.168.0.166:9878"></joltconnectionpool>
        MaximumPoolSize="2" MinimumPoolSize="1" Name="JoltPool"
        PrimaryAddresses="//192.168.0.166:9878"
        SecurityContextEnabled="false" Targets="webServer"/>
    <startupclass></startupclass>
        ClassName="bea.jolt.pool.servlet.weblogic.PoolManagerStartUp"
        LoadBeforeAppActivation="true" Name="MyStartup" Targets="webServer"/>
    <shutdownclass></shutdownclass>
        ClassName="bea.jolt.pool.servlet.weblogic.PoolManagerShutDown"
        Name="MyShutdown" Targets="webServer"/>
       
这里要说明一下:PrimaryAddresses,FailoverAddresses地址是前面Tuxedo配置文件指定的JSL地址和端口
SecurityContextEnabled一定要是false!所有name是随意的,StartupClass和ShutdownClass的ClassName
绝对不能错!

除此方法,还可以通过Weblogic服务的控制台进行管理。启动服务后,在http://localhost:7001/console/
登陆后的主页面上选择 连接性->通过 JOLT 的 Tuxedo  ->配置新的Jolt 连接缓冲池...输入参数内容就是
上面config.xml的参数。另外首页中 已部署的资源 ->启动和关闭 需要设置两个Class,参数也同上。


连接性->通过 JOLT 的 Tuxedo  ->配置新的Jolt 连接缓冲池...

①进入选项卡的General(常规),输入参数:
Name:   JoltPool
Minimum Pool Size:  1
Maximum Pool Size:   2
Recv Timeout:  0
点击Apply应用按纽
②进入选项卡的Addresses(地址),输入参数:
Primary Addresses: //192.168.0.166:9878
Failover Addresses: //192.168.0.166:9878
点击Apply应用按纽
③进入Targets栏:
选中myserver
点击Apply应用按纽.

已部署的资源 ->启动和关闭 分别配置StartUp,ShutDown的Class

①进入Configuration(设置)
在ClassName:中输入: bea.jolt.pool.servlet.weblogic.PoolManagerStartUp,
其它采用默认值。
②进入Targets(目标)栏:
选中myserver,点击Apply应用按纽.

①进入Configuration(设置)
在ClassName:中输入: bea.jolt.pool.servlet.weblogic.PoolManagerShutDown,
其它采用默认值。
②进入Targets(目标):
选中myserver,点击Apply应用按纽.

到这里config.xml文件就设置完了,下面需要编辑startWebLogic.cmd,加入对jolt jar的引用,否则jolt
是启动失败的。在echo CLASSPATH=%CLASSPATH%前加入以下代码,设置CLASSPATH,这里classpath跟外部环境
变量是两码事。

set CLASSPATH=%CLASSPATH%;E:\bea\tuxedo9.0\udataobj\jolt\jolt.jar;E:\bea\tuxedo9.0\udataobj\jolt\joltwls.jar;E:\bea\tuxedo9.0\udataobj\jolt\joltjse.jar

设置完后,重启服务,在Eclipse管理WebLogic服务时如果出现启动关闭不成功,多试几次就可以了。
在启动的console界面里如果出现以下内容,就说明jolt pool启动成功!

<2006-6-1> <notice></notice><weblogicserver></weblogicserver><bea-000327></bea-000327><starting server="" admin="" weblogic=""></starting>
Jolt pool deployed for webServer
<2006-6-1> <notice></notice><security></security>...


------------------------
八、Eclipse3.1编写Servlet代码
------------------------

首先需要在所建工程->右键->Properties->Java BuildPath ->Library->Add External jars ..添加jolt的jar包
这里需要三个jar包,如下:
E:\bea\tuxedo9.0\udataobj\jolt\jolt.jar
E:\bea\tuxedo9.0\udataobj\jolt\joltjse.jar
E:\bea\tuxedo9.0\udataobj\jolt\joltwls.jar
 
添加jar完后,建立一个主页面index.jsp和一个Servlet。关于Eclipse3.1配置Servlet在《Eclipse3.1 Web开发配置》
一文也有说明。这里Servlet名为liwei.java,具体内容如下:

index.jsp


<form name="form1" action="liwei" method="post" id="form1">


</form>

说明:name要是STRING,用来传递参数,action是liwei.java即Servlet。

liwei.java


 public class liwei extends javax.servlet.http.HttpServlet 
 {
 
 //声明管理连接池的变量
 private bea.jolt.pool.servlet.ServletSessionPoolManager bool_mgr = (bea.jolt.pool.servlet.ServletSessionPoolManager) bea.jolt.pool.SessionPoolManager.poolmgr;

 public void init(javax.servlet.ServletConfig config) throws javax.servlet.ServletException
 {
  //初始化servlet
  super.init(config);
 }
   
 public void destroy() {
  //关闭servlet
  bool_mgr = null;
 } 
 
 protected void doGet(javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response)
 throws javax.servlet.ServletException, java.io.IOException
 {
  
  bea.jolt.pool.servlet.ServletResult result;
  
  //设置页面类型,如果没有charset,显示汉字会乱码
  response.setContentType("text/html;charset=UTF-8");
  
  java.io.PrintWriter out =response.getWriter();
  out.println("");
  out.println("");
  
  //System.out.println("TEST________________________1");

   //获取在WebLogic服务定义好的连接池,JoltPool
   bea.jolt.pool.servlet.ServletSessionPool pool_session = (bea.jolt.pool.servlet.ServletSessionPool)
   bool_mgr.getSessionPool("JoltPool");

    if (pool_session == null) {
      out.println("获取Tuxedo服务失败。"+
                  "
"+
                  "确认Tuxedo服务已启动且配置正确。"+
                  "");
      out.close();
      return;
    }
    System.out.println(pool_session);
    
    String sendvalue;
    sendvalue=request.getParameter("STRING");
    System.out.println(sendvalue);
    
    // 调用服务
    try
    {
     System.out.println("OK!");
     
     //调用服务DBREAD
      result = pool_session.call("DBREAD", request);
      out.println("传递的参数 = " + sendvalue);
      out.println("Tuxedo服务成功调用。 ");
     
      //跟据传递的变量STRING值,获取返回值
      out.println("返回值:"+result.getValue("STRING", ""));
    }
    catch (bea.jolt.pool.SessionPoolException e)
    {
      // 连接池繁忙
      out.println("此时请求不能被处理。\n"+
                  "错误信息: "+e.getMessage()+"\n"+
                  "可能的原因:1.无效的连接池 2.连接池已关闭");
    }
    catch (bea.jolt.pool.ServiceException e)
    {
    // 服务出错,这里主要是Tuxedo的服务配置,jrepository文件出错
      e.printStackTrace();
      out.println("错误信息:"+
                  "Error message:"+e.getMessage()+
                  "Error number:"+e.getErrno());
    }
    catch (bea.jolt.pool.ApplicationException e)
    {
      // 应用程序出错
      result = (bea.jolt.pool.servlet.ServletResult) e.getResult();
      out.println("错误代码:"+result.getApplicationCode());
    }
    catch (Exception e)
    {
      out.println("意外错误:"+e);
    }
   
    out.println("\n");
    out.close();
 } 
 
 protected void doPost(javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response)
 throws javax.servlet.ServletException, java.io.IOException
 {
  this.doGet(request,response);
 }          
}

------------------------
九、RUN
------------------------

Run on server ,点击Submit,显示 传递的参数 = 1 Tuxedo服务成功调用。 返回值:aaaaaaa !

你可能感兴趣的:(java,应用服务器,weblogic,servlet,SQL Server)