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

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

API proxy'lerinizden gelen mesajları değiştirmek için Apigee Edge'e dahil olan politikaları kullanabilirsiniz. Politikalarla şunları yapabilirsiniz:

  • Mesajları XML'den JSON'a dönüştürme gibi biçimler arasında dönüştürme.
  • Mesaj içeriğinden değişken değerleri ayarlayın ve değişken değerlerden mesajlar 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. Apigee Edge, çalışma zamanında giriş değerini bir kaynak değişkenden alır ve çıkış değerini bir çıkış değişkenine yazar.

Bu konu, bu özellikleri tanıtır. Daha kapsamlı ve teknik bilgiler için her bir politikanın referanslarına bakın.

XML ve JSON için basit işleme

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

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

JSON'dan XML'e politika, 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 ve ardından değişken değerini XML biçimli bir mesajla değiştirir. Giriş <Source> öğesinde, çıkış ise <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 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ıp ardından değişken değerini JSON biçimli bir mesajla değiştirir. Giriş <Source> öğesinde, çıkış ise <OutputVariable> öğesinde belirtilir.

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

XML'i XSL ile dönüştürme

XSL'yi kullanarak iletileri 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 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 verilerini işleme

Proxy'de veri işleme genellikle durum verileriyle yalnızca akış değişkeni değerleri olarak çalışmayı içerir. Bunu genellikle değişken değerleri alan veya ayarlayan bir politika kullanarak yapabilirsiniz. Örneğin, değişken değerlerini bir mesaja dönüştürmek veya değişken değerlerini ayarlamak için bir mesajın içeriğini ayıklamak isteyebilirsiniz.

Aşağıdaki iki politikanın referanslarını mutlaka inceleyin:

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

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

Genellikle bu işlem, bu dillerden birinde kod yazmayı ve ardından dile özel bir politikadan kodu çağırmayı içerir. Bu konu hakkında daha fazla bilgi için Prosedürsel kod ekleme bölümüne bakın.