【译】使用Java编写Oracle Tuxedo应用
来源:互联网 发布:安卓清理软件 编辑:程序博客网 时间:2024/06/14 08:54
简介
Oracle Tuxedo服务可以使用纯java来编写。使用java实现的服务的功能和其他Tuxedo服务实现是一样的。你可以使用客户端或者Tuxedo服务器通过ATMI接口来调用Tuxedo Java Server(TMJSVASVR
)对外提供的服务;你也在java实现的服务中通过TJATMI接口来调用Tuxedo server提供的服务。
另外,你可以使用任何类型的Tuxedo客户端调用java实现的服务,比如本地客户端,/WS客户端和Jolt客户端。
可以使用TJATMI接口、JATMI类型缓冲、POLO java对象等主流Java技术来实现Tuxedo服务。
编程方针
- Java服务类,实现Java服务,需要继承
TuxedoJavaServer
类;Java服务类应该有一个默认的构造函数 - Java服务类中的Java方法会被向外提供成Java服务,应该声明为public, 并将
TPSVCINFO
接口作为唯一的输入参数 - Java服务类应该实现
tpsvrinit()
方法,在Tuxedo Java服务启动时会被调用 - Java服务类应该实现
tpsvrdone()
方法,在Tuxedo Java服务关闭时会被调用 - Java服务可以使用Tuxedo Java ATMI接口(例如
tpcall
,tpbegin
等) - Java服务可以使用
tpreturn
向客户端返回结果,或者通过抛出异常退出
Tuxedo Java 服务器线程与Java类实例模型
- Tuxedo Java服务使用传统的Tuxedo多线程模型,必须运行在多线程模式下
- 一旦启动,Tuxedo Java服务为每一个定义在配置文件中的类创建一个全局对象(实例),处理Java服务时工作线程共享全局对象(实例)
Tudexo Java服务器 tpsvrinit()/tpsvrdone()
处理
tpsvrinit()
处理:
用户需要实现tpsvrinit()
方法。由于该方法会在服务启动时调用,最好在该方法中完成类的初始化。如果一个类的tpsvrinit()
方法失败,用户日志中会报告一条警告信息,Java服务会继续执行。
tpsvrdone()
处理:
用户需要实现tpsvrinit()
方法。该方法在服务关闭时调用,推荐将类范围的清理工作放入这个方法中。
Tuxedo Java服务器tpreturn()
处理
Java服务的tpreturn()
并不会立即结束Java服务方法的执行,而是向Tuxedo Java服务器返回一个结果。
Java 服务的tpreturn()
的行为与现有Tuxedo系统的tpreturn()
行为不同:
- 当现有Tuxedo系统调用
tpreturn()
时,流控制自动转向Tuxedo - 当Java服务调用
tpreturn()
时,tpreturn()
之后的语句依旧会被执行。用户必须保证tpreturn()
是Java服务中最后一条执行的语句。如果不是,建议在tpreturn()
之后加上return
;否则tpreturn()
不会自动将流控制转向Tuxedo系统
注意:不建议在Java服务中前面没有
tpreturn()
时使用return
。这种用法会使Java服务器返回rcode为0的TPFAIL
到相关的客户端。
Tuxedo Java服务器异常处理
- Java服务执行期间可以抛出任何的异常然后退出Java服务。这种情况下Java服务器会返回
TPFAIL
到其客户端,其中rcode设置为0 - 所有的异常信息会记录在
$APPDIR/stderr
文件中。
编程环境
更新UBB配置文件
你需要配置一个路径,通过该路径Tuxdeo Java服务器可以找到CLOPT中Java实现的服务的配置文件。
由于ATMI Java服务器是一个多线程服务器,你还需要指名线程分配的限制。可以查看Defining the Server Dispatch Threads一章获取更多关于多线程服务配置的信息。
清单2-1 显示了ATMI Java服务器的UBB配置文件示例:
清单2-1
*SERVERSTMJAVASVR SRVGRP=TJSVRGRP SRVID=3CLOPT="-- -c /home/oracle/app/javaserver/TJSconfig.xml"MINDISPATCHTHREADS=2 MAXDISPATCHTHREADS=3
注意:UBBCONFIG中为Java服务器指明的
MAXDISPATCHTHREADS
最小值为2。
参见
- Setting Up an Oracle Tuxedo Application
UBBCONFIG(5)
in the File Formats, Data Descriptions, MIBs, and System Processes Reference
ATMI Java Server 用户接口
TuxedoJavaServer
TuxedoJavaServer
是一个抽象类,所有用户定义的实现服务的类都应该继承它。
表3-1 TuxedoJavaServer接口
Oracle Tuxedo Java上下文
为了获取Oracle Tuxedo Java Server提供的TJATMI原始功能,你需要获取一个TuxAppContext
对象,该对象实现了所有的TJATMI功能
因为服务类继承自TuxedoJavaServer
,你可以在服务中调用getTuxAppContext()
方法获取上下文对象。然而,你不能在tpsvrinit()
中或其TuxAppContext
,因为此时TuxAppContext
没有准备好。如果你在tpsvrinit()
中尝试获取TuxAppContext
,tpsvrinit()
会出错并抛出异常。
Tuxedo Java 应用中的TJATMI功能
TJATMI是原生功能的集合,提供客户端和服务器端的通信功能,比如调用服务,开始和结束事务,获取到数据源的连接,日志等等。更多信息参考Java Server Javadoc
.
表3-2 TJATMI功能
注意:在
tpreturn
结束执行后服务依旧在运行。推荐把tpreturn
作为服务中最后执行的语句。
Tuxedo Java应用的类型缓冲
ATMI Java server 重用了Oracle WebLogic Tuxedo Connector TypedBuffers 作为相应的Oracle Tuxedo类型缓冲。消息通过类型缓冲传入 server 。ATMI Java server提供的类型缓冲见表3-3:
表3-3 类型缓冲
更多关于类型缓冲的信息,参见"weblogic.wtc.jatmi"
类型缓冲支持的限制
TypedFML32
中Fldid()/Fname()
嵌套在另一个TypedFML32
中时无法工作。为了应对这种情况,你可以使用fieldtable
类传输name/id。- 目前
weblogic.wtc.gwt.XmlViewCnv/XmlFmlCnv
类无法使用。
获取/设置服务信息
使用TPSVCINFO
类通过客户端获取/设置服务信息
表3-4 Getter函数
使用TuxATMIReply
从服务请求中获取回应数据和元数据
表3-5 用于回应的Getter函数
tpurcode
异常
你需要捕获服务中JATMI原语抛出的异常,比如tpcall()
。JATMI可能抛出两种类型的异常:
TuxATMITPException
:该异常抛出表明TJATMI出错TuxATMITPReplyException
:如果服务出错(TPESVCFAIL或者TPSVCERROR)该异常抛出,用户数据关联到异常中。
跟踪
你还需要导出TMTRACE=atmi:ulog
,正如你使用传统ATMI那样。TJATMI API跟踪信息被写入ULOG。
在Oracle Tuxedo Java Server 中实现服务
典型过程
- 定义一个继承自
TuxedoJavaServer
的类 - 提供一个默认的构造函数
- 实现
tpsvrinit()
和tpsvrdone()
方法 - 实现服务方法,该方法应该使用
TPSVCINFO
作为唯一的参数- 使用
getTuxAppContext()
获取TuxAppContext
对象 - 使用
TPSVCINFO.getServiceData()
从TPSVCINFO
对象中获取客户端请求数据 - 如果配置了数据源,使用
TuxAppContext.getConnection()
方法获取到数据源的连接 - 完成商业逻辑,比如使用
TuxAppContext.tpcall()
调用其他服务,操纵数据库等 - 分配新的类型缓冲,把应答数据放入类型缓冲中
- 调用
TuxAppContext.tpreturn()
将应答数据返回客户端
- 使用
实例:没有事务的Java服务实现
如下实例是实现TOUPPER服务的简单示例。
定义Java类
清单4-1
import weblogic.wtc.jatmi.TypedBuffer;import weblogic.wtc.jatmi.TypedString;import com.oracle.tuxedo.tjatmi.*;public class MyTuxedoJavaServer extends TuxedoJavaServer { public MyTuxedoJavaServer() { return; } public int tpsvrinit() throws TuxException { System.out.println("MyTuxedoJavaServer.tpsvrinit()"); return 0; } public void tpsvrdone() { System.out.println("MyTuxedoJavaServer.tpsvrdone()"); return; } public void JAVATOUPPER(TPSVCINFO rqst) throws TuxException { TypedBuffer svcData; TuxAppContext myAppCtxt = null; TuxATMIReply myTuxReply = null; TypedBuffer replyTb = null; /* Get TuxAppContext first */ myAppCtxt = getTuxAppContext(); svcData = rqst.getServiceData(); TypedString TbString = (TypedString)svcData; myAppCtxt.userlog("Handling in JAVATOUPPER()"); myAppCtxt.userlog("Received string is:" + TbString.toString()); String newStr = TbString.toString(); newStr = newStr.toUpperCase(); TypedString replyTbString = new TypedString(newStr); /* Return new string to client */ myAppCtxt.tpreturn(TPSUCCESS, 0, replyTbString, 0); } public void JAVATOUPPERFORWARD(TPSVCINFO rqst) throws TuxException { TypedBuffer svcData; TuxAppContext myAppCtxt = null; TuxATMIReply myTuxReply = null; TypedBuffer replyTb = null; long flags = TPSIGRSTRT; /* Get TuxAppContext first */ myAppCtxt = getTuxAppContext(); svcData = rqst.getServiceData(); TypedString TbString = (TypedString)svcData; myAppCtxt.userlog("Handling in JAVATOUPPERFORWARD()"); myAppCtxt.userlog("Received string is:" + TbString.toString()); /* Call another service "TOUPPER" which may be implemented by another Tuxedo Server */ try { myTuxReply = myAppCtxt.tpcall("TOUPPER", svcData, flags); /* If success, get reply buffer */ replyTb = myTuxReply.getReplyBuffer(); TypedString replyTbStr = (TypedString)replyTb; myAppCtxt.userlog("Replied string from TOUPPER:" + replyTbStr.toString()); /* Return the replied buffer to client */ myAppCtxt.tpreturn(TPSUCCESS, 0, replyTb, 0); } catch (TuxATMITPReplyException tre) { myAppCtxt.userlog("TuxATMITPReplyException:" + tre); myAppCtxt.tpreturn(TPFAIL, 0, null, 0); } catch (TuxATMITPException te) { myAppCtxt.userlog("TuxATMITPException:" + te); myAppCtxt.tpreturn(TPFAIL, 0, null, 0); } }}
创建Java Server配置文件
清单4-2显示了配置示例,将MyTuxedoJavaServer.JAVATOUPPER()
方法导出成Tuxedo 服务JAVATOUPPER
,将MyTuxedoJavaServer.JAVATOUPPERFORWARD()
方法导出成Tuxedo 服务JAVATOUPPERFORWARD
。
清单4-2
<?xml version="1.0" encoding="UTF-8"?><TJSconfig> <TuxedoServerClasses> <TuxedoServerClass name="MyTuxedoJavaServer"> </TuxedoServerClass> </TuxedoServerClasses></TJSconfig>
更新UBB配置文件
清单4-3 UBB配置文件
*GROUPSTJSVRGRP LMID=simple GRPNO=2*SERVERSTMJAVASVR SRVGRP= TJSVRGRP SRVID=4 CLOPT="-- -c TJSconfig.xml"MINDISPATCHTHREADS=2 MAXDISPATCHTHREADS=2
实例:带有事务的Java Service实现
清单4-4给出了一个示例,实现WRITEDB_SVCTRN_COMMIT
服务,该服务将用户请求字符串插入表TUXJ_TRAN_TEST
中。
定义Java类
清单4-4
import weblogic.wtc.jatmi.TypedBuffer;import weblogic.wtc.jatmi.TypedString;import com.oracle.tuxedo.tjatmi.*;import java.sql.SQLException;/* MyTuxedoTransactionServer is user defined class */public class MyTuxedoTransactionServer extends TuxedoJavaServer{ public MyTuxedoTransactionServer () { return; } public int tpsvrinit() throws TuxException { System.out.println("In MyTuxedoTransactionServer.tpsvrinit()"); return 0; } public void tpsvrdone() { System.out.println("In MyTuxedoTransactionServer.tpsvrdone()"); return; } public void WRITEDB_SVCTRN_COMMIT(TPSVCINFO rqst) throws TuxException { TuxAppContext myAppCtxt; TypedBuffer rplyBuf = null; String strType = "STRING"; String ulogMsg; TypedString rqstMsg; Connection connDB = null; Statement stmtDB = null; String stmtSQL; int trnLvl, trnStrtInSVC; int trnRtn; int rc = TPSUCCESS; rqstMsg = (TypedString)rqst.getServiceData(); myAppCtxt = getTuxAppContext(); myAppCtxt.userlog("JAVA-INFO: Request Message Is \"" + rqstMsg.toString() + "\""); rplyBuf = new TypedString("This Is a Simple Transaction Test from Tuxedo Java Service"); long trnFlags = 0; try { trnStrtInSVC = 0; trnLvl = myAppCtxt.tpgetlev(); if (0 == trnLvl) { long trnTime = 6000; myAppCtxt.userlog("JAVA-INFO: Start a transaction..."); trnRtn = myAppCtxt.tpbegin(trnTime, trnFlags); myAppCtxt.userlog("JAVA-INFO: tpbegin return " + trnRtn); trnStrtInSVC = 1; } connDB = myAppCtxt.getConnection(); if (null != connDB) { myAppCtxt.userlog("JAVA-INFO: Get connection: (" + connDB.toString() + ")."); } stmtDB = connDB.createStatement(); if (null != stmtDB) { myAppCtxt.userlog("JAVA-INFO: Create statement: (" + stmtDB.toString() + ")."); } stmtSQL = "INSERT INTO TUXJ_TRAN_TEST VALUES ('" + rqstMsg.toString() + "')"; myAppCtxt.userlog("JAVA-INFO: Start to execute sql (" + stmtSQL + ")..."); stmtDB.execute(stmtSQL); myAppCtxt.userlog("JAVA-INFO: End to execute sql (" + stmtSQL +")."); if (1 == trnStrtInSVC) { myAppCtxt.userlog("JAVA-INFO: tpcommit current transaction..."); trnRtn = myAppCtxt.tpcommit(trnFlags); myAppCtxt.userlog("JAVA-INFO: tpcommit return " + trnRtn); trnStrtInSVC = 0; if (-1 == trnRtn ) { rc = TPFAIL; } } } catch (TuxATMIRMException e) { String errMsg = "ERROR: TuxATMIRMException: (" + e.getMessage() + ")."; myAppCtxt.userlog("JAVA-ERROR: " + errMsg); rc = TPFAIL; } catch (TuxATMITPException e) { String errMsg = "ERROR: TuxATMITPException: (" + e.getMessage() + ")."; myAppCtxt.userlog("JAVA-ERROR: " + errMsg); rc = TPFAIL; } catch (SQLException e) { String errMsg = "ERROR: SQLException: (" + e.getMessage() + ")."; myAppCtxt.userlog("JAVA-ERROR: " + errMsg); rc = TPFAIL; } catch (Exception e) { String errMsg = "ERROR: Exception: (" + e.getMessage() + ")."; myAppCtxt.userlog("JAVA-ERROR: " + errMsg); rc = TPFAIL; } catch (Throwable e) { String errMsg = "ERROR: Throwable: (" + e.getMessage() + ")."; myAppCtxt.userlog("JAVA-ERROR: " + errMsg); rc = TPFAIL; } finally { if (null != stmtDB) { try { stmtDB.close(); } catch (SQLException e) {} } } myAppCtxt.tpreturn(rc, 0, rplyBuf, 0); }}
创建Java 服务配置文件
表4-5
<?xml version="1.0" encoding="UTF-8"?><TJSconfig> <ClassPaths> <ClassPath>/home/oracle/app/oracle/product/11.2.0/dbhome_2/ucp/lib/ucp.jar </ClassPath> <ClassPath>/home/oracle/app/oracle/product/11.2.0/dbhome_2/jdbc/lib/ojdbc6.jar</ClassPath> </ClassPaths> <DataSources> <DataSource name="oracle"> <DriverClass>oracle.jdbc.xa.client.OracleXADataSource</DriverClass> <JdbcDriverParams> <ConnectionUrl>jdbc:oracle:thin:@//10.182.54.144:1521/javaorcl</ConnectionUrl> </JdbcDriverParams> </DataSource> </DataSources> <TuxedoServerClasses> <TuxedoServerClass name=" MyTuxedoTransactionServer"> </TuxedoServerClass> </TuxedoServerClasses></TJSconfig>
更新UBB配置文件
清单4-6
*GROUPSORASVRGRP LMID=simple GRPNO=1OPENINFO="Oracle_XA:Oracle_XA+Acc=P/scott/triger+SesTm=120+MaxCur=5+LogDir=.+SqlNet=javaorcl"TMSNAME=TMSORA TMSCOUNT=2*SERVERSTMJAVASVR SRVGRP=ORASVRGRP SRVID=3 CLOPT="-- -c TJSconfig.xml" MINDISPATCHTHREADS=2 MAXDISPATCHTHREADS=4
- 【译】使用Java编写Oracle Tuxedo应用
- java使用jolt调用tuxedo服务
- 使用java通过jolt调用tuxedo
- TUXEDO 与 ORACLE 动态方法四的应用示例
- 使用Java编写oracle存储过程
- 使用Java编写oracle存储过程
- 使用Java编写Oracle存储过程
- 使用MIB来监控你的应用(tuxedo mib)
- 使用MIB来监控你的应用(tuxedo mib)
- JAVA调用Tuxedo服务——使用JNI封装Tuxedo客户端的一个例子
- Tuxedo 应用 过程
- TUXEDO应用小结
- LoadRunner之编写Tuxedo脚本
- Java调用Tuxedo服务
- Java调用Tuxedo方法
- BEA Tuxedo中间件应用初探
- tuxedo之domain应用入门
- Tuxedo配置及简单应用
- Android读取系统时间
- TK1 Darknet上用RTSP网络摄像头 Gstreamer解码解决视屏马赛克解码速度不够的问题
- RecyclerView滑动遇到的坑(动态添加布局引起的)
- H
- Spring4.3x教程之五事物详解
- 【译】使用Java编写Oracle Tuxedo应用
- 第一个python程序--学习笔记
- Spring Boot下的lombok安装以及使用简介
- 使用npm国内镜像
- 堆排序
- TCP套接字网络编程(三)
- 计算任意数阶乘n!末尾所含0的个数
- Unity_设计模式简介_025
- String、StringBuilder、StringBuffer