Дозвольте говорити про це
Node API для .NET дозволяє JavaScript і CM SK1 підключатися одна до одної в рамках одного процесу . Застосунок Node може завантажити управляну конструкцію МSK3 передати Java-функцію на CМSK4 і отримати результат, що включає подальші подзвони назад в JavaScript МСК5 Аplikaція МСК6NET також може хостинувати Node та використовувати його модулі М СК7 API і цикл подій M СК8
Це стає цікаво, коли обидві мови вже мають різні частини програми. Наша календарна програма JavaScript має API для замовлення і знає своїх клієнтів та працівниківM SK1 Наша C# Найяскравіший вид упаковки бібліотека зможе знайти можливі місця для зустрічі. Ми хочемо підключити їх, зберігаючи доступ до існуючого API, відповідального за дані
Цікавими рішеннями є те, хто веде часи запуску, як об 'єкти та зворотні зв' язки переміщуються між ними , і що трапляється, коли дзвінок стає асинхронним або провалюєся МSK2 Розгортання знову змінює варіанти M SK3 завантаження управленої конструкції , посилання нативного npm додатку і запуск M SK5 NET в браузері кожен має різні вимоги MSC6 комп 'ютерний код містить повні приклади; фрагменти тут з 'єднують ці вибірки з реалізацією.
Гость визначає, як працює інтеграція
| Гость МSK1 Як працює інша мова МSK2 Наш приклад | ||
|---|---|---|
| Застосування вузлів | node-api-dotnet хости .NET і завантажує виведену конструкцію |
JS називає CM SK2, яка називає доставлену JS функцію МSK3 |
| МSK1NET-приложение | libnode хости Нод на середовищі потоку |
CM SK1 вводить модуль JS і чекає його API |
| Нод з нативним допоміжником AOT | Node loads a compiled .node bibliotekа |
Функція пакету CM SK1 називає видавcę назви JS |
| Застосування браузера | Програму WebAssembly МSK2NET завантажує час запуску браузера МСК3совместна з кодом МСК4NET мСК5 Інший рецепт, що використовує введення та виведення браузерів एमСК6 |
Перші два знаходяться в- інтеграціях процесівM SK1 Обидві часи запуску все ще існують , з власними життєвими циклами об 'єктів та збирателями сміття
Утримка існуючого API aplikacji
В існуючому API вже є обов 'язки, які регулювальнику потрібно працювати з
| Операція МSK1 Подібність МSK2 | |
|---|---|
readWindow(start, end) |
Асинхронно читати послідовний знімок доступності та ремісію |
getName(id) |
Дайте відповідь на ім 'я з уже загрузених в пам' ять даних aplikacji |
tryBook(candidateId, version, commandId, demands) |
Атомнічно підтвердити і запустити сервер - контрольований проект МSK2 |
Аліс хоче гелі, Бет хоче педикюруM SK1 і вони хочуть почати разом. Планувальник знає про етапи обслуговування та здібності ресурсів . В програмі доступні теперішні замовлення та назви
Запити перетинають мовну межу більше, ніж раз,, тоді як орган рецепції зупиняється там, де вони були
sequenceDiagram
participant JS as Existing JS backend/API
participant CS as C# scheduler
participant DB as Existing booking authority
JS->>DB: Read availability and revision
DB-->>JS: Consistent snapshot
JS->>CS: Suggest(window, snapshot, getName)
CS->>JS: getName(clientId)
JS-->>CS: Alice
CS->>JS: getName(technicianId)
JS-->>CS: Sarah
CS-->>JS: Typed proposal and resource demands
JS->>DB: Commit proposal if revision/capacity still valid
DB-->>JS: Booked or conflict
Назви утримуються лише за допомогою API JS. Планувальник отримує зворотний дзвінок, який може їх читати . що робить двоє M SK2way інтерактив видимими МSK3 Дж. вводить C#, CМSK5 телефонує ДжСM SK6 і запуск повертається до оригінального Джс дзвінка MSC7
Керування JavaScript всередині API C#
В інтерфейсі C# цей зв 'язок виражений безпосередньо
public AppSuggestion Suggest(
ScheduleWindow window,
AvailabilityInput input,
Func<string, string> getName)
ScheduleWindow має Start і End струни. AvailabilityInput Contains the snapshot revision and resource/grid cells AppSuggestion і його вбудовані класи набору є виведеними типами результатів.
В AutoScheduler.cs, метод спочатку обчислює співпадіння
ClientName = getName(appointment.ClientId),
TechnicianName = getName(appointment.Resources["technician"]),
З точки зору методу C# ' these are ordinary delegate invocations МSK3 Node API for МSK4 NET adapts the JavaScript function into that delegate [JSExport] до публічного класу і типів контрактів дозволяє генератору джерело виробляти прив 'язки та декларації TypScript. Подивіться на MicrosoftM SK1s модель робочого потоку.
Керування синхронне, тому що його контракт повертається string. Він читає картку, яку завантажили в установціM SK1 Якщо імена походять з бази даних або HTTP API , партія МSK3 завантажити їх перед тим, як зайти до шкалулера , чи спроектувати асинхронний тип зворотнього зв 'язку та зворотньої зв' язку async функція на цей синхронний delegat returns a Promise where a string is expected; the sample tests that this fails
Синхронна підписка також заперечує блокування асинхронного пошуку .Result або .Wait(). Java-фразма може бути темою, яка потрібна для запуску продовження , так що очікування може запобігти завершенню операції
Установлення .NET стає модулем узла
Пакет вузлів node-api-dotnet хости .NET всередині процесу узлаM SK1 Завантаження в авто-програмуванняM SK1mjs імпортує його і завантажує наш вивезений агрегат:
import dotnet from 'node-api-dotnet/net10.0';
const { AutoScheduler } = dotnet.require(assemblyPath);
const engine = new AutoScheduler();
assemblyPath це абсолютний шлях до файлової системи AppScheduler.dll; вибірка вирішує його відносно import.meta.url. Це вивезений модуль , тому ми використовуємо dotnet.require(). Для произвольних обладнаних груп, доступних за допомогою їхнього використання dotnet.load() замість. Справка з API JS описує різницю.
Як тільки модуль завантажений,, програма може забезпечити свою існуючу функцію пошукуM SK1
const snapshot = await api.readWindow(start, end);
const proposal = engine.suggest(
{ start, end },
snapshot,
id => api.getName(id)
);
І await завершує читання aplikacji перед тим, як C# почне пошуки . Funkція лишається функцією JavaScript МSK2 її не представлено JSON і не є кінцевим пунктом RPC для пошуків наименовань M SK3 Викликає getName відбувається, поки suggest запускає.
Упаковник утворює повертані властивості у звичайні JS дані один раз.. Це запобігає повторюванню odczytу Managed Getters під час створення HTTP реакції. . Це також запобігує зникненням Managed Object, property of prototype of disappearing when the HTTP layer serializes it. МSK3 JSON на тому етапі, коли наступна межа браузера відокремлена від сеrialization between Node and C.
Повернений проект містить ідентичні знаки, на яких повинна діяти заявка, і назва, отримана за допомогою цих зворотньих дзвінків:
Alice: gels with Sarah
Beth: pedicure with Anna
У вашому теперішньому календарі UI, перетворити отримані зустрічі на title, start і end об 'єкти подій. Подаровані адаптер календаря демонструє, що мапування. додаток FullCalendar може додавати повернений массив з calendar.addEventSource(events) використовуючи документацію event-source API.
Надруковані об 'єкти все ще потребують дизайну управління
Головний інтерфейс API безпосередньо передає задруковані об 'єкти. Структури копіюються за значеннямM SK1 Виведені класи є обертаками навколо управляних об' єктів, таким чином, читаючий атрибут може викликати . NET getterMSC4 Наш JS-обертач читає результат якраз в дані, підходящі для існуючої веб-апкиМSK5
Згенеровані декларації описують ці поля та зворотні підписи. Сам завантаження повертає any; підключити модульM SK1 перетворник до generated declaration file при використанні TypeScript . Декларації не підтверджують дані, які надходять з HTTP-запросу
У цьому прикладі виникли два недоліки::
- Генератор провалився при вбудованому навісені-результат артерії, коли представлений як конструкціяМSK1 Експортовані класи результатів працювали МSK2 Primітивні стрічки графів зберігали просту конфігурацію вхідних даних
- Структурні декларації містять незавершений
ValueTypeбаза. Наші підходи для перевірки типу споживачаskipLibCheckдля інтерфейсів декларацій, під час перевірки аргументів та pól споживачаM SK1 Він не certiфікує весь генерований вихід декларації.
Стринь все ще потребує конверсії, і копіовані об 'єкти все ще розподіляють. Уникніть виклику для кожної ячейки пропускної спроможності або приймача всередині щільної інтерфейсової петлі . Перечитайте доступність у великих обсягах та передайте знімок раз за раз МSK2 Назви зворотнього зв' язку демонструють пере МСК3 вход над навантаженнями даних МСК4 це не є причиною виконувати одну базу даних на одне відображане поле М СК5
Використовуйте експлуатовані відхилення таймпа. МеханізмиM SK1 шлюзи та ремісії вміщуються в Java-кодів без загрози ; идентификації чи рахунки, які потребують повного діапазону 64- бітових整х чисел, потребують узгодженої стрічки або BigInt мапування
Держава резервації досі належить до заявки
Планувальнику потрібна послідовна інформація про доступність,, але він не має причини володіти базою даних для резерваціїM SK1 Шнупшот дає C# вихід для одного обчислення, в той час як програма зберігає відповідальність за зміни .
В даний момент API для пакування очікує ICalendarStore, таким чином, приклад supplies a per-callM SK2 read -only adapterMSC4 Reading returns the snapshot received from JavaScript МSK5 Its write methods throw NotSupportedException, інструкція повертає назад до API-прикладу . На цьому шляху інтеграції немає зв 'язку з C МSK2 SQLite
AvailabilityInput використовує рівні- довжинні массиви для ідентифікаторів ресурсів , розгалуження сітки M SK2 пропускна спроможність та використані одиниці . Row i через ці массиви - це один ресурс/ часова клітинаM SK1 Primітивні массиві уникають генератора вказівок ' вбудованого МSK3 структурного M SK4 проблеми з массивом . Конвертація зберігається в адаптері MSC6 поточний API може продовжувати віддавати свою власну програму подій або схеми ресурсів.
Правила каталогу і сервісу встроюваної системи є фіксованими. Конфигурація C# , з стабільними ID ресурсів, доступними в схемі JS. МSK3 Реальна інтеграція повинна завантажувати або мапувати програму. Katalog ' на старті і включати पात्रість. / зміни конфігурації в політиці ремісії.
Комп 'ютерний результат вже може бути застарілий
Запропонування може стати застарілим до того, як його прийме пользователь.
Коли пользователь приймає,, обробник набирає:
return api.tryBook(
candidateId,
trusted.version,
commandId,
trusted.demands
);
API має підтвердити і записувати атомно. Не може перевірити доступністьM SK1 додатка іншого писатиму , а потім безумовно ввести замовлення. У довготривалому застосуванніМSK4 перевірка ремісії МSK5 перевірку пропускної спроможностіMSC6 запис запис та idemпотентність замовлення належать до тієї ж транзакції або еквівалентно умовній операційіMSL7
Установка вводить консервативну перевірку revision: будь-яких причин, які спричиняють репутацію SnapshotChanged. Програмне забезпечення для виробництва може використовувати ресурсиM SK1 масштабовані версії, або переглянути весь набір попитів замість них. Версію зворотнього знімка є доказом прочитаного , не замкненого МSK4
У схемі JS немає await між йогоvaliдацією іstate update, що робить цю послідовність невід 'ємною на одній ланцюзі подій . що не гарантує безпеки транзакцій між процесами чи машинами
Використовуйте один і той самий командний ID при повторній спробі операції. API повертає зачуваний відгук на однакову повторну спробу і відкидає повторне використання цього ID з різними вказівкамиМSK1 Залишити сервераM SK2 зачувані вимоги; не accept edited demands from the browser
Тривалість життя wniosku
Кожен поточний графік зберігає свою останню пропозицію. Нова пошукова система замінює її . Об 'єм, який потікає до аутентифікованого робочого потоку резерваціїM SK2 і додає обмежені строки терміну служби/ відмивання для сервера МSK4 використання заявок в програміMSC5 Сам нативний двигун не зберігає жодної умови резервації
Установка припускає, що Еліс може забронювати для Бет. Autoryzacja коллектора залишається програмою ' його відповідальність МSK2 তার адаптер для зйомок також потребує програми ' існуючі зобов 'язання M SK4 володіння та пропускна спроможність MST5 календарь MSC6 лише візуальні прямокутники виграють MSM7 не забезпечити використання чи обслуговування обладнанням MSV8 обмеження
Коли .NET - це сервер
Те ж відокремлення працює, коли C# є вхідним пунктом для застосування . Замість того, щоб завантажувати DLL до Node M SK2 NET-приложение вміщує Node і називає існуючий JavaScript API . В API все ще є резервний стан МSK5 hosting його з C\ # не вимагає переміщання цього стану до \ MSC7\ NET магазину .
Час запуску приносить цикл подій
І Проект EmbeddedNode застосування Microsoft.JavaScript.LibNode 20.1800.203. Це тестований тут нативний парування часу запуску Microsoft.JavaScript.NodeApi 0.9.36.
Хостинг-нод означає приймати відповідальність за свою платформу та середовище:
using var platform = new NodeEmbeddingPlatform(new NodeEmbeddingPlatformSettings
{
LibNodePath = nativePath
});
using var runtime = platform.CreateThreadRuntime(AppContext.BaseDirectory,
new NodeEmbeddingRuntimeSettings
{
MainScript = "globalThis.require = require('module').createRequire(process.execPath);"
});
nativePath вибирає спакувану libnode.dll, libnode.dylib або libnode.so для ідентификатора кінцевого циклу. У повній програмі runtimes/<rid>/native макет і зрівноважений каталог видавництва. Один процес має одну нодерну платформуM SK1 час запуску потока забезпечує середовище та цикл подій.
bootstrap створює CommonJS require для завантаження модуля. Базова директорія - це компілірована програма ' вихідна директорія МSK2 Копуйте ваші файли JS там і встановіть будь-які необхідні node_modules де Нод може їх розв 'язати. Проект позначає дві .cjs файли з CopyToOutputDirectory.
Встановлений генерічний node застосовується або ділиться libnode не є автоматичним замінником пакету вбудова шлях залишається експериментальним, та управляемые / нативні версії мають бути сов 'язливими
Обіцянки з 'єднують API
Взірковий календарApi.cs обгортає модуль JS за надрукованими методами C# . Його конструктор створює API додатку і зберігає його JSReference.
З допомогою інтерфейсу JS, загорнутого за методами C# , програма може виконувати асинхронні чтення і записи за допомогою шкалулятора
var snapshot = await runtime.RunAsync(() => api.ReadWindowAsync(window));
var offer = runtime.Run(() => engine.Suggest(window, snapshot, api.GetName));
var booked = await runtime.RunAsync(() =>
api.TryBookAsync(offer, Guid.NewGuid().ToString()));
Перший дзвінок вводить JS, викликає readWindow, чекає свого обіцяння і копіює отримані массиви в AvailabilityInput. Другий запускає пошук C api.GetName викликає ДС під час конструювання результату
Адаптер - це місце, де JavaScript Promise стає чимось, чого C# може чекати
var promise = (JSPromise)_api.GetValue()
.CallMethod("readWindow", window.Start, window.End);
return await promise.AsTask(ReadSnapshot);
ReadSnapshot копіює поля в надруковані arrays .NET в адаптері . Результат обіцянки читається під час виконання в контексті JS МSK2 Знову повертаний знімок містить МSK3 NET стрічки \ , \ arrays and numbers \ МSK5 , таким чином, щоб викликатель міг використовувати його після закінчення JS вызову | .
Ціни належать до середовища JavaScript
Створити, доступ і конвертувати JSValue, JSObject і JSArray цінності всередині runtime.Run або RunAsync. Не тримайте сирого JSValue від зворотнього зв 'язку і отримати доступ до нього пізніше на потокі
Об 'єкт API мусить пережити декілька дзвінків,, щоб адаптер мав JSReference. Кожна операція відібрає свою цінність в часі запуску JS . Під час замкнутості МSK2 програма видаляє цю інформацію на штриге JS, МSK3 а потім видаляє час запуску та платформа \ . Це модель життєвого циклу, описана в бібліотеці \ МSK5 об 'єднання потоків та асинхового управління.
В цьому прикладі пошук C# працює на вбудованому JS-стрічку, тому що він називає JS для імен. Task.Run не робить його інтерфейсом JS безпечним для доступу туди.
Значение zwrotу JavaScript може бути Обіцянням
Поширені модуль форматера показує, які зміни відбуваються, коли сутня Java-функція стає асинхронною. вона читає об 'єкт пропозиції і використовує збудований вузол
exports.formatAsync = async offer => {
await delay(1);
return exports.format(offer);
};
delay є setTimeout від node:timers/promises. Синхронний format функція формує час і читає clientName і technicianName, повертається до идентификацій для старішого стандарту
Адаптер C# створює JSObject з полями nabídky і JSArray з зустрічей. Зволікання модуля напряму, а потім - один рядокM SK1
return (string)module.CallMethod("format", value);
В цьому шляху немає стрічки JSON. Адаптер для бронювання де відбуваються поляні копії.
Для асинкної JS-функції, її результатом є ОбіцянняM SK1 а не кінцевий рядок:
var promise = (JSPromise)module.CallMethod("formatAsync", ToJS(offer));
return await promise.AsTask<string>(value => (string)value);
Голосник створює форматор всередині runtime.RunAsync, де його значення модуля важливе для викликуM SK1 Це повертає Task<string>. Конверція закінчується на контексті JS перед тим, як строк покидає йогоM SK1 Ми перевіряємо, чи асинхронний результат відповідає синхронному.
Створити метод асинхронним не перетягує роботу процесора. Дальне затримування дає Node' поточну циклію подій для завершення асинchronної роботиM SK2 Зайняті цикли JavaScript всередині formatAsync все ще блокує цикл подій.
Винятки також перетинають кордон
Викинута помилка JavaScript приходить в C# як JSException. Відторгнута обіцянка конвертована з AsTask помиляє задачу з тим же винятком типу:
try
{
await runtime.RunAsync(() =>
new BookingFormatter(runtime.Import(modulePath)).FormatAsync(offer));
}
catch (JSException error)
{
Console.Error.WriteLine(error.Message);
}
В іншому напрямку, випущена CM SK1 винятка приходить в JavaScript як Error. Тести проводять неправильний вхід C#\input,, зворотний дзвінок на ім 'я ДС, що викидає\ ,\ неправильне синхронне сформаторське покликання\ МSK4\ і відторгнуте сформатори Обіцяння\ МСК5\ Вони також роблять правильний дзвінок після цього, щоб перевірити, чи неспроможність зв' язку не зруйнувала\ М СК6\ навколишнє середовище\ M СК7\
Перетинні- мови перевіряють npm run test:interop вправлятися як синхронними rzutами, так і відмовами від обіцянки:
PASS: C# called JavaScript for availability and names.
PASS: Existing JavaScript API committed the booking.
PASS: JavaScript Promise awaited as a C# Task.
PASS: JavaScript throw arrived as JSException in C#.
PASS: JavaScript Promise rejection arrived as JSException in C#.
Сподівані конфлікти забронювання залишаються нормальними результатами, такими як SnapshotChanged; помилкові вхідні і програмні помилки викидають . Обробляйте їх окремо, щоб недоступний стікок не став ’ ' ’ неяскравою помилкою сервера виняток на карті.
Нативний AOT змінює те, що npm має відправляти
Управляюча конструкція потребує .NET, вмонтованого поряд з вузлом . Нативний AOT може комп 'ютеризувати виведену бібліотеку C# у .node addon, який Node завантажує безпосередньоM SK1 Aplikaція досі володіє заявками за допомогою свого API JS.
І Проект NativeAddon є перевіреним доказом упаковки. Він eksportує цю функціюM SK1
[JSExport]
public static string DescribeAppointment(string clientId, string serviceId,
string technicianId, Func<string, string> getName)
=> $"{getName(clientId)}: {serviceId} with {getName(technicianId)}";
Це зберігає два шляхи зворотнього зв 'язку в пакеті
Збудування все ще починається з вивезеного методу C# ,, але ці властивості змінюють його вихідні даніM SK2
<PublishAot>true</PublishAot>
<PublishNodeModule>true</PublishNodeModule>
<PackNpmPackage>true</PackNpmPackage>
Проект направляє публікування інформації в native/<rid> і торболи в pkg. Його пакет.json містить декларації завантаження, і .node бінарні. Загрузчик CommonJS вибирає ідентификатор часу запуску з Node' платформи та архітектуриM SK2 включно з окремою Linux musl схемоюMSC3
Використовували тести на будову та пакети macOS ARM64
dotnet publish NativeAddon -c Release -r osx-arm64
node NativeAddon/test.cjs
Публикація також працює npm pack. Установити генерований шар стерболу в окремий проект вузлів
npm install /absolute/path/to/NativeAddon/pkg/mostlylucid-native-interop-demo-0.1.0.tgz
Для використання Node app, zainstalowanий пакет відкриває функцію:
const { describeAppointment } = require('@mostlylucid/native-interop-demo');
const text = describeAppointment('alice', 'gels', 'sarah', id => api.getName(id));
Я перевірив zainstalowanий tarball, а також локальний вихід. . Він складається з чотирьох файлів. .node бінарний, і не має node-api-dotnet npm залежність від часу запуску. Пакет є приватним демонстраційним і не було опубліковано в регістрі
Для дистрибутивного випуску, побудувати кожен піддерживаний RID на відповідному руйнері , зібрати бінарні файли МSK2 потім запакувати цілий набір платформи M SK3 У прикладі tarball є лише macOS ARM64. перевірити glibc та musl окремо на LinuxM SK5 ПлатформаMSC6 конкретний аддон не єМSK7 не портативним, вставляючи його у npm tarballMST8 MicrosoftM ST9s Нативний інструкційний модуль AOT obejmuje модель збудови.
Проект підключений до компілятора runtime/ 10.0.14 тому що старіший початковий варіант SDK' видав попередження під час публікації консультація.
Останнє робоче місце на графіку - МСК0
Кора упаковки наразі використовує відображання System.Text.Json виклики для конструювання канонічних тлумачень, ключі до запиту та ID-кандидатівM SK1 Ці виклики потребують AOT -безпечного втілення або зачуваних метадань МSK3 після чого буде опубліковано M SK4артефектний тест . Виведення JSON з мовної межі не призвело до відкидання ядрої бібліотеки MSC7 внутрішньої сеrialізації MSL8
Невеликий аддон перевіряє пакування, нативне завантаження і зворотньі зв 'язкиM SK1 Він не встановлює здатності нативного AOT AutoScheduler, і не заявлено жодного результату планування AOT МSK1 Залишити цю роботу відокремленою від вже існуючої МSK2 випробуваної інтеграції .
WebAssembly переміщає хоста у браузер
Переміщення тієї ж функції у браузер змінює межі інтеграції. Маршрут інтерфейсу браузера M SK1NET використовує System.Runtime.InteropServices.JavaScript. Браузер не може завантажити .node двойник вище; він потребує браузера-совладнаний M SK2NET код і генеровані активи WebAssembly runtime .
І WasmSketch показує два відповідних-допомічника шляхуM SK1
[JSImport("getName", "calendarApi")]
private static partial string GetName(string id);
[JSExport]
public static string DescribeAppointment(string clientId, string serviceId, string technicianId)
=> $"{GetName(clientId)}: {serviceId} with {GetName(technicianId)}";
Клас, який містить static partial. Ці атрибути приходять з інтероп-навігацій браузера BCL . Гость JS реєструє свій існуючий пошук наименовання і отримує МSK2NET eksports МSK3
const runtime = await dotnet.create();
runtime.setModuleImports('calendarApi', { getName });
const exports = await runtime.getAssemblyExports(runtime.getConfig().mainAssemblyName);
const text = exports.BrowserInterop.DescribeAppointment('alice', 'gels', 'sarah');
Microsoft's вказівник програмного забезпечення браузера надає інструменти та шаблон для цього хоста:
dotnet workload install wasm-tools
dotnet new install Microsoft.NET.Runtime.WebAssembly.Templates
dotnet new wasmbrowser -n BrowserInteropDemo
Скетч надає обкладинку C# і JS-файлів для цього шаблону . Опублікувати проект браузера та подавати його повний генерований каталог активів поряд з загрузчиком JS МSK2 Пакет npm міг би розповсюджувати цей загрузчик та каталог активов для вашої додатки M SK3 будувати, щоб копіювати в його громадські активи . Захищати файли пробігу часу та URL-зв 'язки MSC5 копіювання лише .wasm файл недостатньо.
Аут використовує власний браузер WebAssembly RunAOTCompilation publish setting and toolchain. Це відрізняється від нативного AOT PublishAot налаштування для .node. Рухування WebAssembly AOT пояснює ефективність
Для веб-браузера:-засобний планування часуM SK1 додаток перейде моментальний знімок, локально обчислить запропонування і відправить прийняту пропозицію до свого існуючого сервера API . Сервер ще підтверджує та атомічно підтверджує замовленняMSC4 Він мусить перебудувати або перевірити службуМSK5запроси на ресурсі МSK6 включно з квалифікаціями та тривалістюMSL7 перед тим, як написатиMST8 Веб-браузер:" Браузер " -" обчислювані вимоги - ненадійні дані" МSK10\ Веб-працівник може відсторонювати важкі обчислення від календаря\ "'" інтерфейс інтерфейсу \ "МSK12" з моментичними знімками та результатами, які переносяться в якості повідомлень
Адаптер браузера, пакуванняM SK1 співпадність ядра і завантаження / вартість запуску потрібно підтвердити wasm-tools не було zainstalowanо в цьому середовищі, тож креслення не було збудовано чи сконструованоM SK1 Це документований наступний крок, не опублікований WASM програміст або результат
Де інтеграція може піти не так
| Симптомен МSK1 перевірити або виправити МSK2 | |
|---|---|
ERR_PACKAGE_PATH_NOT_EXPORTED для net10.0.js |
Використовувати node-api-dotnet/net10.0 з в 'язаними 0.9.36 пакет |
| Не в змозі знайти управляемого модуля | Сконструюйте спочатку і розв 'язуйте DLL із абсолютним маршрутом файлової системи |
| Не вистачає DLL залежності | Копія модуля МSK2 управляемые залежність CopyLocalLockFileAssemblies |
Class not registered for JS export |
Экспорт класів DTO, а також класів послуг МSK1 |
| В HTTP-реакції JSON зникають властивості JS | Застосувати поля у Managed Wrapper МSK2 до даних JS |
Відповідь про те, що очікувана стрічка async передача зворотнього зв 'язку Func<string,string> |
|
Рух JS зазнає невдачі після await або на іншому потокі |
Перетворити всередині середовища зворотнього зв 'язку або зберегти JSReference і доступ до нього через час запуску |
| Вбудований вузол не здатний розв 'язати модуля | Проверка вихідного каталогу .cjs/ESM вибір і node_modules місцезнаходження |
| Поиск не знаходить нічого, хоча інтерфейс виглядає пустим | Включити модулі з пропускною спроможністю клієнта МSK2 обладнання та повний слід від reset у сфотографуванні |
| Запропонування провалюється після успішного пошуку | Переновлюйте зйомку |
| Відмовлений запит відображається як подібне забронювання | Знову використати оригінал ID команди і надати правосуперечності в API для запису МSK2 |
C# і JavaScript можуть відновити один одного, а потім ще один.M SK1 ввести інший. . Залишити контракт зворотнього зв 'язку невеликим. МSK3 уникати блокування очікувань та вирішити, хто має довгі.МSK4 тривалий зворотній зв' язок.
Що вимірювання кажуть нам
Дані вимірювання залишаються з оригінального автономного приладу: Мережа, яка запускає управляний CM SK1 шкалулятор зі своїм в- пам 'ятним SQLite тест-сторінкомMSC3 за допомогою надрукованих об' єктів
Ця відокремлення має значення. МСК0. Числа порівнюють мову. МSK1. Транспортні кордони навколо одного робочого навантаження. ;. Вони не є прогнозом затримки для повної інтеграції.
Введені об 'єкти, JSON і межі gRPC
Викреслення сеrialізації JSON замінює її організацією об 'єктів і доступом до нерухомості. Для вимірювання цих витратM SK1 зброєння тепер порівнює три шляхи:
- Введені об 'єкти в-процесM SK1 включаючи читання кожного повернутого поля у JS-скріншоті.
- JSON у-процесіM SK1 включно з Серіалізацією C# і JavaScript-аналізом .
- Автомобіль gRPC,, який переносить ту реакцію JSON у protobuf-повідомлення.
Усі три викликають один і той самий C# пошук і будують один і такий самий модель результатуM SK1 Старі FindTogetherJson метод залишається тільки для порівняння та адаптера для автозаправки. Це автономне приладдя використовує FindTogether для того, щоб написати шлях. AutoScheduler.Suggest замість.
Benchmark читає повний результат на кожному маршруті. Встановлення часу лише створення упорядкованого обкладинки об 'єктів залишає позаду роботу, яку має зробити календарна програма пізнішеM SK1 Управлення перевіряє повернений кандидат і завдання на всіх трьох маршрутах , і кожен вимірений пошук знову виконує перевірку wykonalności.
Тривалість і послідовна пропускна здатність
вимірюваний на Apple M5, macOS ARM64, M SK2 GiB RAMМSK3 Ноді v22.15.0 і .NET SDK 10.0.201. Автомобіль використовує Grpc.AspNetCore 2.85.0;, який використовує Node Client @grpc/grpc-js 1.14.7. Обидві МSK1 NET-хости використовують робочу станцію GC
Кожен із трьох нових-процесових випробувань нагріває кожну операцію за допомогою M SK1 дзвінків,, а потім вимірює 1,500 дзвінки на співпадковості одиногоMSC4 Три режими обертаються вгору за послідовністю запускуМSK5 Кожен елемент tabelі є середнім показником цієї статистики впродовж випробуванихMNK6 p50 це середня тривалість дзвінків; p95 - це час, за який 95% пробного ' закінчився дзвінок
Ехо МSK1 Кіб поле МSK2 gRPC + реакція ДжЗОН мSK4 МСК5 μs СМСК6 \СМСк7μs \SМСК8 \ СМСК9 \сМСК10
| Praca per call | Path МSK2 pM SK3 МSK4 p\95 | Последовательні дзвінки | ||
|---|---|---|---|---|
| Ехо МSK1 Кіб поле МSK2 Типовані об 'єкти ♫ ♫ МSK3 ♫ Снимок Дж.С. ♫ | ||||
| Ехо МSK1 Кіб поле МSK2 ДжЗОН інтероп | ♫ ♫ МSK4 ♫ μs ♫ | ♫ | ||
| Найти об 'єднане наді' єднання МSK1 Введені об' єкти ♫ ♫ МSK2 ♫ Снова робота ♫ | ||||
| Найти об 'єднане призначення | Interop JSON МSK2 МSK3 μs | |||
| Найти об 'єднане назначення МSK1 gRPC ♫ ♫ МSK2 ♫ Відповідь JSON ♫ |
В цій установці пошук був повільнішим при p50 Для цього знадобилося приблизно 621 μs , порівняно з МSK2μs за допомогою JSON і МSK3 μ s за допомогою gRPCM SK4 У парних випробуванняхMSC5, читаючи результат друкування, додали приблизно \33–87\μs більше, ніж в wersji JSON. Пп \ 95\ був нижчим у сукупній таблиці \ МSK9, тож вимірювання не підтверджують об 'єктивного твердження, що або в \МSK11 \ технологічний шлях перемагає на кожному процентілі \ мSK12 \
Угортачі класів та яскравий приклад JS пояснюють, чому потрібно уникати серійизації' не бути швидкістюM SK1 Ми читаємо поля за допомогою інтероп-слої і створюємо JS-об 'єкти для додатку . Для цього маленького вантажу, кодувальник JSONMSC4 параparser дуже добре конкурує з цим завданням МSK5 Інший вантажМSK6 інша форма DTO або покращена цінністьMska7 сортування типу могло б змінити результатM Ska8 ті, хто потребує власних вимірів Мska9
Ехо-контролер переводить текстовий поле 1 KiB через кожен шлях . Його надрукована версія використовує структуру wartości МSK2 потім читає повернене поле . Її JSON-версія переводить і розшифровує стрічку JSON \ . Навіть тут \ МSK5 \ пряме маркування має справу з цим МSK6 \ він читає та копіює поля об 'єктів | . \ Усунення JSON сама по собі не робить ані ', ані МSK9
Реакція шкалулятора' - це 495 байти, коли представлені як JSONM SK2 Це порівняння розмірів для задрукованого результату МSK3 не є твердженням, що задрукований шлях надсилає МSK4 байтову зв 'язку з' язком
Що таке gRPC над głowicою?
Запроси на службу gRPC FindTogetherJson через поновлюваний простий текст HTTP/2 зв 'язок на зворотньому ланцюгу TCPM SK1 Client робить наступне: канал-направлення для використання, для того, щоб встановити зв 'язок перед вимірюваними дзвінкамиM SK1 В цьому тесті немає TLS, прокси чи віддаленої мережі
Під час парних випробувань, його пошук pM SK1 був приблизно 119–282 μs вище, ніж інтерп JSON і 32–221μs вище ніж задрукований шляхMSC4 Це включає в себе обробку протобуфуМSK5 HTTP МSK6 планування потоків та зворотнього зв 'язку з JavaScriptMST7 Обробка об' єднання обіцяньMSL8 Полностью задрукована реакція протобфа мала б різні витрати на серіалізаціюМСК9 Ці цифри описують адаптер, збудований тут МСК10, а не фіксовані накладні витрати для gRPCMСК11
Різниця невелика для одного календаря- натискання кнопкиM SK1 Вони важливіші, коли додаток повторює пошуки, коли обмеження змінюються, або робить багато викликів за запитом за допомогою двигуна . Залишає виклики на рівні поточної операції, а не переносить окремі значення через API RPC.
Це був розробка- машина, що працює з природним збиранням сміття та іншими системами . Виклики column reports sequential throughput at concurrency one M SK3 пропускна спроможність сервера під одночасним навантаженням МSK4 залишки записують і пишуть суперечку потребують окремого тесту .
Пам 'ять: підраховує весь порядок
RSS - це резидентна пам 'ять, яка відображається для процесу. Включно з кодом забігу , бібліотеками МSK2 буферами та пам' ятками придатників, а також управляемыми гіпсами .
| Установлення | Початковий RSS МSK2 RSS після навантаження | |||
|---|---|---|---|---|
| Введені об 'єкти + Шнупшот JS МSK2 МSK3 MiB | МSK4 | 128.8 | MiB | |
| Interop JSON МSK1 107.3 MiB МSK3 ♫ ♫ МSK4 ♫ MiB | ||||
| gRPC МSK1 реакція JSON , об 'єднана |
Це середні знімки після першого важливого пошуку, а також після нагрівання та запланованого навантаження. Ніяких примусних VM SK1 чи .NET зйомок не виконується . Процес базового узла був приблизно МSK4 MiB RSSMSC5
Тут вказаний шлях не зменшив RSS порівняно з JSON. Виведення текстових буферів можна відокремити у Managed Wrappers
Для gRPC, таблиця додає Node client's RSS до бокового вагонуMSC2s working setM SK3 Подивившись лише на клієнта, ви приховуєте більшу частину об 'єднанняMSL4 Общее RSS може рахувати спільні сторінки більше, ніж разМSL5 і час збирання впливає на збереження пам' ятіМСЛ6 Ці дані не є унікальними фізичнимиМСМ7спогадамиММСК8 пікомМУСК9спогадами або вимірюваннями протікуМСК10
Зроблені результати зберігають кожен процес, а вимірювання МСК0 відокремлені. МСК1. Контейнери МСК2. Установлення GC. Завантаження МСК3. Заряди МСК4. Або сторонній вагон, спільний багатьма Node-процесами, можуть змінити порівняння. МSK5. Загрузка МСК6.NET всередині Node все ще означає запуск both V8 and the CLR, with their separate heaps and garbage collectors. ММК9.
Синхронні дзвінки досі блокують цикл подій Node's
Обидві способи пошуку в-процесі запускаються синхронно на стріці підключення до узлаM SK1 Відказування задрукованого об 'єкта не змінює ' місця, де відбувається пошук. Client gRPC чекає відповіді, поки робота відбувається в іншому процесіMSC4
Приймання налаштовують таймер 10 ms , потім запускає МSK2 пошуки МSK3 додаткове затримування таймера було приблизно 31–53 ms для надрукованих об 'єктів, 30–33 ms для JSON interop, і 0–0.9 ms через gRPC. Вибух споживає дані, що повертаються, , включаючи задрукований знімок або аналіз JSON МSK2 але забув про петлю затримувань
Цей спалах також затримував відклики без зв 'язку на одній стріці узла. Об' єднати пошукову роботу та виміряти подіюM SK1 затримувати цикл разом з затримкою запросу. Якщо двигун рухається до стрічки робітника або асинхронного APIMSC3 вирішувати, яка стрічка виконує роботу і володіє її станом . Обіцяння навколо синхронного виклику все ще запускає його на теперішньому стрічкуМSK5
Проводити порівняння
npm run build:bench
npm run bench
npm run bench:summary
Бегунок починає і зупиняє свій зворотний бік, використовує свіжі клієнти, перевіряє еквіваленцію результатів, Результати including trial values, details of the environment and hashes of the measured assemblies BENCH_TRIALS і BENCH_ITERATIONS налагодити запуск.
Ці вимірювання охоплюють пошуки та контрольний дзвінок. Вони не дають Benchmark rezerwацій записівM SK1 TLS , віддалена служба, Нативний AOTMska4 одночасні користувачіM Ska5 браузер чи повний стильоMSKA6 робот-інженціяMска7
Випробовуючи приклади
І зразок супутника вимагає: .NET 10 і Node МSK2 Залишати пакети та веб-репозитори одна біля одної
git clone https://github.com/scottgal/mostlylucid.packing.git
git clone https://github.com/scottgal/mostlylucidweb.git
cd mostlylucidweb/samples/NodePacking
npm ci
npm run build:app
npm run app
npm run reverse
npm run test:interop
npm run app управляє Node-поширеною інтеграцією, обговорюваною вище
Alice: gels with Sarah
Beth: pedicure with Anna
C# called JavaScript for names: true
Existing API booked: true
Retry returns same reservation: true
Existing API accepted stale offer: false
npm run reverse починається з C#. Він импортує Java-API , читає стрічку зйомки M SK2 питає JavaScript про ім ’ я МSK3 відправляє замовлення через цей API і формує результат test:interop також перевіряє викидині помилки JS та відкидилі обіцянки.
Ці шляхи використовують JavaScript API як свою рецепцію. Програмне забезпечення, що його можна застосувати, використовує JavaScript в пам ’ яті, в інтерфейсі цього APIM SK2 В вашій aplikacji, заміняють ці методи викликом до існуючого репозиторию або сервісу . Це не надключений адаптер до баз даних виробництваМSK5
І README пояснює джерело-перехилення маршруту і окремий ліндикаторно-рівний fixtureM SK1 Приклади в цій статті походять з цих проектівМSK2
Що було перевірено
Управляні інтеграції, синхронний зворотній зв 'язокM SK1 Обіцянки, об' єднання винятків,, одиниціMSC4 поток замовлення авторських прав та ARM для macOSMスク5 локальний AOT npm-помічник було запущено . npm tarball був zainstalowanий і викликаний від окремого споживача МSK7 Тести поширюються на старі пропозиціїМSK8 повтори командMSL9 невдачі зворотнього зв' язкуМSL10 неправильний вхід сфотографу та ДС МSL11 власні ім 'я MSL12
Сущене-каlender API залишається функціональним вM SK1памятному пристрої, щоб замінити його за допомогою вашої додатки 'API. Її тривалий транзакції M SK4 політика аутентифікації та anulації - це інтеграція МSK5 Полний планувальник М SK6 порт нативного AOT і браузер WebAssembly не підтверджуються релізами .