mirror of
https://github.com/zap-proto/cs.git
synced 2026-10-30 15:05:32 +00:00
Finishes the in-flight capnp→ZAP rebrand on this branch. The prior commits
renamed identifiers/namespaces/files/projects (Capnp.Net.Runtime→Zap.Net.Runtime,
CapnpC→ZapC, .capnp→.zap) but left the human-readable brand name "Cap'n Proto"
throughout doc-comments, .csproj/.nuspec descriptions, README, MSBuild .xaml
rule display names, and the generated XML doc. This completes brand neutrality:
- Replace 154 "Cap'n Proto" / 4 "Cap'n-Proto" / 1 "Cap'n'p" prose occurrences
with "ZAP" across 32 first-party files (runtime, generator, zapc-csharp,
MSBuild integration, chocolatey nuspecs, README, docs, XML doc).
- Revert the LICENSE provenance URL to the real upstream fork
(c80k/capnproto-dotnetcore) — upstream-fork license headers must stay.
- Canonicalize project/repo URLs to github.com/zap-proto/cs (were fabricated
c80k/zap-dotnetcore) in csproj/nuspec/VERIFICATION/README badges.
- Canonicalize docs URLs zap-protocol(.github.io|/zap-cs|/zap-cpp-core)
→ zap-proto.dev / github.com/zap-proto/{cs,cpp-core}.
- Collapse redundant "zap \"ZAP\"" PackageTags to "zap".
Verified consistent (no toolchain on host): every .sln/.csproj ProjectReference
resolves; all namespaces are Zap*/ZapC*; MSBuild task chain
(GenerateZapFileCodeBehindTask, ZapFiles ItemGroup, _ZapcCsharp_TaskAssembly)
is uniformly renamed; props/targets/xaml/coverage/chocolatey carry no capnp.
Deliberately preserved as upstream-derived test data (not first-party source):
upstream Cap'n Proto schema fixtures (rpc.zap, rpc-twoparty.zap, json.zap,
rpc-csharp.zap), golden compiler-error outputs (errors.txt), and the
machine-generated DO-NOT-EDIT test.zap.{c++,h}. Their "Cap'n Proto" strings are
the literal output of the external schema compiler the compat test matches.
218 lines
6.3 KiB
C#
218 lines
6.3 KiB
C#
using Zap.Util;
|
|
using System;
|
|
using System.Diagnostics;
|
|
using System.Threading.Tasks;
|
|
|
|
namespace Zap.Rpc
|
|
{
|
|
class PromisedCapability : RemoteResolvingCapability
|
|
{
|
|
readonly uint _remoteId;
|
|
readonly object _reentrancyBlocker = new object();
|
|
readonly TaskCompletionSource<ConsumedCapability> _resolvedCap = new TaskCompletionSource<ConsumedCapability>();
|
|
readonly StrictlyOrderedAwaitTask<Proxy> _whenResolvedProxy;
|
|
bool _released;
|
|
|
|
public PromisedCapability(IRpcEndpoint ep, uint remoteId): base(ep)
|
|
{
|
|
_remoteId = remoteId;
|
|
|
|
async Task<Proxy> AwaitProxy() => new Proxy(await _resolvedCap.Task);
|
|
_whenResolvedProxy = AwaitProxy().EnforceAwaitOrder();
|
|
}
|
|
|
|
public override StrictlyOrderedAwaitTask WhenResolved => _whenResolvedProxy;
|
|
public override T? GetResolvedCapability<T>() where T: class => _whenResolvedProxy.WrappedTask.GetResolvedCapability<T>();
|
|
|
|
internal override Action? Export(IRpcEndpoint endpoint, CapDescriptor.WRITER writer)
|
|
{
|
|
lock (_reentrancyBlocker)
|
|
{
|
|
|
|
if (_resolvedCap.Task.ReplacementTaskIsCompletedSuccessfully())
|
|
{
|
|
using var proxy = new Proxy(_resolvedCap.Task.Result);
|
|
proxy.Export(endpoint, writer);
|
|
}
|
|
else
|
|
{
|
|
if (_ep == endpoint)
|
|
{
|
|
writer.which = CapDescriptor.WHICH.ReceiverHosted;
|
|
writer.ReceiverHosted = _remoteId;
|
|
|
|
Debug.Assert(!_released);
|
|
++_pendingCallsOnPromise;
|
|
|
|
return () =>
|
|
{
|
|
bool release = false;
|
|
|
|
lock (_reentrancyBlocker)
|
|
{
|
|
if (--_pendingCallsOnPromise == 0 && _resolvedCap.Task.IsCompleted)
|
|
{
|
|
_released = true;
|
|
release = true;
|
|
}
|
|
}
|
|
|
|
if (release)
|
|
{
|
|
_ep.ReleaseImport(_remoteId);
|
|
}
|
|
};
|
|
}
|
|
else
|
|
{
|
|
this.ExportAsSenderPromise(endpoint, writer);
|
|
}
|
|
}
|
|
}
|
|
|
|
return null;
|
|
}
|
|
|
|
async void TrackCall(StrictlyOrderedAwaitTask call)
|
|
{
|
|
try
|
|
{
|
|
await call;
|
|
}
|
|
catch
|
|
{
|
|
}
|
|
finally
|
|
{
|
|
bool release = false;
|
|
|
|
lock (_reentrancyBlocker)
|
|
{
|
|
if (--_pendingCallsOnPromise == 0 && _resolvedCap.Task.IsCompleted)
|
|
{
|
|
release = true;
|
|
_released = true;
|
|
}
|
|
}
|
|
|
|
if (release)
|
|
{
|
|
_ep.ReleaseImport(_remoteId);
|
|
}
|
|
}
|
|
}
|
|
|
|
protected override ConsumedCapability? ResolvedCap
|
|
{
|
|
get
|
|
{
|
|
try
|
|
{
|
|
return _resolvedCap.Task.IsCompleted ? _resolvedCap.Task.Result : null;
|
|
}
|
|
catch (AggregateException exception)
|
|
{
|
|
throw exception.InnerException!;
|
|
}
|
|
}
|
|
}
|
|
|
|
protected override void GetMessageTarget(MessageTarget.WRITER wr)
|
|
{
|
|
wr.which = MessageTarget.WHICH.ImportedCap;
|
|
wr.ImportedCap = _remoteId;
|
|
}
|
|
|
|
internal override IPromisedAnswer DoCall(ulong interfaceId, ushort methodId, DynamicSerializerState args)
|
|
{
|
|
lock (_reentrancyBlocker)
|
|
{
|
|
if (_resolvedCap.Task.IsCompleted)
|
|
{
|
|
return CallOnResolution(interfaceId, methodId, args);
|
|
}
|
|
else
|
|
{
|
|
Debug.Assert(!_released);
|
|
++_pendingCallsOnPromise;
|
|
}
|
|
}
|
|
|
|
var promisedAnswer = base.DoCall(interfaceId, methodId, args);
|
|
TrackCall(promisedAnswer.WhenReturned);
|
|
return promisedAnswer;
|
|
}
|
|
|
|
public void ResolveTo(ConsumedCapability resolvedCap)
|
|
{
|
|
bool release = false;
|
|
|
|
lock (_reentrancyBlocker)
|
|
{
|
|
#if DebugFinalizers
|
|
if (resolvedCap != null)
|
|
resolvedCap.ResolvingCap = this;
|
|
#endif
|
|
_resolvedCap.SetResult(resolvedCap!);
|
|
|
|
if (_pendingCallsOnPromise == 0)
|
|
{
|
|
release = true;
|
|
_released = true;
|
|
}
|
|
}
|
|
|
|
if (release)
|
|
{
|
|
_ep.ReleaseImport(_remoteId);
|
|
}
|
|
}
|
|
|
|
public void Break(string message)
|
|
{
|
|
bool release = false;
|
|
|
|
lock (_reentrancyBlocker)
|
|
{
|
|
#if false
|
|
_resolvedCap.SetException(new RpcException(message));
|
|
#else
|
|
_resolvedCap.SetResult(LazyCapability.CreateBrokenCap(message));
|
|
#endif
|
|
|
|
if (_pendingCallsOnPromise == 0)
|
|
{
|
|
release = true;
|
|
_released = true;
|
|
}
|
|
}
|
|
|
|
if (release)
|
|
{
|
|
_ep.ReleaseImport(_remoteId);
|
|
}
|
|
}
|
|
|
|
protected async override void ReleaseRemotely()
|
|
{
|
|
if (!_released)
|
|
{
|
|
_released = true;
|
|
_ep.ReleaseImport(_remoteId);
|
|
}
|
|
|
|
try { using var _ = await _whenResolvedProxy; }
|
|
catch { }
|
|
}
|
|
|
|
protected override Call.WRITER SetupMessage(DynamicSerializerState args, ulong interfaceId, ushort methodId)
|
|
{
|
|
var call = base.SetupMessage(args, interfaceId, methodId);
|
|
|
|
call.Target.which = MessageTarget.WHICH.ImportedCap;
|
|
call.Target.ImportedCap = _remoteId;
|
|
|
|
return call;
|
|
}
|
|
}
|
|
} |