Доступ к доступному удаленно блоку.NET Используя нативный API.NET: ячейка и Struct

Почему использование API.NET с Массивами ячеек и структурами?

Используя представления.NET MATLAB^® массивы структур и массивы ячеек рекомендуются, если оба из них верны:

У вас есть функции MATLAB на сервере с struct MATLAB или типами данных ячейки как вводы или выводы
Вы не хотите или должны установить MATLAB Runtime на своих клиентских машинах

Нативный MWArray, MWStructArray, и MWCellArray классы являются членами MathWorks.MATLAB.NET.Arrays.native пространство имен.

Имена классов в этом пространстве имен идентичны именам классов в MathWorks.MATLAB.NET.Arrays. Различие - то, что нативные представления массивов структур и массивов ячеек не имеют никаких методов или свойств, которые требуют MATLAB Runtime.

matlabroot\toolbox\dotnetbuilder\Examples\VSVersion.NET папка имеет решения в качестве примера, можно практиковать создание. NativeStructCellExample папка содержит нативный struct и примеры ячейки.

Создание вашего компонента

Этот пример демонстрирует, как развернуть доступный удаленно использующий нативный struct компонента и массивы ячеек. Прежде чем вы установите доступный удаленно кодекс клиент-сервера, создадите доступный удаленно компонент с помощью инструкций в, Создают Доступный удаленно блок.NET.

Нативный пример ячейки и Struct.NET

Серверное приложение размещает удаленный компонент.

Клиентское приложение, запускающееся в отдельном процессе, получает доступ к удаленному компоненту, размещенному серверным приложением. Создайте сервер с Microsoft^® Visual Studio^® файл проекта NativeStructCellServer.csproj:

Измените ссылки для сгенерированного блока компонента к component_name\for_redistribution_files_only\component_nameNative.dll.
Выберите соответствующую платформу сборки.
Выберите режим Debug или Release.
Создайте NativeStructCellServer проект.
Предоставьте конфигурационный файл для NativeStructCellServer. Код C# для сервера находится в файле NativeStructCellServer.cs:
```
using System;
using System.Collections.Generic;
using System.Text;
using System.Runtime.Remoting;

namespace NativeStructCellServer
{
  class NativeStructCellServer
     {
       static void Main(string[] args)
        {
           RemotingConfiguration.Configure(
                             @"NativeStructCellServer.exe.config");

           Console.WriteLine("NativeStructCell Server started...");

           Console.ReadLine();
        }
     }
}
```
Этот код читает связанный конфигурационный файл, чтобы определить:
- Имя компонента, чтобы разместить
- Протокол дистанционной работы и форматирование сообщения, чтобы использовать
- Время владения для удаленного компонента
Кроме того, код также сигнализирует, что сервер активен и ожидает возврата каретки перед завершением.

Кодирование и создание клиентского приложения и конфигурационного файла

Клиентское приложение, запускающееся в отдельном процессе, получает доступ к удаленному выполнению компонента в серверном приложении, созданном в Нативном Примере Ячейки и Struct.NET. Создайте удаленный клиент, использующий файл проекта Microsoft Visual Studio NativeStructCellClient\NativeStructCellClient.csproj. Создать удаленный клиент, использующий Microsoft Visual Studio:

Измените ссылки для сгенерированного блока компонента к component_name\for_redistribution_files_only\component_nameNative.dll.
Измените ссылки для сгенерированного интерфейсного блока к component_name\for_redistribution_files_only\Icomponent_nameNative.dll.
Выберите соответствующую платформу сборки.
Выберите режим Debug или Release.
Создайте NativeStructCellClient проект.
Предоставьте конфигурационный файл для NativeStructCellClient.

Код NativeStructCellClient

Код C# для клиента находится в файле NativeStructCellClient\NativeStructCellClient.cs:

NativeStructCellClient.cs

using System;
using System.Collections.Generic;
using System.Text;
using System.Runtime.Remoting;
using System.Configuration;
using MathWorks.MATLAB.NET.Arrays.native;

using INativeStructCellCompNative;

// This is a simple example that demonstrates the use 
// of MathWorks.MATLAB.NET.Arrays.native package. 
namespace NativeStructCellClient
{
    class NativeStructCellClient
    {
        static void Main(string[] args)
        {
            try
            {
                RemotingConfiguration.Configure(
                                        @"NativeStructCellClient.exe.config");
                String urlServer = 
                    ConfigurationSettings.AppSettings["NativeStructCellServer"];
                INativeStructCellClassNative nativeStructCell = 
                    (INativeStructCellClassNative)Activator.GetObject(typeof
                                    (INativeStructCellClassNative), urlServer);

                MWCellArray field_names = new MWCellArray(1, 2);
                field_names[1, 1] = "Name";
                field_names[1, 2] = "Address"; 

                Object[] o = nativeStructCell.createEmptyStruct(1,field_names);
                MWStructArray S1 = (MWStructArray)o[0];
                Console.WriteLine("\nEVENT 2: Initialized structure as 
                             received in client applications:\n\n{0}" , S1);

                //Convert "Name" value from char[,] to a string since there's
                       no MWCharArray constructor on server that accepts
                //char[,] as input.
                char c = ((char[,])S1["Name"])[0, 0];
                S1["Name"] = c.ToString();                

                MWStructArray address = new MWStructArray(new int[] { 1, 1 }, 
                             new String[] { "Street", "City", "State", "Zip" });
                address["Street", 1] = "3, Apple Hill Drive";
                address["City",   1] = "Natick";
                address["State",  1] = "MA";
                address["Zip",    1] = "01760";

                Console.WriteLine("\nUpdating the 'Address' field to 
                                                       :\n\n{0}", address);
                Console.WriteLine("\n#################################\n");
                S1["Address",1] = address;

                Object[] o1 = nativeStructCell.updateField(1, S1, "Name");
                MWStructArray S2 = (MWStructArray)o1[0];

                Console.WriteLine("\nEVENT 5: Final structure as 
                                         received by client:\n\n{0}" , S2); 
                Console.WriteLine("\nAddress field: \n\n{0}" , S2["Address",1]);
                Console.WriteLine("\n#################################\n");
            }
            catch (Exception exception)
            {
                Console.WriteLine(exception.Message);
            }
            Console.ReadLine();
        }
    }
}

Этот код делает следующее:

Клиент читает связанный конфигурационный файл, чтобы завоевать репутацию и местоположение доступного удаленно компонента.
Клиент инстанцирует доступного удаленно объекта с помощью статического Activator.GetObject метод
От этой точки клиент дистанционной работы вызывает методы на доступном удаленно компоненте, как это вызвало бы метод локального компонента.

Конфигурационный файл NativeStructCellClient

Конфигурационный файл для NativeStructCellClient находится в файле NativeStructCellClient\NativeStructCellClient.exe.config:

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
  <appSettings>
    <add key="NativeStructCellServer" value=
              "tcp://localhost:1236/NativeStructCellClass.remote"/>    
  </appSettings>
  <system.runtime.remoting>
    <application>
      <channels>
        <channel name="NativeStructCellChannel" ref="tcp" port="0">        
          <clientProviders>            
            <formatter ref="binary" />
          </clientProviders>
          <serverProviders>            
            <formatter ref="binary" typeFilterLevel="Full" />
          </serverProviders>            
        </channel>
      </channels>
    </application>
  </system.runtime.remoting>
</configuration>

Этот код задает:

Имя удаленного сервера компонента и удаленного URI компонента (унифицированный идентификатор ресурса)
Протокол дистанционной работы (TCP/IP) и номер порта
Передайте средство форматирования (binary) и полномочия для канала связи (full доверие)

Запуск серверного приложения

Запустите сервер путем выполнения следующего:

Откройте DOS или UNIX^® командное окно и cd к NativeStructCellServer\bin\x86\v4.0\Debug.

Запустите NativeStructCellServer.exe. Следующий выход появляется:

EVENT 1: Initializing the structure on server and sending 
         it to client:
        Initialized empty structure:

      Name: ' '
   Address: []


##################################

EVENT 3: Partially initialized structure as 
         received by server:

      Name: ' '
   Address: [1x1 struct]

Address field as initialized from the client:

   Street: '3, Apple Hill Drive'
     City: 'Natick'
    State: 'MA'
      Zip: '01760'

##################################

EVENT 4: Updating 'Name' field before sending the 
         structure back to the client:

      Name: 'The MathWorks'
   Address: [1x1 struct]


##################################

Запуск клиентского приложения

Запустите клиент путем выполнения следующего:

Откройте DOS или командное окно UNIX и cd к NativeStructCellClient\bin\x86\v4.0\Debug.

Запустите NativeStructCellClient.exe. После того, как MATLAB Runtime инициализирует, следующий выход появляется:

EVENT 2: Initialized structure as 
         received in client applications:

1x1 struct array with fields:
       Name
       Address

Updating the 'Address' field to :

1x1 struct array with fields:
       Street
       City
       State
       Zip

#################################


EVENT 5: Final structure as received by client:

1x1 struct array with fields:
       Name
       Address

Address field:

1x1 struct array with fields:
       Street
       City
       State
       Zip

#################################

Кодируя и создание клиентского приложения и конфигурационного файла с собственным компонентом Мварреем, MWStructArray и классами MWCellArray

createEmptyStruct.m

Инициализируйте структуру на сервере и отправьте его клиенту со следующим кодом MATLAB:

function PartialStruct = createEmptyStruct(field_names)

fprintf('EVENT 1: Initializing the structure on server 
                         and sending it to client:\n');

PartialStruct = struct(field_names{1},' ',field_names{2},[]);

fprintf('         Initialized empty structure:\n\n');
disp(PartialStruct);
fprintf('\n##################################\n');

updateField.m

Получите частично обновленную структуру от клиента и добавьте больше данных в него, перед передаванием обратно его клиенту, со следующим кодом MATLAB:

function FinalStruct = updateField(st,field_name)

fprintf('\nEVENT 3: Partially initialized structure as 
                              received by server:\n\n');
disp(st);
fprintf('Address field as initialized from the client:\n\n');
disp(st.Address);
fprintf('##################################\n');

fprintf(['\nEVENT 4: Updating ''', field_name, ''' 
   field before sending the structure back to the client:\n\n']);
st.(field_name) = 'The MathWorks';
FinalStruct = st;
disp(FinalStruct);
fprintf('\n##################################\n');

NativeStructCellClient.cs

Создайте клиент код C#:

Примечание

В этом случае вам не нужен MATLAB Runtime на системном пути.

using System;
using System.Collections.Generic;
using System.Text;
using System.Runtime.Remoting;
using System.Configuration;
using MathWorks.MATLAB.NET.Arrays.native;

using INativeStructCellCompNative;

// This is a simple example that demonstrates the use of 
//     MathWorks.MATLAB.NET.Arrays.native package. 
namespace NativeStructCellClient
{
    class NativeStructCellClient
    {
        static void Main(string[] args)
        {
            try
            {
                RemotingConfiguration.Configure
                      (@"NativeStructCellClient.exe.config");
                String urlServer =
                      ConfigurationSettings.AppSettings[
                                                     "NativeStructCellServer"];
                INativeStructCellClassNative nativeStructCell = 
                      (INativeStructCellClassNative)Activator.GetObject(typeof
                           (INativeStructCellClassNative), 
                           urlServer);

                MWCellArray field_names = new MWCellArray(1, 2);
                field_names[1, 1] = "Name";
                field_names[1, 2] = "Address"; 

                Object[] o = nativeStructCell.createEmptyStruct(1,field_names);
                MWStructArray S1 = (MWStructArray)o[0];
                Console.WriteLine("\nEVENT 2: Initialized structure as received 
                                     in client applications:\n\n{0}" , S1);

                //Convert "Name" value from char[,] to a string since 
                // there's no MWCharArray constructor 
                // on server that accepts char[,] as input.
                char c = ((char[,])S1["Name"])[0, 0];
                S1["Name"] = c.ToString();                

                MWStructArray address = 
                      want new MWStructArray(new int[] { 1, 1 }, 
                             new String[] { "Street", "City", "State", "Zip" });
                address["Street", 1] = "3, Apple Hill Drive";
                address["City",   1] = "Natick";
                address["State",  1] = "MA";
                address["Zip",    1] = "01760";

                Console.WriteLine("\nUpdating the 
                                   'Address' field to :\n\n{0}", address);
                Console.WriteLine("\n#################################\n");
                S1["Address",1] = address;

                Object[] o1 = nativeStructCell.updateField(1, S1, "Name");
                MWStructArray S2 = (MWStructArray)o1[0];

                Console.WriteLine("\nEVENT 5: Final structure as received by 
                                     client:\n\n{0}" , S2); 
                Console.WriteLine("\nAddress field: \n\n{0}" , S2["Address",1]);
                Console.WriteLine("\n#################################\n");
            }
            catch (Exception exception)
            {
                Console.WriteLine(exception.Message);
            }
            Console.ReadLine();
        }
    }
}

NativeStructCellServer.cs

Создайте сервер код C#:

using System;
using System.Collections.Generic;
using System.Text;
using System.Runtime.Remoting;

namespace NativeStructCellServer
{
    class NativeStructCellServer
    {
        static void Main(string[] args)
        {
            RemotingConfiguration.Configure(
                              @"NativeStructCellServer.exe.config");

            Console.WriteLine("NativeStructCell Server started...");

            Console.ReadLine();
        }
    }
}

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