注：大约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

来源：oschina

链接：https://my.oschina.net/u/114016/blog/112405

标签

jolt

tuxedo

对使用Jolt调用Tuxedo的一个简单的封装