Просмтор этого файла доступен только зарегистрированным пользователям. Но у нас супер быстрая регистрация: достаточно только электронной почты!

Текст из файла

Национальный Исследовательский Университет

МОСКОВСКИЙ ЭНЕРГЕТИЧЕСКИЙ ИНСТИТУТ

Институт автоматики и вычислительной техники

Кафедра прикладной математики

Лабораторная работа № 1

Разработка сервиса с применением

Windows Communication Foundation

Курс «Проектирование крупных распределенных программных систем и баз данных»

Выполнил

студент группы А-13-08

Захаров Антон

Преподаватель

Куриленко Иван Евгеньевич

Москва, 2012

Цель работы

Научиться разрабатывать сервисные приложения с применением WCF и Microsoft Visual Studio 2010.

Требования

• Наличие сервера

• Наличие клиента

• Наличие механизма передачи событий сервера на сторону клиента

• Умение настраивать Endpoint-ы

• Умение получить WSDL сервиса

Теоретическое введение

Сервис-ориентированная архитектура (SOA, англ. service-oriented architecture) — модульный подход к разработке программного обеспечения, основанный на использовании распределённых, слабо связанных заменяемых компонентов, оснащённых стандартизированными интерфейсами для взаимодействия по стандартизированным протоколам.

Windows Communication Foundation (WCF) – платформа нового поколения для построения распределенных систем, выпущенная в составе .NET Framework 3.0. Класс службы WCF не может существовать самостоятельно. Каждая служба WCF должна находиться под управлением некоторого процесса Windows, называемого хостовым процессом.

Контракт представляет собой описание сообщений, передаваемых оконечным точкам службы и возвращаемых ей. Каждая оконечная точка определяется своими АПК: Адресуемым местом в сети, куда посылаются сообщения; Привязкой, описывающей способ передачи сообщений, и Контрактом, в котором оговорены форматы сообщений. Служба можно рассматривать как набор оконечных точек, которые реализуют те или иные программно-закодированные алгоритмы.

Это может быть бизнесфункция высокого уровня, например ввод заказа в систему, или более специализированная функция, как, скажем, поиск адреса клиента.

Для высокоуровневых функций обычно требуются сложные структуры данных, тогда как для более простых часто хватает базовых типов. В любом случае оконечная точка должна специфицировать, какие операции она может выполнять, и формат ожидаемых данных. В совокупности эти спецификации и составляют контракт.

В WCF есть контракты трех видов:

• Контракт о службе описывает функциональные операции, реализуемые службой. Он отображает методы класса .NET на описания служб, типов портов и операций на языке WSDL. Внутри контракта о службе имеются контракты об операциях, которые описывают отдельные операции службы, то есть методы, реализующие ее функции.

• Контракт о данных описывает структуры данных, используемые службой для взаимодействия с клиентами. Он описывает все данные, получаемые и отправляемые операциями службы.

• Контракт о сообщениях описывает формат сообщений протокола SOAP, что находит отражение в определениях сообщений на языках WSDL. Контракт о сообщениях позволяет точно контролировать состав заголовков и тел SOAP сообщений.

SOAP (от англ. Simple Object Access Protocol) – протокол обмена сообщениями в распределённой вычислительной среде.

WSDL (англ. Web Services Description Language) – язык описания веб-сервисов и доступа к ним, основанный на языке XML. Каждый документ WSDL можно разбить на следующие логические части:

1. определение типов данных (types) – определение вида отправляемых и получаемых сервисом XML сообщений;

2. элементы данных (message) – сообщения, используемые сервисом;

3. абстрактные операции – список операций, которые могут быть выполнены с сообщениями;

4. тип порта (PortType) – именованный набор абстрактных операций и абстрактных сооб­щений. Оконечная точка службы реализует некий тип порта, группирующий взаимосвязанные операции.

5. служба определяет набор взаимосвязанных портов;

6. связывание сервисов (binding) – способ, которым сообщение будет доставлено.

Поскольку контракты описываются на языке WSDL, а программа обычно работает с типами CLR, возникает необходимость отобразить одну систему типов на другую. В WCF эта задача решается в три этапа. Сначала при написании кода службы вы снабжаете класс определенными в WCF атрибутами [ServiceContract], [OperationContract], [FaultContract], [MessageContract] и [DataContract]. Затем при написании клиентского кода вы запрашиваете у службы детали контракта. Это делается с помощью Visual Studio или утилиты svcutil.exe, которая вызывает инфраструктурную оконечную точку службы, возвращающую метаданные, необходимые для генерации WSDLдокумента, получая их от атрибутов. Наконец, на этапе исполнения, когда клиент вызывает какой-то метод, определенный в интерфейсе службы, WCF сериализует типы CLR и вызов метода в формат XML и посылает сообщение в сеть в соответствии с привязкой и схемой кодирования, согласованным посредством WSDL.

Выполнение работы

В данной работе предложена реализация сервиса хеширования по различным алгоритмам (MD5, SHA-1, SHA-256, SHA-512) с применением WCF и Microsoft Visual Studio 2010. Для демонстрации работы механизма передачи событий сервиса на клиент реализовано уведомление клиентов в режиме реального времени об общем числе клиентов, использующих сервис.

Создание проекта

Создадим библиотеку классов «CryptService», в которой определим саму службу, консольное приложение «ConsoleHost», которое будем использовать в качестве хоста, и приложение-клиент Windows Forms «Client».

Рис. 1. Создание библиотеки классов CryptService.dll

Рис. 2. Добавление консольного приложения ConsoleHost

Рис. 3. Добавление приложения клиента Client

Создание контракта

IStringCrypt.cs

using System.ServiceModel;

namespace CryptService

{

[ServiceContract(SessionMode = SessionMode.Required,

CallbackContract = typeof(IClientCallback))]

public interface IStringCrypt

{

[OperationContract]

string md5(string str);

[OperationContract]

string sha1(string str);

[OperationContract]

string sha256(string str);

[OperationContract]

string sha512(string str);

[OperationContract(IsOneWay = true)]

void join();

[OperationContract(IsOneWay = true)]

void leave();

}

public interface IClientCallback

{

[OperationContract(IsOneWay = true)]

void count(int count);

}

}

Необходимо сообщить WCF, что это наш контракт. Делаем это путем добавления атрибутов (ServiceContract и OperationContract). Кроме того, нужно добавить ссылку на System.ServiceModel.

Рис. 4. Добавление ссылки на System.ServiceModel

Реализация службы

StringCrypt.cs

using System;

using System.Text;

using System.Security.Cryptography;

using System.ServiceModel;

using System.Collections.Generic;

namespace CryptService

{

[ServiceBehavior(InstanceContextMode = InstanceContextMode.PerSession)]

public class StringCrypt : IStringCrypt

{

public static int count = 0;

private static List users = new List();

private User user;

class User

{

public IClientCallback callback;

public User(IClientCallback callback)

{

this.callback = callback;

}

}

public string md5(string str)

{

MD5 md5Hasher = MD5.Create();

byte[] buffer = Encoding.Default.GetBytes(str);

byte[] data = md5Hasher.ComputeHash(buffer);

return bytes2string(data);

}

public string sha1(string str)

{

SHA1 sha1Hasher = SHA1.Create();

byte[] buffer = Encoding.Default.GetBytes(str);

byte[] data = sha1Hasher.ComputeHash(buffer);

return bytes2string(data);

}

public string sha256(string str)

{

SHA256 sha256Hasher = SHA256.Create();

byte[] buffer = Encoding.Default.GetBytes(str);

byte[] data = sha256Hasher.ComputeHash(buffer);

return bytes2string(data);

}

public string sha512(string str)

{

SHA512 sha512Hasher = SHA512.Create();

byte[] buffer = Encoding.Default.GetBytes(str);

byte[] data = sha512Hasher.ComputeHash(buffer);

return bytes2string(data);

}

public void join()

{

count++;

IClientCallback callback =

OperationContext.Current.GetCallbackChannel();

User u = new User(callback);

users.Add(u);

user = u;

foreach (User x in users)

x.callback.count(count);

}

public void leave()

{

count--;

users.Remove(user);

foreach (User x in users)

x.callback.count(count);

}

private string bytes2string(byte[] data)

{

StringBuilder sBuilder = new StringBuilder();

for (int i = 0; i < data.Length; i++)

sBuilder.Append(data[i].ToString("x2"));

return sBuilder.ToString();

}

}

}

ConsoleHost, Program.cs

using System;

using System.Collections.Generic;

using System.Linq;

using System.Text;

using System.ServiceModel;

using CryptService;

using System.ServiceModel.Description;

namespace ConsoleHost

{

class Program

{

const string URI = "http://localhost:8080/";

static void Main(string[] args)

{

// Тип сервиса

Type serviceType = typeof(StringCrypt);

// URI сервиса

Uri serviceUri = new Uri(URI);

ServiceHost host = new ServiceHost(serviceType, serviceUri);

host.Open();

Console.ForegroundColor = ConsoleColor.Green;

foreach (Uri uri in host.BaseAddresses)

Console.WriteLine(uri.ToString());

Console.ResetColor();

Console.WriteLine();

Console.ForegroundColor = ConsoleColor.DarkGray;

Console.Write("Нажмите ENTER, чтобы закрыть хост");

Console.ResetColor();

Console.ReadLine();

host.Close();

}

}

}

App.config

Получение WSDL сервиса

Теперь можно запустить консольное приложение-хост (в противном случае, конечные точки будут недоступны) и перейти к URI службы http://localhost:8080/

Вы увидите экран со ссылкой на WSDL сервиса http://localhost:8080/?wsdl.

Приложение-клиент

Необходимо создать прокси-класс, который будет находиться между нашим клиентом и службой. Один из способов создания прокси-класса – воспользоваться генератором прокси svcutil.exe. Для этого необходимо ввести в командной строке Visual Studio следующую команду, находясь в папке расположения «Client»:

> svcutil http://localhost:8080/ /o:ServiceProxy.cs /config:App.Config /n:*,Client

Эта команда сгенерирует два файла: прокси службы и файл конфигурации приложения, которые необходимо включить в проект.

Когда мы запустили svcutil.exe мы передали ему в качестве первого аргумента место расположения нашей службы, как указано в хосте. Это и есть базовый адрес. Вторым аргументом является прокси. Третий аргумент указывает, что мы также хотим обновить конфигурацию приложения, а если она не доступна, создать её. Последний аргумент – пространство имён для прокси.

Характеристики

Тип файла документ

Документы такого типа открываются такими программами, как Microsoft Office Word на компьютерах Windows, Apple Pages на компьютерах Mac, Open Office - бесплатная альтернатива на различных платформах, в том числе Linux. Наиболее простым и современным решением будут Google документы, так как открываются онлайн без скачивания прямо в браузере на любой платформе. Существуют российские качественные аналоги, например от Яндекса.

Будьте внимательны на мобильных устройствах, так как там используются упрощённый функционал даже в официальном приложении от Microsoft, поэтому для просмотра скачивайте PDF-версию. А если нужно редактировать файл, то используйте оригинальный файл.

Файлы такого типа обычно разбиты на страницы, а текст может быть форматированным (жирный, курсив, выбор шрифта, таблицы и т.п.), а также в него можно добавлять изображения. Формат идеально подходит для рефератов, докладов и РПЗ курсовых проектов, которые необходимо распечатать. Кстати перед печатью также сохраняйте файл в PDF, так как принтер может начудить со шрифтами.

Список файлов лабораторной работы