فراخوان دور rpc
JSON-RPC 2.0 و MessagePack-RPC: سرور، کارخواه و ثبت متدها.
واردسازی فراخوان دور
نام آرگومانها شناسهی خود کد است و معادل فارسی ندارد؛ گونهها، کلیدواژهها و نام بستهها با معادل فارسی نوشته میشوند.
با فراخوان دور یک برنامه متدهای برنامهی دیگر را صدا میزند، انگار تابعهای خودشاند. در سمت سرور هر متد را با ثبت متد به یک تابع وصل میکنید؛ آن تابع شمارهی فراخوان را میگیرد، پارامترها را با پارامتر عددی فراخوان و مانند آن میخواند و با پاسخ ... یا شکست جواب میدهد.
پیامها با کدک جیسون (JSON-RPC 2.0) یا مسگپک رد و بدل میشوند و روی TCP با یکی از سه قاببندی خطی، سرآیندی (مثل LSP) یا طولدار جدا میشوند؛ کارخواه و سرور باید قاببندی یکسانی داشته باشند. پردازش متن همین را بدون شبکه انجام میدهد تا RPC را پشت یک مسیر اچ تی تی پی بگذارید.
یک سرویس کوچک بدون شبکه
سریعترین راه طراحی یک API از نوع RPC ساختنش با پردازش متن است: یک درخواست JSON-RPC (یا یک دسته) را به شکل متن میگیرد و پاسخ را هم به شکل متن برمیگرداند، بی هیچ شبکهای. هر متد یک تابع معمولی است که شمارهی یک فراخوان ف را میگیرد؛ پارامترها را با پارامتر متنی فراخوان، پارامتر عددی فراخوان و همخانوادههایشان میخواند و باید دقیقاً یک بار پاسخ دهد، با یکی از تابعهای پاسخ ... یا با شکست.
واردسازی فراخوان دور
واردسازی کدگذاری.مقدار
ناپایا کارها := وکتور {} برگردان وکتور<رشته>
تابع افزودن کار(ف: صحیح۶۴):
عنوان := فراخوان دور.پارامتر متنی فراخوان(ف، "title"، ۰)
اگر عنوان == "":
فراخوان دور.پارامتر نامعتبر(ف، "عنوان لازم است")
برگشت
پایان
کارها.بیفزا(عنوان)
فراخوان دور.پاسخ عددی(ف، کارها.طول())
پایان
تابع فهرست کارها(ف: صحیح۶۴):
ناپایا اقلام := مقدار.آرایه جدید()
هر ک در کارها:
مقدار.افزودن به آرایه(اقلام، مقدار.مقدار رشته(ک))
پایان
فراخوان دور.پاسخ دادن(ف، اقلام)
پایان
تابع شمار کارها(ف: صحیح۶۴):
فراخوان دور.پاسخ عددی(ف، کارها.طول())
پایان
تابع ریشه:
فراخوان دور.ثبت متد با توضیح("todo.add"، افزودن کار، "یک کار میافزاید و تعداد کارها را برمیگرداند")
فراخوان دور.ثبت متد با توضیح("todo.list"، فهرست کارها، "همهی کارها را برمیگرداند")
فراخوان دور.ثبت متد("todo.count"، شمار کارها)
سرچاپ فراخوان دور.پردازش متن(`{"jsonrpc":"2.0","method":"todo.add","params":{"title":"خرید نان"},"id":1}`)
سرچاپ فراخوان دور.پردازش متن(`{"jsonrpc":"2.0","method":"todo.add","params":["تماس با سارا"],"id":2}`)
سرچاپ فراخوان دور.پردازش متن(`{"jsonrpc":"2.0","method":"todo.add","params":{},"id":3}`)
سرچاپ فراخوان دور.پردازش متن(`{"jsonrpc":"2.0","method":"todo.list","id":4}`)
سرچاپ فراخوان دور.پردازش متن(`[{"jsonrpc":"2.0","method":"todo.count","id":5},{"jsonrpc":"2.0","method":"todo.delete","id":6}]`)
سرچاپ فراخوان دور.توضیح متد("todo.add")
کارها.آزادکن()
پایانهر پارامتر همزمان با نام و با جایگاهش جستوجو میشود: پارامتر متنی فراخوان(ف، "title"، ۰) هم {"title": ...} را پیدا میکند و هم نخستین عضو [...] را، پس کارخواهها میتوانند هر کدام از این دو شکل را به کار ببرند. پارامتر نامعتبر با کد استاندارد -32602 پاسخ میدهد، و متدی که هرگز ثبت نشده بی هیچ کدی از طرف شما -32601 میگیرد. در یک دسته، هر درخواست پاسخ خودش را دارد، شکستها هم.
دفتر ثبت متدها برای کل برنامه سراسری است، پس وضعیت متدها، مثل فهرست کارها در اینجا، در یک متغیر سراسری یا پشت آن زندگی میکند. اگر چند اتصال در نخهای موازی خدمت میگیرند، آن وضعیت را با یک قفل از همگام سازی محافظت کنید.
سرور و کارخواه روی TCP
برای دو برنامه، سرور جدید با درگاه ۰ میگذارد سیستم یک درگاه آزاد انتخاب کند و درگاه سرور پس از گوش دادن آن را گزارش میکند. خدمت به تعداد به تعداد ثابتی اتصال خدمت میدهد و برمیگردد، که برای آزمون مناسب است؛ خدمت تا توقف سرور ادامه میدهد. هر دو در هر لحظه فقط به یک اتصال پاسخ میدهند: تا وقتی یک کارخواه وصل مانده، بعدی در صف منتظر است. اگر باید همزمان به چند کارخواه خدمت داد، اتصالها را خودتان با تی سی پی بپذیرید (تی سی پی.پیوند و بعد تی سی پی.پذیرش در یک حلقه) و fd هر اتصال را در نخی جدا از نخ به خدمت به اتصال بدهید. در طرف دیگر، اتصال کارخواه وصل میشود و فراخوان یک درخواست میفرستد و منتظر پاسخش میماند.
واردسازی فراخوان دور
واردسازی کدگذاری.مقدار
واردسازی همگام سازی
ناپایا سرور := فراخوان دور.سرور جدید(۰، فراخوان دور.کدک جیسون)
ناپایا آماده := همگام سازی.گروه انتظار جدید()
تابع تبدیل ارز(ف: صحیح۶۴):
مبلغ := فراخوان دور.پارامتر اعشاری فراخوان(ف، "amount"، ۰)
ارز := فراخوان دور.پارامتر متنی فراخوان(ف، "to"، ۱)
اگر ارز == "EUR":
فراخوان دور.پاسخ اعشاری(ف، مبلغ * ۰.۵)
برگشت
پایان
فراخوان دور.شکست(ف، -۳۲۰۱۰، "ارز ناشناخته: " + ارز)
پایان
تابع اجرای سرور():
_ := فراخوان دور.گوش دادن(سرور)
همگام سازی.اتمام(آماده)
_ := فراخوان دور.خدمت به تعداد(سرور، ۱)
پایان
تابع ریشه:
فراخوان دور.ثبت متد("convert"، تبدیل ارز)
همگام سازی.افزودن(آماده، ۱)
ن := نخساز(اجرای سرور)
همگام سازی.انتظار(آماده)
ناپایا کارخواه := فراخوان دور.اتصال کارخواه("127.0.0.1"، فراخوان دور.درگاه سرور(سرور)، فراخوان دور.کدک جیسون)
اگر وارونه فراخوان دور.کارخواه معتبر(کارخواه):
سرچاپ "اتصال برقرار نشد:"، فراخوان دور.خطای کارخواه(کارخواه)
برگشت ۱
پایان
ناپایا پارامترها := مقدار.شیء جدید()
مقدار.تنظیم کلید(پارامترها، "amount"، مقدار.مقدار اعشاری(۴۰.۰))
مقدار.تنظیم کلید(پارامترها، "to"، مقدار.مقدار رشته("EUR"))
خوب := فراخوان دور.فراخوان(کارخواه، "convert"، پارامترها)
سرچاپ "۴۰ برابر است با"، فراخوان دور.نتیجه اعشاری(خوب)، "یورو"
مقدار.تنظیم کلید(پارامترها، "to"، مقدار.مقدار رشته("XYZ"))
بد := فراخوان دور.فراخوان(کارخواه، "convert"، پارامترها)
اگر فراخوان دور.پاسخ خطاست(بد):
سرچاپ "خطا"، فراخوان دور.کد خطا(بد)، فراخوان دور.پیام خطا(بد)
پایان
فراخوان دور.بستن کارخواه(کارخواه)
نخپیوند(ن)
فراخوان دور.توقف سرور(سرور)
برگشت ۰
پایانفراخوان ناموفق چیزی را از کار نمیاندازد. اول پاسخ خطاست را بررسی کنید و بعد کد خطا و پیام خطا را بخوانید؛ خواندن نتیجه اعشاری روی پاسخ خطا صفر برمیگرداند. کدهای خطای خودتان بهتر است بیرون از بازهی -32768 تا -32000 بمانند که JSON-RPC رزرو کرده، بهجز بلوک -32000 تا -32099 که برای خطاهای سرور است و -32010 از همانجا آمده.
کارخواه و سرور باید روی کدک و قاببندی توافق داشته باشند. JSON با قاببندی خطی پیشفرض است و با یک پایانه بهراحتی اشکالزدایی میشود. کدک مسگپک کوچکتر و سریعتر است و قابهای طولدار به کار میبرد؛ هر دو طرف را با تنظیم قاببندی و تنظیم قاببندی کارخواه تنظیم کنید.
گفتگو از راه ورودی و خروجی استاندارد
ابزارهای ویرایشگر، سرورهای زبان و افزونهها اغلب به شکل یک فرایند فرزند اجرا میشوند و پیامها را از راه ورودی و خروجی استاندارد رد و بدل میکنند. خدمت ورودی خروجی در هر خط یک درخواست میخواند (یا با قاب سرآیندی قابهای Content-Length به سبک LSP را)، پاسخ هر کدام را در خروجی استاندارد مینویسد و وقتی ورودی تمام شد تعداد درخواستها را برمیگرداند. گزارشها باید مثل اینجا به خروجی خطا بروند، وگرنه پاسخها را خراب میکنند.
پیش از اینکه روی خدمت ورودی خروجی چیزی بسازید، دو محدودیتش را بدانید:
- در قاببندی خطی، یک خط خالی پایان ورودی حساب میشود و خدمت همانجا تمام میشود.
قاب سرآیندیهنوز با کارخواههای واقعی LSP کار نمیکند. آنها سرآیندها را با\r\nتمام میکنند و بعد از بدنه خط تازه نمیفرستند؛ پس به خط خالی\rبا خطای تجزیه پاسخ داده میشود و سرآیند بعدی جزء بدنه خوانده میشود. در پایان ورودی هم هرگز برنمیگردد. فعلاً روی ورودی و خروجی استاندارد قاببندی خطی را به کار ببرید.
واردسازی فراخوان دور
واردسازی رشته
واردسازی ورودی خروجی
تابع شمار واژه(ف: صحیح۶۴):
واژهها := رشته.واژه ها(فراخوان دور.پارامتر متنی فراخوان(ف، "text"، ۰))
فراخوان دور.پاسخ عددی(ف، واژهها.طول())
واژهها.آزادکن()
پایان
تابع فریاد(ف: صحیح۶۴):
فراخوان دور.پاسخ متنی(ف، رشته.بزرگ(فراخوان دور.پارامتر متنی فراخوان(ف، "text"، ۰)))
پایان
تابع ریشه:
فراخوان دور.ثبت متد("words"، شمار واژه)
فراخوان دور.ثبت متد("shout"، فریاد)
پاسخداده := فراخوان دور.خدمت ورودی خروجی(فراخوان دور.قاب خطی)
ورودی خروجی.نوشتن خطا با خط جدید("به " + پاسخداده + " درخواست پاسخ داده شد")
پایاناین برنامه منتظر ورودی میماند، پس اینجا فقط کامپایل میشود. آن را بسازید و دو درخواست را با لوله به آن بدهید:
salam build rpc-guide-stdio.salam --output=tool
printf '%s\n' '{"jsonrpc":"2.0","method":"words","params":["one two three"],"id":1}' \
'{"jsonrpc":"2.0","method":"shout","params":{"text":"salam"},"id":2}' | ./tool
{"jsonrpc": "2.0", "id": 1, "result": 3}
{"jsonrpc": "2.0", "id": 2, "result": "SALAM"}
به 2 درخواست پاسخ داده شد
JSON-RPC پشت یک مسیر HTTP
چون پردازش متن فقط متن لازم دارد، گذاشتن همین متدها پشت یک سرور وب یک مسیر بیشتر نمیخواهد. گرداننده بدنهی درخواست را به آن میدهد و پاسخ را به شکل JSON با اچ تی تی پی برمیگرداند؛ دستهها هم کار میکنند. برنامههای دیگر میتوانند با فراخوان اچ تی تی پی یا هر کارخواه HTTP دیگری صدایش بزنند.
واردسازی فراخوان دور
واردسازی شبکه.اچ تی تی پی
واردسازی شبکه.مسیریاب
ناپایا بازدیدها := ۰
تابع بازدید(ف: صحیح۶۴):
بازدیدها++
فراخوان دور.پاسخ عددی(ف، بازدیدها)
پایان
تابع خوشامد(ف: صحیح۶۴):
فراخوان دور.پاسخ متنی(ف، "سلام، " + فراخوان دور.پارامتر متنی فراخوان(ف، "name"، ۰))
پایان
تابع نقطه پایانی(زمینه: صحیح۶۴):
اچ تی تی پی.جیسون(زمینه، فراخوان دور.پردازش متن(اچ تی تی پی.بدنه(زمینه)))
پایان
تابع ریشه:
فراخوان دور.ثبت متد("hit"، بازدید)
فراخوان دور.ثبت متد("greet"، خوشامد)
ناپایا م := مسیریاب.مسیریاب جدید()
مسیریاب.ارسال(م، "/rpc"، نقطه پایانی)
ناپایا س := اچ تی تی پی.سرور جدید(۸۰۹۰)
اچ تی تی پی.استفاده(س، م)
سرچاپ "JSON-RPC روی http://127.0.0.1:8090/rpc"
اچ تی تی پی.اجرا(س)
پایانبرنامه را اجرا کنید و از پایانهی دیگری صدایش بزنید:
curl -X POST http://127.0.0.1:8090/rpc -d '{"jsonrpc":"2.0","method":"greet","params":{"name":"سارا"},"id":1}'
curl -X POST http://127.0.0.1:8090/rpc -d '[{"jsonrpc":"2.0","method":"hit","id":1},{"jsonrpc":"2.0","method":"hit","id":2}]'
{"jsonrpc": "2.0", "id": 1, "result": "سلام، سارا"}
[{"jsonrpc": "2.0", "id": 1, "result": 1}, {"jsonrpc": "2.0", "id": 2, "result": 2}]
| راه ارتباط | طرف سرور | طرف کارخواه |
|---|---|---|
| هیچ، درون یک برنامه یا یک آزمون | پردازش متن، اجرای درخواست | متن درخواست را خودتان بسازید |
| TCP | سرور جدید، گوش دادن، خدمت | اتصال کارخواه، فراخوان، فراخوان دستهای، اعلان |
| ورودی و خروجی استاندارد | خدمت ورودی خروجی | فرایند پدر خطها را مینویسد |
| HTTP | پردازش متن درون یک مسیر | فراخوان اچ تی تی پی |
گونهها
کارخواه Client
ساختار کارخواه| نام | انگلیسی | گونه | توضیح |
|---|---|---|---|
| اتصال | conn | تی سی پی.اتصال شبکه | اتصال. |
| جریان | stream | جریان | جریان خواندن. |
| کدک | codec | صحیح = 0 | کدک. |
| قاببندی | framing | صحیح = 0 | قاببندی. |
| شناسه بعدی | next_id | صحیح۶۴ = 1 | شناسهی درخواست بعدی. |
| سالم | ok | منطقی = نادرست | سالم است. |
| آخرین خطا | last_error | رشته = "" | آخرین خطا. |
واردسازی فراخوان دور
واردسازی کدگذاری.مقدار
واردسازی شبکه.اچ تی تی پی
واردسازی شبکه.مسیریاب
واردسازی همگام سازی
ناپایا سرور := فراخوان دور.سرور جدید(۰، فراخوان دور.کدک جیسون)
ناپایا آماده := همگام سازی.گروه انتظار جدید()
تابع جمع(ج: صحیح۶۴):
فراخوان دور.پاسخ عددی(ج، فراخوان دور.پارامتر عددی فراخوان(ج، "a"، ۰) + فراخوان دور.پارامتر عددی فراخوان(ج، "b"، ۱))
پایان
تابع زمان(ج: صحیح۶۴):
فراخوان دور.پاسخ متنی(ج، "12:00")
پایان
تابع یادداشت(ج: صحیح۶۴):
فراخوان دور.پاسخ تهی(ج)
پایان
تابع اجرای سرور():
_ := فراخوان دور.گوش دادن(سرور)
همگام سازی.اتمام(آماده)
_ := فراخوان دور.خدمت به تعداد(سرور، ۱)
پایان
تابع نقطه پایانی(ز: صحیح۶۴):
اچ تی تی پی.جیسون(ز، فراخوان دور.پردازش متن(اچ تی تی پی.بدنه(ز)))
پایان
تابع ریشه:
فراخوان دور.ثبت متد("add"، جمع)
فراخوان دور.ثبت متد("time"، زمان)
فراخوان دور.ثبت متد("note"، یادداشت)
فراخوان دور.تنظیم قاببندی(سرور، فراخوان دور.قاب خطی)
همگام سازی.افزودن(آماده، ۱)
ن := نخساز(اجرای سرور)
همگام سازی.انتظار(آماده)
سرچاپ فراخوان دور.درگاه سرور(سرور) > ۰
ناپایا ک := فراخوان دور.اتصال کارخواه("127.0.0.1"، فراخوان دور.درگاه سرور(سرور)، فراخوان دور.کدک جیسون)
فراخوان دور.تنظیم قاببندی کارخواه(ک، فراخوان دور.قاب خطی)
سرچاپ فراخوان دور.کارخواه معتبر(ک)
ناپایا پ := مقدار.آرایه جدید()
مقدار.افزودن به آرایه(پ، مقدار.مقدار صحیح(۲))
مقدار.افزودن به آرایه(پ، مقدار.مقدار صحیح(۴۰))
سرچاپ فراخوان دور.نتیجه عددی(فراخوان دور.فراخوان(ک، "add"، پ))
سرچاپ فراخوان دور.نتیجه متنی(فراخوان دور.فراخوان بدون پارامتر(ک، "time"))
ناپایا آرگ := وکتور {} برگردان وکتور<مقدار.مقدار>
آرگ.افزودن(مقدار.مقدار صحیح(۱))
آرگ.افزودن(مقدار.مقدار صحیح(۲))
سرچاپ فراخوان دور.نتیجه عددی(فراخوان دور.فراخوان با آرگومان(ک، "add"، آرگ))
سرچاپ فراخوان دور.اعلان(ک، "note"، مقدار.آرایه جدید())
ناپایا دسته := وکتور {} برگردان وکتور<فراخوان دور.درخواست>
دسته.افزودن(فراخوان دور.درخواست جدید("add"، پ، ۱۰))
دسته.افزودن(فراخوان دور.درخواست جدید("missing"، مقدار.آرایه جدید()، ۱۱))
پاسخها := فراخوان دور.فراخوان دستهای(ک، دسته)
سرچاپ پاسخها.پاسخها.طول()، فراخوان دور.نتیجه عددی(پاسخها.پاسخها[۰])
سرچاپ فراخوان دور.پاسخ خطاست(پاسخها.پاسخها[۱])، فراخوان دور.کد خطا(پاسخها.پاسخها[۱])، فراخوان دور.پیام خطا(پاسخها.پاسخها[۱])
فراخوان دور.بستن کارخواه(ک)
سرچاپ فراخوان دور.کارخواه معتبر(ک)، فراخوان دور.خطای کارخواه(ک).طول() >= ۰
نخپیوند(ن)
فراخوان دور.توقف سرور(سرور)
ناپایا م := مسیریاب.مسیریاب جدید()
مسیریاب.ارسال(م، "/rpc"، نقطه پایانی)
ناپایا ه := اچ تی تی پی.سرور جدید(۱۹۶۱۱)
اچ تی تی پی.استفاده(ه، م)
_ := اچ تی تی پی.اجرا در پس زمینه(ه)
ر := فراخوان دور.فراخوان اچ تی تی پی("http://127.0.0.1:19611/rpc"، "add"، پ، ۷)
سرچاپ فراخوان دور.نتیجه عددی(ر)
پایانجریان Stream
ساختار جریان| نام | انگلیسی | گونه | توضیح |
|---|---|---|---|
| توصیفگر سوکت | fd | صحیح۶۴ = -1 | سوکت. |
| داده | data | فشرده سازی.بافر بایت | دادهی خواندهشده. |
| جای خواندن | pos | صحیح = 0 | جای خواندن. |
| ورودی تمامشده | closed | منطقی = نادرست | ورودی تمام شده. |
| روی سوکت | has_fd | منطقی = نادرست | روی سوکت است. |
واردسازی فراخوان دور
واردسازی فشرده سازی
تابع ریشه:
خط := فراخوان دور.قاببندی متن(فراخوان دور.قاب خطی، `{"a":1}`)
سرآیندی := فراخوان دور.قاببندی متن(فراخوان دور.قاب سرآیندی، `{"b":2}`)
طولدار := فراخوان دور.قاببندی(فراخوان دور.قاب طولدار، فشرده سازی.بافر از رشته(`{"c":3}`))
سرچاپ خط.طول، سرآیندی.طول، طولدار.طول
سرچاپ فشرده سازی.بافر به رشته(سرآیندی).طول() > ۰
ناپایا ج := فراخوان دور.جریان حافظه()
فراخوان دور.تغذیه متن(ج، `{"x":1}` + "\n" + `{"x":2}` + "\n")
ناپایا سالم := نادرست
سرچاپ فراخوان دور.خواندن قاب متنی(ج، فراخوان دور.قاب خطی، سالم)، سالم
سرچاپ فراخوان دور.باقیمانده جریان(ج)
سرچاپ فراخوان دور.خواندن قاب متنی(ج، فراخوان دور.قاب خطی، سالم)
_ := فراخوان دور.خواندن قاب متنی(ج، فراخوان دور.قاب خطی، سالم)
سرچاپ سالم، فراخوان دور.جریان بسته(ج)
ناپایا ج۲ := فراخوان دور.جریان حافظه()
فراخوان دور.تغذیه بافر(ج۲، سرآیندی)
فراخوان دور.تغذیه بافر(ج۲، طولدار)
سرچاپ فراخوان دور.خواندن قاب متنی(ج۲، فراخوان دور.قاب سرآیندی، سالم)
ب := فراخوان دور.خواندن قاب(ج۲، فراخوان دور.قاب طولدار، سالم)
سرچاپ فشرده سازی.بافر به رشته(ب)، سالم
سرچاپ فراخوان دور.اندازه تکه خواندن، فراخوان دور.بیشینه اندازه قاب
فراخوان دور.آزادسازی جریان(ج)
فراخوان دور.آزادسازی جریان(ج۲)
پایانسرور فراخوان Server
ساختار سرور فراخوان| نام | انگلیسی | گونه | توضیح |
|---|---|---|---|
| درگاه | port | صحیح = 0 | درگاه؛ صفر یعنی یک درگاه آزاد. |
| کدک | codec | صحیح = 0 | کدک. |
| قاببندی | framing | صحیح = 0 | قاببندی. |
| سوکت گوشدهنده | listen_fd | صحیح۶۴ = -1 | سوکت گوش دادن. |
| فعال | running | منطقی = نادرست | در حال اجرا. |
| شمار اتصال پاسخداده | served | صحیح = 0 | شمار اتصالهای پاسخداده. |
واردسازی فراخوان دور
واردسازی شبکه.تی سی پی
واردسازی فشرده سازی
تابع پژواک(ج: صحیح۶۴):
فراخوان دور.پاسخ دادن(ج، فراخوان دور.پارامترهای فراخوان(ج))
پایان
تابع ریشه:
فراخوان دور.ثبت متد("echo"، پژواک)
اگر فراخوان دور.پردازش متن("").طول() == ۰:
_ := فراخوان دور.خدمت ورودی خروجی(فراخوان دور.قاب سرآیندی)
برگشت
پایان
ناپایا س := فراخوان دور.سرور جدید(۴۰۰۰، فراخوان دور.کدک مسگپک)
فراخوان دور.تنظیم قاببندی(س، فراخوان دور.قاب طولدار)
اگر فراخوان دور.گوش دادن(س):
سرچاپ "روی درگاه"، فراخوان دور.درگاه سرور(س)، س.فعال
فراخوان دور.خدمت(س)
پایان
ا := تی سی پی.شماره گیری("127.0.0.1"، ۴۰۰۱)
_ := فراخوان دور.خدمت به اتصال(ا.توصیفگر، فراخوان دور.کدک جیسون، فراخوان دور.قاب خطی)
ک := تی سی پی.شماره گیری("127.0.0.1"، ۴۰۰۲)
ناپایا کارخواه := فراخوان دور.کارخواه از توصیفگر(ک.توصیفگر، فراخوان دور.کدک جیسون)
سرچاپ فراخوان دور.نتیجه متنی(فراخوان دور.فراخوان بدون پارامتر(کارخواه، "version"))
ناپایا ج := فراخوان دور.جریان جدید(ک.توصیفگر)
_ := فراخوان دور.نوشتن قاب متنی(ک.توصیفگر، فراخوان دور.قاب خطی، `{"jsonrpc":"2.0","method":"echo","params":[1],"id":1}`)
_ := فراخوان دور.نوشتن قاب(ک.توصیفگر، فراخوان دور.قاب خطی، فشرده سازی.بافر از رشته(`{"jsonrpc":"2.0","method":"echo","id":2}`))
ناپایا سالم := نادرست
سرچاپ فراخوان دور.خواندن قاب متنی(ج، فراخوان دور.قاب خطی، سالم)
پاسخ := فراخوان دور.پردازش بار(فراخوان دور.کدک جیسون، فشرده سازی.بافر از رشته(`{"jsonrpc":"2.0","method":"echo","params":[3],"id":3}`))
سرچاپ فشرده سازی.بافر به رشته(پاسخ)
فراخوان دور.آزادسازی جریان(ج)
فراخوان دور.توقف سرور(س)
پایانخطای فراخوان Error
ساختار خطای فراخوان| نام | انگلیسی | گونه | توضیح |
|---|---|---|---|
| کد | code | صحیح = 0 | کد. |
| پیام | message | رشته = "" | پیام. |
| داده | data | مقدار.مقدار | دادهی اضافه. |
| داده دارد | has_data | منطقی = نادرست | داده دارد. |
واردسازی فراخوان دور
واردسازی کدگذاری.مقدار
واردسازی فشرده سازی
تابع ریشه:
ناپایا پ := مقدار.آرایه جدید()
مقدار.افزودن به آرایه(پ، مقدار.مقدار صحیح(۲))
مقدار.افزودن به آرایه(پ، مقدار.مقدار رشته("سلام"))
مقدار.افزودن به آرایه(پ، مقدار.مقدار اعشاری(۱.۵))
مقدار.افزودن به آرایه(پ، مقدار.مقدار منطقی(درست))
د := فراخوان دور.درخواست جدید("calc"، پ، ۱)
سرچاپ فراخوان دور.کدگذاری درخواست جیسون(د)
سرچاپ فراخوان دور.تعداد پارامتر(د)، فراخوان دور.پارامتر عددی(د، "a"، ۰)، فراخوان دور.پارامتر متنی(د، "b"، ۱)
سرچاپ فراخوان دور.پارامتر اعشاری(د، "c"، ۲)، فراخوان دور.پارامتر بولی(د، "d"، ۳)، فراخوان دور.پارامتر دارد(د، "e"، ۴)
سرچاپ مقدار.به صحیح(فراخوان دور.پارامتر در جایگاه(د، ۰))، مقدار.به صحیح(فراخوان دور.پارامتر(د، "a"، ۰))
ناپایا ش := مقدار.شیء جدید()
مقدار.تنظیم کلید(ش، "name"، مقدار.مقدار رشته("علی"))
د۲ := فراخوان دور.درخواست با شناسه متنی("greet"، ش، "req-1")
سرچاپ فراخوان دور.کدگذاری درخواست جیسون(د۲)
سرچاپ مقدار.به رشته(فراخوان دور.پارامتر نامدار(د۲، "name"))
ا := فراخوان دور.اعلان جدید("tick"، مقدار.آرایه جدید())
سرچاپ فراخوان دور.اعلان است(ا)، فراخوان دور.کدگذاری درخواست جیسون(ا)
ناپایا سالم := نادرست
خ := فراخوان دور.کدگشایی درخواست جیسون(`{"jsonrpc":"2.0","method":"add","params":{"a":1,"b":2},"id":9}`، سالم)
سرچاپ سالم، خ.متد، خ.شناسه عددی، فراخوان دور.پارامتر عددی(خ، "b"، ۱)
پاسخ := فراخوان دور.پاسخ جدید(مقدار.مقدار صحیح(۱)، مقدار.مقدار رشته("ok"))
سرچاپ فراخوان دور.کدگذاری پاسخ جیسون(پاسخ)
خطا := فراخوان دور.خطای استاندارد(فراخوان دور.کد روش یافت نشد)
سرچاپ خطا.کد، خطا.پیام
سرچاپ فراخوان دور.کدگذاری پاسخ جیسون(فراخوان دور.پاسخ خطا(مقدار.مقدار صحیح(۲)، فراخوان دور.خطای جدید(-۳۲۰۰۰، "سرور مشغول است")))
با داده := فراخوان دور.خطا با داده(فراخوان دور.کد پارامترهای نامعتبر، "بد"، مقدار.مقدار رشته("x"))
سرچاپ با داده.داده دارد، فراخوان دور.خطای سطح بالای جیسون(فراخوان دور.خطای استاندارد(فراخوان دور.کد خطای تجزیه))
ر := فراخوان دور.کدگشایی پاسخ جیسون(`{"jsonrpc":"2.0","result":3.5,"id":1}`، سالم)
سرچاپ سالم، فراخوان دور.نتیجه اعشاری(ر)، فراخوان دور.پاسخ خطاست(ر)
ر۲ := فراخوان دور.کدگشایی پاسخ جیسون(`{"jsonrpc":"2.0","error":{"code":-32601,"message":"nope"},"id":2}`، سالم)
سرچاپ فراخوان دور.پاسخ خطاست(ر۲)، فراخوان دور.کد خطا(ر۲)، فراخوان دور.پیام خطا(ر۲)
همه := فراخوان دور.کدگشایی پاسخهای جیسون(`[{"jsonrpc":"2.0","result":true,"id":1},{"jsonrpc":"2.0","result":"x","id":2}]`، سالم)
سرچاپ همه.به شکل آرایه، همه.پاسخها.طول()، فراخوان دور.نتیجه بولی(همه.پاسخها[۰])، فراخوان دور.نتیجه متنی(همه.پاسخها[۱])
سرچاپ فراخوان دور.کدگذاری پاسخهای جیسون(همه)
سرچاپ فراخوان دور.نام کدک(فراخوان دور.کدک جیسون)، فراخوان دور.نام کدک(فراخوان دور.کدک مسگپک)
سرچاپ فراخوان دور.قاببندی پیشفرض کدک(فراخوان دور.کدک جیسون) == فراخوان دور.قاب خطی، فراخوان دور.قاببندی پیشفرض کدک(فراخوان دور.کدک مسگپک) == فراخوان دور.قاب طولدار
م := فراخوان دور.کدگذاری درخواست(فراخوان دور.کدک مسگپک، د)
سرچاپ م.طول، فشرده سازی.دریافت بایت(م، ۰)
دسته := فراخوان دور.کدگشایی دسته(فراخوان دور.کدک مسگپک، م)
سرچاپ دسته.خواندهشده، دسته.درخواستها[۰].متد، دسته.درخواستها[۰].شناسه عددی
سرچاپ فراخوان دور.کدگشایی دسته مسگپک(فراخوان دور.کدگذاری درخواست مسگپک(د)).درخواستها[۰].متد
مپ := فراخوان دور.کدگذاری پاسخ مسگپک(فراخوان دور.پاسخ جدید(مقدار.مقدار صحیح(۱)، مقدار.مقدار صحیح(۴۲)))
سرچاپ فراخوان دور.نتیجه عددی(فراخوان دور.کدگشایی پاسخ مسگپک(مپ، سالم))، سالم
ج := فراخوان دور.کدگذاری درخواست(فراخوان دور.کدک جیسون، د)
سرچاپ فراخوان دور.نتیجه عددی(فراخوان دور.کدگشایی پاسخ(فراخوان دور.کدک مسگپک، مپ، سالم))، ج.طول > ۰
سرچاپ فشرده سازی.بافر به رشته(فراخوان دور.کدگذاری پاسخها(فراخوان دور.کدک جیسون، همه)).طول() > ۰
سرچاپ فشرده سازی.بافر به رشته(فراخوان دور.کدگذاری خطای سطح بالا(فراخوان دور.کدک جیسون، خطا))
سرچاپ فراخوان دور.نوع درخواست مسگپک، فراخوان دور.نوع پاسخ مسگپک، فراخوان دور.نوع اعلان مسگپک
سرچاپ فراخوان دور.کد درخواست نامعتبر، فراخوان دور.کد خطای داخلی، فراخوان دور.کد خطای کارساز
سرچاپ فراخوان دور.نوع درخواست، فراخوان دور.نوع اعلان، فراخوان دور.نوع پاسخ
سرچاپ فشرده سازی.بافر به رشته(فشرده سازی.بافر از رشته(فراخوان دور.کدگذاری درخواست جیسون(د))).طول() > ۰
پایاندرخواست Request
ساختار درخواست| نام | انگلیسی | گونه | توضیح |
|---|---|---|---|
| متد | method | رشته = "" | نام متد. |
| پارامترها | params | مقدار.مقدار | پارامترها: آرایه یا شیء. |
| پارامتر دارد | has_params | منطقی = نادرست | پارامتر دارد. |
| شناسه | id | مقدار.مقدار | شناسه؛ عدد یا رشته. |
| شناسه دارد | has_id | منطقی = نادرست | شناسه دارد؛ بدون آن اعلان است. |
| شناسه عددی | msgid | صحیح۶۴ = 0 | شناسهی عددی. |
| کد خطا | err_code | صحیح = 0 | اگر درخواست خوانده نشد، کد خطا. |
| پیام خطا | err_message | رشته = "" | پیام آن خطا. |
واردسازی فراخوان دور
واردسازی کدگذاری.مقدار
تابع جمع(ج: صحیح۶۴):
الف := فراخوان دور.پارامتر عددی فراخوان(ج، "a"، ۰)
ب := فراخوان دور.پارامتر عددی فراخوان(ج، "b"، ۱)
فراخوان دور.پاسخ عددی(ج، الف + ب)
پایان
تابع تقسیم(ج: صحیح۶۴):
مقسومعلیه := فراخوان دور.پارامتر اعشاری فراخوان(ج، "b"، ۱)
اگر مقسومعلیه == ۰.۰:
فراخوان دور.پارامتر نامعتبر(ج، "تقسیم بر صفر")
برگشت
پایان
فراخوان دور.پاسخ اعشاری(ج، فراخوان دور.پارامتر اعشاری فراخوان(ج، "a"، ۰) / مقسومعلیه)
پایان
تابع سلام(ج: صحیح۶۴):
نام := فراخوان دور.پارامتر متنی فراخوان(ج، "name"، ۰)
اگر نام.طول() == ۰:
فراخوان دور.شکست(ج، -۳۲۰۰۱، "نام لازم است")
برگشت
پایان
فراخوان دور.پاسخ متنی(ج، "سلام " + نام)
پایان
تابع وضعیت(ج: صحیح۶۴):
ناپایا ش := مقدار.آرایه جدید()
مقدار.افزودن به آرایه(ش، مقدار.مقدار رشته(فراخوان دور.نام متد فراخوان(ج)))
مقدار.افزودن به آرایه(ش، مقدار.مقدار صحیح(فراخوان دور.تعداد پارامتر فراخوان(ج)))
مقدار.افزودن به آرایه(ش، مقدار.مقدار منطقی(فراخوان دور.پارامتر بولی فراخوان(ج، "verbose"، ۰)))
فراخوان دور.پاسخ دادن(ج، ش)
پایان
تابع ثبت رویداد(ج: صحیح۶۴):
سرچاپ "رویداد:"، مقدار.به رشته(فراخوان دور.پارامتر فراخوان(ج، "event"، ۰))، فراخوان دور.فراخوان اعلان است(ج)
_ := فراخوان دور.پارامترهای فراخوان(ج)
_ := فراخوان دور.درخواست فراخوان(ج)
فراخوان دور.پاسخ تهی(ج)
پایان
تابع ممنوع(ج: صحیح۶۴):
فراخوان دور.شکست با داده(ج، -۳۲۰۰۳، "دسترسی ندارید"، مقدار.مقدار رشته("admin"))
پایان
تابع همیشه(ج: صحیح۶۴):
فراخوان دور.پاسخ بولی(ج، درست)
پایان
تابع ریشه:
فراخوان دور.ثبت متد با توضیح("add"، جمع، "جمع دو عدد")
فراخوان دور.ثبت متد("divide"، تقسیم)
فراخوان دور.ثبت متد("hello"، سلام)
فراخوان دور.ثبت متد("status"، وضعیت)
فراخوان دور.ثبت متد("log"، ثبت رویداد)
فراخوان دور.ثبت متد("admin"، ممنوع)
فراخوان دور.ثبت متد("ping"، همیشه)
سرچاپ فراخوان دور.تعداد متدها()، فراخوان دور.متد دارد("add")، فراخوان دور.توضیح متد("add")
سرچاپ فراخوان دور.فهرست متدها().طول()
سرچاپ فراخوان دور.پردازش متن(`{"jsonrpc":"2.0","method":"add","params":[2,40],"id":1}`)
سرچاپ فراخوان دور.پردازش متن(`{"jsonrpc":"2.0","method":"add","params":{"a":5,"b":6},"id":2}`)
سرچاپ فراخوان دور.پردازش متن(`{"jsonrpc":"2.0","method":"divide","params":[1,0],"id":3}`)
سرچاپ فراخوان دور.پردازش متن(`{"jsonrpc":"2.0","method":"hello","params":["مریم"],"id":"x"}`)
سرچاپ فراخوان دور.پردازش متن(`{"jsonrpc":"2.0","method":"hello","params":[],"id":4}`)
سرچاپ فراخوان دور.پردازش متن(`{"jsonrpc":"2.0","method":"status","params":{"verbose":true},"id":5}`)
سرچاپ فراخوان دور.پردازش متن(`{"jsonrpc":"2.0","method":"admin","id":6}`)
سرچاپ فراخوان دور.پردازش متن(`{"jsonrpc":"2.0","method":"nope","id":7}`)
سرچاپ فراخوان دور.پردازش متن(`{"jsonrpc":"2.0","method":"log","params":{"event":"start"}}`).طول()
سرچاپ فراخوان دور.پردازش متن(`[{"jsonrpc":"2.0","method":"ping","id":8},{"jsonrpc":"2.0","method":"add","params":[1,1],"id":9}]`)
سرچاپ فراخوان دور.پردازش متن(`{"jsonrpc":`)
ناپایا سالم := نادرست
د := فراخوان دور.کدگشایی درخواست جیسون(`{"jsonrpc":"2.0","method":"add","params":[20,22],"id":10}`، سالم)
پ := فراخوان دور.اجرای درخواست(د)
سرچاپ فراخوان دور.نتیجه عددی(پ)
دسته := فراخوان دور.کدگشایی دسته جیسون(`[{"jsonrpc":"2.0","method":"ping","id":1}]`)
سرچاپ فراخوان دور.اجرای دسته(دسته).پاسخها.طول()
سرچاپ فراخوان دور.حذف متد("ping")، فراخوان دور.متد دارد("ping")
فراخوان دور.بازنشانی ثبت()
سرچاپ فراخوان دور.تعداد متدها()
پایانپاسخ Response
ساختار پاسخ| نام | انگلیسی | گونه | توضیح |
|---|---|---|---|
| شناسه | id | مقدار.مقدار | شناسهی درخواست. |
| شناسه دارد | has_id | منطقی = نادرست | شناسه دارد. |
| نتیجه | result | مقدار.مقدار | نتیجه. |
| خطاست | is_error | منطقی = نادرست | خطاست. |
| خطا | err | خطای فراخوان | خطا. |
| شناسه عددی | msgid | صحیح۶۴ = 0 | شناسهی عددی. |
نمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Methods.salam
دسته Batch
ساختار دسته| نام | انگلیسی | گونه | توضیح |
|---|---|---|---|
| درخواستها | items | وکتور<درخواست> | درخواستها. |
| به شکل آرایه | is_batch | منطقی = نادرست | به شکل آرایه آمده بود. |
| خواندهشده | ok | منطقی = درست | درست خوانده شد. |
| خطا | err | خطای فراخوان | اگر نه، خطا. |
نمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Methods.salam
پاسخها Responses
ساختار پاسخها| نام | انگلیسی | گونه | توضیح |
|---|---|---|---|
| پاسخها | items | وکتور<پاسخ> | پاسخها. |
| به شکل آرایه | is_batch | منطقی = نادرست | به شکل آرایه فرستاده شود. |
نمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Messages.salam
متد Method
ساختار متد| نام | انگلیسی | گونه | توضیح |
|---|---|---|---|
| نام | name | رشته = "" | نام. |
| تابع | fn | صحیح۶۴ = 0 | تابع. |
| توضیح | doc | رشته = "" | توضیح. |
نمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Methods.salam
جدول متدها MethodTable
ساختار جدول متدها| نام | انگلیسی | گونه | توضیح |
|---|---|---|---|
| متدها | items | وکتور<متد> | متدها. |
نمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Methods.salam
جایگاه فراخوان CallSlot
ساختار جایگاه فراخوان| نام | انگلیسی | گونه | توضیح |
|---|---|---|---|
| درخواست | req | درخواست | درخواست. |
| نتیجه | result | مقدار.مقدار | نتیجه. |
| خطا | err | خطای فراخوان | خطا. |
| خطاست | is_error | منطقی = نادرست | خطاست. |
| پاسخ دادهشده | replied | منطقی = نادرست | پاسخ داده شده. |
| مشغول | busy | منطقی = نادرست | در استفاده. |
نمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Methods.salam
جدول جایگاهها SlotTable
ساختار جدول جایگاهها| نام | انگلیسی | گونه | توضیح |
|---|---|---|---|
| فراخوانها | items | وکتور<جایگاه فراخوان> | فراخوانها. |
نمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Methods.salam
پایاها و متغیرها
نوع درخواست مسگپک RPC_MP_REQUEST
پایا نوع درخواست مسگپک: صحیح۳۲ = 0نمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Messages.salam
نوع پاسخ مسگپک RPC_MP_RESPONSE
پایا نوع پاسخ مسگپک: صحیح۳۲ = 1نمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Messages.salam
نوع اعلان مسگپک RPC_MP_NOTIFY
پایا نوع اعلان مسگپک: صحیح۳۲ = 2نمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Messages.salam
اندازه تکه خواندن RPC_READ_CHUNK
پایا اندازه تکه خواندن: صحیح۳۲ = 4096نمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Frames.salam
بیشینه اندازه قاب RPC_MAX_FRAME
پایا بیشینه اندازه قاب: صحیح۳۲ = 33554432نمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Frames.salam
کد خطای تجزیه RPC_PARSE_ERROR
پایا کد خطای تجزیه: صحیح۳۲ = -32700نمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Messages.salam
کد درخواست نامعتبر RPC_INVALID_REQUEST
پایا کد درخواست نامعتبر: صحیح۳۲ = -32600نمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Messages.salam
کد روش یافت نشد RPC_METHOD_NOT_FOUND
پایا کد روش یافت نشد: صحیح۳۲ = -32601نمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Messages.salam
کد پارامترهای نامعتبر RPC_INVALID_PARAMS
پایا کد پارامترهای نامعتبر: صحیح۳۲ = -32602نمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Messages.salam
کد خطای داخلی RPC_INTERNAL_ERROR
پایا کد خطای داخلی: صحیح۳۲ = -32603نمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Messages.salam
کد خطای کارساز RPC_SERVER_ERROR
پایا کد خطای کارساز: صحیح۳۲ = -32000نمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Messages.salam
نوع درخواست RPC_KIND_REQUEST
پایا نوع درخواست: صحیح۳۲ = 1نمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Messages.salam
نوع اعلان RPC_KIND_NOTIFICATION
پایا نوع اعلان: صحیح۳۲ = 2نمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Messages.salam
نوع پاسخ RPC_KIND_RESPONSE
پایا نوع پاسخ: صحیح۳۲ = 3نمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Messages.salam
کدک جیسون RPC_CODEC_JSON
پایا کدک جیسون: صحیح۳۲ = 0نمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Messages.salam
کدک مسگپک RPC_CODEC_MSGPACK
پایا کدک مسگپک: صحیح۳۲ = 1نمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Messages.salam
قاب خطی RPC_FRAME_LINE
پایا قاب خطی: صحیح۳۲ = 0نمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Messages.salam
قاب سرآیندی RPC_FRAME_HEADER
پایا قاب سرآیندی: صحیح۳۲ = 1Content-Length، مثل LSP.نمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Frames.salam
قاب طولدار RPC_FRAME_LENGTH
پایا قاب طولدار: صحیح۳۲ = 2نمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Messages.salam
تابعها
کدگذاری درخواست مسگپک MsgpackEncodeRequest
تابع کدگذاری درخواست مسگپک(r: درخواست): فشرده سازی.بافر بایتنمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Messages.salam
کدگذاری پاسخ مسگپک MsgpackEncodeResponse
تابع کدگذاری پاسخ مسگپک(r: پاسخ): فشرده سازی.بافر بایتنمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Messages.salam
کدگشایی دسته مسگپک MsgpackDecodeBatch
تابع کدگشایی دسته مسگپک(b: فشرده سازی.بافر بایت): دستهنمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Messages.salam
کدگشایی پاسخ مسگپک MsgpackDecodeResponse
تابع کدگشایی پاسخ مسگپک(b: فشرده سازی.بافر بایت، ok &: منطقی): پاسخنمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Messages.salam
اتصال کارخواه DialClient
تابع اتصال کارخواه(host: رشته، port: صحیح، codec: صحیح): کارخواهنمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Client.salam
کارخواه از توصیفگر ClientFromFd
تابع کارخواه از توصیفگر(fd: صحیح۶۴، codec: صحیح): کارخواهنمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Serve.salam
تنظیم قاببندی کارخواه ClientSetFraming
تابع تنظیم قاببندی کارخواه(c &: کارخواه، framing: صحیح)نمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Client.salam
کارخواه معتبر ClientOk
تابع کارخواه معتبر(c: کارخواه): منطقینمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Client.salam
خطای کارخواه ClientError
تابع خطای کارخواه(c: کارخواه): رشتهنمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Client.salam
بستن کارخواه CloseClient
تابع بستن کارخواه(c &: کارخواه)نمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Client.salam
فراخوان Call
تابع فراخوان(c &: کارخواه، method: رشته، params: مقدار.مقدار): پاسخنمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Methods.salam
فراخوان بدون پارامتر CallNoParams
تابع فراخوان بدون پارامتر(c &: کارخواه، method: رشته): پاسخنمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Client.salam
فراخوان با آرگومان CallArgs
تابع فراخوان با آرگومان(c &: کارخواه، method: رشته، args: وکتور<مقدار.مقدار>): پاسخنمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Client.salam
اعلان Notify
تابع اعلان(c &: کارخواه، method: رشته، params: مقدار.مقدار): منطقینمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Methods.salam
فراخوان دستهای CallBatch
تابع فراخوان دستهای(c &: کارخواه، reqs: وکتور<درخواست>): پاسخهانمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Client.salam
نتیجه عددی ResultInt
تابع نتیجه عددی(r: پاسخ): صحیح۶۴نمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Methods.salam
نتیجه اعشاری ResultFloat
تابع نتیجه اعشاری(r: پاسخ): اعشار۶۴نمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Messages.salam
نتیجه متنی ResultStr
تابع نتیجه متنی(r: پاسخ): رشتهنمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Messages.salam
نتیجه بولی ResultBool
تابع نتیجه بولی(r: پاسخ): منطقینمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Messages.salam
پاسخ خطاست IsErrorResponse
تابع پاسخ خطاست(r: پاسخ): منطقینمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Messages.salam
کد خطا ErrorCode
تابع کد خطا(r: پاسخ): صحیحنمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Messages.salam
پیام خطا ErrorMessage
تابع پیام خطا(r: پاسخ): رشتهنمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Messages.salam
فراخوان اچ تی تی پی CallHTTP
تابع فراخوان اچ تی تی پی(url: رشته، method: رشته، params: مقدار.مقدار، id: صحیح۶۴): پاسخنمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Client.salam
نام کدک CodecName
تابع نام کدک(codec: صحیح): رشتهjson-rpc-2.0.نمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Messages.salam
قاببندی پیشفرض کدک CodecDefaultFraming
تابع قاببندی پیشفرض کدک(codec: صحیح): صحیحنمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Messages.salam
کدگذاری درخواست EncodeRequest
تابع کدگذاری درخواست(codec: صحیح، r: درخواست): فشرده سازی.بافر بایتنمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Messages.salam
کدگذاری پاسخها EncodeResponses
تابع کدگذاری پاسخها(codec: صحیح، rs: پاسخها): فشرده سازی.بافر بایتنمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Messages.salam
کدگشایی دسته DecodeBatch
تابع کدگشایی دسته(codec: صحیح، payload: فشرده سازی.بافر بایت): دستهنمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Methods.salam
کدگشایی پاسخ DecodeResponse
تابع کدگشایی پاسخ(codec: صحیح، payload: فشرده سازی.بافر بایت، ok &: منطقی): پاسخنمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Messages.salam
کدگذاری خطای سطح بالا EncodeTopLevelError
تابع کدگذاری خطای سطح بالا(codec: صحیح، e: خطای فراخوان): فشرده سازی.بافر بایتنمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Messages.salam
جریان جدید NewStream
تابع جریان جدید(fd: صحیح۶۴): جریاننمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Serve.salam
جریان حافظه NewMemStream
تابع جریان حافظه(): جریاننمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Frames.salam
آزادسازی جریان FreeStream
تابع آزادسازی جریان(s &: جریان)نمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Frames.salam
تغذیه متن FeedStr
تابع تغذیه متن(s &: جریان، text: رشته)نمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Frames.salam
تغذیه بافر FeedBuf
تابع تغذیه بافر(s &: جریان، b: فشرده سازی.بافر بایت)نمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Frames.salam
باقیمانده جریان StreamPending
تابع باقیمانده جریان(s: جریان): صحیحنمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Frames.salam
جریان بسته StreamClosed
تابع جریان بسته(s: جریان): منطقینمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Frames.salam
قاببندی FrameEncode
تابع قاببندی(kind: صحیح، payload: فشرده سازی.بافر بایت): فشرده سازی.بافر بایتنمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Messages.salam
قاببندی متن FrameEncodeStr
تابع قاببندی متن(kind: صحیح، payload: رشته): فشرده سازی.بافر بایتنمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Frames.salam
خواندن قاب ReadFrame
تابع خواندن قاب(s &: جریان، kind: صحیح، ok &: منطقی): فشرده سازی.بافر بایتنمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Frames.salam
خواندن قاب متنی ReadFrameStr
تابع خواندن قاب متنی(s &: جریان، kind: صحیح، ok &: منطقی): رشتهنمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Frames.salam
نوشتن قاب WriteFrame
تابع نوشتن قاب(fd: صحیح۶۴، kind: صحیح، payload: فشرده سازی.بافر بایت): منطقینمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Serve.salam
نوشتن قاب متنی WriteFrameStr
تابع نوشتن قاب متنی(fd: صحیح۶۴، kind: صحیح، payload: رشته): منطقینمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Serve.salam
سرور جدید NewServer
تابع سرور جدید(port: صحیح، codec: صحیح): سرور فراخواننمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Client.salam
تنظیم قاببندی SetFraming
تابع تنظیم قاببندی(s &: سرور فراخوان، framing: صحیح)نمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Client.salam
اجرای دسته InvokeBatch
تابع اجرای دسته(b: دسته): پاسخهانمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Methods.salam
پردازش بار HandlePayload
تابع پردازش بار(codec: صحیح، payload: فشرده سازی.بافر بایت): فشرده سازی.بافر بایتنمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Serve.salam
پردازش متن HandleText
تابع پردازش متن(text: رشته): رشتهنمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Methods.salam
خدمت به اتصال ServeConn
تابع خدمت به اتصال(fd: صحیح۶۴، codec: صحیح، framing: صحیح): صحیحنمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Serve.salam
گوش دادن Listen
تابع گوش دادن(s &: سرور فراخوان): منطقینمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Client.salam
درگاه سرور Port
تابع درگاه سرور(s: سرور فراخوان): صحیحنمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Client.salam
خدمت به تعداد ServeCount
تابع خدمت به تعداد(s &: سرور فراخوان، n: صحیح): صحیحگوش دادن را صدا میزند.نمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Client.salam
خدمت Serve
تابع خدمت(s &: سرور فراخوان)توقف سرور صدا زده نشده، به اتصالها یکییکی پاسخ میدهد. کارخواهی که اتصالش را باز نگه دارد بقیه را منتظر میگذارد.نمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Client.salam
توقف سرور StopServer
تابع توقف سرور(s &: سرور فراخوان)نمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Client.salam
خدمت ورودی خروجی ServeStdio
تابع خدمت ورودی خروجی(framing: صحیح): صحیحنمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Serve.salam
خطای جدید NewError
تابع خطای جدید(code: صحیح، message: رشته): خطای فراخواننمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Messages.salam
خطای استاندارد StdError
تابع خطای استاندارد(code: صحیح): خطای فراخواننمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Messages.salam
خطا با داده ErrorWithData
تابع خطا با داده(code: صحیح، message: رشته، data: مقدار.مقدار): خطای فراخواننمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Messages.salam
درخواست جدید NewRequest
تابع درخواست جدید(method: رشته، params: مقدار.مقدار، id: صحیح۶۴): درخواستنمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Messages.salam
درخواست با شناسه متنی NewRequestStrId
تابع درخواست با شناسه متنی(method: رشته، params: مقدار.مقدار، id: رشته): درخواستنمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Messages.salam
اعلان جدید NewNotification
تابع اعلان جدید(method: رشته، params: مقدار.مقدار): درخواستنمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Messages.salam
اعلان است IsNotification
تابع اعلان است(r: درخواست): منطقینمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Methods.salam
پاسخ جدید NewResponse
تابع پاسخ جدید(id: مقدار.مقدار، result: مقدار.مقدار): پاسخنمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Messages.salam
پاسخ خطا NewErrorResponse
تابع پاسخ خطا(id: مقدار.مقدار، e: خطای فراخوان): پاسخنمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Messages.salam
تعداد پارامتر ParamCount
تابع تعداد پارامتر(r: درخواست): صحیحنمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Methods.salam
پارامتر در جایگاه ParamAt
تابع پارامتر در جایگاه(r: درخواست، i: صحیح): مقدار.مقدارنمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Messages.salam
پارامتر نامدار ParamNamed
تابع پارامتر نامدار(r: درخواست، key: رشته): مقدار.مقدارنمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Messages.salam
پارامتر Param
تابع پارامتر(r: درخواست، key: رشته، pos: صحیح): مقدار.مقدارنمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Methods.salam
پارامتر عددی ParamInt
تابع پارامتر عددی(r: درخواست، key: رشته، pos: صحیح): صحیح۶۴نمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Methods.salam
پارامتر اعشاری ParamFloat
تابع پارامتر اعشاری(r: درخواست، key: رشته، pos: صحیح): اعشار۶۴نمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Methods.salam
پارامتر متنی ParamStr
تابع پارامتر متنی(r: درخواست، key: رشته، pos: صحیح): رشتهنمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Methods.salam
پارامتر بولی ParamBool
تابع پارامتر بولی(r: درخواست، key: رشته، pos: صحیح): منطقینمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Methods.salam
پارامتر دارد HasParam
تابع پارامتر دارد(r: درخواست، key: رشته، pos: صحیح): منطقینمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Messages.salam
ثبت متد Register
تابع ثبت متد(name: رشته، fn: صحیح۶۴)نمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Methods.salam
ثبت متد با توضیح RegisterDoc
تابع ثبت متد با توضیح(name: رشته، fn: صحیح۶۴، doc: رشته)نمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Methods.salam
حذف متد Unregister
تابع حذف متد(name: رشته): منطقینمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Methods.salam
متد دارد HasMethod
تابع متد دارد(name: رشته): منطقینمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Methods.salam
تعداد متدها MethodCount
تابع تعداد متدها(): صحیحنمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Methods.salam
فهرست متدها ListMethods
تابع فهرست متدها(): وکتور<رشته>نمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Methods.salam
توضیح متد MethodDoc
تابع توضیح متد(name: رشته): رشتهنمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Methods.salam
بازنشانی ثبت ResetRegistry
تابع بازنشانی ثبت()نمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Methods.salam
درخواست فراخوان CallRequest
تابع درخواست فراخوان(slot: صحیح۶۴): درخواستنمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Methods.salam
نام متد فراخوان CallMethodName
تابع نام متد فراخوان(slot: صحیح۶۴): رشتهنمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Methods.salam
پارامترهای فراخوان CallParams
تابع پارامترهای فراخوان(slot: صحیح۶۴): مقدار.مقدارنمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Methods.salam
فراخوان اعلان است CallIsNotification
تابع فراخوان اعلان است(slot: صحیح۶۴): منطقینمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Methods.salam
تعداد پارامتر فراخوان CallParamCount
تابع تعداد پارامتر فراخوان(slot: صحیح۶۴): صحیحنمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Methods.salam
پارامتر فراخوان CallParam
تابع پارامتر فراخوان(slot: صحیح۶۴، key: رشته، pos: صحیح): مقدار.مقدارنمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Methods.salam
پارامتر عددی فراخوان CallParamInt
تابع پارامتر عددی فراخوان(slot: صحیح۶۴، key: رشته، pos: صحیح): صحیح۶۴نمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Methods.salam
پارامتر اعشاری فراخوان CallParamFloat
تابع پارامتر اعشاری فراخوان(slot: صحیح۶۴، key: رشته، pos: صحیح): اعشار۶۴نمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Methods.salam
پارامتر متنی فراخوان CallParamStr
تابع پارامتر متنی فراخوان(slot: صحیح۶۴، key: رشته، pos: صحیح): رشتهنمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Methods.salam
پارامتر بولی فراخوان CallParamBool
تابع پارامتر بولی فراخوان(slot: صحیح۶۴، key: رشته، pos: صحیح): منطقینمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Methods.salam
پاسخ دادن Reply
تابع پاسخ دادن(slot: صحیح۶۴، result: مقدار.مقدار)نمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Methods.salam
پاسخ عددی ReplyInt
تابع پاسخ عددی(slot: صحیح۶۴، n: صحیح۶۴)نمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Methods.salam
پاسخ اعشاری ReplyFloat
تابع پاسخ اعشاری(slot: صحیح۶۴، n: اعشار۶۴)نمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Methods.salam
پاسخ متنی ReplyStr
تابع پاسخ متنی(slot: صحیح۶۴، s: رشته)نمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Methods.salam
پاسخ بولی ReplyBool
تابع پاسخ بولی(slot: صحیح۶۴، b: منطقی)نمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Methods.salam
پاسخ تهی ReplyNull
تابع پاسخ تهی(slot: صحیح۶۴)نمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Methods.salam
شکست Fail
تابع شکست(slot: صحیح۶۴، code: صحیح، message: رشته)نمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Methods.salam
شکست با داده FailWithData
تابع شکست با داده(slot: صحیح۶۴، code: صحیح، message: رشته، data: مقدار.مقدار)نمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Methods.salam
پارامتر نامعتبر FailInvalidParams
تابع پارامتر نامعتبر(slot: صحیح۶۴، message: رشته)نمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Methods.salam
اجرای درخواست Invoke
تابع اجرای درخواست(req: درخواست): پاسخنمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Methods.salam
کدگذاری درخواست جیسون JsonEncodeRequest
تابع کدگذاری درخواست جیسون(r: درخواست): رشتهنمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Messages.salam
کدگذاری پاسخ جیسون JsonEncodeResponse
تابع کدگذاری پاسخ جیسون(r: پاسخ): رشتهنمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Messages.salam
کدگذاری پاسخهای جیسون JsonEncodeResponses
تابع کدگذاری پاسخهای جیسون(rs: پاسخها): رشتهنمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Messages.salam
کدگشایی دسته جیسون JsonDecodeBatch
تابع کدگشایی دسته جیسون(text: رشته): دستهنمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Methods.salam
کدگشایی درخواست جیسون JsonDecodeRequest
تابع کدگشایی درخواست جیسون(text: رشته، ok &: منطقی): درخواستنمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Methods.salam
کدگشایی پاسخ جیسون JsonDecodeResponse
تابع کدگشایی پاسخ جیسون(text: رشته، ok &: منطقی): پاسخنمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Messages.salam
کدگشایی پاسخهای جیسون JsonDecodeResponses
تابع کدگشایی پاسخهای جیسون(text: رشته، ok &: منطقی): پاسخهانمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Messages.salam
خطای سطح بالای جیسون JsonTopLevelError
تابع خطای سطح بالای جیسون(e: خطای فراخوان): رشتهنمونهی این مورد همراه با موارد بالاتر آمده است: rpc-Messages.salam