消息(5)——WSE增强的web服务套件,MTOM附件

简介: WSE是什么? 它是Web Service Enhancements,是微软发布的构筑Web服务应用程序的附加套件。这个套件可以使web服务应用程序支持WS-Security、WS-Routing、WS-Attachments等规格。

WSE是什么?

它是Web Service Enhancements,是微软发布的构筑Web服务应用程序的附加套件。这个套件可以使web服务应用程序支持WS-SecurityWS-RoutingWS-Attachments等规格。

1)安全性:支援对平台安全的xml web服务的构筑,具有用于对soap信息进行电子签名和加密的功能。

2)路由功能,对soap信息进行中继,并负责xml web服务的路由

3)添加功能,可以向xml web服务soap信息中添加二进制数据。

 

.net Web服务中,不支持MIME格式的soap附件,但在WSE2.0中却支持DIME附件,现在的WSE版本为3.0,在2.0中的DIME附件,在3.0中由MTOM模型代替。

关于wse更多内容可以参见老徐的系列:

http://www.cnblogs.com/frank_xl/admin/EditPosts.aspx?catid=177055

 

现在通过WSE3.0构建附件Soap消息包。

(一)  WSE服务端

WSE3.0可以到:

http://www.microsoft.com/downloads/details.aspx?

familyid=018a09fd-3a74-43c5-8ec1-8d789091255d&displaylang=en

下载

支持vs2005,其它版本的支持请参考其它文档。安装时以插件形式安装。

 

建立网站,并添加web 服务

[WebMethod]

public void SaveImage(byte[] bb)

{

FileStream fs = File.Create(@"k:\soapPicBinary2.gif");

fs.Write(bb, 0, bb.Length);

fs.Close();

}

 

在网站项目上右键,然后在右键菜单中可以看到WSE设置:WSE settings 3.0

这个可视化的工具是对Web.config文件的配置工具,WSE配置选项是放在web.config文件中的。

·在常规选项卡上,把增强选项和WSE soap协议工厂选中。

·在消息选项卡上,在MTOM设置中把客户模式选择打开。

然后就可以发布了。

 

(二)  客户端

在客户端添加web服务引用,生成代理,同时也要进行wse设置,这个比较简单,只要在消息选项卡上,把MTOM设置中的客户模式打开就行。如果是网站项目,会自动在Web.config文件中添加必要的章节,如果是应用程序,会在app.config文件中添加章节。

例如,现在在类库项目中添加wse服务引用,设置3.0后,app.config内容如下:

添加   

<section name="microsoft.web.services3"

type="Microsoft.Web.Services3.

Configuration.WebServicesConfiguration, Microsoft.Web.Services3,

Version=3.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35" />

章节,此节定义消息模式:

<microsoft.web.services3>

<messaging>

<mtom clientMode="On" serverMode="always" />

</messaging>

</microsoft.web.services3>

 

测试代码:

public void TestWse()

{

FirstInstance.FirstServiceWse client =

new UTest.FirstInstance.FirstServiceWse();

 

    FileStream fs = new FileStream(@"k:\x1.gif", FileMode.Open);

    byte[] bb = new byte[fs.Length];

 

    fs.Read(bb, 0, bb.Length);

    client.SaveImage(bb);

}

 

现在客户端通过的就是WSE服务代理实例来实现WSE服务请求。会了区分WSE下的附件MTOM传输优化,现在先通过WS服务代理实例来实现附件传输:

只要改到实例就可以:

FirstInstance.FirstService client =

new UTest.FirstInstance.FirstService();

 

查看soap包:

<?xml version="1.0" encoding="utf-8"?>

<soap:Envelope

  xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"

  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

  xmlns:xsd="http://www.w3.org/2001/XMLSchema">

  <soap:Body>

    <SaveImage xmlns="http://tempuri.org/">

      <bb>R0lGODlhZGMDggAOw==</bb>

    </SaveImage>

  </soap:Body>

</soap:Envelope>

在包体的附件部分,我省略了大部分内容,但它是base64编码,与我在http://www.cnblogs.com/jams742003/archive/2010/03/31/1701555.html

中的附件的格式相同。

 

下面是启用了MTOM传输的WSE服务代理实例下的soap包:

----MIMEBoundary634057127108593750

content-id: <0.634057127108593750@example.org>

content-type: application/xop+xml; charset=utf-8; type="text/xml; charset=utf-8"

content-transfer-encoding: binary

 

<soap:Envelope

  xmlns:xop="http://www.w3.org/2004/08/xop/include"

  xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"

  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

  xmlns:xsd="http://www.w3.org/2001/XMLSchema"

  xmlns:wsa="http://schemas.xmlsoap.org/ws/2004/08/addressing"

  xmlns:wsse="http://docs.oasis-open.org/wss/2004/

01/oasis-200401-wss-wssecurity-secext-1.0.xsd"

  xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/

oasis-200401-wss-wssecurity-utility-1.0.xsd">

    <soap:Header>     

    </soap:Header>

    <soap:Body>

      <SaveImage xmlns="http://tempuri.org/">

        <bb>

          <xop:Include href="cid:1.634057127108906250@example.org" />

        </bb>

      </SaveImage>

    </soap:Body>

  </soap:Envelope>

----MIMEBoundary634057127108593750

content-id: <1.634057127108906250@example.org>

content-type: application/octet-stream

content-transfer-encoding: binary

GIF89ad

----MIMEBoundary634057127108593750—

 

可以看到所谓的MTOM优化传输包的形式。

 

Web service,或是WSEsoap协议(包)来传递消息,消息是重要的,也是目的所在。精确的控制消息,或说精准的控制包的内容是最主要的任务。

Soap协议版本从1.11.2有一些改进,消除了以前所存在的歧义,使解析更明确。.net web 服务及WSE就是遵循soap协议规则而用于控制soap包的简便工具。

 

现在实现传递附件和客户实例

服务端:

[WebMethod]

public void SaveImage(byte[] bb)

{

FileStream fs = File.Create(@"k:\soapPicBinary3.gif");

fs.Write(bb, 0, bb.Length);

fs.Close();

}

 

[WebMethod]

public void SaveAttachments(byte[] bb,Customer customer)

{

SaveImage(bb);

CreateText(customer);

}

 

private void CreateText(Customer customer)

{

StreamWriter writer=  File.CreateText(@"k:\customer.txt");

writer.Write(customer.Unid.ToString()

+ "" + customer.UserName

+ " " + customer.CreateTime.ToString());

   writer.Close();

}

 

其中加粗的方法是进行测试的方法。

 

在客户端:

public void TestCustomer()

{

FirstInstance.Customer customer =

new UTest.FirstInstance.Customer();

    customer.Unid = 2;

    customer.UserName = "Songjiang";

    customer.CreateTime = Convert.ToDateTime("2010-4-1");

 

    FileStream fs = new FileStream(@"k:\x1.gif", FileMode.Open);

    byte[] bb = new byte[fs.Length];

    fs.Read(bb, 0, bb.Length);

    fs.Close();

 

FirstInstance.FirstServiceWse client =

new UTest.FirstInstance.FirstServiceWse();

    client.SaveAttachments(bb, customer);

}

包的形式大概也能猜出来,现在只取包体一段内容:

<soap:Body>

  <SaveAttachments xmlns="http://tempuri.org/">

    <bb>

      <xop:Include href="cid:1.634057142194062500@example.org" />

    </bb>

    <customer>

      <Unid>2</Unid>

      <UserName>Songjiang</UserName>

      <CreateTime>2010-04-01T00:00:00</CreateTime>

    </customer>

  </SaveAttachments>

</soap:Body>

 

其中的客户还是以原来的格式存储,而附件(图片)是以MTOM形式存在发送。

 

消息是主体,消息就是包,精准的控制包的各个部分及命名要根据工具的控制力和自己的深入程度来达到。.net ws做为微软的ws工具,是不支持MIME附件soap包的,但在WSE2中就支持了对DIME附件的控制,在3.0中又支持了MTOM传输,这是工具的控制力;在WCF中,对于信道,信道元素,绑定模型等深层内容的掌握就是程序员深入理解和构建包的有力条件。尽管在我们的应用层面上,WCF对我们的大部分应用已经胜任且绰绰有余,但更深入的研究、理解和应用只有好处。轮子并不要我们创造,但从割胶到提取加工,以至到轮胎成型,如果整个过程我们理解的话,也不是坏事的,这样最少有2个好处:对于不同路面的轮胎可以进行不同处理而提供最恰当的轮胎(尽管差一点的轮胎也能上路);谁知道什么时候要做一回鲁宾逊?

 

例如,为服务的方法添加名字空间:

<SaveAttachments xmlns="http://tempuri.org/">

这个可以在web服务的类中添加修饰标签来达到:

[WebService(Namespace = "http://tempuri.org/")]

 

博客园大道至简

http://www.cnblogs.com/jams742003/

转载请注明:博客园

目录
相关文章
|
3天前
|
开发框架 监控 .NET
Visual Basic的Web服务和REST API开发指南
【4月更文挑战第27天】本文探讨了使用Visual Basic(VB.NET)构建Web服务和RESTful API的方法。首先介绍了Web服务的基础和REST API的概念,然后阐述了.NET Framework与.NET Core/.NET 5+对VB.NET的支持,以及ASP.NET Core在Web开发中的作用。接着,详细讲解了创建RESTful API的步骤,包括控制器与路由设置、模型绑定与验证,以及返回响应。此外,还讨论了安全措施、测试方法、部署选项和监控策略。最后强调,VB.NET开发者可以通过ASP.NET Core涉足现代Web服务开发,拓宽技术领域。
|
1月前
|
网络协议 Java Nacos
nacos常见问题之在web界面 上下线服务时报错 400如何解决
Nacos是阿里云开源的服务发现和配置管理平台,用于构建动态微服务应用架构;本汇总针对Nacos在实际应用中用户常遇到的问题进行了归纳和解答,旨在帮助开发者和运维人员高效解决使用Nacos时的各类疑难杂症。
33 0
|
1月前
|
监控 Serverless 测试技术
Serverless 应用引擎常见问题之做的web服务计费如何解决
Serverless 应用引擎(Serverless Application Engine, SAE)是一种完全托管的应用平台,它允许开发者无需管理服务器即可构建和部署应用。以下是Serverless 应用引擎使用过程中的一些常见问题及其答案的汇总:
408 3
|
12天前
|
JSON API 数据库
解释如何在 Python 中实现 Web 服务(RESTful API)。
在Python中实现Web服务(RESTful API)涉及选择框架(如Flask、Django、FastAPI),定义路由及处理函数(对应HTTP请求方法),处理请求,构建响应和启动服务器。以下是一个使用Flask的简单示例:定义用户列表,通过`@app.route`装饰器设置GET和POST请求处理函数,返回JSON响应,并用`app.run()`启动服务器。实际API会包含更复杂的逻辑和错误处理。
13 1
|
28天前
|
数据采集 Java API
python并发编程: Python使用线程池在Web服务中实现加速
python并发编程: Python使用线程池在Web服务中实现加速
18 3
python并发编程: Python使用线程池在Web服务中实现加速
|
1月前
javaWeb服务详解(含源代码,测试通过,注释) ——web.xml
javaWeb服务详解(含源代码,测试通过,注释) ——web.xml
7 0
|
1月前
|
XML JSON API
通过Flask框架创建灵活的、可扩展的Web Restful API服务
通过Flask框架创建灵活的、可扩展的Web Restful API服务
|
26天前
|
监控 JavaScript 前端开发
《理解 WebSocket:Java Web 开发的实时通信技术》
【4月更文挑战第4天】WebSocket是Java Web实时通信的关键技术,提供双向持久连接,实现低延迟、高效率的实时交互。适用于聊天应用、在线游戏、数据监控和即时通知。开发涉及服务器端实现、客户端连接及数据协议定义,注意安全、错误处理、性能和兼容性。随着实时应用需求增加,WebSocket在Java Web开发中的地位将更加重要。
|
1月前
|
Web App开发 前端开发 开发工具
介绍Web开发的基础知识
介绍Web开发的基础知识
29 7
|
6天前
|
设计模式 存储 前端开发
Java从入门到精通:2.2.1学习Java Web开发,了解Servlet和JSP技术,掌握MVC设计模式
Java从入门到精通:2.2.1学习Java Web开发,了解Servlet和JSP技术,掌握MVC设计模式