詳細介紹XML Web Service圖文程式碼實例

 

#對於初識XML Web Service並想快速上手的人，可能希望快速了解它的建立和呼叫方法。本文將以一個小範例來講述如何用Visual Studio 2008來建立Web Service以及如何來呼叫它。範例中的Web Service將根據客戶程式的請求來傳回一幅圖像。

#1.       #建立Web Service專案

開啟VS2008，選擇File/New/Project選單項，在開啟的New Project對話方塊中，依序選擇Visual C# -> Web -> ASP.NET Web Service Application，然後輸入項目名稱(Name)，存放位置(Position)和解決方案名稱(Solution Name)，點選「OK」產生項目。此範例中我們以AnnotationWebService作為專案和解決方案的名稱（見圖1）。

# 

圖片

1#：

New Project

對話方塊

################## ################## #############

2.       增加一個Web Service

 

在VS2008的Solution Explorer點選# AnnotationWebService項，選擇Project/Add new item選單項目，在開啟的Add New Item對話方塊中，依序選擇Web/Web Service，然後輸入Web Service的名稱(Name)，點擊「Add」來增加一個Web Service。此範例中我們以ImageService作為Web Service的名稱（見圖2）。

# 

#

#圖 2：Add New Item對話方塊

# 

## 之後，我們在Solution Explorer中會看到這樣的專案目錄（見圖3

）。 （注意：系統在建立專案時會缺省地增加一個

Web Service

，名字為

Service1，可以點擊其右鍵選單中的Delete

項目將其刪除。

#圖片

3

：Solution Explorer # 

#3.

      

##############################################################################################################################################################################################' ####為### Web Service###編碼################

右鍵點擊ImageService.asmx，選擇View Markup，可以開啟此文件，我們可以看到如下一行：

<%@ WebService Language="C#" CodeBehind="ImageService.asmx.cs" Class="AnnotationWebService.ImageService" %>

#它指示ImageService的程式碼在ImageService. asmx.cs檔案中。我們右鍵點擊ImageService.asmx，選擇View Code，開啟ImageService.asmx.cs文件，增加我們的服務程式碼，此例中，我們寫一個根據給定的檔案名稱讀取圖像並傳回給客戶端的方法GetImage（請參閱下面程式碼）。

#

using System.IO;
using System.Web;
using System.Web.Services;
using System.Web.Services.Protocols;
 
namespace AnnotationWebService
{
    /// <summary>
    /// Summary description for ImageService
    /// </summary>
    [WebService(Namespace = "http://tempuri.org/")]
    [WebServiceBinding(ConformsTo = WsiProfiles.BasicProfile1_1)]
    [System.ComponentModel.ToolboxItem(false)]
    // To allow this Web Service to be called from script, using ASP.NET AJAX, uncomment the following line.
    // [System.Web.Script.Services.ScriptService]
    public class ImageService : System.Web.Services.WebService
    {
 
        [WebMethod(Description="Request an image by name")]
        public byte[] GetImage(string imageFileName)
        {
            byte[] imageArray = GetBinaryFile(imageFileName);
            if (imageArray.Length < 2)
            {
                throw new SoapException("Could not open image on server.", SoapException.ServerFaultCode);
            }
            else
            {
                return imageArray;
            }
        }
 
        private byte[] GetBinaryFile(string fileName)
        {
            string fullPathFileName = HttpContext.Current.Request.PhysicalApplicationPath + fileName;
            if (File.Exists(fullPathFileName))
            {
                try
                {
                    FileStream fileStream = File.OpenRead(fullPathFileName);
                    return ConvertStreamToByteBuffer(fileStream);
                }
                catch
                {
                    return new byte[0];
                }
            }
            else
            {
                return new byte[0];
            }
        }
 
        public byte[] ConvertStreamToByteBuffer(Stream imageStream)
        {
            int imageByte;
            MemoryStream tempStream = new MemoryStream();
            while ((imageByte = imageStream.ReadByte()) != -1)
            {
                tempStream.WriteByte((byte)imageByte);
            }
            return tempStream.ToArray();
        }
    }
}

 

4.       在IIS中增加虛擬目錄(Virtual Directory)

開啟IIS控制台程序，右鍵點選Default Web Site，選擇增加New/Virtual Directory選單項，在開啟的Virtual Directory Caption Wizard對話方塊中輸入虛擬目錄別名(Alias)，此範例我們輸入AnnotationWebService，點選「Next ”，再選擇ImageService.asmx所在的目錄，再點選“Next”直到“Finish”。 （註：上述描述是基於XP SP3環境。）

##5.        為Web Service建立代理程式(Proxy)

在VS2008中，開啟一個Windows應用程式解決方案(.sln)，此範例中我們開啟一個叫做AnnotationApp的解決方案。在要呼叫Web Service的項目上（比如此例中我們選擇用DataLib）點擊右鍵，選擇Add Web Reference選單項目（如果從未新增過Web Reference，可能會看不到Add Web Reference選單項，我們可以先選擇Add Service Reference選單項，在彈出的Add Service Reference對話框中點擊“Advanced”，再在彈出的Service Reference Settings對話框裡點擊“Add Web Reference”），在在彈出的Add Web Reference對話方塊中，輸入我們要呼叫的Web Service的URL，此範例我們輸入：

 

#http://localhost/AnnotationWebService/ImageService.asmx

 

#

然後點擊“Go”，ImageService就會顯示在下面的Web Page裡，在Web reference name編輯框輸入Web引用的名字，為了避免再用ImageService這個名字，這裡我們輸入ImageWebService（見圖4），然後點選「Add Reference」來新增Web引用。

# 

圖

4#：

Add Web Reference

對話方塊

## ################### #############

這會在Solution Explorer中增加一個Web Reference（見圖5）。

# 

圖

5#：

Web Reference

被加入

 #新增的引用是Image Service的代理程式碼，其中包括一個與ImageService同名的類，派生於

System.Web.Services.Protocols.SoapHttpClientProtocol

。這樣在客戶程式碼中就可以像呼叫自己的

Assembly

裡的方法一樣呼叫ImageService的

GetImage

方法。

###################### #############

6. 客户程序调用Web Service

在客户程序中需要调取图像的地方增加如下代码（注：代码中的Image类不是.Net Framework类库中的Image类，是客户程序中的一个类）：

    ImageService imageService = new ImageService();
            Bitmap bitmap;
            try
            {
                byte[] image = imageService.GetImage("half-bred panthers.jpg");
                MemoryStream memoryStream = new MemoryStream(image);
                bitmap = new Bitmap(memoryStream);
                _image = new Image(_viewportTransformer, bitmap);
            }
            catch (WebException e)
            {
                // Exception handling
            }

 

然后，可以将图像显示出来。

 

7．运行客户程序来测试Web Service调用

 

编译运行客户程序，Web Service被成功调用并返回所调用的图像（见图6）。

 

#圖 6：執行結果

# 

## ################################

以上是詳細介紹XML Web Service圖文程式碼實例的詳細內容。更多資訊請關注PHP中文網其他相關文章！