การกำหนดรูปแบบ การเข้าถึง และการแปลงข้อความ

คุณกําลังดูเอกสารประกอบของ Apigee Edge
ไปที่เอกสารประกอบของ Apigee X info

คุณสามารถใช้นโยบายที่รวมอยู่ใน Apigee Edge เพื่อจัดการข้อความที่ส่งผ่านพร็อกซี API ได้ นโยบายช่วยให้คุณทำสิ่งต่อไปนี้ได้

  • แปลงข้อความรูปแบบต่างๆ เช่น จาก XML เป็น JSON
  • ตั้งค่าค่าตัวแปรจากเนื้อหาข้อความ และสร้างข้อความจากค่าตัวแปร
  • ใช้โค้ดขั้นตอน เช่น JavaScript, Java และ Python เพื่อจัดการข้อความและข้อมูลในรูปแบบที่ซับซ้อนมากขึ้น

โดยทั่วไป เมื่อใช้นโยบายเหล่านี้ คุณต้องระบุอินพุตและเอาต์พุตเป็นตัวแปรของโฟลว์ ในระยะรันไทม์ 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/>

การจัดการข้อมูลตัวแปร

การจัดการข้อมูลภายในพร็อกซีมักเกี่ยวข้องกับการใช้ข้อมูลสถานะเป็นค่าตัวแปรของโฟลว์ คุณสามารถทำได้โดยใช้นโยบายที่รับหรือกำหนดค่าตัวแปร เช่น คุณอาจต้องการเปลี่ยนรูปแบบค่าตัวแปรเป็นข้อความ หรือดึงข้อมูลเนื้อหาของข้อความเพื่อกำหนดค่าตัวแปร

โปรดดูข้อมูลอ้างอิงสำหรับนโยบาย 2 รายการต่อไปนี้

การสร้างการเปลี่ยนรูปแบบที่ซับซ้อนมากขึ้น

สำหรับการจัดการข้อมูลที่ซับซ้อนเกินความสามารถของนโยบายที่รวมไว้ คุณสามารถใช้ภาษาเชิงกระบวน เช่น JavaScript, Java หรือ Python

โดยทั่วไปแล้ว การดำเนินการนี้เกี่ยวข้องกับการเขียนโค้ดในภาษาใดภาษาหนึ่งเหล่านี้ จากนั้นเรียกใช้โค้ดจากนโยบายเฉพาะภาษา ดูข้อมูลเพิ่มเติมได้ที่การรวมโค้ดเชิงกระบวนการ