Sử dụng XML Web Services

Trước khi tạo .NET Compact Framework XML Web service client, XML Web Service client phải sử dụng được. Trong phần này chúng ta tạo một Web service, và tạo một a .NET Compact Framework client để sử dụng Web service. XML Web service trả về thông tin của một cá nhân.

Thông tin của người đó được lưu trong CSDL Microsoft SQL Server. Khi một yêu cầu được tạo ra, XML Web service sẽ truy vấn một trích dẫn ngâu nghiên và trả về thông tin trích dẫn. Chúng ta cần phải thiết lập CSDL này trước khi chúng ta có thể chạy ví dụ này.

Để tạo XML Web service trong Visual Studio.NET, sử dụng ASP.NET Web Service template. Tên dự án là

QuotableQuotesWebService

Service1

Service1.asmx.

QuoteService

.aspx

QuoteService.aspx.

XML Web service sẽ đưa ra một phương thức web,

GetQuote

QuotableQuotes

GetQuote

GetQuote

QuotableQuotes

GetQuote

sqlConnection1

sqlCommand1

sqlConnection1

SqlConnection

QuotableQuotes

sqlCommand1

SqlCommand

sqlConnection1

sqlCommand1

quoteConnection 

cmdGetQuote

Trước khi thực thi

GetQuote,

cmdGetQuote 

integer

QuotableQuote

GetLargestQuoteIdentifier

GetLargestQuoteID

cmdGetLargestID

 QuoteService

Listing 7.1

public Int64 LargestID
{
get
{
object largestID = cmdGetLargestID.ExecuteScalar();
if(largestID== null || !(largestID is Int64))
return -1;

return (Int64)largestID;
}
}

Trước khi viết mã lệnh để nhận giá trị lớn nhất của trường khóa từ bảng

Quotes

cmdGetLargestID SqlCommand

Sau khi nhận giá trị của trường khóa lớn nhất, một giá trị IP ngâu nghiên được tạo. Làm điều này cùng với lớp

System.Random

System.Random

Next

(Int32).

Next

(Int32),

Phương thức sẽ trả về cấu trúc dữ liệu khách hàng, cấu trúc này chứa đựng thông tin trích dẫn. Listing 7.2 chứa đựng lớp

Quote

QuoteService.aspx

Li st ing 7 . 2

public class Quote
{
public string String; 
public string Author; 
public string Date;
}

Phương thức

GetQuote

GetQuote

Bước 1: Phát sinh một giá trị

Quote

Bước 2: Lấy dữ liệu trích dẫn từ CSDL. Bước 3: Điền vào cấu trúc dữ liệu

Quote

Quote

Trong đoạn mã Listing 7.3 đưa đến phương thức Hello World trong file

QuoteService.aspx.

Listing 7.3

[WebMethod]
public Quote GetQuote()
{
quoteConnection.Open();

try
{
Int64 largestID = LargestID;
if(-1 == largestID)
return null;
Random rand = new Random(DateTime.Now.Millisecond);
Int64 randomQuoteId = rand.Next((int)largestID);
cmdGetQuote.Parameters["@id"] =
new SqlParameter("@id", randomQuoteId);
SqlDataReader reader = cmdGetQuote.ExecuteReader();
if(!reader.Read())
return null;
Quote q = new Quote();
q.String = reader.GetString(0);
// Get Quote String q.Author = reader.GetString(1);
// Get author's name q.Date = reader.GetString(2);
// Get the spoken date
return q;
}
finally
{
quoteConnection.Close();
}
}

Trước tiên kết nối với CSDL

QuotableQuotes

quoteConnection

System.Random

cmdGetQuote SqlCommand

ExecuteReader

SqlComman

SqlDataReader

SqlDataReader

finally

SqlClient

System.Data.SqlClient

QuoteService.aspx

Mặc định , một Web service mới được đưa vào không gian tên http://tempura.org. Microsoft khuyến cáo rằng mỗi XML Web service có một không gian tên XML duy nhất. Điều này cho phép ứng dụng client chỉ ra sự khác biệt nó với các dịch vụ khác trên Web. Có thể hoàn thành bằng cách áp dụng thuộc tính

WebServiceAttribute

QuoteService

[WebService(Namespace="http://netcfkickstart/QuoteService",
 Description="Provides access to famous quotes")]
    

Thay đổi thuộc tính không gian tên của

QuoteService

Cùng với thuộc tính

WebServiceAttribute

QuoteService

WebServiceAttribute

Service Description

GetQuote

GetQuote

Trang kiểm thử này cung cấp một vài thông tin. Chọn vào nút

Invoke

GetQuote

<?xml version="1.0" encoding="utf-8" ?>
    <Quote xmlns:xsd="http://www.w3.org/2001/XMLSchema"
 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <String>
"Once you eliminate the impossible, whatever remains,
 no matter how improbable, must be the truth."
    </String>
    <Author>Sherlock Holmes</Author>
    <Date>1859-1930</Date>
</Quote>
    

Bên cạnh sự cung cấp khả năng kiểm thử Web service, trang này còn cung cấp ba ví dụ về cách yêu cầu Web service và ví dụ trả về. Ví dụ này bao gồm định dạng cho

HTTP-POST

HTTP-GET

SOAP

Sử dụng giao thức HTTP và thông điệp SOAP, Web service client có thể gửi yêu cầu và thể hiện thông tin trả về từ Web server. Hình 7.1 mô tả thời gian tồn tại của một phương thức Web gọi từ client tới Web server.

Sau đây là danh sách mô tả 9 bước trong thời gian tồn tại của phương thứcWeb method.

Bước1: Ứng dụng client tạo một thể hiện lớp proxy. Proxy là lớp thông điệp giao tiếp giữa ứng dụng client và Web service. Ứng dụng client gọi một phương thức trên lớp proxy

Bước2: Proxy, sử dụng kiến trúc Web service bên phía client, tuần tự hóa XML Web service yêu cầu và đóng gói nó trong thông điệp SOAP.

Bước 3: Thông điệp SOAP sau đó gửi tới Web server thông qua HTTP.

Bước 4: Kiến trúc Web service phía server nhận và hủy tuần tự hóa thông điệp SOAP.

Bước5: Sử dụng thông điệp SOAP, lớp thể hiện Web service được tạo. Tiếp theo, đối số của phương thức Web được tạo từ thông điệp SOAP. Cuối cùng, phương thứ Web được gọi cùng với đối số riêng.

Bước6: Kiến trúc Web service phía server đóng gói đưa ra tham số và trả về giá trị vào thông điệp SOAP.

Bước 7: Thông điệp SOAP được gửi trở lại client thông qua HTTP.

Bước8: Kiến trúc Web service phía client nhận thông điệp SOAP và hủy tuần tự hóa tham số đưa ra và trả về giá trị. Giá trị được trả về lớp proxy.

Bước 9: Lớp proxy trả về tham số đầu ra và trả về giá trị tới ứng dụng client.

Bây giờ chúng tạo một client cho

QuotableQuotes

Get Quote

Thêm Web Reference vào Client Application

Bây giờ, Web tham chiếu đến dịch vụ cần thiết thêm vào dự án client. Để làm điều này, vào Solution Explorer, bấm chuột phải vào mục

Reference

, và chọn

Add Web References 

.... Hộp thoại Add Web Reference như hình (hinh sau) Hộp thoại Web Reference.

Hộp thoại Add Web Reference giúp xác định Web Services và sử dụng chúng trong ứng dụng. Hộp thoại hiển thị bốn liên kết. Một liên kết cho phép chúng ta xem tất cả XML Web services trên máy. Ba liên kết khác liên kết đến ba UDDI servers/directories. Liên kết "Browse UDDI Servers on the local machine" cho phép chúng ta duyệt UDDI servers trên mạng cục bộ.

hai liên kết khác có nhãn là UDDI Directory và UDDI Directory cung cấp truy cập tới dịch vụ đã được đăng ký với Microsoft. Liên kết "UDDI Directory" duyệt UDDI business registry để tìm công ty và sản phẩm Web services. Liên kết "Test Microsoft UDDI Directory" xác định XML Web services kiểm thử, có nghĩa là được sử dụng trong quá trình phát triển.

Trong ví dụ này

QuotableQuotes

XML Web service sẽ không đăng ký với UDDI. Thay vì đăng ký

QuotableQuotes 

XML Web service cùng với UDDI, địa chỉ trang

QuoteService.aspx

sẽ được đưa vào trong hộp thoại Add Web Reference. Đưa vào địa chỉ URL sau,

http://localhost/QuotableQuotesWebService/QuoteService.asm

x

, vào trong hộp text

Address 

và bấm

Enter

hoặc nút

Go

.

Hộp thoại sẽ download file WSDL cho QuoteService Web service. Quá trình download được hoàn thành, bâm vào nút Add Reference.

Quote

Quote

Quote

[System.Xml.Serialization.XmlTypeAttribute
( Namespace="http://netcfkickstart/QuoteService")] 
public class Quote { /// <remarks/>
    public string String;
    /// <remarks/>
    public string Author;
/// <remarks/>
public string Date;
    }
    

System.Xml.Serialization.XmlTypeAttribute

Get Quote.

using QuotableQuotesClient.QuoteServiceWebReference;
    

private void btnGetQuote_Click(object sender, System.EventArgs e)
{
QuoteService qs = new QuoteService(); Quote quote = qs.GetQuote();
if(null == quote)
{
MessageBox.Show("An error occurred retrieving a quote");
Return;
}
UpdateQuoteUI(quote);
}

UpdateQuoteUI

UpdateQuoteUI

private void UpdateQuoteUI(Quote quote)
{
lblQuote.Text = quote.String;
lblAuthor.Text = "- " + quote.Author;
lblDate.Text = ( quote.Date == "Unknown" ) ?
string.Empty :
quote.Date;
}

 GetQuote

GetQuote

eginWebMethod

EndWebMethod

WebMethod

QuoteService

BeginGetQuote

EndGetQuote

BeginWebMethod

WebMethod

GetQuote

BeginGetQuote

System.AsyncCallback

System.IAsyncResult

public static void GetQuoteCallBack(IAsyncResult ar)
    {
      MessageBox.Show("GetQuote completed");
    }
    

private void btnGetQuote_Click(object sender, System.EventArgs e)
{
QuoteService qs = new QuoteService();
// Set the url of the proxy to the proper url of the web service

AsyncCallback getQuoteCB = new AsyncCallback( QuotableQuotesClient.Form1.GetQuoteCallBack);

object[] callBackState = {qs, this};
qs.BeginGetQuote(getQuoteCB, callBackState);
}

AsycnCallback

GetQuoteCallBack

BeginGetQuote

GetQuoteCallBack

public static void GetQuoteCallBack(IAsyncResult ar)
{
object[] callBackState = (object[])ar.AsyncState; 
QuoteService qs = (QuoteService)callBackState[0];
 Form1 app = (Form1)callBackState[1];
Quote quote = qs.EndGetQuote(ar);
if(null == quote)
{
MessageBox.Show("No quote object received.");
return;
}

app.UpdateQuoteUI(quote);
}

XML Web service đã trả về cấu trúc dữ liệu khách hàng. .NET Compact Framework cung cấp khả năng truyền sự kiện nhiều dữ liệu phức tạp, giống như là

DataSet

 DataSet

Gửi và nhận một DataSet thường xuyên được hoàn thành chính xác giống như là gửi cấu trúc dữ liệu hoặc những phẫn dữ liệu đơn giản, như là chuỗ. Phương thức Web đơn giản cần chấp nhận hoặc trả về đối tượng

System.Data.DataSet

Quotes

GetQuote

Có một stored procedure trong CSDL

QuotableQuotes

GetQuotes

Quotes.

cmdGetQuotes

GetQuotes

QuoteService

DataSet

DataSet

SqlDataAdapter

cmdGetQuotes

[WebMethod]
public DataSet GetQuotes()
{
quoteConnection.Open();
try
{
DataSet quotesDS = new DataSet();
SqlDataAdapter quotesDa = new SqlDataAdapter(this.cmdGetQuotes);
quotesDa.Fill(quotesDS);
return quotesDS;
}
finally
{
quoteConnection.Close();
}
}

Dịch và thử phương thức Web trong cách giống với phương thức

GetQuote

Lần này kết quả sẽ trả về một trang dài XML tới trình đuyệt. XML đơn giản dưa ra XML từ

DataSet.WriteXml

DataSet

DataSet.WriteXml

Bay giờ chúng ta tạo một ứng dụng client sử dụng

DataSet

QuotableQuotesClient

Form1

private DataSet quotesDataSet;
    private int curQuoteRowNdx;
    

Bấm đúp vào nút Get Quotes sẽ đưa đến sự kiện click. Listing 7.9chứa mã nguồn.

Listing 7.9

private void btnQuote_Click(object sender, System.EventArgs e)
    {
     if(null == quotesDataSet)
      {
        
    QuoteService qs = new QuoteService();
    // Set the proxy's url property to the correct url of the server
quotesDataSet = qs.GetQuotes();
curQuoteRowNdx = 0;
    }
if( quotesDataSet.Tables.Count <= 0 )
{MessageBox.Show("Could not retreive the quotes dataset.");
    return;
    }
if(curQuoteRowNdx >= quotesDataSet.Tables[0].Rows.Count)
curQuoteRowNdx = 0;
DataRow quote = quotesDataSet.Tables[0].Rows[curQuoteRowNdx];
curQuoteRowNdx++;
UpdateQuoteUI(quote, 0);
}

Quotes

DataSet

 DataSet

null

DataSet

DataSet

Nếu quotes

DataSet

QuoteService

GetQuotes 

Tương ứng với

DataRow

DataSet

UpdateQuoteUI

UpdateQuoteUI

DataRow 

offset

Int32

Listing 7.10 chứa đựng sự thực thi của phương thức

 UpdateQuoteUI

Listing 7.10

private void UpdateQuoteUI(DataRow quote, int offset)
{
lblQuote.Text = (string)quote[offset];
lblAuthor.Text = "-" + quote[offset + 1];
lblDate.Text = "Unknown" == (string)quote[offset + 2] ?
string.Empty : (string)quote[offset + 2];
}

Dịch và chạy ứng dụng. Ứng dụng sẽ hành động chính xác như nó đã làm trước, ngoại trừ trích dẫn sẽ lặp lại ngoại trừ hiển thị theo thứ tự không định trước.

.NET Compact Framework không hỗ trợ kiểu

DataSet

DataSet

Có công việc xung quanh vấn đề sử dụng kiểu

DataSet

- Thay đổi XML Web service để sử dụng

DataSet

- Thay đổi XML Web Service để đưa ra

DataSet

- Tạo một XML Web service mới sử dụng kiểu DataSet nguyên bản và chuyển nó

DataSet 

Có hai lựa chọn có thể dường như giống nhau, nhưng chúng khác nhau. Lựa chọn đề xuất là chúng ta loại bỏ toàn bộ tất cả thể hiện của kiểu

DataSet

DataSet 

DataSet

DataSet

DataSet

Đơn giản là ghi ra một XML Web service để đưa ra

DataSet

DataSet

QuoteableQuotes 

Quotes

<ServerName>SQLServers<ServerInstanceName>QuotableQuotesTables. 
    

Kéo bảng

Quotes

SqlDataAdapter

DataSet

Quotes

SqlDataAdapter

daQuotesDS

Bấm vào

SqlDataAdapter

Data

DataSet

QuotesDataSet

DataSet

Quotes

Tạo một phương thức Web tên là

GetTypeQuotes

DataSet

QuotesDataSet

DataSet

DataSet

DataSet

Listing 7.11

[WebMethod]
public DataSet GetTypedQuotes()
{
quoteConnection.Open(); 
try
{
QuotesDataSet quotesDS = new QuotesDataSet();
this.daQuotesDS.Fill(quotesDS);

return quotesDS;
}
finally
{quoteConnection.Close();
}
}

Để kết thúc ví dụ về Quotable Quotes DataSet client cần phải thay đổi để sử dụng phương thức

GetTypedQuotes

GetTypeQuotes

GetQuotes

offset

UpdateQuoteUI

DataRow

Listing 7.12

private void btnQuote_Click(object sender, System.EventArgs e)
{
if(null == quotesDataSet)
{
QuoteService qs = new QuoteService();
// Set the proxy's url property to the correct url of the server
quotesDataSet =	qs.GetTypedQuotes();
curQuoteRowNdx = 0;
}
if(quotesDataSet.Tables.Count >= 0)
{
MessageBox.Show("Could not retreive the quotes dataset.");
    return;
    
}
if(curQuoteRowNdx >= quotesDataSet.Tables[0].Rows.Count)
curQuoteRowNdx = 0;
DataRow quote = quotesDataSet.Tables[0].Rows[curQuoteRowNdx];
    
curQuoteRowNdx++;
UpdateQuoteUI(quote, 1);
}

- .NET Compact Framework cung cấp khả năng cho ứng dụng sử XML Web services.

- .NET Compact Framework cung cấp khả năng cho sử dụng dữ liệu đơn giản, như là chuỗi, dữ liệu phức tạp, như là cấu trúc dữ liệu người dùng tự định nghĩa và DataSet.

- .NET Compact Framework hỗ trợ đồng bộ và không đồng bộ gọi XML Web service..