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 gelen mesajları değiştirmek için Apigee Edge'deki politikaları kullanabilirsiniz. Politikalarla şunları yapabilirsiniz:

  • Mesajları biçimler arasında (ör. XML'den JSON'a) dönüştürün.
  • İleti içeriğinden değişken değerleri ayarlayın ve mesajları değişken değerlerden oluşturun.
  • Mesajları ve verileri daha karmaşık şekillerde işlemek için JavaScript, Java ve Python gibi prosedür 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 bölümde, söz konusu özellikler tanıtılmaktadır. Daha eksiksiz ve teknik bilgiler için her biriyle ilgili politika referanslarına bakın.

XML ve JSON için basit işleme

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

JSON'yi XML'e dönüştürme

JSON'den XML'e dönüştürme politikası, JSON girişinizi alıp XML'e dönüştürür.

Aşağıdaki politika örneğinde politika, request değişkeninden JSON biçimli bir mesaj alır, 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'yi JSON'a dönüştürme

XML'den JSON'ye politika, 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 mesaj alır, ardından değişken değerini JSON biçimli bir mesajla değiştirir. Giriş <Source> öğesinde belirtilirken, çıkış <OutputVariable> öğesinde belirtilir.

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

XML'yi XSL ile Dönüştürme

XSL kullanarak mesajları dönüştürmek için XSL Dönüştürme politikasını kullanabilirsiniz. Örneğin, bir JSON yükünü XML'e 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 mesaj alır, ardından değişken değerini my_transform.xsl tarafından biçimlendirilmiş bir mesajla değiştirir. Giriş <Source> öğesinde belirtilirken, çıkış <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 verilerini işleme

Proxy içinde veri işleme genellikle sadece akış değişken değerleri olarak durum verileriyle çalışmayı içerir. Bunu çoğu zaman değişken değerler alan veya belirleyen bir politika kullanarak yapabilirsiniz. Örneğin, değişken değerleri mesaja dönüştürmek veya değişken değerler ayarlamak için bir mesajın içeriğini çıkarmak isteyebilirsiniz.

Aşağıdaki iki politikaya ilişkin referansları gördüğünüzden emin olun:

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

Karmaşıklığı, dahil edilen politikaların sağlanamayacağı kadar karmaşık olan veri işleme için JavaScript, Java veya Python gibi prosedürel diller kullanabilirsiniz.

Genellikle bu, bu dillerden birinde kod yazılmasını ve ardından kodun ilgili dile özgü bir politikadan çağrılmasını içerir. Bu konu hakkında daha fazla bilgi için Prosedürel kodu ekleme bölümüne bakın.