注：大约4年前，在上家公司封装的一个Jolt调用Texedo的包，并写的一个使用文档。不知道现在还有没有人使用Jolt这个东西了。

源码下载地址见文章最后

--------------------------------------------------------------------------------------------------------------------------------

1 Jolt通用调用包简介

1.1 调用Tuxedo服务的两种方式

在程序开发中，有两种方式可以调用Tuxedo服务，分别是：

1. 用C/C++来编写程序，通过WSL来调用Tuxedo提供的服务。

2. 用Java通过Jolt包来编写程序，通过JSL来调用Tuxedo提供的服务。

第一种方式使用C/C++语言开发，效率高，但是程序调试困难，容易出错。

第二种方式使用Java语言开发，运行效率相对于第一种方式略有不足，但是开发容易，调试简单。但是为了提供更大的灵活性，使用Jolt方式对长连接和短连接调用提供了两套完全不同的API，

1.2 Jolt通用调用包的目标

l 简化开发

仅需要编写少量的代码就可以完成Tuxedo服务调用。

l 屏蔽长短连接

对于长连接或者短连接，开发人员编写的代码是一样的。长连接和短连接的切换，仅需要修改一下配置文件即可。

l 配置灵活

提供多种配置方式，既可以通过文件配置，也可以让开发人员编程配置。

1.3 Jolt通用调用包的组成

Jolt通用调用包仅有一个包：joltutility.jar。该包依赖于Oracle提供的jolt.jar包。

在开发时，将 joltutility.jar 和 jolt.jar 两个包引入工程即可。

2 快速入门

本节的主要目地是：使开发人员快速掌握通过joltutility.jar来调用Tuxedo服务的方法。

Jolt通用调用包对程序开发人员完全屏蔽长连接和短连接，长连接和短连接的调用方式一致，只有在涉及到某种连接方式特有的设置才需要单独进行设置。

调用Tuxedo服务一共分六步：

第一步 配置

Jolt通用调用包存在两种配置方式：配置文件方式 和 编程自定义配置。

配置文件方式

通常，Jolt通用调用包需要通过配置文件来进行配置。配置文件的格式见附录。

配置文件设置完成以后，在程序中进行配置加载该配置文件。一共有3种跟配置文件相关的配置方式：

l 在程序中指定配置文件

调用 JoltConfig.configure( cfgFilePath ) 静态方法，设置从cfgFilePath中读取配置。

l 在JVM的参数中指定配置文件

在进程启动的脚本中，为JVM的启动参数增加 -Djolt.configuration=cfgFilePath。这样程序会自动从cfgFilePath中加载配置。

l 使用默认配置文件

如果既不在程序中指定配置文件，也不在JVM的参数中指定配置文件，那么程序会自动从应用程序根目录下面的JoltConfig.xml文件中读取配置。

编程自定义配置

如果不想从配置文件中读取配置，也可以在程序中对配置类进行自定义设置。代码如下：

JoltConfig cfg = JoltConfig.newInstance();// 短连接配置BasicJoltConfig basicConfig = new BasicJoltConfig();… … // 在这里对basicConfig进行设置// 长连接配置PoolJoltConfig poolConfig = new PoolJoltConfig();… … // 在这里对poolConfig进行设置cfg.setBasicConfig( basicConfig );cfg.setPoolConfig( poolConfig );// 自定义配置JoltConfig.configure( JoltConfig cfg );

注：以上四种配置方法任何一种均可，而且只需要配置一次，通常我们可以在进程刚启动时进行配置。

第二步 实例化一个JoltCaller对象

JoltCaller caller = new JoltCaller();

JoltCaller对象会根据配置文件中的配置，与Tuxedo服务器连接，并提供调用Tuxedo服务的功能。所以，如果想调用Tuxedo服务，首先要创建一个JoltCaller对象。

第三步 生成一个IJoltData对象

IJoltData data = JoltCaller.getJoltData( serviceName ); // 生成调用某一个服务的参数对象

IJoltData是向Tuxedo服务发送的参数对象的抽象，使用JoltCaller.getJoltData( serviceName )方法，可以生成某一个服务对应的参数象。。

第四步 设置调用参数

data.setString( "STRING", "HelloWorld" );

根据协议文档的内容，对第三步中生成的参数对象进行设置。

第五步 调用服务

data = caller.call( data );

通过调用JoltCaller对象的call( IJoltData )方法，可以调用Tuxedo服务，并返回结果。

第六步 处理返回结果

String s = data.getStringDef( "STRING", "defalut" );

根据协议文档的内容，获取Tuxedo服务返回的各个数据项，进行业务处理。

通过以上六步，就可以调用一次Tuxedo服务。各个类的详细说明，请参考附带的javadoc文档。

3 高级应用

3.1 长连接连接多个Tuxedo服务器

Jolt通用调用包在进行长连接调用时，对连接多个Tuxedo服务器提供了支持。在配置文件中可以添加多个Tuxedo服务器的配置（见附录），然后在程序中通过如下形式进行调用：

JoltCaller caller = JoltCaller.getInstance();IJoltData data = JoltCaller.getJoltData( serviceName );data.setString( "STRING", "HelloWorld" );// sessionName就是指定的连接池名称，只有长连接会使用这个重载的方法，短连接使用该重载方法，sessionName不起作用。data = caller.call( data, sessionName );String s = data.getStringDef( "STRING", "defalut" );

3.2 短连接自定义调用Tuxedo服务的配置

Jolt通用调用包在进行短连接调用时，可以对每一个服务的调用都进行自定义的设置，如：调用ServiceA时，我们希望连接服务器I，并且超时间设置为5秒；在调用ServiceB时，我们希望连接服务器II，并且超时时间设置为10秒。

通过如下的代码可以实现这个功能：

JoltCaller caller = new JoltCaller ();BasicJoltConfig cfg = new BasicJoltConfig();...... // 在这里进行自定义设置// 这里生成的data就是按照自定义的配置生成的，不会使用默认设置了。只有短连接调用时才使用这个重载的方法，长连接调用时使用该重载方法，cfg不起作用。IJoltData data = JoltCaller.getJoltData( serviceName, cfg );data.setString( "STRING", "HelloWorld" );data = caller.call( data );String s = data.getStringDef( "STRING", "defalut" );

3.3 自定义配置文件

通常，Jolt通用调用包使用单独的一个配置文件，但是Jolt通用调用包也可以与其它应用程序共用同一个配置文件。

因为Jolt通用调用包的配置文件是XML格式的，而且根结点为<Root>，二级节点为<Jolt>。所以任何使用<Root>作为根结点的配置文件，都可以与Jolt通用调用包共用配置文件（如空中选号系统）。

附录 配置文件的格式

Jolt通用调用包的配置文件保存的编码格式一律为GB2312，使用ASCII，ISO8859-1，UTF-8，UTF-16等编码方式保存时，加载配置文件可能会出错。

配置文件内容如下：

<?xml version="1.0" encoding="gb2312"?><Root><Jolt><!-- 是否使用连接池,true:使用 false:不使用 --><usePool>false</usePool><!-- 短连接设置 --><commonSetting><!-- Tuxedo服务器地址  --><appAddress>//10.0.52.14:9988</appAddress><!-- 应用密码 --><appPassword></appPassword><!-- 用户名 --><userName></userName><!-- 用户密码 --><userPassword></userPassword><!-- 用户角色 --><userRole></userRole><!-- 接收超时,单位秒 --><recvTimeout>3</recvTimeout><!-- 发送超时,单位秒 --><sendTimeout>0</sendTimeout><!-- Session超时,单位秒.JSL中的-T选项，一般对此设置为0 --><sessionTimeout>0</sessionTimeout><!-- 网络空闲超时, 如果设置0,Jolt连接JSH会采用 RETAINED模式;如果大于0,Jolt连接JSH会采用RECONNECT模式; --><idleTimeout>0</idleTimeout></commonSetting><!-- 连接池设置 --><poolSetting><!-- 连接池项,设置多个连接池时,设置多个 poolItem 结点，不同的结点用poolName来区分。可以每一个Tuxedo服务器来建立一个连接池项。 --><poolItem><!-- 应用密码 --><appPassword></appPassword><!-- 用户名 --><userName></userName><!-- 用户密码 --><userPassword></userPassword><!-- 用户角色 --><userRole></userRole><!-- 接收超时,单位秒 --><recvTimeout>3</recvTimeout><!-- 首选地址列表,当有多个备选地址列表时,可以使用多个 addr 结点 --><primaryAddr><addr>//10.0.52.14:9988</addr></primaryAddr><!-- 备选地址列表,当有多个备选地址列表时,可以使用多个 addr 结点 --><secondaryAddr><addr>//10.0.52.14:9988</addr></secondaryAddr><!-- 连接池名称，不设置为默认连接池 --><poolName></poolName><!-- 最小连接数，即程序一启动时就建立的连接数 --><minPoolSize>5</minPoolSize><!-- 最大连接数，即同时并发调用的数量 --><maxPoolSize>15</maxPoolSize></poolItem></poolSetting></Jolt></Root>

下载地址: http://yun.baidu.com/share/link?shareid=2404381116&uk=3221528213