کتابخانه‌ی استاندارد · شبکه

فراخوان دور rpc

JSON-RPC 2.0 و MessagePack-RPC: سرور، کارخواه و ثبت متدها.

واردسازی فراخوان دور

نام آرگومان‌ها شناسه‌ی خود کد است و معادل فارسی ندارد؛ گونه‌ها، کلیدواژه‌ها و نام بسته‌ها با معادل فارسی نوشته می‌شوند.

با فراخوان دور یک برنامه متدهای برنامه‌ی دیگر را صدا می‌زند، انگار تابع‌های خودش‌اند. در سمت سرور هر متد را با ثبت متد به یک تابع وصل می‌کنید؛ آن تابع شماره‌ی فراخوان را می‌گیرد، پارامترها را با پارامتر عددی فراخوان و مانند آن می‌خواند و با پاسخ ... یا شکست جواب می‌دهد.

پیام‌ها با کدک جیسون (JSON-RPC 2.0) یا مسگ‌پک رد و بدل می‌شوند و روی TCP با یکی از سه قاب‌بندی خطی، سرآیندی (مثل LSP) یا طول‌دار جدا می‌شوند؛ کارخواه و سرور باید قاب‌بندی یکسانی داشته باشند. پردازش متن همین را بدون شبکه انجام می‌دهد تا RPC را پشت یک مسیر اچ تی تی پی بگذارید.

یک سرویس کوچک بدون شبکه

سریع‌ترین راه طراحی یک API از نوع RPC ساختنش با پردازش متن است: یک درخواست JSON-RPC (یا یک دسته) را به شکل متن می‌گیرد و پاسخ را هم به شکل متن برمی‌گرداند، بی هیچ شبکه‌ای. هر متد یک تابع معمولی است که شماره‌ی یک فراخوان ف را می‌گیرد؛ پارامترها را با پارامتر متنی فراخوان، پارامتر عددی فراخوان و هم‌خانواده‌هایشان می‌خواند و باید دقیقاً یک بار پاسخ دهد، با یکی از تابع‌های پاسخ ... یا با شکست.

rpc-guide-todo.salam
واردسازی فراخوان دور
واردسازی کدگذاری.مقدار

ناپایا کارها := وکتور {} برگردان وکتور<رشته>

تابع افزودن کار(ف: صحیح۶۴):
    عنوان := فراخوان دور.پارامتر متنی فراخوان(ف، "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")
    کارها.آزادکن()
پایان
خروجی{"jsonrpc": "2.0", "result": 1, "id": 1} {"jsonrpc": "2.0", "result": 2, "id": 2} {"jsonrpc": "2.0", "error": {"code": -32602, "message": "عنوان لازم است"}, "id": 3} {"jsonrpc": "2.0", "result": ["خرید نان", "تماس با سارا"], "id": 4} [{"jsonrpc": "2.0", "result": 2, "id": 5}, {"jsonrpc": "2.0", "error": {"code": -32601, "message": "Method not found"}, "id": 6}] یک کار می‌افزاید و تعداد کارها را برمی‌گرداند

هر پارامتر هم‌زمان با نام و با جایگاهش جست‌وجو می‌شود: پارامتر متنی فراخوان(ف، "title"، ۰) هم {"title": ...} را پیدا می‌کند و هم نخستین عضو [...] را، پس کارخواه‌ها می‌توانند هر کدام از این دو شکل را به کار ببرند. پارامتر نامعتبر با کد استاندارد -32602 پاسخ می‌دهد، و متدی که هرگز ثبت نشده بی هیچ کدی از طرف شما -32601 می‌گیرد. در یک دسته، هر درخواست پاسخ خودش را دارد، شکست‌ها هم.

دفتر ثبت متدها برای کل برنامه سراسری است، پس وضعیت متدها، مثل فهرست کارها در این‌جا، در یک متغیر سراسری یا پشت آن زندگی می‌کند. اگر چند اتصال در نخ‌های موازی خدمت می‌گیرند، آن وضعیت را با یک قفل از همگام سازی محافظت کنید.

سرور و کارخواه روی TCP

برای دو برنامه، سرور جدید با درگاه ۰ می‌گذارد سیستم یک درگاه آزاد انتخاب کند و درگاه سرور پس از گوش دادن آن را گزارش می‌کند. خدمت به تعداد به تعداد ثابتی اتصال خدمت می‌دهد و برمی‌گردد، که برای آزمون مناسب است؛ خدمت تا توقف سرور ادامه می‌دهد. هر دو در هر لحظه فقط به یک اتصال پاسخ می‌دهند: تا وقتی یک کارخواه وصل مانده، بعدی در صف منتظر است. اگر باید هم‌زمان به چند کارخواه خدمت داد، اتصال‌ها را خودتان با تی سی پی بپذیرید (تی سی پی.پیوند و بعد تی سی پی.پذیرش در یک حلقه) و fd هر اتصال را در نخی جدا از نخ به خدمت به اتصال بدهید. در طرف دیگر، اتصال کارخواه وصل می‌شود و فراخوان یک درخواست می‌فرستد و منتظر پاسخش می‌ماند.

rpc-guide-tcp.salam
واردسازی فراخوان دور
واردسازی کدگذاری.مقدار
واردسازی همگام سازی

ناپایا سرور := فراخوان دور.سرور جدید(۰، فراخوان دور.کدک جیسون)
ناپایا آماده := همگام سازی.گروه انتظار جدید()

تابع تبدیل ارز(ف: صحیح۶۴):
    مبلغ := فراخوان دور.پارامتر اعشاری فراخوان(ف، "amount"، ۰)
    ارز := فراخوان دور.پارامتر متنی فراخوان(ف، "to"، ۱)
    اگر ارز == "EUR":
        فراخوان دور.پاسخ اعشاری(ف، مبلغ * ۰.۵)
        برگشت
    پایان
    فراخوان دور.شکست(ف، -۳۲۰۱۰، "ارز ناشناخته: " + ارز)
پایان

تابع اجرای سرور():
    _ := فراخوان دور.گوش دادن(سرور)
    همگام سازی.اتمام(آماده)
    _ := فراخوان دور.خدمت به تعداد(سرور، ۱)
پایان

تابع ریشه:
    فراخوان دور.ثبت متد("convert"، تبدیل ارز)
    همگام سازی.افزودن(آماده، ۱)
    ن := نخ‌ساز(اجرای سرور)
    همگام سازی.انتظار(آماده)

    ناپایا کارخواه := فراخوان دور.اتصال کارخواه("127.0.0.1"، فراخوان دور.درگاه سرور(سرور)، فراخوان دور.کدک جیسون)
    اگر وارونه فراخوان دور.کارخواه معتبر(کارخواه):
        سرچاپ "اتصال برقرار نشد:"، فراخوان دور.خطای کارخواه(کارخواه)
        برگشت ۱
    پایان
    ناپایا پارامترها := مقدار.شیء جدید()
    مقدار.تنظیم کلید(پارامترها، "amount"، مقدار.مقدار اعشاری(۴۰.۰))
    مقدار.تنظیم کلید(پارامترها، "to"، مقدار.مقدار رشته("EUR"))
    خوب := فراخوان دور.فراخوان(کارخواه، "convert"، پارامترها)
    سرچاپ "۴۰ برابر است با"، فراخوان دور.نتیجه اعشاری(خوب)، "یورو"

    مقدار.تنظیم کلید(پارامترها، "to"، مقدار.مقدار رشته("XYZ"))
    بد := فراخوان دور.فراخوان(کارخواه، "convert"، پارامترها)
    اگر فراخوان دور.پاسخ خطاست(بد):
        سرچاپ "خطا"، فراخوان دور.کد خطا(بد)، فراخوان دور.پیام خطا(بد)
    پایان
    فراخوان دور.بستن کارخواه(کارخواه)
    نخ‌پیوند(ن)
    فراخوان دور.توقف سرور(سرور)
    برگشت ۰
پایان
خروجی۴۰ برابر است با 20 یورو خطا -32010 ارز ناشناخته: XYZ

فراخوان ناموفق چیزی را از کار نمی‌اندازد. اول پاسخ خطاست را بررسی کنید و بعد کد خطا و پیام خطا را بخوانید؛ خواندن نتیجه اعشاری روی پاسخ خطا صفر برمی‌گرداند. کدهای خطای خودتان بهتر است بیرون از بازه‌ی -32768 تا -32000 بمانند که JSON-RPC رزرو کرده، به‌جز بلوک -32000 تا -32099 که برای خطاهای سرور است و -32010 از همان‌جا آمده.

کارخواه و سرور باید روی کدک و قاب‌بندی توافق داشته باشند. JSON با قاب‌بندی خطی پیش‌فرض است و با یک پایانه به‌راحتی اشکال‌زدایی می‌شود. کدک مسگ‌پک کوچک‌تر و سریع‌تر است و قاب‌های طول‌دار به کار می‌برد؛ هر دو طرف را با تنظیم قاب‌بندی و تنظیم قاب‌بندی کارخواه تنظیم کنید.

گفتگو از راه ورودی و خروجی استاندارد

ابزارهای ویرایشگر، سرورهای زبان و افزونه‌ها اغلب به شکل یک فرایند فرزند اجرا می‌شوند و پیام‌ها را از راه ورودی و خروجی استاندارد رد و بدل می‌کنند. خدمت ورودی خروجی در هر خط یک درخواست می‌خواند (یا با قاب سرآیندی قاب‌های Content-Length به سبک LSP را)، پاسخ هر کدام را در خروجی استاندارد می‌نویسد و وقتی ورودی تمام شد تعداد درخواست‌ها را برمی‌گرداند. گزارش‌ها باید مثل این‌جا به خروجی خطا بروند، وگرنه پاسخ‌ها را خراب می‌کنند.

پیش از این‌که روی خدمت ورودی خروجی چیزی بسازید، دو محدودیتش را بدانید:

  • در قاب‌بندی خطی، یک خط خالی پایان ورودی حساب می‌شود و خدمت همان‌جا تمام می‌شود.
  • قاب سرآیندی هنوز با کارخواه‌های واقعی LSP کار نمی‌کند. آن‌ها سرآیندها را با \r\n تمام می‌کنند و بعد از بدنه خط تازه نمی‌فرستند؛ پس به خط خالی \r با خطای تجزیه پاسخ داده می‌شود و سرآیند بعدی جزء بدنه خوانده می‌شود. در پایان ورودی هم هرگز برنمی‌گردد. فعلاً روی ورودی و خروجی استاندارد قاب‌بندی خطی را به کار ببرید.
rpc-guide-stdio.salam
واردسازی فراخوان دور
واردسازی رشته
واردسازی ورودی خروجی

تابع شمار واژه(ف: صحیح۶۴):
    واژه‌ها := رشته.واژه ها(فراخوان دور.پارامتر متنی فراخوان(ف، "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 دیگری صدایش بزنند.

rpc-guide-http.salam
واردسازی فراخوان دور
واردسازی شبکه.اچ تی تی پی
واردسازی شبکه.مسیریاب

ناپایا بازدیدها := ۰

تابع بازدید(ف: صحیح۶۴):
    بازدیدها++
    فراخوان دور.پاسخ عددی(ف، بازدیدها)
پایان

تابع خوشامد(ف: صحیح۶۴):
    فراخوان دور.پاسخ متنی(ف، "سلام، " + فراخوان دور.پارامتر متنی فراخوان(ف، "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

ساختار کارخواه
کارخواه RPC روی یک اتصال TCP.
نامانگلیسیگونهتوضیح
اتصالconnتی سی پی.اتصال شبکهاتصال.
جریانstreamجریانجریان خواندن.
کدکcodecصحیح = 0کدک.
قاب‌بندیframingصحیح = 0قاب‌بندی.
شناسه بعدیnext_idصحیح۶۴ = 1شناسه‌ی درخواست بعدی.
سالمokمنطقی = نادرستسالم است.
آخرین خطاlast_errorرشته = ""آخرین خطا.
rpc-Client.salam
واردسازی فراخوان دور
واردسازی کدگذاری.مقدار
واردسازی شبکه.اچ تی تی پی
واردسازی شبکه.مسیریاب
واردسازی همگام سازی

ناپایا سرور := فراخوان دور.سرور جدید(۰، فراخوان دور.کدک جیسون)
ناپایا آماده := همگام سازی.گروه انتظار جدید()

تابع جمع(ج: صحیح۶۴):
    فراخوان دور.پاسخ عددی(ج، فراخوان دور.پارامتر عددی فراخوان(ج، "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"، پ، ۷)
    سرچاپ فراخوان دور.نتیجه عددی(ر)
پایان
خروجیtrue true 42 12:00 3 true 2 42 true -32601 Method not found false true 42

جریان Stream

ساختار جریان
جریان ورودی که قاب‌ها را از سوکت یا حافظه جدا می‌کند.
نامانگلیسیگونهتوضیح
توصیفگر سوکتfdصحیح۶۴ = -1سوکت.
دادهdataفشرده سازی.بافر بایتداده‌ی خوانده‌شده.
جای خواندنposصحیح = 0جای خواندن.
ورودی تمام‌شدهclosedمنطقی = نادرستورودی تمام شده.
روی سوکتhas_fdمنطقی = نادرستروی سوکت است.
rpc-Frames.salam
واردسازی فراخوان دور
واردسازی فشرده سازی

تابع ریشه:
    خط := فراخوان دور.قاب‌بندی متن(فراخوان دور.قاب خطی، `{"a":1}`)
    سرآیندی := فراخوان دور.قاب‌بندی متن(فراخوان دور.قاب سرآیندی، `{"b":2}`)
    طول‌دار := فراخوان دور.قاب‌بندی(فراخوان دور.قاب طول‌دار، فشرده سازی.بافر از رشته(`{"c":3}`))
    سرچاپ خط.طول، سرآیندی.طول، طول‌دار.طول
    سرچاپ فشرده سازی.بافر به رشته(سرآیندی).طول() > ۰

    ناپایا ج := فراخوان دور.جریان حافظه()
    فراخوان دور.تغذیه متن(ج، `{"x":1}` + "\n" + `{"x":2}` + "\n")
    ناپایا سالم := نادرست
    سرچاپ فراخوان دور.خواندن قاب متنی(ج، فراخوان دور.قاب خطی، سالم)، سالم
    سرچاپ فراخوان دور.باقی‌مانده جریان(ج)
    سرچاپ فراخوان دور.خواندن قاب متنی(ج، فراخوان دور.قاب خطی، سالم)
    _ := فراخوان دور.خواندن قاب متنی(ج، فراخوان دور.قاب خطی، سالم)
    سرچاپ سالم، فراخوان دور.جریان بسته(ج)

    ناپایا ج۲ := فراخوان دور.جریان حافظه()
    فراخوان دور.تغذیه بافر(ج۲، سرآیندی)
    فراخوان دور.تغذیه بافر(ج۲، طول‌دار)
    سرچاپ فراخوان دور.خواندن قاب متنی(ج۲، فراخوان دور.قاب سرآیندی، سالم)
    ب := فراخوان دور.خواندن قاب(ج۲، فراخوان دور.قاب طول‌دار، سالم)
    سرچاپ فشرده سازی.بافر به رشته(ب)، سالم
    سرچاپ فراخوان دور.اندازه تکه خواندن، فراخوان دور.بیشینه اندازه قاب
    فراخوان دور.آزادسازی جریان(ج)
    فراخوان دور.آزادسازی جریان(ج۲)
پایان
خروجی8 28 11 true {"x":1} true 8 {"x":2} false false {"b":2} {"c":3} true 4096 33554432

سرور فراخوان Server

ساختار سرور فراخوان
سرور RPC.
نامانگلیسیگونهتوضیح
درگاهportصحیح = 0درگاه؛ صفر یعنی یک درگاه آزاد.
کدکcodecصحیح = 0کدک.
قاب‌بندیframingصحیح = 0قاب‌بندی.
سوکت گوش‌دهندهlisten_fdصحیح۶۴ = -1سوکت گوش دادن.
فعالrunningمنطقی = نادرستدر حال اجرا.
شمار اتصال پاسخ‌دادهservedصحیح = 0شمار اتصال‌های پاسخ‌داده.
rpc-Serve.salam
واردسازی فراخوان دور
واردسازی شبکه.تی سی پی
واردسازی فشرده سازی

تابع پژواک(ج: صحیح۶۴):
    فراخوان دور.پاسخ دادن(ج، فراخوان دور.پارامترهای فراخوان(ج))
پایان

تابع ریشه:
    فراخوان دور.ثبت متد("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

ساختار خطای فراخوان
خطای JSON-RPC.
نامانگلیسیگونهتوضیح
کدcodeصحیح = 0کد.
پیامmessageرشته = ""پیام.
دادهdataمقدار.مقدارداده‌ی اضافه.
داده داردhas_dataمنطقی = نادرستداده دارد.
rpc-Messages.salam
واردسازی فراخوان دور
واردسازی کدگذاری.مقدار
واردسازی فشرده سازی

تابع ریشه:
    ناپایا پ := مقدار.آرایه جدید()
    مقدار.افزودن به آرایه(پ، مقدار.مقدار صحیح(۲))
    مقدار.افزودن به آرایه(پ، مقدار.مقدار رشته("سلام"))
    مقدار.افزودن به آرایه(پ، مقدار.مقدار اعشاری(۱.۵))
    مقدار.افزودن به آرایه(پ، مقدار.مقدار منطقی(درست))
    د := فراخوان دور.درخواست جدید("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}]`، سالم)
    سرچاپ همه.به شکل آرایه، همه.پاسخ‌ها.طول()، فراخوان دور.نتیجه بولی(همه.پاسخ‌ها[۰])، فراخوان دور.نتیجه متنی(همه.پاسخ‌ها[۱])
    سرچاپ فراخوان دور.کدگذاری پاسخ‌های جیسون(همه)

    سرچاپ فراخوان دور.نام کدک(فراخوان دور.کدک جیسون)، فراخوان دور.نام کدک(فراخوان دور.کدک مسگ‌پک)
    سرچاپ فراخوان دور.قاب‌بندی پیش‌فرض کدک(فراخوان دور.کدک جیسون) == فراخوان دور.قاب خطی، فراخوان دور.قاب‌بندی پیش‌فرض کدک(فراخوان دور.کدک مسگ‌پک) == فراخوان دور.قاب طول‌دار
    م := فراخوان دور.کدگذاری درخواست(فراخوان دور.کدک مسگ‌پک، د)
    سرچاپ م.طول، فشرده سازی.دریافت بایت(م، ۰)
    دسته := فراخوان دور.کدگشایی دسته(فراخوان دور.کدک مسگ‌پک، م)
    سرچاپ دسته.خوانده‌شده، دسته.درخواست‌ها[۰].متد، دسته.درخواست‌ها[۰].شناسه عددی
    سرچاپ فراخوان دور.کدگشایی دسته مسگ‌پک(فراخوان دور.کدگذاری درخواست مسگ‌پک(د)).درخواست‌ها[۰].متد
    مپ := فراخوان دور.کدگذاری پاسخ مسگ‌پک(فراخوان دور.پاسخ جدید(مقدار.مقدار صحیح(۱)، مقدار.مقدار صحیح(۴۲)))
    سرچاپ فراخوان دور.نتیجه عددی(فراخوان دور.کدگشایی پاسخ مسگ‌پک(مپ، سالم))، سالم
    ج := فراخوان دور.کدگذاری درخواست(فراخوان دور.کدک جیسون، د)
    سرچاپ فراخوان دور.نتیجه عددی(فراخوان دور.کدگشایی پاسخ(فراخوان دور.کدک مسگ‌پک، مپ، سالم))، ج.طول > ۰
    سرچاپ فشرده سازی.بافر به رشته(فراخوان دور.کدگذاری پاسخ‌ها(فراخوان دور.کدک جیسون، همه)).طول() > ۰
    سرچاپ فشرده سازی.بافر به رشته(فراخوان دور.کدگذاری خطای سطح بالا(فراخوان دور.کدک جیسون، خطا))
    سرچاپ فراخوان دور.نوع درخواست مسگ‌پک، فراخوان دور.نوع پاسخ مسگ‌پک، فراخوان دور.نوع اعلان مسگ‌پک
    سرچاپ فراخوان دور.کد درخواست نامعتبر، فراخوان دور.کد خطای داخلی، فراخوان دور.کد خطای کارساز
    سرچاپ فراخوان دور.نوع درخواست، فراخوان دور.نوع اعلان، فراخوان دور.نوع پاسخ
    سرچاپ فشرده سازی.بافر به رشته(فشرده سازی.بافر از رشته(فراخوان دور.کدگذاری درخواست جیسون(د))).طول() > ۰
پایان
خروجی{"jsonrpc": "2.0", "method": "calc", "params": [2, "سلام", 1.5, true], "id": 1} 4 2 سلام 1.5 true false 2 2 {"jsonrpc": "2.0", "method": "greet", "params": {"name": "علی"}, "id": "req-1"} علی true {"jsonrpc": "2.0", "method": "tick", "params": []} true add 9 2 {"jsonrpc": "2.0", "result": "ok", "id": 1} -32601 Method not found {"jsonrpc": "2.0", "error": {"code": -32000, "message": "سرور مشغول است"}, "id": 2} true {"jsonrpc": "2.0", "error": {"code": -32700, "message": "Parse error"}, "id": null} true 3.5 false true -32601 nope true 2 true x [{"jsonrpc": "2.0", "result": true, "id": 1}, {"jsonrpc": "2.0", "result": "x", "id": 2}] json-rpc-2.0 msgpack-rpc true true 29 148 true calc 1 calc 42 true 42 true true {"jsonrpc": "2.0", "error": {"code": -32601, "message": "Method not found"}, "id": null} 0 1 2 -32600 -32603 -32000 1 2 3 true

درخواست Request

ساختار درخواست
یک درخواست.
نامانگلیسیگونهتوضیح
متدmethodرشته = ""نام متد.
پارامترهاparamsمقدار.مقدارپارامترها: آرایه یا شیء.
پارامتر داردhas_paramsمنطقی = نادرستپارامتر دارد.
شناسهidمقدار.مقدارشناسه؛ عدد یا رشته.
شناسه داردhas_idمنطقی = نادرستشناسه دارد؛ بدون آن اعلان است.
شناسه عددیmsgidصحیح۶۴ = 0شناسه‌ی عددی.
کد خطاerr_codeصحیح = 0اگر درخواست خوانده نشد، کد خطا.
پیام خطاerr_messageرشته = ""پیام آن خطا.
rpc-Methods.salam
واردسازی فراخوان دور
واردسازی کدگذاری.مقدار

تابع جمع(ج: صحیح۶۴):
    الف := فراخوان دور.پارامتر عددی فراخوان(ج، "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")
    فراخوان دور.بازنشانی ثبت()
    سرچاپ فراخوان دور.تعداد متدها()
پایان
خروجی7 true جمع دو عدد 7 {"jsonrpc": "2.0", "result": 42, "id": 1} {"jsonrpc": "2.0", "result": 11, "id": 2} {"jsonrpc": "2.0", "error": {"code": -32602, "message": "تقسیم بر صفر"}, "id": 3} {"jsonrpc": "2.0", "result": "سلام مریم", "id": "x"} {"jsonrpc": "2.0", "error": {"code": -32001, "message": "نام لازم است"}, "id": 4} {"jsonrpc": "2.0", "result": ["status", 1, true], "id": 5} {"jsonrpc": "2.0", "error": {"code": -32003, "message": "دسترسی ندارید", "data": "admin"}, "id": 6} {"jsonrpc": "2.0", "error": {"code": -32601, "message": "Method not found"}, "id": 7} رویداد: start true 0 [{"jsonrpc": "2.0", "result": true, "id": 8}, {"jsonrpc": "2.0", "result": 2, "id": 9}] {"jsonrpc": "2.0", "error": {"code": -32700, "message": "Parse error"}, "id": null} 42 1 true false 0

پاسخ 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
نوع پیام MessagePack-RPC: درخواست.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: 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
کدک JSON-RPC 2.0.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: rpc-Messages.salam

کدک مسگ‌پک RPC_CODEC_MSGPACK

پایا کدک مسگ‌پک: صحیح۳۲ = 1
کدک MessagePack-RPC.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: rpc-Messages.salam

قاب خطی RPC_FRAME_LINE

پایا قاب خطی: صحیح۳۲ = 0
قاب‌بندی: هر پیام در یک خط.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: rpc-Messages.salam

قاب سرآیندی RPC_FRAME_HEADER

پایا قاب سرآیندی: صحیح۳۲ = 1
قاب‌بندی: سرآیند Content-Length، مثل LSP.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: rpc-Frames.salam

قاب طول‌دار RPC_FRAME_LENGTH

پایا قاب طول‌دار: صحیح۳۲ = 2
قاب‌بندی: طول ۴ بایتی پیش از هر پیام.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: rpc-Messages.salam

تابع‌ها

کدگذاری درخواست مسگ‌پک MsgpackEncodeRequest

تابع کدگذاری درخواست مسگ‌پک(r: درخواست): فشرده سازی.بافر بایت
درخواست را به MessagePack-RPC کدگذاری می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: rpc-Messages.salam

کدگذاری پاسخ مسگ‌پک MsgpackEncodeResponse

تابع کدگذاری پاسخ مسگ‌پک(r: پاسخ): فشرده سازی.بافر بایت
پاسخ را به MessagePack-RPC کدگذاری می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: rpc-Messages.salam

کدگشایی دسته مسگ‌پک MsgpackDecodeBatch

تابع کدگشایی دسته مسگ‌پک(b: فشرده سازی.بافر بایت): دسته
پیام MessagePack-RPC را به دسته‌ی درخواست‌ها برمی‌گرداند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: rpc-Messages.salam

کدگشایی پاسخ مسگ‌پک MsgpackDecodeResponse

تابع کدگشایی پاسخ مسگ‌پک(b: فشرده سازی.بافر بایت، ok &: منطقی): پاسخ
پاسخ MessagePack-RPC را کدگشایی می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: rpc-Messages.salam

اتصال کارخواه DialClient

تابع اتصال کارخواه(host: رشته، port: صحیح، codec: صحیح): کارخواه
به سرور RPC با کدک داده‌شده وصل می‌شود؛ قاب‌بندی پیش‌فرض همان کدک به کار می‌رود.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: 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: صحیح۶۴): پاسخ
درخواست JSON-RPC را با POST به نشانی HTTP می‌فرستد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: rpc-Client.salam

نام کدک CodecName

تابع نام کدک(codec: صحیح): رشته
نام کدک، مثل json-rpc-2.0.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: rpc-Messages.salam

قاب‌بندی پیش‌فرض کدک CodecDefaultFraming

تابع قاب‌بندی پیش‌فرض کدک(codec: صحیح): صحیح
قاب‌بندی پیش‌فرض کدک: خطی برای جیسون و طول‌دار برای MessagePack.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: 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: رشته): رشته
یک متن JSON-RPC را پردازش می‌کند و پاسخ را برمی‌گرداند؛ برای اعلان‌ها رشته‌ی خالی. برای قرار دادن RPC پشت یک مسیر HTTP.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: rpc-Methods.salam

خدمت به اتصال ServeConn

تابع خدمت به اتصال(fd: صحیح۶۴، codec: صحیح، framing: صحیح): صحیح
به یک اتصال تا بسته شدنش پاسخ می‌دهد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: rpc-Serve.salam

گوش دادن Listen

تابع گوش دادن(s &: سرور فراخوان): منطقی
گوش دادن را آغاز می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: rpc-Client.salam

درگاه سرور Port

تابع درگاه سرور(s: سرور فراخوان): صحیح
درگاهی که واقعاً گرفته شد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: rpc-Client.salam

خدمت به تعداد ServeCount

تابع خدمت به تعداد(s &: سرور فراخوان، n: صحیح): صحیح
به n اتصال، یکی پس از دیگری، پاسخ می‌دهد و تعداد کل اتصال‌های پاسخ‌داده را برمی‌گرداند. اگر لازم باشد، اول خودش گوش دادن را صدا می‌زند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: rpc-Client.salam

خدمت Serve

تابع خدمت(s &: سرور فراخوان)
تا وقتی توقف سرور صدا زده نشده، به اتصال‌ها یکی‌یکی پاسخ می‌دهد. کارخواهی که اتصالش را باز نگه دارد بقیه را منتظر می‌گذارد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: rpc-Client.salam

توقف سرور StopServer

تابع توقف سرور(s &: سرور فراخوان)
سرور را متوقف می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: rpc-Client.salam

خدمت ورودی خروجی ServeStdio

تابع خدمت ورودی خروجی(framing: صحیح): صحیح
درخواست‌ها را خط‌به‌خط از ورودی استاندارد می‌خواند و پاسخ هر کدام را در خروجی استاندارد می‌نویسد؛ در پایان ورودی یا در نخستین خط خالی تعداد درخواست‌ها را برمی‌گرداند. قاب‌بندی سرآیندی هنوز ترافیک واقعی LSP را درست نمی‌خواند؛ یادداشت راهنمای بالا را ببینید.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: 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: درخواست): رشته
درخواست به متن JSON-RPC.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: rpc-Messages.salam

کدگذاری پاسخ جیسون JsonEncodeResponse

تابع کدگذاری پاسخ جیسون(r: پاسخ): رشته
پاسخ به متن JSON-RPC.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: 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: خطای فراخوان): رشته
پاسخ خطای JSON-RPC با شناسه‌ی تهی.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: rpc-Messages.salam