分享
 
 
 

ASP.NET创建Web服务之发布和部署

王朝asp·作者佚名  2006-11-24
窄屏简体版  字體: |||超大  

部署一个XML Web服务包括复制.asmx文件和任何XML Web服务使用的汇编文件,而不要把Microsoft.NET Framework的一部分作为Web服务器上的虚拟目录。有关如何部署一个XML Web服务的信息,请参见"部署XML Web服务"。XML Web服务对使用发现机制的用户适用。用户可以浏览一个特殊的发现文件或Web服务器的根来定位发现文件。从这些文件中,他们可以判断那些服务对他们来说有用。

部署XML Web服务

部署一个XML Web服务包括把.asmx文件和任何XML Web服务使用的汇编文件,而不是Microsoft.NET Framework的一部分,复制到Web服务器上。

例如,假设你把一个XML Web服务命名为StockServices。为了部署XML Web服务,你需要在你的Web服务器上创建一个虚拟目录和把XML Web服务的.asmx文件放入这个目录。这个虚拟目录还应该是一个IIS Web应用程序,虽然它不是必需的。一个典型的部署将有下面的目录结构:

\Inetpub

\Wwwroot

\StockServices

StockServices.asmx

\Bin

你的XML Web服务使用的汇编不是Microsoft.NET Framework一部分的。

XML Web服务发布的条目

当你发布一个XML Web服务时,下列条目用来部署一个Web服务器。

条目

描述

Web应用程序目录

作为你的XML Web服务的根目录。所有的文件都存放在这个目录中。这个目录应该被标记为一个IIS Web应用程序所用。

<MyXMLWebService>.asmx 文件

调用XML Web服务的客户端的基本URL。这个文件可以为任何有效的文件名。

<MyXMLWebService>.disco文件

(可选的)作为XML Web服务的发现机制。.disco文件不会自动地为XML Web服务创建。这个文件可以为任何有效的文件名。

Web.config文件

(可选择的)如果你需要覆盖默认配置设置,你可以包含一个web.config文件。XML Web服务使用这个配置文件来允许系统的定制和可扩展性。例如,如果在系统中你的XML Web服务需要验证而其他的Web应用程序不需要的话,你可以提供一个该XML Web服务特定的web.config文件。

\Bin目录

包含用于这个XML Web服务的二进制文件。如果你的XML Web服务类和.asmx文件不在同一个目录下,那么包含类的部件必须在\Bin目录中。

发现一个XML Web服务

XML Web服务发现是定位和询问XML Web服务描述的过程,这是访问一个XML Web服务的预备步骤。通过发现过程,XML Web服务客户端可以在设计时得知一个XML Web服务存在,它能做什么以及如何适当的与之交互。

可以在XML Web服务发布一个.disco文件时编程发现,.disco是一个包含与其它发现文档、XSD模式和服务描述连接的XML文档。换句话说,使用ASP.NET创建的XML Web服务自动地有提供一个产生发现文档的能力。当使用带有?DISCO的URL访问时,一个发现文档自动地为XML Web服务生成。例如,如果到一个XML Web服务的URL是www.contoso.com/getquote.asmx,然后自动以www.contoso.com/getquote.asmx?DISCO生成一个发现文档。

为了使能发现一个XML Web服务:

使用你喜欢的编辑器创建一个XML文档,把标记<?xml version="1.0"?>添加到第一行。

在这个XML文档内添加一个<discovery>元素,如:

<disco:discovery xmlns:disco="http://schemas.xmlsoap.org/disco/">

</disco:discovery>

在<discovery>元素内,添加到服务描述、XSD模式和其他发现文档的引用。

你可以添加对任意你想公开的引用。服务描述引用在一个发现文档中通过使用http://schemas.xmlsoap.org/disco/scl/ XML域名空间添加一个<contractRef>元素来指定。同样地,对其它的发现文档和XSD模式的引用分别通过添加<discoveryRef>和<schemaRef> XML元素来指定。对于XSD模式引用,必须指定XML域名空间http://schemas.xmlsoap.org/disco/schema。。下面的代码示例有对于发现文档、服务描述和一个XSD模式的引用。

<?xml version="1.0"?>

<discovery xmlns="http://schemas.xmlsoap.org/disco/">

<discoveryRef ref="/Folder/Default.disco"/>

<contractRef ref="http://MyWebServer/UserName.asmx?WSDL"

docRef="Service.htm"

xmlns="http://schemas.xmlsoap.org/disco/scl/"/>

<schemaRef ref="Schema.xsd"

xmlns="http://schemas.xmlsoap.org/disco/schema/"/>

</discovery>

引用可以与发现文档存在于的目录有关,就如在discoveryRef元素所示,或与一个URI有关,就如在contractRef元素所示。

通过复制发现文档到Web服务器的一个虚拟目录下,把发现文档部署到这台Web服务器上。

选择性地,如果你想要通过指定一个IIS应用程序而不需要指定一个文档来允许预期消耗者导航到一个URL,那么你可以添加一个到IIS应用程序的默认的页面。这对预期消耗者有益,他们不必知道任意发现文档的名称。用户可以提供想下面发现过程中的URL:

http://MyWebServer/MyWebApplication

如果用于Web应用程序的默认页面是一个HTML页面:

在用于Web服务器的默认Web的页面的<head>标记中添加一个链接到发现文档。例如,如果你命名你的发现文档MyWebService.disco并把它放入与默认页面相同的目录中,你需要放置下面的标记到默认的Web页面中。

<HEAD>

<link type='text/xml' rel='alternate' href='MyWebService.disco'/>

</HEAD>

如果用于Web应用程序的默认页面是一个XML文档:

在用于Web服务器的默认Web的页面的<head>标记中添加一个链接到发现文档。例如,如果你命名你的发现文档MyWebService.disco并把它放入与默认页面相同的目录中,你需要放置下面的代码到默认的Web页面的顶端。

<?xml-stylesheet type="text/xml" alternate="yes" href="MyWebService.disco" ?>

选择性地,如果你使用Visual Studio.NET,你可以开启动态的发现来允许XML Web服务客户端应用程序来在一个没有创建发现文档的Web服务器上发现可用的XML Web服务。当动态发现开启的时候,客户应用程序在Add Web Reference对话框中指定一个引用带有.vsdisco部分的文件的URL,例如www.contoso.com/default.vsdisco,来代替特定的发现文档。

为了开启用于一个Web服务器的动态发现,要修改machine.config来添加下面的<add>元素。

<configuration>

<system.web>

<httpHandlers>

<add verb="*" path="*.vsdisco"

type="System.Web.Services.Discovery.DiscoveryRequestHandler,

System.Web.Services, Version=1.0.3300.0,

Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a"

validate="false"/>

</httpHandlers>

</system.web>

</configuration>

注意:当动态发现开启的时候,所有的XML Web服务和存在于Web服务器的发现文档都是可发现的。因此,当开启动态发现时必须小心,因为如果Web服务器不在带有隔火墙的安全网络中的话,它可能会在无意中暴露敏感数据。

部署一个XML Web服务包括复制.asmx文件和任何XML Web服务使用的汇编文件,而不要把Microsoft.NET Framework的一部分作为Web服务器上的虚拟目录。有关如何部署一个XML Web服务的信息,请参见"部署XML Web服务"。XML Web服务对使用发现机制的用户适用。用户可以浏览一个特殊的发现文件或Web服务器的根来定位发现文件。从这些文件中,他们可以判断那些服务对他们来说有用。

部署XML Web服务

部署一个XML Web服务包括把.asmx文件和任何XML Web服务使用的汇编文件,而不是Microsoft.NET Framework的一部分,复制到Web服务器上。

例如,假设你把一个XML Web服务命名为StockServices。为了部署XML Web服务,你需要在你的Web服务器上创建一个虚拟目录和把XML Web服务的.asmx文件放入这个目录。这个虚拟目录还应该是一个IIS Web应用程序,虽然它不是必需的。一个典型的部署将有下面的目录结构:

\Inetpub

\Wwwroot

\StockServices

StockServices.asmx

\Bin

你的XML Web服务使用的汇编不是Microsoft.NET Framework一部分的。

XML Web服务发布的条目

当你发布一个XML Web服务时,下列条目用来部署一个Web服务器。

条目

描述

Web应用程序目录

作为你的XML Web服务的根目录。所有的文件都存放在这个目录中。这个目录应该被标记为一个IIS Web应用程序所用。

<MyXMLWebService>.asmx 文件

调用XML Web服务的客户端的基本URL。这个文件可以为任何有效的文件名。

<MyXMLWebService>.disco文件

(可选的)作为XML Web服务的发现机制。.disco文件不会自动地为XML Web服务创建。这个文件可以为任何有效的文件名。

Web.config文件

(可选择的)如果你需要覆盖默认配置设置,你可以包含一个web.config文件。XML Web服务使用这个配置文件来允许系统的定制和可扩展性。例如,如果在系统中你的XML Web服务需要验证而其他的Web应用程序不需要的话,你可以提供一个该XML Web服务特定的web.config文件。

\Bin目录

包含用于这个XML Web服务的二进制文件。如果你的XML Web服务类和.asmx文件不在同一个目录下,那么包含类的部件必须在\Bin目录中。

发现一个XML Web服务

XML Web服务发现是定位和询问XML Web服务描述的过程,这是访问一个XML Web服务的预备步骤。通过发现过程,XML Web服务客户端可以在设计时得知一个XML Web服务存在,它能做什么以及如何适当的与之交互。

可以在XML Web服务发布一个.disco文件时编程发现,.disco是一个包含与其它发现文档、XSD模式和服务描述连接的XML文档。换句话说,使用ASP.NET创建的XML Web服务自动地有提供一个产生发现文档的能力。当使用带有?DISCO的URL访问时,一个发现文档自动地为XML Web服务生成。例如,如果到一个XML Web服务的URL是www.contoso.com/getquote.asmx,然后自动以www.contoso.com/getquote.asmx?DISCO生成一个发现文档。

为了使能发现一个XML Web服务:

使用你喜欢的编辑器创建一个XML文档,把标记<?xml version="1.0"?>添加到第一行。

在这个XML文档内添加一个<discovery>元素,如:

<disco:discovery xmlns:disco="http://schemas.xmlsoap.org/disco/">

</disco:discovery>

在<discovery>元素内,添加到服务描述、XSD模式和其他发现文档的引用。

你可以添加对任意你想公开的引用。服务描述引用在一个发现文档中通过使用http://schemas.xmlsoap.org/disco/scl/ XML域名空间添加一个<contractRef>元素来指定。同样地,对其它的发现文档和XSD模式的引用分别通过添加<discoveryRef>和<schemaRef> XML元素来指定。对于XSD模式引用,必须指定XML域名空间http://schemas.xmlsoap.org/disco/schema。。下面的代码示例有对于发现文档、服务描述和一个XSD模式的引用。

<?xml version="1.0"?>

<discovery xmlns="http://schemas.xmlsoap.org/disco/">

<discoveryRef ref="/Folder/Default.disco"/>

<contractRef ref="http://MyWebServer/UserName.asmx?WSDL"

docRef="Service.htm"

xmlns="http://schemas.xmlsoap.org/disco/scl/"/>

<schemaRef ref="Schema.xsd"

xmlns="http://schemas.xmlsoap.org/disco/schema/"/>

</discovery>

引用可以与发现文档存在于的目录有关,就如在discoveryRef元素所示,或与一个URI有关,就如在contractRef元素所示。

通过复制发现文档到Web服务器的一个虚拟目录下,把发现文档部署到这台Web服务器上。

选择性地,如果你想要通过指定一个IIS应用程序而不需要指定一个文档来允许预期消耗者导航到一个URL,那么你可以添加一个到IIS应用程序的默认的页面。这对预期消耗者有益,他们不必知道任意发现文档的名称。用户可以提供想下面发现过程中的URL:

http://MyWebServer/MyWebApplication

如果用于Web应用程序的默认页面是一个HTML页面:

在用于Web服务器的默认Web的页面的<head>标记中添加一个链接到发现文档。例如,如果你命名你的发现文档MyWebService.disco并把它放入与默认页面相同的目录中,你需要放置下面的标记到默认的Web页面中。

<HEAD>

<link type='text/xml' rel='alternate' href='MyWebService.disco'/>

</HEAD>

如果用于Web应用程序的默认页面是一个XML文档:

在用于Web服务器的默认Web的页面的<head>标记中添加一个链接到发现文档。例如,如果你命名你的发现文档MyWebService.disco并把它放入与默认页面相同的目录中,你需要放置下面的代码到默认的Web页面的顶端。

<?xml-stylesheet type="text/xml" alternate="yes" href="MyWebService.disco" ?>

选择性地,如果你使用Visual Studio.NET,你可以开启动态的发现来允许XML Web服务客户端应用程序来在一个没有创建发现文档的Web服务器上发现可用的XML Web服务。当动态发现开启的时候,客户应用程序在Add Web Reference对话框中指定一个引用带有.vsdisco部分的文件的URL,例如www.contoso.com/default.vsdisco,来代替特定的发现文档。

为了开启用于一个Web服务器的动态发现,要修改machine.config来添加下面的<add>元素。

<configuration>

<system.web>

<httpHandlers>

<add verb="*" path="*.vsdisco"

type="System.Web.Services.Discovery.DiscoveryRequestHandler,

System.Web.Services, Version=1.0.3300.0,

Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a"

validate="false"/>

</httpHandlers>

</system.web>

</configuration>

注意:当动态发现开启的时候,所有的XML Web服务和存在于Web服务器的发现文档都是可发现的。因此,当开启动态发现时必须小心,因为如果Web服务器不在带有隔火墙的安全网络中的话,它可能会在无意中暴露敏感数据。

 
 
 
免责声明:本文为网络用户发布,其观点仅代表作者个人观点,与本站无关,本站仅提供信息存储服务。文中陈述内容未经本站证实,其真实性、完整性、及时性本站不作任何保证或承诺,请读者仅作参考,并请自行核实相关内容。
2023年上半年GDP全球前十五强
 百态   2023-10-24
美众议院议长启动对拜登的弹劾调查
 百态   2023-09-13
上海、济南、武汉等多地出现不明坠落物
 探索   2023-09-06
印度或要将国名改为“巴拉特”
 百态   2023-09-06
男子为女友送行,买票不登机被捕
 百态   2023-08-20
手机地震预警功能怎么开?
 干货   2023-08-06
女子4年卖2套房花700多万做美容:不但没变美脸,面部还出现变形
 百态   2023-08-04
住户一楼被水淹 还冲来8头猪
 百态   2023-07-31
女子体内爬出大量瓜子状活虫
 百态   2023-07-25
地球连续35年收到神秘规律性信号,网友:不要回答!
 探索   2023-07-21
全球镓价格本周大涨27%
 探索   2023-07-09
钱都流向了那些不缺钱的人,苦都留给了能吃苦的人
 探索   2023-07-02
倩女手游刀客魅者强控制(强混乱强眩晕强睡眠)和对应控制抗性的关系
 百态   2020-08-20
美国5月9日最新疫情:美国确诊人数突破131万
 百态   2020-05-09
荷兰政府宣布将集体辞职
 干货   2020-04-30
倩女幽魂手游师徒任务情义春秋猜成语答案逍遥观:鹏程万里
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案神机营:射石饮羽
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案昆仑山:拔刀相助
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案天工阁:鬼斧神工
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案丝路古道:单枪匹马
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案镇郊荒野:与虎谋皮
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案镇郊荒野:李代桃僵
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案镇郊荒野:指鹿为马
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案金陵:小鸟依人
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案金陵:千金买邻
 干货   2019-11-12
 
推荐阅读
 
 
 
>>返回首頁<<
 
靜靜地坐在廢墟上,四周的荒凉一望無際,忽然覺得,淒涼也很美
© 2005- 王朝網路 版權所有