Часть 1, Часть 2, Часть 3

Создание клиентского приложения WCF

Итак, настало время создать клиентское приложение и попробовать нашу службу в действии.

Добавим в наше решение новый проект — консольное приложение Windows и назовем его CalcClient.

Консольное клиентское приложение

К созданному проекту нужно добавить ссылку на службу (Add ServiceReference).

Добавление ссылки на сервис

В появившемся диалоге нужно нажать кнопку «Discover» (после чего в списке появится наша служба), дать имя ссылке на службу (напрмер, ServiceReference) и нажать Ok (не забываем запустить студию от имени администратора в Висте):

Диалоговое окно добавления ссылки на сервис

Примечание

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

Также нам нужно добавить ссылку на проект CalcCommon (точно также, как мы это делали для самой службы).

Теперь перейдем в тело метода Main (точки входа нашего консольного приложения) и напишем следующий код:

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

Сделаем оба проекта — библиотеку службы и наш новый клиент — стартовыми (это делается в свойствах решения).

Диалоговое окно выбора стартовых проектов

Готово! Можно запускать решение. Вот какой результат мы получили:

Результат обращения к WCF службе

Что логично — 1 + 2 = 3.

Изменим теперь код вызова метода службы на следующий:

CalcOperationResult res = client.Calc(1, 0, CalcOperationType.Div);

И запустим приложение. В результате получаем информацию об исключении (деление на ноль):

Результат обращения к WCF-службе — произошла ошибка

Заключение

Помните, в связи с выходом нового Framework’а материал статьи может быть устаревшим.

Не забывайте запускать VS с правами Администратора.

Часть 1, Часть 2, Часть 3

Реализация сервиса

Итак, мы создали контракт нашей службы, теперь нужно этот контракт реализовать. Сразу переименуем файл Service1.cs в CalcService.cs (VS спросит, хотите ли вы переименовать тип, хранящийся в файле — нужно согласиться) и откроем его.

В xml-комментарии перед описанием класса сервиса видим то же самое предупреждение, что и в случае с интерфейсом. Удаляем его, а также все автоматически сгенерированное содержимое класса — оно нам не понадобится.

Теперь переводим курсор на имя наследуемого интерфейса, нажимаем Alt+Shift+F10 и в появившемся меню выбираем Implement interface ‘ICalcService’. Осталось лишь реализовать наш метод Calc:

Код метода Calc — Реализация службы CalcService

WcfTestClient и WcfServiceHost

В состав .NET Framework 3.5 входит пара замечательных утилит для тестирования WCF-приложений: это WcfTestClient и WcfServiceHost. Расскажу о них поподробнее.

Первая из них — это универсальный тестовый клиент для WCF-сервисов, позволяющий вызывать методы службы, передавая им различные параметры, а также просматривать весь Xml-код запроса и ответа.

Примечание

Тестовый клиент, к сожалению, не поддерживает сеансы (о них подробнее в одной из следующих статей) и передачу композитных типов данных.

Так как тестовый клиент оперирует только с простыми типами данных, мы не сможем с помощью него проверить действие функции Calc.

Вторая утилита — это универсальное хост-приложение для WCF-сервисов. Она автоматически запускается студией при нажатии клавиши F5, когда стартовым проектом является библиотека WCF-службы. WcfServiceHost использует параметры сервиса из файла app.config библиотеки службы и, при наличии ошибок, сообщает об этом.

Попробуем запустить наше приложение, нажав клавишу F5. В системном трее появится значок WcfSvcHost. Дважды кликнув по нему, увидим такое окно:

WCF Service Host

В списке служб находится только одна служба — наш CalcService. Статус у него — «запущен», значит никаких ошибок на стороне службы не возникло. Если в статусе стоит «error» (ошибка), можно выбрать службу в списке и в поле Additional Information просмотреть подробное описание ошибки.

Второе окно, нас интересующее, — это тестовый клиент. После получения метаданных службы он выводит список методов в левой колонке. Как и следовало ожидать, наш метод Calc() тестовым клиентом не поддерживается — ведь он использует композитные типы данных.

WCF Test Client

Конфигурация службы

Настало время изучить файл конфигурации службы и разобраться с ее основными параметрами. Как мы помним из предыдущей статьи, точка соединения содержит в себе три основных объекта: адрес, привязку и контракт. Именно их мы сейчас и зададим.

Открываем файл app.config из проекта библиотеки службы и находим раздел <system.serviceModel>.

Перед тегом, открывающим данный раздел, видим следующий комментарий:

«<!— When deploying the service library project, the content of the config file must be added to the host’s app.config file. System.Configuration does not support config files for libraries. —>»

Переведу: при развертывании проекта библиотеки службы, содержимое конфигурационного файла должно быть добавлено в файл app.config приложения-хоста. Пространство имен System.Configuration не поддерживает конфигурационные файлы для библиотек. Но нас это пока не касается, так как мы используем утилиту WcfSvcHost, которая автоматически считывает параметры из файла конфигурации библиотеки.

Сейчас в разделе <system.serviceModel> видим только один подраздел — <services>, а в нем только один сервис — наш CalcService. У конфигурации службы есть два основных атрибута — это name, в котором нужно указать полное имя класса нашей службы (WcfCalcService.CalcService), и behaviorConfiguration — имя конфигурации поведения службы. Внутри описания службы объявлено две точки соединения — для самого сервиса и для его метаданных.

По умолчанию для точки соединения не указан адрес — установим его в «http://localhost/CalcService». В качестве привязки (binding) выберем пока basicHttpBinding (это привязка, которая обеспечивает просто транспорт по протоколу HTTP). В качестве контракта (contract) указан наш интерфейс — WcfCalcService.ICalcService. Также у точки соединения службы есть дочерний элемент <identity>, который служит для идентификации веб-приложения. Мы его пока проигнорируем.

Следующая точка соединения — это точка метаданных. Она используется для получения информации о контракте службы и сигнатурах ее методов. В качестве адреса у нее установлено значение «mex», без указания типа протокола. Это — относительный адрес, и для того, чтобы он работал, необходимо указание для него базового адреса. Что и сделано студией по умолчанию: в дочернем элементе точки соединения host\baseAddresses содержится элемент «add» с атрибутом baseAddress. Его значение мы установим в «http://localhost/CalcService». Теперь, при обращении по адресу «http://localhost/CalcService» клиент будет попадать к нашей службе, а по адресу «http://localhost/CalcService/mex» — к точке, обслуживающей метаданные.

Примечание

Заметьте, что точка соединения для метаданных использует специальные привязку и контракт — mexHttpBinding и IMetadataExchange соответственно. Менять эти значения не нужно.

Следующим за разделом <services> идет раздел <behaviors>, который описывает поведения служб. Для нашей службы там уже создан элемент «<behavior name=”WcfCalcService.Service1Behavior”>» (помните, в качестве значения атрибута behaviorConfiguration нашей службы как раз установлено «WcfCalcService.Service1Behavior»). В этом разделе содержится два элемента, перед каждым из которых видим увесистый комментарий:

1. To avoid disclosing metadata information, set the value below to false and remove the metadata endpoint above before deployment — Чтобы избежать раскрытия метаданных, установите значение ниже в false и точки соедидения метаданных перед развертыванием

2. To receive exception details in faults for debugging purposes, set the value below to true. Set to false before deployment to avoid disclosing exception information — Чтобы получать информацию об исключениях при возникновении ошибок в целях отладки, установите значение ниже в true. Установите значение ниже в false перед развертыванием для избежания раскрытия информации об исключительных ситуациях.

Нам до развертывания приложения еще далеко, поэтому пока оставляем все как есть.

Примечание

При возникновении необработанной исключительной ситуации на стороне службы, независимо от того, передаем мы подробную информацию об исключительной ситуации или нет, клиентский объект перейдет в состояние Faulted (об этом подробнее в одной из следующих статей), и соединение нужно будет создавать заново. Это очень неудобно, когда используются пошаговые сценарии с поддержкой сеансов, поэтому, для наглядности дальнейших демонстраций возможностей WCF мы не выкидываем Exception в нашем методе Calc, а включаем его в состав «результирующего» объектаCalcOperationResult.

Ниже приведен полный код файла app.config библиотеки службы:

Примечание

Если вы работаете в операционной системе Windows Vista, и попробуете сейчас запустить службу, появится окно приложения WcfSvcHost с сообщением об ошибке для службы калькулятора:

«System.ServiceModel.AddressAccessDeniedException: HTTP could not register URL http://+:80/CalcService/. Your process does not have access rights to this namespace (seehttp://go.microsoft.com/fwlink/?LinkId=70353 for details). → System.Net.HttpListenerException: Access is denied»

Это означает, что у процесса нет прав на регистрацию точки соединения по указанному адресу. Чтобы этой ошибки избежать, нужно просто запустить Visual Studio от имени администратора.

Готов поиграть в игру: Кто сможет дать максимально подробное описание или комментарии к данному коду или переписать его максимально просто для человеческого прочтения? И сколько на это понадобится времени?

private List<BlankComposition> GetBlankInfo(SKDREntities db, Requisition inz, int deliveryType, long? languageId)
        {
            return db.RuleDescriptions
                .Where(rd => rd.OrganizationId == inz.ReqUnit && rd.IsActive)
                .ToList()
                .Where(rd => rd.DeliveryTypes.Split(',').Select(int.Parse).Contains(deliveryType))
                .DefaultIfEmpty()
                .SelectMany(or => db.RuleDescriptions
                    .Where(rd => rd.OrganizationId == inz.RequisitionOrg.OrgID && rd.IsActive)
                    .ToList()
                    .Where(rd => rd.DeliveryTypes.Split(',').Select(int.Parse).Contains(deliveryType)).DefaultIfEmpty(), (org, lab) => new { org, lab })
                .Select(rule => new[] { rule.org, rule.lab }.Where(r => r != null).ToList())
                .Select(rule => new
                    {
                        HeadHeight = rule.Select(r => r.Composition.HeaderHeight).FirstOrDefault(hh => hh != null) ?? "3cm",
                        FooterHeight = rule.Select(r => r.Composition.FooterHeight).FirstOrDefault(fh => fh != null) ?? "4.5cm",
                        DemographyDescriptionId = rule.Select(r => r.DemographyDescriptionId).FirstOrDefault(),
                        Suffix = rule.Select(r => r.Suffix).FirstOrDefault(),
                        Elements = rule
                                    .SelectMany(
                                        re => re.Composition.CompositionElements,
                                        (rd, element) => new { element, priority = rd == rule.First(), langPriority = element.LanguageId == languageId }
                                    )
                                    .GroupBy(g => g.element.ElementTypeId)
                                    .SelectMany(g => g
                                        .OrderByDescending(e => e.priority)
                                        .ThenByDescending(e => e.langPriority)
                                        .Take(1)
                                        .Select(e => e.element)
                                    )
                                    .Where(e => e.ElementId != null)
                                    .ToList()
                    }
                ).Select(item => new BlankComposition
                    {
                        HeaderHeight = item.HeadHeight,
                        FooterHeight = item.FooterHeight,
                        BlankElements = item.Elements.Select(e => new BlankElement
                        {
                            Width = e.Element.Width,
                            Height = e.Element.Height,
                            Left = e.Element.Left,
                            Top = e.Element.Top,
                            Image = e.Element.ImageId == null ? null : e.Element.Image.Data,
                            Text = e.Element.Text,
                            Placing = e.Placing
                        }).ToList(),
                        Demography = db.DemographyDescriptions
                            .Single(dd => dd.Id == item.DemographyDescriptionId)
                            .DemographyTables
                            .Select(dt => new DemographyInfo
                            {
                                Placing = dt.Placing,
                                Height = dt.Height,
                                Left = dt.Left,
                                Top = dt.Top,
                                Width = dt.Width,
                                Lines = DemographyFormatter.GetDemographyInfo(inz, dt.DemographyType.DemographyContents.OrderBy(o => o.SortOrder).ToList())
                            })
                            .ToList(),
                        Suffix = item.Suffix,
                        AddHyperlinks = item.Elements.Any(hy => hy.ElementTypeId == 6 && hy.ElementId != null)
                    }
                ).ToList();
        }

Приложение готово для Windows Phone, в ближайшие дни я покажу его автору метода. Приложение во многом опирается на системоцелостную психологию, являющуюся фундаментом «метода Бронникова».

Надеюсь в скором времени после демонстрации приложение появится в Marketplace.

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

Суть заключается в том, что, выбирая на форме в поле типа Дата и Время, например, 1 мая 2012, Вы рассчитываете, что в БД так и запишется: 1 мая 2012. Но все не так просто.

CRM хранит Дату и Время в UTC, таким образом, выходит, что, если Ваш сервер находится где-то за Уралом, то время в БД будет отличаться уже более чем на 6 часов с тем, что Вы указали. Так, у меня, к примеру, получалось, что если установить дату 1 мая, то в автосгенерированном через плагин договоре ставилось 30 апреля.

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

Если бы я сразу был внимателен, то MSDN прямым текстом говорит «Specifies the attribute value in UTC format.». Сам CRM так и будет показывать в веб-форме ту дату, что Вы выбрали, но если Вы работаете с датами через плагин, то не забывайте возвращать дату из UTC в ваш часовой пояс.

Ниже предложено расширение для BinaryReader, позволяющие использовать ReadLine для бинарной строки. При необходимости оно позволяет читать кусочки данных так же, как текст — строками.

public class LineReader : BinaryReader
{
  private Encoding _encoding;
  private Decoder _decoder;   const int bufferSize = 1024;
  private char[] _LineBuffer = new char[bufferSize];

 public LineReader(Stream stream, int bufferSize, Encoding encoding)
    : base(stream, encoding)
  {
    this._encoding = encoding;
    this._decoder = encoding.GetDecoder();
  }

 public string ReadLine()
  {
    int pos = 0;   char[] buf = new char[2];   StringBuilder stringBuffer = null;
    bool lineEndFound = false;   while(base.Read(buf, 0, 2) > 0)
    {
      if (buf[1] == 'r')
      {
        // grab buf[0]
        this._LineBuffer[pos++] = buf[0];
        // get the 'n'
        char ch = base.ReadChar();
        Debug.Assert(ch == 'n');   lineEndFound = true;
      }
      else if (buf[0] == 'r')
      {
        lineEndFound = true;
      }
      else
      {
        this._LineBuffer[pos] = buf[0];
        this._LineBuffer[pos+1] = buf[1];
        pos += 2;   if (pos >= bufferSize)
        {
          stringBuffer = new StringBuilder(bufferSize + 80);
          stringBuffer.Append(this._LineBuffer, 0, bufferSize);
          pos = 0;
        }
      }

      if (lineEndFound)
      {
        if (stringBuffer == null)
        {
          if (pos > 0)
            return new string(this._LineBuffer, 0, pos);
          else
            return string.Empty;
        }
        else
        {
          if (pos > 0)
            stringBuffer.Append(this._LineBuffer, 0, pos);
          return stringBuffer.ToString();
        }
      }
    }   if (stringBuffer != null)
    {
      if (pos > 0)
        stringBuffer.Append(this._LineBuffer, 0, pos);
      return stringBuffer.ToString();
    }
    else
    {
      if (pos > 0)
        return new string(this._LineBuffer, 0, pos);
      else
        return null;
    }
  }

}

© Omar Zabib, Перевод