Mesaj şekillendirme, dönüştürme ve mesajlara erişme

Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin. bilgi

API proxy'lerinizden geçen iletileri değiştirmek için Apigee Edge ile birlikte gelen politikaları kullanabilirsiniz. Politikalarla şunları yapabilirsiniz:

  • Mesajları XML'den JSON'a gibi biçimler arasında dönüştürme
  • Değişken değerlerini mesaj içeriğinden ayarlayın ve değişken değerlerinden mesajlar oluşturun.
  • İletileri ve verileri daha karmaşık şekillerde işlemek için JavaScript, Java ve Python gibi prosedürel kodlar kullanın.

Genel olarak, bu politikaları kullanırken giriş ve çıkışı akış değişkenleri olarak belirtirsiniz. Çalışma zamanında Apigee Edge, giriş değerini bir kaynak değişkenden alır ve çıkış değerini bir çıkış değişkenine yazar.

Bu konuda bu özellikler tanıtılmaktadır. Daha eksiksiz ve teknik bilgiler için her birinin politika referanslarına bakın.

XML ve JSON için basit işleme

Apigee Edge, XML ile JSON arasında dönüşüm yapmayı ve XML'yi XSL ile dönüştürmeyi kolaylaştıran politikalar içerir.

JSON'u XML'ye dönüştürme

JSON'dan XML'ye politikası, JSON girişinizi alıp XML'ye dönüştürür.

Aşağıdaki politika örneğinde, politika request değişkeninden JSON biçimli bir mesaj alır ve ardından değişken değerini XML biçimli bir mesajla değiştirir. Giriş, <Source> öğesinde belirtilirken çıkış, <OutputVariable> öğesinde belirtilir.

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

XML'i JSON'a dönüştürme

XML'den JSON'a dönüştürme politikası, XML giriş mesajını JSON'a dönüştürür.

Aşağıdaki politika örneğinde, politika response değişkeninden XML biçimli bir ileti alır, ardından değişken değerini JSON biçimli bir iletiyle değiştirir. Giriş, <Source> öğesinde belirtilirken çıkış, <OutputVariable> öğesinde belirtilir.

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

XSL ile XML dönüştürme

XSL Transform politikası ile XSL kullanarak mesajları dönüştürebilirsiniz. Örneğin, bir JSON yükünü XML'ye dönüştürdükten sonra, ihtiyacınız olan dönüşümü gerçekleştirmek için XSL Dönüşümü politikasını bir stil sayfasıyla birlikte kullanabilirsiniz.

Aşağıdaki politika örneğinde politika, response değişkeninden XML biçimli bir ileti alır ve ardından değişken değerini my_transform.xsl tarafından biçimlendirilmiş bir iletiyle değiştirir. Giriş, <Source> öğesinde, çıkış ise <OutputVariable> öğesinde belirtilir.

<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/>

Değişken verileri işleme

Bir proxy'deki veri işleme genellikle durum verileriyle akış değişkeni değerleri olarak çalışmayı içerir. Bunu genellikle değişken değerlerini alan veya ayarlayan bir politika kullanarak yapabilirsiniz. Örneğin, değişken değerlerini bir mesaj haline getirmek veya değişken değerlerini ayarlamak için mesajın içeriğini ayıklamak isteyebilirsiniz.

Aşağıdaki iki politikayla ilgili referansları inceleyin:

Daha karmaşık dönüşümler oluşturma

Karmaşıklığı dahil edilen politikaların kapsamı dışında olan veri işleme için JavaScript, Java veya Python gibi prosedürel dilleri kullanabilirsiniz.

Genellikle bu işlem, aşağıdaki dillerden birinde kod yazmayı ve ardından dile özgü bir politikadan kodu çağırmayı içerir. Bu konu hakkında daha fazla bilgi için Prosedürel kod ekleme başlıklı makaleyi inceleyin.