public string[] GetSalesTagLines() {
string[] currentDeals = {
"Цены на Colt снижены на 50%",
"Bce BMW комплектуются 8-канальным звуком",
"Caravan бесплатно… спросите у дилера!"
};
return currentDeals;
}
[WebMethod(Description = "Сортировки списка марок")]
public string[] SortCarMakes(string[] theCarsToSort) {
Array.Sort(theCarsToSort);
return theCarsToSort;
}
}
Замечание. Страница тестирования, генерируемая с помощью DefaultWsdlHelpGenerator.aspx, не может вызывать методы, использующие в качестве параметров массивы типов.
Доступ к структурам
Протокол SOAP позволяет передачу XML.предcтавлений пользовательских типов данных (таких как классы и структуры). Web-сервисы XML используют тип XmlSerializer для преобразования типа в XML-код (см. главу 17, где имеется более подробная информация по этому поводу). Напомним, что XmlSerializer:
• не выполняет сериализацию приватных данных: для сериализации используются только открытые поля и свойства;
• требует, чтобы каждый позволяющий сериализацию класс имел конструктор, заданный по умолчанию;
• не требует использования атрибута [Serializable].
С учетом сказанного, наш следующий Web-метод будет возвращать массив структур SalesInfoDetails, определенных следующим образом.
// Пользовательский тип.
public struct SalesInfoDetails {
public string info;
public DateTime dateExpired;
public string Url;
}
Другим интересным моментом в отношении XmlSerializer является то, что этот тип позволяет осуществлять многослойный контроль представления типа. По умолчанию сериализация структуры SalesInfoDetails выполняется путем преобразования каждого поля данных поля в уникальный XML-элемент.
‹SalesInfoDetails›
‹info›Цены на Colt снижены на 50'%!‹/info›
‹dateExpired›2004-12-02T00:00:00.0000000-06:00‹/dateExpired›
‹Url›http://www.CarsRUs.com‹/Url›
‹/SalesInfoDetails›
Чтобы изменить поведение, предлагаемое по умолчанию, вы можете в определения своих типов добавить атрибуты, определенные в пространстве имен System.Xml.Serialization (снова см. главу 17).
public struct SalesInfoDetails {
public string info;
[XmlAttribute]
public DateTime dateExpired;
public string Url;
}
В результате будет получено следующее XML-представление данных.
‹SalesInfoDetails dateExpired="2004-12-02T00:00:00"›
‹info›Цены на Colt снижены на 50%!‹/info›
‹Url›http://www.CarsRUs.com‹/Url›
‹/SalesInfoDetails›
Реализация GetSalesInfoDetails() возвращает заполненный массив этой пользовательской структуры.
[WebMethod(Description="Get details of current sales")]
public SalesInfoDetails[] GetSalesInfoDetails() {
SalesInfoDetails[] theInfo = new SalesInfoDetails[3];
theInfo[0].info = "Цены на Colt снижены на 50%!";
theInfo[0].dateExpired = DateTime.Parse("12/02/04");
theInfo[0].Url = "http://www.CarsRUs.com";
theInfo[1].info = "Все BMW комплектуются 8-канальным звуком";
theInfo[1].dateExpired = DateTime.Parse("8/11/03");
theInfo[1].Url = "http://www.Bmws4U.com";
theInfo[2].info = "Caravan бесплатно… спросите у дилера!";
theInfo[2].dateExpired = DateTime.Parse("12/01/09");
theInfo[2].Url = "http://www.AllPinkVans.com";
return theInfo;
}
Доступ к типам DataSet ADO.NET
Чтобы завершить создание нашего Web-сервиса XML, вот вам еще един Web-метод, который возвращает DataSet с данными таблицы Inventory базы данных Cars, созданной при изучении ADO.NET в главе 22.
// Получение списка всех машин из таблицы Inventory.
[WebMethod(Description = "Возвращает список машин из таблицы Inventory базы данных Cars")]
pubic DataSet SetCurrentInventory() {
// Заполнение DataSet данными таблицы Inventory.
SqlConnection sqlConn = new SqlConnection();
sqlConn.ConnectionString = "data source=localhost;initial catalog=Cars;uid=sa;pwd=";
SqlDataAdapter myDA= new SqlDataAdapter("Select * from Inventory", sqlConn);
DataSet ds = new DataSet();
myDA.Fill(ds, "Inventorу");
return ds;
}
Исходный код. Файлы примера CarsSalesInfoWS размещены в подкаталоге, соответствующим главе 25.
Клиент Windows Forms
Чтобы проверить работу нового Web-сервисa XML, создайте приложение Windows Forms и укажите в нем ссылку на CarsSalesInfoWS, используя диалоговое окно Add Web Reference в Visual Studio 2005 (рис. 25.7).
Pиc. 25.7. Добавление ссылки на CarsSalesInfoWS
Теперь просто используйте генерируемый агент для вызова доступных Web-методов. Вот один из возможных вариантов реализации формы.
using CarsSalesInfoCLient.localhost;
…
namespace CarsSalesInfoClient {
public partial class MainWindow: Farm {
private CarSalesInfoWS ws = new CarSalesInfoWS();
…
private void MainWindow_Load(object sender, EventArgs e) {
// Привязка к таблице.
inventoryDataGridView.DataSource = ws.GetCurrentInventory().Tables[0];
}
private void btnGetTagLines_Click(object sender, EventArgs e) {
string[] tagLines = ws.GetSalesTagLines();
foreach (string tag in tagLines) listBoxTags.Items.Add(tag);
}
private void btnGetAllDetails_Click (object sender, EventArgs e) {
SalesInfoDetails[] theSkinny = ws.GetSalesInfoDetails();
foreach (SalesInfoDetails s in theSkinny) {
string d = string.Format("Info: {0}nURL:(1}nExpiration Date:{2}", s.info, s.Url, s.dateExpired);
MessageBox.Show(d, "Details");
}
}
}
На рис. 25.8 показан результат тестового запуска приложения.
Рис. 25.8. Клиент CarsSalesInfo
Представление типов на стороне клиента
Когда клиент устанавливает ссыпку на Web-сервис, предоставляющий доступ к пользовательским типам, файл класса агента получает определения для каждого отрытого пользовательского типа. Так, если вы посмотрите на представление клиента для SalesInfoDetails (в генерируемом файле Reference.cs), вы увидите, что каждое поле инкапсулировано в строго типизованное свойство (также обратите внимание на то, что этот тип теперь определен, как класс, а не как структура).
[System.SerializableAtttribute()]
[System.Xml.Serialization.XmlTypeAttribute(Namespace="http://IntertechTraining.com/")]
public partial class SalesInfoDetails {
private string infoField;
private string urlField;
private System.DateTime dateExpiredField;
public string info {
get { return this.infoField; }
set { this.infoField = value; }
}
public string Url {
get { return this.urlField; }
set { this.urlField = value; }
}
[System.Xml.Serialization.XmlAttributeAttribute()]
public System.DateTime dateExpired {
get { return this.dateExpiredField; }
set { this.dateExpiredField = value; }
}
}
При этом, конечно, следует понимать, что подобно случаю удаленного взаимодействия .NET, типы, сериализация которых выполняется по сети в формате XML, не сохраняют логику реализации. Поэтому, если структура SalesInfoDetails поддерживала ряд открытых методов, генератор агента учесть это не сможет (прежде всего, потому, что эти методы не отражены в документе WSDL!). Однако если вы установите компоновочный блок клиента, который будет содержать программный код реализации типа клиента, вы сможете использовать программную логику типа. Но при этом требуется, чтобы соответствующая машина обеспечивала поддержку .NET.
Исходный код. Проект CarSaleslnfoClient размещен в подкаталоге, соответствующем главе 25.
Стандарт поиска и взаимодействия (протокол UDDI)
Тот факт, что первый типичный шаг клиента при обращении к удаленному Web-серверу оказывается темой заключительного раздела этой главы, может казаться немного странным. Причиной этой несообразности является то, что процесс проверки существования (или отсутствия) данного Web-сервиса с помощью UDDI является не только необязательным, но во многих случаях вообще ненужным.
Пока Web-сервисы XML не стали де-факто стандартом распределенных вычислений, большинство Web-сервисов используется компаниями в жесткой связи с конкретным поставщиком. При этом и компания, и поставщик уже хорошо знают один другого, поэтому у них не возникает никакой необходимости запрашивать UDDI-сервер для выяснения вопроса о существовании Web-сервиса. Однако если создатель Web-сервиса XML пожелает открыть свободный доступ к функциональным возможностям своего Web-сервиса, этот Web-сервис можно внести в UDDI-каталог.
UDDI (Universal Description, Discovery and Integration – универсальное описание, поиск и взаимодействие, стандарт UDDI) является инициативой, позволяющей разработчикам Web-сервисов "выставить" коммерческий Web-сервис в общеизвестном хранилище. Независимо от того, что вы могли сейчас подумать, UDDI не является технологией, поддерживаемой исключительно фирмой Microsoft. На самом деле IBM и Sun Microsystems имеют не меньшую заинтересованность в успexe инициативы UDDI. Как и следует ожидать, UDDI-каталоги обслуживаются многими поставщиками. Например, посвященный UDDI официальный Web-сайт Microsoft доступен по адресу http://uddi.microsoft.com. Официальный Web-сайт UDDI (http://www.uddi.org) предлагает множество "белых книг" и SDK, которые позволяют строить внутренние UDDI-серверы.
