مشاركة عبر

نشر الحدث إلى اشتراك GraphQL

  • مقالة

ينطبق على: جميع مستويات إدارة واجهة برمجة التطبيقات

ينشر النهج publish-event حدثا إلى اشتراك واحد أو أكثر محدد في مخطط واجهة برمجة تطبيقات GraphQL. تكوين النهج في محلل GraphQL لحقل ذي صلة في المخطط لنوع عملية آخر مثل الطفرة. في وقت التشغيل، يتم نشر الحدث إلى عملاء GraphQL المتصلين. تعرف على المزيد حول واجهات برمجة تطبيقات GraphQL في APIM.

إشعار

تعيين عناصر النهج والعناصر التابعة بالترتيب الوارد في بيان النهج. تعلم كيفية إعداد نُهج APIM أو تعديلها.

نهج السياسة

<http-data-source>
<!-- http-data-source is an example resolver policy -->
    <http-request>
    [...]
    </http-request>
    <http-response>
        [...]
        <publish-event>
            <targets>
                <graphql-subscription id="subscription field" />
            </targets>
        </publish-event>
    </http-response>
</http-data-source>

عناصر

Name ‏‏الوصف مطلوب
targets اشتراك واحد أو أكثر في مخطط GraphQL، المحدد في target العناصر الفرعية، والذي يتم نشر الحدث إليه. ‏‏نعم‬

الاستخدام

ملاحظات الاستخدام

  • يتم استدعاء هذا النهج فقط عند تنفيذ استعلام أو طفرة GraphQL ذات صلة.
  • يجب عدم تعريف محلل للاشتراك المقابل. تعريف نهج publish-event على استعلام مصدر أو طفرة كافية لتشغيل أحداث الاشتراك.

مثال

تم تكوين تعريف نهج المثال التالي في محلل للطفرة createUser . ينشر حدثا إلى onUserCreated الاشتراك.

مثال لمخطط بسيط

type User {
  id: Int!
  name: String!
}


type Mutation {
    createUser(id: Int!, name: String!): User
}

type Subscription {
    onUserCreated: User!
}

مثال على النهج

<http-data-source>
    <http-request>
        <set-method>POST</set-method>
        <set-url>https://contoso.com/api/user</set-url>
        <set-body template="liquid">{ "id" : {{body.arguments.id}}, "name" : "{{body.arguments.name}}"}</set-body>
    </http-request>
    <http-response>
        <publish-event>
            <targets>
                <graphql-subscription id="onUserCreated" />
            </targets>
        </publish-event>
    </http-response>
</http-data-source>

المحتوى ذو الصلة

لمزيد من المعلومات حول العمل مع النُهج، راجع: