شکل دهی، دسترسی و تبدیل پیام ها

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

می‌توانید از خط‌مشی‌های موجود در Apigee Edge برای دستکاری پیام‌هایی که از طریق پراکسی‌های API شما جاری می‌شوند استفاده کنید. با سیاست ها، می توانید:

• پیام ها را بین فرمت ها، مانند از XML به JSON تبدیل کنید.
• مقادیر متغیر را از محتوای پیام تنظیم کنید و از مقادیر متغیر پیام ایجاد کنید.
• از کد رویه ای مانند جاوا اسکریپت، جاوا و پایتون برای مدیریت پیام ها و داده ها به روش های پیچیده تر استفاده کنید.

به طور کلی، هنگام استفاده از این سیاست ها، ورودی و خروجی را به عنوان متغیرهای جریان مشخص می کنید. در زمان اجرا، Apigee Edge مقدار ورودی را از یک متغیر منبع بازیابی می کند و مقدار خروجی را در یک متغیر خروجی می نویسد.

این موضوع به معرفی این قابلیت ها می پردازد. برای اطلاعات کاملتر و فنی تر، به مراجع خط مشی مربوط به هر یک مراجعه کنید.

مدیریت ساده برای XML و JSON

Apigee Edge شامل خط مشی هایی است که تبدیل بین XML و JSON و تبدیل XML با XSL را آسان تر می کند.

تبدیل JSON به XML

خط مشی JSON به XML ورودی JSON شما را می گیرد و آن را به XML تبدیل می کند.

در مثال خط مشی زیر، این خط مشی یک پیام با فرمت JSON از متغیر request می گیرد، سپس مقدار متغیر را با پیامی با قالب XML جایگزین می کند. ورودی در عنصر <Source> مشخص می شود، در حالی که خروجی در عنصر <OutputVariable> مشخص می شود.

<JSONToXML name="jsontoxml">
     <Source>request</Source>
     <OutputVariable>request</OutputVariable>
</JSONToXML>

تبدیل XML به JSON

خط مشی XML به JSON پیام ورودی XML را به JSON تبدیل می کند.

در مثال خط مشی زیر، این خط مشی یک پیام با قالب XML از متغیر response می گیرد، سپس مقدار متغیر را با پیامی با قالب JSON جایگزین می کند. ورودی در عنصر <Source> مشخص می شود، در حالی که خروجی در عنصر <OutputVariable> مشخص می شود.

<XMLToJSON name="ConvertToJSON">
   <OutputVariable>response</OutputVariable>
   <Source>response</Source>
</XMLToJSON>

تبدیل XML با XSL

می توانید از خط مشی XSL Transform برای تبدیل پیام ها با استفاده از XSL استفاده کنید. به عنوان مثال، پس از تبدیل یک payload JSON به XML، می توانید از خط مشی XSL Transform با یک شیوه نامه برای انجام تبدیل مورد نیاز خود استفاده کنید.

در مثال خط مشی زیر، این خط مشی یک پیام با قالب XML از متغیر response می گیرد، سپس مقدار متغیر را با پیامی که توسط my_transform.xsl قالب بندی شده است جایگزین می کند. ورودی در عنصر <Source> مشخص می شود، در حالی که خروجی در عنصر <OutputVariable> مشخص می شود.

<XSL name="TransformXML">
    <ResourceURL>xsl://my_transform.xsl</ResourceURL>
    <Source>response</Source>
    <OutputVariable>response</OutputVariable>
</XSL>

    <Source>request</Source>
    <ResourceURL>xsl://XSL-Transform-1.xsl</ResourceURL>
    <OutputVariable/>

مدیریت داده های متغیر

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

حتماً مراجع مربوط به دو خط مشی زیر را ببینید:

• خط مشی پیام را برای ایجاد پیام از مقادیر متغیر اختصاص دهید .
• استخراج خط مشی متغیرها برای اختصاص متغیرها از محتوای پیام.

ایجاد تحولات پیچیده تر

برای مدیریت داده‌هایی که پیچیدگی آن‌ها خارج از توانایی سیاست‌های گنجانده شده است، می‌توانید از زبان‌های رویه‌ای مانند جاوا اسکریپت، جاوا یا پایتون استفاده کنید.

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