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

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

در مثال زیر از سیاست، سیاست یک پیام با فرمت 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/>

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

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

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

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

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

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