WebLogic Workshop集成.NET…

作者：WebLogic Workshop 小组

网络服务的宗旨是使运行于各种硬件平台上由不同厂商开发的应用，能够通过共同的一组协议和数据格式包括 SOAP、UDDI和WSDL进行相互定位和通讯。本文说明微软.NET的网络服务如何与BEA平台进行互操作。我首先描述如何在每个平台上创建网络服务定义语言（WSDL）文件，然后讨论如何采用WSDL文件调用外部平台上的网络服务。最后，将演示每个平台强大的、非标准的特性如何被其它平台使用。

两个简单的网络服务

在最初的例子中，我们将创建两个非常相似的网络服务，一个基于.NET，另一个基于WebLogic Workshop。两个网络服务都有一个简单的方法getHelloMessage，返回简单的Hello消息。在示例中，将演示两个平台的网络服务之间如何相互调用。

下面是WebLogic Workshop网络服务的代码:

public class WLWExample { /** @jws:operation */ public String getHelloMessage() { return "Hello from WebLogic Workshop!"; } }

下面是.NET网络服务的代码:

using System.ComponentModel; using System.Web.Services; namespace DotNetExample { public class Service1 : WebService { public Service1() { InitializeComponent(); } private IContainer components = null; private void InitializeComponent() {} protected override void Dispose( bool disposing ) { if(disposing && components != null) components.Dispose(); base.Dispose(disposing); } [WebMethod] public string getHelloMessage() { return "Hello from Visual Studio .NET!"; } } }

在编写调用这些网络服务的代码之前，需要先快速浏览一下网络服务互操作的工作原理。

网络服务互操作原理
网络服务互操作的核心是网络服务定义语言(WSDL). WSDL是一种基于XML的语言，使网络服务能够以平台中立的方式发布其公开契约。WSDL用于描述由网络服务提供的方法，并描述这些方法能够产生和接收的消息。 WSDL是一种通用格式，两个不同的网络服务产品能够通过WSDL描述其网络服务。

为了能够跨平台调用上述两个网络服务，必须首先为这两个网络服务生成WSDL文件。描述过程在WebLogic Workshop和Visual Studio .NET稍有差别，但都非常简单。

在WebLogic Workshop中创建WSDL
1. 在项目树（project tree）上，用右键点击您的网络服务并选择"Generate WSDL from JWS."（从JWS生成WSDL ），将从您的网络服务创建一个新WSDL文件。项目树将创建的WSDL作为网络服务的子项。

WebLogic Workshop对WSDL文件和CTRL文件将采用一种特殊的命名约定 (将在后面讨论)。假定您有一个网络服务命名为Service.jws，那么此服务的WSDL文件将被命名为ServiceContract.wsdl，其CTRL文件将被命名为 ServiceControl.ctrl。

在Visual Studio .NET中创建WSDL
1. 按F5从菜单中选择Debug/Start在浏览器中打开网络服务；
2. 在Internet Explorer中按右键点击"Service
Description"（服务描述）连接，并选择"Save Target As"（存储目标为），并选择一个以。wsdl结束的文件名。

即使对于简单的网络服务，其WSDL文件依然非常复杂。幸运的是，采用网络服务无需对WSDL细节进行了解。感兴趣的读者，可以在http://www.w3.org/TR/wsdl找到WSDL完整的规范。

从WebLogic Workshop调用.NET网络服务
无论WebLogic Workshop或者是Visual Studio .NET，都有其内部机制来使用WSDL或引用被调用网络服务。在 WebLogic Workshop中，必须创建服务控制（Service Control），在Visual Studio .NET中，相应的概念是网络引用（Web Reference）。本节将讨论如何为WSDL文件创建服务控制（Service Control），用于调用底层的网络服务。下一节将对网络引用（Web Reference）进行讨论。

首先，需要创建一个新的WebLogic Workshop网络服务作为客户端访问.NET 网络服务。结束以后，再对此网络访问增加服务控制。

从WSDL创建服务控制
1. 在设计视窗中点击"Add Control" （增加控制）下拉菜单并选择"Service Control."（服务控制）
2. 在第一个正文框中输入控制的变量名。这个变量名将被用于在源代码中引用此控制。
3. 选择组合框选项"Create a service control from a WSDL" （从WSDL创建服务控制），在正文框中输入WSDL 路径，也可以使用"Browse"（浏览）按钮指定WSDL位置。
4. 按"Create"（创建）按钮。

创建服务控制将在您的网络服务中增加一行类似下列的代码：

/** @jws:control */ DotNetExampleControl dotNetExample;

控制变量名应引起足够重视，因为这个名子将用于调用.NET网络服务。现在，可以添加一个方法使用服务控制调用.NET 网络服务。这个调用看起来像下面的代码:

/** @jws:operation */ public String callDotNet() { return dotNetExample.getHelloMessage(); }

之后，您应该有一个类似下面的WebLogic Workshop网络服务：

public class WLWClient { /** @jws:control */ private DotNetExampleControl dotNetExample; /** @jws:operation */ public String callDotNet() { return dotNetExample.getHelloMessage(); } }

假设.NET网络服务正在运行，您应该能够运行这个网络服务，并激活callDotNet方法向.NET网络服务发送跨平台调用。当激活这个方法时，将获得一个应答消息：.NET hello 消息:

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" > <soap:Body > <getHelloMessageResponse xmlns="http://tempuri.org/" > <getHelloMessageResult > Hello from VisualStudio.NET! </getHelloMessageResult > </getHelloMessageResponse > </soap:Body > </soap:Envelope >

从.NET调用WebLogic Workshop 网络服务
现在我们已经可以从WebLogic Workshop调用.NET网络服务，下一步将从.NET调用WebLogic Workshop 网络服务。在WebLogic Workshop中,我们采用了服务控制来调用外部网络服务，在.NET中，我们将采用网络引用（Web Reference）。

从WSDL创建网络引用
1. 选择"Project"菜单，然后选择"Add Web Reference."（添加网络引用）
2. 这时将弹出一个对话框用于浏览网络服务。在地址正文输入框中，输入为WebLogic WorkshopIn网络服务创建的WSDL文件的路径。
3. 选择"Add Reference"（添加引用）按钮。

您选择已经为项目（project）添加了指向WebLogic Workshop 网络服务的网络引用。默认情况下，将命名为 WebReference1。采用Solution Explorer，能够看到引用已添加到项目中,在引用之下，可以看到引用相应的WSDL 。

像使用其它对象一样，您可以在C#中使用网络引用。首先，必须将引用输入（import）到源文件中，只需在C#文件中增加下列代码:
using DotNetClient.WebReference1;

一旦将引用输入到源文件中，就可以创建引用实例（instance），并使用它调用WebLogic Workshop 网络服务。下列代码说明了C#服务的这个功能:

using System.ComponentModel; using System.Web.Services; using DotNetExample.WebReference1; namespace DotNetClient { public class Service1 : WebService { public Service1() { InitializeComponent(); } private IContainer components = null; private void InitializeComponent() {} protected override void Dispose( bool disposing ) { if(disposing && components != null) components.Dispose(); base.Dispose(disposing); } private WLWExample wlwExample = new WLWExample(); [WebMethod] public DataSet callWLW() { wlwExample.getHelloMessage(); } } }

当您接口callWLW 方法时，将收到来自WebLogic Workshop 网络服务的hello消息。

< ?xml version="1.0" encoding="utf-8" ? > < string xmlns="http://tempuri.org/" > Hello from WebLogic Workshop! </string >

从.NET调用会话式网络服务
在WebLogic Workshop中采用会话方式非常简单并且透明。但是，如果希望从.NET调用会话网络服务，必须需要额外的工作以确保会话功能正常运行。

当网络服务客户端调用会话方法时，WebLogic Workshop采用了会话关键字确定这次调用相关的会话。会话关键字嵌入在向网络服务发送的SOAP消息头中。对开始（start）方法，消息头格式如下:

<StartHeader > <conversationID > convID < /conversationID > <callbackLocation > callback < /callbackLocation > </StartHeader >

会话ID和回调定位均为可选项。如果未提供会话ID，WebLogic Workshop将为您自动生成一个会话ID。回调定位 (callback location) 用于指定WebLogic Workshop应向何处发送回调消息。

对于后续方法，会话头具有下列格式:

<ContinueHeader > <conversationID > convID </conversationID > </ContinueHeader >

对于后续方法，必须指定会话ID，因为需要有一种方式告诉WebLogic Workshop，调用这个后续方法时，希望加入哪个会话。回调定位不是必须的，它已经在起始方法中指定过。

为一个.NET网络服务增加SOAP头非常简单。会话网络服务的WSDL文件已经指定了起始和后续头的结构。所有.NET 已经知道如何进行格式化。当.NET创建网络引用时，它为每一个在WSDL中指定的SOAP头的引用中置入了一个字段（域）:

// A web reference to a conversational Web service. private WLWExample wlwExample; [WebMethod] public void callStartMethod() { wlwExample.StartHeaderValue = new WebReference1.StartHeader(); wlwExample.StartHeaderValue.conversationID = 齝onvID? wlwExample.StartHeaderValue.callbackLocation = 齝allbackLoc? wlwExample.startMethod(); }

本例程假设已经有一个名为WebReference1 网络引用包含了一个指向名为cWLWExample网络服务的引用，与前面的例程相似。WLWExample有一个名为startMethod方法开始一个会话。您应该用您实际需要的会话ID和回调定位替换字符串"convID" 和"callbackLoc" 。

为了能够调用后续的方法，可以使用类似的代码(用ContinueHeaderValue替换StartHeaderValue )。在WebLogic Workshop中使用.NET DataSets

DataSet 是微软的活动数据对象（Active Data object ），用于提供数据的更通用的包装。一个DataSet 将其数据模型化为一组表，其结构与SQL的表格非常相近，一样具有特定字段集、特定类型和次序。, DataSet对象提供了丰富的工具装载和操作数据。但是，针对这篇文章的目的，我们对这些工具的兴趣远小于对数据集序列化机制的关注。

创建DataSet样例
开始时，我们将创建一个简单的DataSet，表示电话簿并逐渐增加相应的例子数据。然后，将DataSet 从网络服务返回。请注意DataSet如何序列化成为XML格式。

[WebMethod] public DataSet getDataSet() { // 创建新数据集，并增加相应的表。 DataSet dataSet = new DataSet("MyDataSet"); DataTable table = dataSet.Tables.Add("PhoneBook"); // 创建表列（字段）。 DataColumn primaryKeyCol = table.Columns.Add("ID", typeof(int)); table.Columns.Add("Name", typeof(string)); table.Columns.Add("Telephone", typeof(string)); // 设置ID字段作为主关键字。 table.PrimaryKey = new DataColumn[] { primaryKeyCol }; // 创建假想数据。 table.LoadDataRow(new object[] {1, "Fred", "555.2145"}, true); table.LoadDataRow(new object[] {2, "Bob", "555.6246"}, true); table.LoadDataRow(new object[] {3, "Howard", "555.1125"}, true); table.LoadDataRow(new object[] {4, "Stanley", "555.0932"}, true); // 将数据返回给调用者。 return dataSet; }

DataSet的概要非常简单。这里DataSet（数据集）中有一个表，我们称为"PhoneBook." (电话簿)，表包含有三列－一个ID列，作为主关键字，一个Name列和一个Telephone列。我们已向本DataSet中添加了一些样例数据。当调用方法时，将返回下列XML：

<?xml version="1.0" encoding="utf-8"?> <DataSet xmlns="http://tempuri.org/"> <xs:schema id="MyDataSet" xmlns="" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:msdata="urn:schemas-microsoft-com:xml-msdata"> <xs:element name="MyDataSet" msdata:IsDataSet="true"> <xs:complexType> <xs:choice maxOccurs="unbounded"> <xs:element name="PhoneBook"> <xs:complexType> <xs:sequence> <xs:element name="ID" type="xs:int" /> <xs:element name="Name" type="xs:string" minOccurs="0" /> <xs:element name="Telephone" type="xs:string" minOccurs="0" /> </xs:sequence> </xs:complexType> </xs:element> </xs:choice> </xs:complexType> <xs:unique name="Constraint1" msdata:PrimaryKey="true"> <xs:selector xpath=".//PhoneBook" /> <xs:field xpath="ID" /> </xs:unique> </xs:element> </xs:schema> <diffgr:diffgram xmlns:msdata="urn:schemas-microsoft-com:xml-msdata" xmlns:diffgr="urn:schemas-microsoft-com:xml-diffgram-v1"> <MyDataSet xmlns=""> <PhoneBook diffgr:id="PhoneBook1" msdata:rowOrder="0"> <ID>1</ID> <Name>Fred</Name> <Telephone>555.2145</Telephone> </PhoneBook> <PhoneBook diffgr:id="PhoneBook2" msdata:rowOrder="1"> <ID>21</ID> <Name>Bob</Name> <Telephone>555.6246</Telephone> </PhoneBook> <PhoneBook diffgr:id="PhoneBook3" msdata:rowOrder="2"> <ID>3</ID> <Name>Howard</Name> <Telephone>555.1125</Telephone > </PhoneBook > <PhoneBook diffgr:id="PhoneBook4" msdata:rowOrder="3" > <ID>4</ID > <Name > Stanley</Name > <Telephone > 555.0932</Telephone > </PhoneBook > </MyDataSet > </diffgr:diffgram > </DataSet >

DataSet有两部分XML编码。第一部分为概要，描述了XML编码的结构。第二部分DataSet的实际数据体。本文中，我们将忽略概要部分，假定预先已知，而只集中精力于数据自身的解码。在更复杂的应用中，可能需要利用概要提供的其它信息。

我们创建的表中数据被编码为更简单的格式，其元素按下列格式不断重复。

给定我们所知的特定XML形式，我们能够编写一个WebLogic Workshop 网络服务使用这个数据。

利用XML Map（视图）提取数据
利用WebLogic Workshop的XML映射技术，我们能够捕获数据并将其存储为Java对象以表示电话簿中的信息项。首先，我们需要定义一个Java类型以承载电话簿信息项。下列代码能够满足这个要求：

public static class PhoneBookEntry { public int id; public String name; public String phoneNumber; }

为了将接收到的XML进行解码，我们将采用XML视图。下列XML视图能够用来返回服务控制的视图，这些服务控制用于调用.NET 网络服务从而返回DataSet。

/** * @jws:return-xml xml-map:: * <getDataSetResponse xmlns="http://tempuri.org/"> * <getDataSetResult> * <diffgr:diffgram * xmlns:diffgr="urn:schemas-microsoft-com:xml-diffgram-v1"> * <MyDataSet xmlns=""> * <PhoneBook xm:multiple="entry in return"> * <ID>{entry.id}</ID> * <Name>{entry.name}</Name> * <Telephone>{entry.telephone}</Telephone> * </PhoneBook> * </MyDataSet> * </diffgr:diffgram> * </getDataSetResult> * </getDataSetResponse> * :: */ public PhoneBookEntry[] getDataSet();

本映射应该添加到.NET网络服务的CTRL的getDataSet方法中。映射看起来有点复杂，实际上只是深入到.NET网络服务返回的XML，并获取电话簿条目列表。然后，利用xm:multiple 属性将每个电话簿条目的数据与getDataSet 返回的数组元素绑定。

您可能已经注意到，本映射建议的XML与前面描述有所不同。不幸的是，WebLogic Workshop收到的SOAP消息与 .NET网络接口显示的XML看上去有差别。可以通过从WebLogic Workshop激活.NET网络服务方法来发现WebLogic Workshop 实际收到的XML消息，并采用测试查看.NET返回的XML消息。

结束语
在网络服务世界中，互操作具有重要的意义。WebLogic Workshop很容易与其它网络服务实现实现互操作。本文中，我们浏览了与.NET互操作需要的工作。但是，本文讨论的原则适用于能够生成有效WSDL的任何网络服务产品。

返回顶部

下一篇：升级到WebLogic Server 7.0 >>