پیوست کردن خط‌مشی به «جریان» ProxyEndpoint یا TargetEndpoint

درحال مشاهده اسناد Apigee Edge هستید.
به اسناد Apigee X بروید.
اطلاعات

خط‌مشی‌ها تا زمانی که به «جریان» پیوست نشوند اجرا نمی‌شوند. با نام‌گذاری «خط‌مشی» در پیکربندی «مرحله»، می‌توانید پیوست «خط‌مشی» ایجاد کنید.

انتخاب نقطه پیوست برای رفتار پراکسی API شما حیاتی است. برای مثال، اگر خط‌مشی «سهمیه» را به «جریان» پاسخ پیوست کنید، «سهمیه» پس‌از ارسال پیام درخواست به سرویس زیرینه اعمال خواهد شد. این کار هدف اعمال خط‌مشی «سهمیه» را ازبین می‌برد! بنابراین، باید «خط‌مشی سهمیه» را به‌عنوان «مرحله پردازش» به «جریان» درخواست پیوست کنید.

قالب پیوست خط‌مشی به‌صورت زیر است:

<Step>
    <Name>{policy_name}</Name>
</Step>

برای مثال:

<Step>
    <Name>QuotaPolicy</Name>
</Step>

خط‌مشی با افزودن پیکربندی «مرحله» به عنصر «جریان» درخواست یا پاسخ مناسب در پیکربندی ProxyEndpoint یا TargetEndpoint به «جریان» پیوست می‌شود.

می‌توانید خط‌مشی را به درخواست یا پاسخ «جریان» پیوست کنید. «جریان‌های» درخواست و پاسخ به «جریان پیشین» و «جریان پسین» تقسیم می‌شوند.

مثال زیر حداقل پیکربندی ProxyEndpoint را بدون پیوست خط‌مشی نشان می‌دهد. این کار به‌سادگی (ورودی) HTTPProxyConnection و RouteRule را تعریف می‌کند.

<ProxyEndpoint name="default">
    <HTTPProxyConnection>
        <BasePath>/weather</BasePath>
        <VirtualHost>default</VirtualHost>
    </HTTPProxyConnection>
    <RouteRule name="default">
        <TargetEndpoint>default</TargetEndpoint>
    </RouteRule>
</ProxyEndpoint>

باید این پیکربندی را اصلاح کنید تا ProxyEndpoint خط‌مشی «سهمیه» را (به‌عنوان «مرحله پردازش») قبل‌از اینکه پراکسی API هر پردازش دیگری را انجام دهد اعمال کند. اگر توسعه‌دهنده‌ای از «سهمیه» فراتر رفته باشد، نمی‌خواهید منابع محاسباتی را برای درخواست‌های اضافی هدر دهید.

برای اعمال این پیکربندی، یک «مرحله» پردازش را به «جریان پیش‌از درخواست» به‌صورت زیر پیوست می‌کنید:

<ProxyEndpoint name="default">
  <PreFlow>
    <Request>
      <Step><Name>QuotaPolicy</Name></Step>
    </Request>
  </PreFlow>
  <HTTPProxyConnection> 
    <BasePath>/weather</BasePath> 
    <VirtualHost>default</VirtualHost> 
  </HTTPProxyConnection> 
  <RouteRule name="default"> 
    <TargetEndpoint>default</TargetEndpoint> 
  </RouteRule> 
</ProxyEndpoint>

گاهی اوقات، ممکن است بخواهید خط‌مشی‌ای پس‌از پردازش اولیه دیگری در ProxyEndpoint اجرا شود. برای مثال، می‌خواهید «سهمیه» را در «جریان پیش‌از اجرا» بررسی کنید، سپس مجموعه دیگری از پردازش را پس‌از بررسی «سهمیه» انجام دهید، مثلاً درخواست را از JSON به XML تبدیل کنید. برای انجام این کار، خط‌مشی را به مسیر درخواست PostFlow پیوست کنید. در زیر درخواست نمونه‌ای از پیوست PostFlow آورده شده است. این خط‌مشی پس‌از اجرای همه خط‌مشی‌های موجود در PreFlow (و هرگونه جریان شرطی) روی پیام درخواست اجرا می‌شود.

<PostFlow>
  <Request>
    <Step><Name>JSONtoXMLPolicy</Name></Step>
  </Request>
</PostFlow>

در زیر نمونه‌ای از پیوست PostFlow پاسخ آمده است. این خط‌مشی در پیام پاسخ اجرا می‌شود. (پاسخ ProxyEndpoint PostFlow آخرین مرحله پردازش قبل‌از برگرداندن پاسخ به برنامه مشتری درخواست‌کننده است.)

<PostFlow>
  <Response>
    <Step><Name>XMLtoJSONPolicy</Name></Step>
  </Response>
</PostFlow>