Документация

Напишите и протестируйте код MATLAB

Создайте свой MATLAB^® а затем протестируйте код перед реализацией безопасного интерфейса. Функции в вашей программе MATLAB должны совпадать с объявлениями в вашем родном .NET интерфейсе.

В следующем примере развертываемый код MATLAB содержит одну экспортированную функцию, addOne. The addOne функция добавляет значение one (1) к полученному входу. Вход должен быть числовым, скаляром или матрицей с одной или несколькими размерностями.

function y = addOne(x)
% ADDONE Add one to numeric input. Input must be numeric.

    if ~isnumeric(x)
        error('Input must be numeric. Input was %s.', class(x));
    end
    y = x + 1;

end

Разрабатывайте свой интерфейс WCF

После записи и тестирования кода MATLAB разработайте интерфейс на C # или Visual Basic, который поддерживает родные типы через API .

Задайте перегрузки IAddOne.  Полные правила определения перегрузок интерфейса см. в разделе Реализация безопасного интерфейса типа.

В сложение при использовании WCF ваши перегруженные функции должны иметь уникальные имена.

Обратите внимание, что в реализации WCF addOne, вы украшаете методы OperationContract свойство. Вы присваиваете каждому методу уникальное имя операции, которое задаете с помощью Name свойство OperationContract, как в этом примере:

using System.ServiceModel;

[ServiceContract]
public interface IAddOne
{
    [OperationContract(Name = "addOne_1")]
    int addOne(int x);

    [OperationContract(Name = "addOne_2")]
    void addOne(ref int y, int x);

    [OperationContract(Name = "addOne_3")]
    void addOne(int x, ref int y);

    [OperationContract(Name = "addOne_4")]
    System.Double addOne(System.Double x);

    [OperationContract(Name = "addOne_5")]
    System.Double[] addOne(System.Double[] x);

    [OperationContract(Name = "addOne_6")]
    System.Double[][] addOne(System.Double[][] x);
}

Как видим, IAddOne интерфейс задает шесть перегрузок addOne функция. Кроме того, заметьте, что все имеют один вход и один выход (чтобы соответствовать MATLAB addOne function), хотя тип и положение этих параметров изменяются.

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

Актуальные сведения о WCF см. в разделе «Что такое Windows Communication Foundation» на веб-странице корпорации Майкрософт.

Скомпилируйте IAddOne в сборку.  Скомпилируйте IAddOne.cs в сборку с помощью Microsoft Visual Studio^®.

Создайте свой компонент и сгенерируйте безопасный API-интерфейс

Чтобы сгенерировать безопасный для типа API, используйте приложение Library Compiler или инструменты командной строки развертывания.

Использование Library Compiler.  Приложение Library Compiler генерирует безопасный для типа API, когда вы создаете свой компонент, если выбраны правильные опции.

Использование инструментов командной строки развертывания.  Чтобы сгенерировать API с безопасным типом с помощью сборки (компиляции) вашего компонента mcc, выполните следующее:

Разрабатывайте серверную программу с использованием интерфейса WCF

Теперь вы создали свой компонент и сгенерировали API, отвечающий требованиям WCF.

Далее разработайте серверную программу, которая обеспечивает доступ (через WCFServiceContract) к перегрузкам addOne определяется WCF IAddOne интерфейс. Программа ссылается на App.config Строение XML.

Программа сервера WCF загружает addOne.Mechanism на основе WCF Компонент и делает его доступным для клиентов SOAP через безопасную mechanismIAddOne интерфейс.

 Программа WCF-сервера

using System;
using System.Text;
using System.ServiceModel;


namespace AddMasterServer
{
    class AddMasterServer
    {
        static void Main(string[] args)
        {
            try
            {
                using (ServiceHost host = 
                    new ServiceHost(typeof(MechanismIAddOne)))
                {
                    host.Open();
                    Console.WriteLine("
                       AddMaster Server is up running......");
                    Console.WriteLine("
                       Press any key to close the service.");
                    Console.ReadLine();
                    Console.WriteLine("Closing service...");
                }
            }
            catch (Exception ex)
            {
                Console.WriteLine(ex.Message);
            }  
        }
    }
}

XML-  файл App.config

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
  <system.web>
    <compilation debug="true" />
  </system.web>
  <system.serviceModel>
    <services>
      <service behaviorConfiguration=
       "AddMaster.ServiceBehavior" name="MechanismIAddOne">
        <endpoint
          address=""
          binding="wsHttpBinding"
          contract="IAddOne"
          name="HttpBinding" />
        <endpoint
        address=""
        binding="netTcpBinding"
        contract="IAddOne"
        name="netTcpBinding" />
        <endpoint
          address="mex"
          binding="mexHttpBinding"
          contract="IMetadataExchange"
          name="MexHtppBinding"/>
        <endpoint
        address="mex"
        binding="mexTcpBinding"
        contract="IMetadataExchange"
        name="MexTCPBinding"/>
        <host>
          <baseAddresses>
           <add baseAddress=
                "http://localhost:8001/AddMaster/" />
           <add baseAddress=
                "net.tcp://localhost:8002/AddMaster/" />
          </baseAddresses>
        </host>
      </service>
    </services>
    <behaviors>
      <serviceBehaviors>
        <behavior name="AddMaster.ServiceBehavior">
          <serviceMetadata httpGetEnabled="True" httpGetUrl=
                     "http://localhost:8001/AddMaster/mex" />
          <!-- 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 -->
          <serviceDebug includeExceptionDetailInFaults="True" />
        </behavior>
      </serviceBehaviors>
    </behaviors>
  </system.serviceModel>
</configuration>

Скомпилируйте серверную программу

Скомпилируйте серверную программу с помощью Microsoft Visual Studio, выполнив следующее:

Запуск серверной программы

Запустите серверную программу из командной строки.

Выходы должны выглядеть аналогично следующим.

AddMaster Server is up running......
Press any key to close the service.

Нажатие клавиши приводит к следующему.

Closing service....

Сгенерируйте Прокси Кода для клиентов

Сконфигурируйте своих клиентов для связи с сервером путем запуска автоматического инструмента генерации прокси-сервера, svcutil.exe. Большинство версий Microsoft Visual Studio может автоматически генерировать прокси кода клиента из метаданных сервера.

Резервирование портов и использование localhost 8001.  При запуске автономного приложения могут возникнуть проблемы с резервированием портов. При необходимости измените строения портов одним из приведенных ниже инструментов.

Скомпилируйте клиентскую программу

Клиентская программа отличается от AddMaster.cs серверная программа следующим образом:

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

Запуск клиентской программы

Запустите клиентскую программу из командной строки.

Выходные выходы должны быть аналогичны следующим:

Conntecting to AddMaster Service through Http connection...
Conntected to AddMaster Service...
addOne(1) = 2
addOne(16) = 17
addOne(2) = 3
addOne(495) = 496
addOne([30 60 88]) = [31 61 89]
addOne([0 2; 3 1]) = [1 3; 4 2]
Press any key to close the client application.

Нажатие клавиши приводит к следующему.

Closing client....