IBM MQ ileti üstbilgilerinin IBM MQ classes for Javaile işlenmesi

Java sınıfları, farklı tipte ileti üstbilgisi gösteririr. İki yardımcı sınıfı da sağlanır.

MQHeader arabirimi

Üstbilgi nesnelerine, üstbilgi alanlarına erişmek ve ileti içeriğini okumak ve yazmak için genel amaçlı yöntemler sağlayan MQHeader arabirimi tarafından açıklanmıştır. Her üstbilgi tipinin, MQHeader arabirimini gerçekleştiren kendi sınıfı vardır ve tek tek alanlar için alıcı ve ayarlayıcı yöntemleri ekler. Örneğin, MQRFH2 üstbilgi tipi MQRFH2 sınıfı tarafından gösterilir; MQDLH sınıfı tarafından MQDLH üstbilgisi ve benzeri bir üstbilgi tipi vardır. Üstbilgi sınıfları, gereken tüm veri dönüştürmeyi otomatik olarak gerçekleştirir ve belirtilen sayısal kodlama ya da karakter kümelerinde (CCSID) veri okuyabilir ya da veri yazabilir.

Önemli: MQRFH2 üstbilgi sınıfları, iletiyi rasgele erişim dosyası olarak kabul eder; bu da, imlecin iletinin başlangıcındaki konumlarına yerleştirilmesi gerektiği anlamına gelir. MQRFH, MQRFH2, MQCIH, MQDEAD, MQILH ya da MQXMIT gibi bir iç ileti üstbilgisi sınıfı kullanılmadan önce, iletiyi sınıfa iletmeden önce, iletinin imleç konumunu doğru yere güncellediğinizden emin olun.

Yardımcı sınıflar

İki yardımcı sınıfı, MQHeaderIterator ve MQHeaderList, iletilerde üstbilgi içeriğini okuma ve çözme (ayrıştırma) ile yardımcı olur:
  • MQHeaderIterator sınıfı java.util.Iterator gibi işlev görmektedir. İletide daha fazla üstbilgi olduğu sürece, next () yöntemi true değerini döndürür ve nextHeader () ya da next () yöntemi sonraki üstbilgi nesnesini döndürür.
  • MQHeaderList, java.util.List gibi çalışır. MQHeaderIterator gibi, üstbilgi içeriğini ayrıştırır, ancak aynı zamanda belirli üstbilgileri aramanıza, yeni üstbilgiler eklemenize, var olan üstbilgileri kaldırmanıza, üstbilgi alanlarını güncellemenize ve daha sonra, üstbilgi içeriğini bir iletiye geri yazmanıza da olanak tanır. Diğer bir seçenek olarak, boş bir MQHeaderList yaratabilir ve bunu üstbilgi örnekleriyle doldurup bir ya da sürekli olarak bir iletiye yazabilirsiniz.
MQHeaderIterator ve MQHeaderList sınıfları, belirli ileti tipleri ve biçimleriyle ilişkilendirilecek IBM® MQ üstbilgi sınıflarını öğrenmek için MQHeaderRegistry içindeki bilgileri kullanır. MQHeaderRegistry, tüm geçerli IBM MQ biçimleri ve üstbilgi tipleri ve bunların uygulama sınıfları bilgisiyle yapılandırılır ve kendi üstbilgi tiplerinizi kaydettirebilirsiniz.
Aşağıdaki yaygın olarak kullanılan IBM MQ üstbilgileri için destek sağlanır.
  • MQRFH-Kurallar ve biçimleme üstbilgisi
  • MQRFH2 - Like MQRFH, used to pass messages to and from a message broker belonging to IBM Integration Bus. İleti özelliklerini içermek için de kullanılır
  • MQCIH- CICS® Köprüsü
  • MQDLH-Ölü harf üstbilgisi
  • MQIIH- IMS bilgi üstbilgisi
  • MQRMH-başvuru iletisi üstbilgisi
  • MQSAPH- SAP üstbilgisi
  • MQWIH-İş bilgisi üstbilgisi
  • MQXQH-İletim Kuyruğu üstbilgisi
  • MQDH-Dağıtım üstbilgisi
  • MQEPH-Kapsüllenmiş PCF üstbilgisi
Ayrıca, kendi üstbilgilerinizin gösterildiği sınıfları da tanımlayabilirsiniz.

To use an MQHeaderIterator to get an RFH2 header, either set MQGMO_PROPERTIES_FORCE_MQRFH2 in the GetMessageOptions, or set the queue property PROPCTL to FORCE.