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

درحال مشاهده اسناد 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برای تبدیل پیام‌ها بااستفاده از XSL استفاده کنید. برای مثال، پس‌از تبدیل کردن بار JSON به XML، می‌توانید از خط‌مشی «تبدیل XSL» با برگ سبک برای انجام تبدیل موردنیازتان استفاده کنید.

در مثال خط‌مشی زیر، خط‌مشی پیامی با قالب 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/>

اداره کردن داده‌های متغیر

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

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

ایجاد تبدیل‌های پیچیده‌تر

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

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