NeverENG commented on code in PR #34:
URL: https://github.com/apache/dubbo-net/pull/34#discussion_r4513708890


##########
Docs/en/architecture/index.md:
##########
@@ -0,0 +1,51 @@
+# Source Navigation: Calls and Updates
+
+[Documentation home](../index.md) · [中文](../../zh/architecture/index.md) · 
[User guide](../../../README.md)
+
+This map describes the **current `main` source used by PR #34**, not a 
proposed architecture. DubboNet is a consumer of remote Java Providers. The two 
paths below can be read independently; conditional steps do not run on every 
request. For API usage, start with the [user guide](../../../README.md); wire 
details belong to the [native](../protocols/native-dubbo.md) and 
[Triple](../protocols/triple.md) pages.
+
+## Request path: `QueryAsync` to result
+
+```text
+DubboClient.QueryAsync
+  ├─ Java types missing → CreateMetadataInvocationAsync → DubboMetadataManager 
→ signature resolution
+  └─ QueryInternalAsync → GetRequiredProtocolAsync (best-effort overload check)
+       → DubboDriverCollection.GetDubboActuatorSuite(reserve: true)
+          ├─ no driver → ConcurrentGetProviderEndPoints → 
AddDubboServiceDriver → select again
+          ├─ driver with no Providers → discover again; retry only if 
Providers appear
+          ├─ candidates present but no available actuator → failure result
+          └─ selected → LoadBalancedInvocation.InvokeAsync → actuator 
SendQuery → DubboRequestResult
+```
+
+| Start reading here | Question and next page |
+| --- | --- |
+| [`DubboClient.QueryAsync` / 
`QueryInternalAsync`](../../../Clients/DubboClient.cs) | Where do arguments 
enter? When are types inferred, protocol checked, and initial discovery 
triggered? → [Client](client.md) |
+| [`CreateMetadataInvocationAsync`](../../../Clients/DubboClient.cs) / 
[`DubboMetadataManager.GetServiceMethodsAsync`](../../../Clients/DubboMetadataManager.cs)
 | Where do Java signatures come from, and what if they are unavailable? → 
[Metadata](metadata.md) |
+| [`ConcurrentGetProviderEndPoints` / 
`GetSeviceProviderEndPointsAsync`](../../../Clients/DubboClient.cs) | Who looks 
up addresses and installs subscriptions? → [Registry and 
discovery](registry.md) |

Review Comment:
   done,之前想先合 #36 再处理 #34,但感觉可以到 #36 再处理文档



-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]


---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to