SABUN protokolü. Basit Nesne Erişim Protokolü (SOAP) Genel Açıklama

Hatanın nedeni ... İletinin dilini belirten isteğe bağlı bir xml:lang özniteliği (bkz. Bölüm D) ve hatayı açıklayan isteğe bağlı sayıda iç içe öğe içerir.

Isteğe bağlı öğeler.

? - hatayı fark eden ara SOAP düğümünün URI'si.

? - hatayı fark eden SOAP düğümünün rolü.

? - gövde işlenirken görülen hatanın açıklaması mesaj değil, başlık.

Liste 3.2, bir prosedürü yürütmeye çalışırken bir hata mesajı gösterir. Hata, prosedürün argümanlarının adlarının SOAP mesajında ​​doğru yazılmaması ve prosedürün bunları anlayamamasıdır.

Liste 3.2. Hata mesajı

xmlns: env = "http://www.w3.org/2002/06/soap-envelope" xmlns: rpc = 'http: //www.w3.org/2002/06/soap-rpc'>

env: Gönderen

rpc: BadArgumentsc / env: Değer>

Ptocessing ETror

xmlns: e = "http://www.example.org/faults"> No.me eşleşmiyor 999

Hata türleri

Hata kodlarının listesi sürekli değişiyor ve genişliyor. Sürüm 1.1, dört tür hata tanımlar.

VersionMismatch Ad alanı tanınmıyor. Belki eskidir veya adı yanlış yazılmıştır.

MustUnderstand - mustUnderstand özniteliği ile 1 değeriyle işaretlenmiş bir başlık bloğu, belge şemasında tanımlanan sözdizimine uymuyor.

İstemci - Mesajı içeren XML belgesi hatalı biçimlendirilmiş ve bu nedenle sunucu onu işleyemiyor. Müşteri mesajı değiştirmelidir.

Sunucu - sunucu, kendi dahili nedenlerinden dolayı doğru şekilde kaydedilmiş bir mesajı işleyemez.

Sürüm 1.2, beş tür hata tanımlar.

VersionMismatch Ad alanı tanınmıyor. Eski olabilir veya adı yanlış yazılmış olabilir veya mesajda bu ad alanında tanımlanmamış bir XML öğesi adı olabilir. Sunucu, öğeyi yanıt başlığına yazar iç içe öğeleri listeleme sunucu tarafından anlaşıldığı gibi doğru ad alanı adları. Sunucu yanıtı Liste 3.3'te gösterilmektedir.

MustUnderstand - mustunderstand özniteliği true olarak ayarlanmış bir başlık bloğu, belge şemasında tanımlanan sözdizimine uymuyor. Sunucu, yanıt başlığına öğeler yazar qname özniteliği geçersiz bloğun adını içerir. Liste 3.4, Liste 3.1'deki başlığın yanlış yazıldığı ortaya çıkarsa sunucunun vereceği yanıtın bir örneğini içerir.

DataEncodingUnknown - mesaj anlaşılmaz veriler içeriyor, belki bilinmeyen bir kodlamayla yazılmışlardır.

Gönderen - İletiyi içeren XML belgesi hatalı biçimlendirilmiş ve bu nedenle sunucu onu işleyemiyor. Müşteri mesajı değiştirmelidir.

Alıcı - sunucu, dahili nedenlerden dolayı doğru yazılmış bir mesajı işleyemiyor, örneğin gerekli XML ayrıştırıcısı eksik.

Sunucu, bu tür hatalara kendi türlerinden bazılarını ekleyebilir. Genellikle

standart türleri detaylandırırlar ve bunlarla ilgili mesajlar öğelerde görünür yukarıda Liste 3.2'de gösterildiği gibi.

? Liste 3.3. VersionMismatch türünde bir hata mesajı içeren sunucu yanıtı

xmlns: env = "http://www.w3.org/2002/06/soap-envelope">

xmlns: upg = "http://www.w3.org/2002/06/soap-upgrade">

xmlns: nsl = "http://www.w3.org/2002/06/soap-envelope" />

xmlns: ns2 = "http://schemas.xmlsoap.org/soap/envelope/" />

env: Sürüm Uyuşmazlığı

Sürüm uyuşmazlığı

Liste 3. 4. MustUnderstand hata mesajı ile sunucu yanıtı

xmlns: t = 'http: //some.com/transaction' />

env: Anlamak Zorundayım

Bir veya daha fazla zorunlu başlık anlaşılmadı

Edebiyat:

Khabibullin I. Sh. Java Kullanarak Web Servislerinin Geliştirilmesi. - SPb.: BHV-Petersburg, 2003 .-- 400 s: hasta.

Konu başlığı gerçekten bir soru çünkü Ben kendim ne olduğunu bilmiyorum ve ilk kez bu makale çerçevesinde onunla çalışmaya çalışacağım. Aşağıdaki kodun çalışacağını garanti edebileceğim tek şey, ancak cümlelerim yalnızca tüm bunları nasıl anladığımla ilgili varsayımlar ve tahminler olacaktır. O zaman hadi gidelim ...

Tanıtım

1. SABUN... Bir uzak prosedürü çağırmadan önce, bu çağrıyı bir SOAP XML dosyasında tanımlamanız gerekir. SOAP, web hizmetlerinde kullanılan birçok XML biçimlendirmesinden yalnızca biridir. HTTP üzerinden bir yere göndermek istediğimiz her şey önce bir XML SOAP açıklamasına dönüştürülür, ardından bir HTTP paketine konur ve TCP/IP üzerinden ağ üzerindeki başka bir bilgisayara gönderilir.
2. WSDL... Bir web servisi var, yani. yöntemleri uzaktan çağrılabilen bir program. Ancak standart, bu programa "evet, yanılmıyorsunuz - bu gerçekten bir web hizmetidir ve ondan bu tür yöntemleri çağırabilirsiniz" diyen bir açıklamanın eklenmesini gerektirir. Bu açıklama, WSDL gibi farklı bir biçime sahip başka bir XML dosyasıyla temsil edilir. Onlar. WSDL, yalnızca bir XML web hizmeti açıklama dosyasıdır ve başka bir şey değildir.

Genel yaklaşım

1. Web servisimizin arayüzünü tanımlayın
2. Bu arayüzü uygula
3. Web hizmetimizi başlatın
4. Bir istemci yazın ve gerekli web hizmeti yöntemini uzaktan çağırın

sunucu

Müşteri

Çözüm

Brett McLaughlin Çeviren İlya Chekmenev

SOAP, Basit Nesne Erişim Protokolüdür. Onu daha önce hiç duymadıysanız, medeniyetten uzak, vahşi bir yerde yaşıyor olmalısınız. Web programlamada tüm öfke haline geldi ve en son nesil web geliştirmede bu tür fanatizmle kullanılan web hizmetlerinin ayrılmaz bir parçası. .NET'i, Microsoft'un buluşu veya eşler arası "devrimi" duyduysanız, SOAP kullanan teknolojileri de duymuşsunuzdur (ne olduğunu bilmeseniz bile). öyle biri yok ama 2 MSDN destek sitesinde (http://msdn.microsoft.com/) binlerce sayfa bulunan Apache ve Microsoft'tan SOAP uygulamaları.

Bu yazıda size SOAP'ın ne olduğunu ve web programlama paradigmasının evriminde neden bu kadar önemli bir parçası olduğunu anlatacağım. Bu, temel bilgileri atlamanıza ve doğrudan SOAP araç setine atlamanıza yardımcı olacaktır. Ardından mevcut SOAP projelerine hızlı bir genel bakış sunacağım ve Apache uygulamasının daha derinlerine ineceğim. Bu makale, SOAP'ın tam resmini yeniden oluşturma iddiasında değil, kitabım Java ve XML 2. Baskı birçok boşluğu doldurdu. Bu makaleyi okuduktan sonra ortaya çıkan birçok sorunun cevabını kitapta bulacaksınız.

Tanıtım

Öncelikle SOAP'ın ne olduğunu anlamanız gerekir. W3C Görüşünün tamamını (ve çok uzun) http://www.w3.org/TR/SOAP adresinde okuyabilirsiniz. Sonra, tüm saçmalıkları ayırıp attıktan sonra, SOAP'ın sadece bir protokol olduğunu anlıyorsunuz. Dağıtılmış bir mimaride bir noktada bilgi alışverişinin gerekli olduğu fikrine dayanan basit bir protokoldür (kullanmak için yeni bir tane yazmaya gerek yoktur). Ayrıca, tıkanıklık olasılığının ve işleme süreçlerinde zorlukların olduğu sistemler için bu protokol, hafif olması ve minimum miktarda kaynak gerektirmesi nedeniyle çok faydalıdır. Son olarak, tüm işlemlerin HTTP üzerinden gerçekleştirilmesine izin verir, bu da güvenlik duvarı gibi zor şeyleri atlamayı ve düşünülemez sayıda bağlantı noktasının soketleri dinlemesini önlemeyi mümkün kılar. Ana şey, bunun farkına varmanızdır ve diğer her şey ayrıntıdır.

Tabii ki, bu detayları bilmek istersiniz ve onları görmezden gelmeyeceğim. SOAP belirtiminde üç temel bileşen vardır: bir SOAP zarfı, bir dizi şifreleme kuralı ve bir istek ile yanıt arasındaki iletişim aracı. Bir SABUN mesajını normal bir mektup gibi düşünelim. Posta pulu ve ön yüzünde adres yazılı zarflardaki bu eski şeyleri hala hatırlıyor musunuz? Bu benzetme, SABUN kavramını bir "zarf" olarak daha iyi görselleştirmenize yardımcı olacaktır. Şekil 12-1, bu benzetme biçiminde SOAP işlemlerini göstermektedir.

Şekil 12-1. SABUN mesaj süreci

Bu resmi göz önünde bulundurarak, SOAP spesifikasyonunun üç bileşenine bir göz atalım. Bu kavramı en iyi temsil eden örnekler vererek her birini kısaca açıklayacağım. Bu üç temel bileşen, SOAP'ı çok önemli ve anlamlı kılmaktadır. Hata işleme, çeşitli şifrelemeler için destek, parametre serileştirme ve çoğu durumda SOAP'ın HTTP üzerinden çalışması, onu diğer dağıtılmış protokol çözümlerinden daha çekici kılmaktadır. SOAP, kitabımda daha ayrıntılı olarak ele aldığım diğer uygulamalarla yüksek derecede birlikte çalışabilirlik sağlar. Şimdilik, SOAP'ın temel unsurlarına odaklanmak istiyorum.

Mektup

Bir SABUN zarfı, normal bir mektup zarfına benzer. Ana SABUN bölümünde, alıcı ve gönderen hakkında bilgilerin yanı sıra mesajın kendisiyle ilgili bilgiler de dahil olmak üzere şifrelenecek mesaj hakkında bilgiler içerir. Örneğin, bir SOAP zarf başlığı, bir mesajın nasıl işlenmesi gerektiğini gösterebilir. Bir uygulama bir mesajı işlemeye başlamadan önce, mesajı işleyip işleyemeyeceği de dahil olmak üzere mesaj hakkındaki bilgileri ayrıştırır. Standart XML-RPC çağrılarındaki durumun aksine (hatırlayın? XML-RPC mesajları, şifreleme, vb., her şey tek bir XML parçasında birleştirilir), SOAP ile, mesaj hakkında bir şeyler bulmak için mevcut işleme gerçekleşir. Tipik bir SOAP mesajı, alıcının mesajı işlemesine yardımcı olmak için bir şifre stili de içerebilir. Örnek 12-1, bir kodlama belirtimi ile biten bir SOAP zarfını göstermektedir.

Örnek 12-1: SABUN Zarfı

Gördüğünüz gibi, şifreleme, uygulamanın (özniteliğin değerini kullanarak) belirlemesini sağlayan zarfın içinde ayarlanır. kodlamaStyle), elemanda bulunan gelen mesajı okuyabilecek mi? Vücut... SOAP zarfının ad alanının doğru olduğundan emin olun, aksi takdirde mesajınızı alan SOAP sunucuları sürüm uyuşmazlığı hatası verir ve onlarla etkileşime geçemezsiniz.

şifreleme

SOAP'ın ikinci önemli unsuru, özel veri türlerini şifreleme yeteneğidir. RPC'de (ve XML-RPC), şifreleme yalnızca indirdiğiniz XML-RPC araç setinde desteklenen önceden tanımlanmış veri türleri üzerinde gerçekleştirilebilir. Diğer veri türlerini şifrelemek, RPC sunucusunu ve istemcisini kendiniz değiştirmenizi gerektirir. SOAP ile XML Şeması, yeni veri türlerini belirtmek için oldukça kolay bir şekilde kullanılabilir (yapıyı kullanarak). karmaşık tip kitabımın 2. Bölümünde tartışılmıştır) ve bu yeni türler, ana SOAP bölümünün bir parçası olarak XML'de temsil edilebilir. XML Schema ile entegrasyon sayesinde, bir SOAP mesajındaki her türlü veriyi bir XML Şeması içinde mantıksal olarak tanımlayarak şifreleyebilirsiniz.

Telefon etmek

Bir SOAP çağrısının nasıl çalıştığını anlamanın en iyi yolu, onu XML-RPC gibi aşina olduğunuz bir şeyle karşılaştırmaktır. Hatırlarsanız, XML-RPC çağrısı Liste 12-2'de gösterilen kod parçacığına benziyor.

Örnek 12-2. XML-RPC'de arama

Uçak bileti sipariş etmek için en basit programı oluşturdum. Şimdi SOAP'ta aramayı gösteren Örnek 12-3'e bir göz atın.

Örnek 12-3. SABUN Çağrısı

Gördüğünüz gibi, nesne tarafından temsil edilen gerçek çağrı Telefon etmek, bellekte yerleşiktir. Çağrının hedefini, çağrının yöntemini, kodlama stilini, parametreleri ve bu örnekte gösterilmeyen diğer birçok parametreyi belirlemenizi sağlar. XML-RPC yönteminden daha esnektir ve XML-RPC'de dolaylı olarak tanımlanmış bir dizi çeşitli parametreyi açıkça belirtmenize olanak tanır. Bu makalenin ilerleyen bölümlerinde, SOAP'ın geçersiz istekleri nasıl ele aldığı, hata hiyerarşisi ve tabii ki döndürülen çağrı sonuçları dahil, çağırma süreci hakkında daha fazla bilgi edineceksiniz.

Bu kadar kısa bir girişten sonra, zaten bu komik şeyle ilgilenecek kadar bilgi sahibisiniz. Şimdi size kullanacağım SOAP uygulamasını tanıtmama izin verin. Neden seçtiğimi açıklayacağım ve bazı kod örneklerini ele alacağım.

özelleştirme

Artık konsept hakkında temel bir anlayışa sahip olduğunuza göre, eğlenceli kısma geçme zamanı: programlama. Bunu yapmak için, ilk bakışta göründüğünden daha kolay bulunan uygun bir projeye veya ürüne ihtiyacınız var. SOAP yetenekleri sağlayan bir Java projesine ihtiyacınız varsa, onu uzun süre aramanız gerekmez. Ticari ve ücretsiz olmak üzere iki ürün grubu vardır. Kitabımda olduğu gibi ticari ürünlerden bahsetmekten kaçınacağım. Bu hiç de kötü olduklarından değil (tam tersine bazıları güzel), ancak herhangi bir okuyucunun verilen örneklerden herhangi birini denemesini istediğim için. Bunun nedeni, birçok ticari ürünün sahip olmadığı bulunabilirliktir. Bunları kullanmak için ödeme yapmanız veya indirdikten sonra sınırlı bir süre için geçici olarak kullanmanız gerekir.

Böylece açık kaynak projelerine sorunsuz bir şekilde yaklaştık. Bu alanda tek ürün var: Apache SOAP. http://xml.apache.org/soap adresinde bulunur ve Java için SOAP araç takımı sağlar. Bu yazının yazıldığı sırada Apache web sitesinden indirebileceğiniz 2.2 sürümü çıktı. Bu makale için örneklerde kullanacağım sürüm budur.

Diğer alternatifler

Apache SOAP'ı kurmaya ve yapılandırmaya geçmeden önce, aklınıza sızmış olabilecek birkaç soruyu yanıtlayacağım. Ticari ürünler kullanmama nedenlerini de gayet net bir şekilde açıkladım kanaatimce. Bununla birlikte, kullanmak istediğiniz başka açık kaynak projeleri veya ilgili projeleri düşünebilirsiniz ve bunlar hakkında herhangi bir yorum yapmamış olmama şaşırabilirsiniz.

IBM SOAP4J'ye ne dersiniz?

Alternatifler listesinde ilk sırada IBM'den bir uygulama var: SOAP4J. IBM'in çalışması, tıpkı IBM XML4J'nin şu anda Apache Xerces XML Ayrıştırıcı Projesi olarak bilinen projeye dönüşmesi gibi, Apache SOAP projesinin temelini attı. IBM uygulamasının Apache SOAP ile birleşecek şekilde yeniden tasarlanması bekleniyor. Kabaca aynı şey IBM'in XML4J'sinde de oldu: şimdi yalnızca Xerces'te paketleme sağlıyor. Bu yalnızca eğilimin altını çiziyor - büyük üreticiler genellikle OpenSource projelerini destekliyor ve kullanıyor, bu durumda her iki proje de (Apache ve IBM) aynı kod tabanını kullanıyor ...

Microsoft kenarda mı?

Tabii ki hayır. Microsoft ve SOAP uygulamasının yanı sıra tüm .NET alanı (kitabımda daha ayrıntılı olarak ele alınmıştır) önemlidir. Aslında, zamanımın çoğunu Microsoft'un SOAP uygulamasını ayrıntılı olarak incelemek istedim, ancak yalnızca onlar gibi COM nesnelerini destekliyor ve Java'yı desteklemiyor. Bu nedenlerle, Java ve XML ile ilgili bir makaleye böyle bir açıklama eklenememiştir. Yine de Microsoft (geliştiriciler olarak bu şirkete karşı sahip olduğumuz tüm iddialara rağmen) web servisleri alanında önemli çalışmalar yapmış ve sadece çıplak duygularla yönlendirilerek tereddüt etmeden reddederseniz hata yapmış olursunuz. COM veya Visual Basic bileşenleriyle çalışmanız gerekiyorsa, http://msdn.microsoft.com/library/default.asp?url=/nhp/Default.asp adresinde bulunan Microsoft SOAP araç setini kullanmayı denemenizi şiddetle tavsiye ederim. ? contentid = 28000523, diğer birçok SOAP kaynağıyla birlikte.

Eksen nedir?

Apache'yi takip edenleriniz Apache Axis'i duymuş olmalı. Axis, Apache XML çatısı altında geliştirilen yeni nesil bir SOAP araç takımıdır. Son yıllarda hızla ve radikal bir şekilde gelişen SOAP'ın (belirli bir uygulama değil, bir spesifikasyon) takip edilmesi çok zordur. Mevcut gelişen gereksinimlerle tamamen uyumlu bir SOAP sürümü oluşturmaya çalışmak da zordur. Sonuç olarak, Apache SOAP'ın mevcut sürümü, tasarım kısıtlamalı bir çözüm sunar. Mevcut aracı tamamen tersine çevirmeye çalışmamaya karar veren Apache geliştiricileri, yeni koda dayalı bir proje oluşturmaya başladılar. Eksen doğdu. SOAP adı da önce SOAP'tan XP'ye ve ardından XMLP'ye değişti. Daha sonra yeni SABUN'un adından şartnamenin adı çıkarılmış ve "Axis" adı doğmuştur. Ancak şimdi W3C, SOAP spesifikasyonunun (sürüm 1.2 veya 2.0) ismine geri dönüyor gibi görünüyor, bu nedenle işler hala değişebilir ve daha fazla karışıklık olacak!

IBM SOAP4J'yi bir SOAP araç mimarisi olarak mı düşünüyorsunuz? Bir mimari olarak Apache SOAP'a (bu makalede ele alınan) ne dersiniz? Ve Eksen mimari # 3, yeni nesil mimaridir. Bu proje SAX kullanıyor, Apache SOAP ise DOM tabanlı. Ek olarak, Axis, Apache SOAP'tan daha kullanıcı dostu bir yaklaşım sunar. Bu değerleri sıraladıktan sonra, konu olarak neden Axis'i seçmediğimi merak edebilirsiniz. Sadece biraz erken olurdu. Şu anda yalnızca 0.51 Axis sürümü yayınlanmak üzere hazırlanıyor. Henüz beta değil, alfa sürümü bile değil. Axis için yeni özelliklerin ana hatlarını vermeyi çok isterim, ancak kritik sistem ihtiyaçlarınız için alfanın altındaki açık kaynak yazılımları kullanabileceğiniz konusunda yönetiminizi ikna etme şansınız olmaz. Bu yüzden senin gerçek olduğun bir şeye odaklanmaya karar verdim. kullanabilirsinizçoktan bugün- Apaçi SABUNU. Apache Axis'in son sürümü yayınlandığında, bu materyali kitabımın bir sonraki baskısında güncelleyeceğimi düşünüyorum. O zamana kadar, zaten mevcut olan çözüme odaklanalım.

Kurulum

SOAP kurulumunun iki şekli vardır. Birincisi, SOAP mesajlarını kabul edebilen bir sunucuyla iletişim kurmak için SOAP API'sini kullanarak bir SOAP istemcisi başlatmaktır. İkinci yol, SOAP istemcisinden mesaj alabilen bir SOAP sunucusu başlatmaktır. Bu bölümde, her iki prosedürü de açıkladım.

Müşteri

SOAP istemcisini kullanmak için önce http://xml.apache.org/dist/soap adresinde bulunan Apache SOAP'ı indirmeniz gerekir. 2.2 sürümünü ikili biçimde indirdim (alt dizinden sürüm-2.2). Ardından, arşivin içeriğini bilgisayarınızdaki bir dizine açmalısınız. Benim durumumda, dizindi javaxml2 (c: \ javaxml2 Windows bilgisayarımda, / javaxml2 Mac OS X bilgisayarımda). Sonuç olarak, dosyalar açıldı / javaxml2 / sabun-2_2... Ayrıca, http://java.sun.com/products/javamail/ adresindeki Sun'ın sunucusunda bulunan JavaMail paketini de indirmeniz gerekecektir. Apache SOAP tarafından kullanılan SMTP aktarım protokolünün desteklenmesi gerekecektir. Ardından, yine Sun'ın sunucusundan http://java.sun.com/products/beans/glasgow/jaf.html adresinde bulunan Java Beans Activation Framework'ü (JAF) indirin. Halihazırda Xerces veya başka bir XML ayrıştırıcısının kurulu ve kullanıma hazır olduğunu varsayarsak.

Not: XML ayrıştırıcınızın JAXP uyumlu olduğundan ve doğru ad alanını kullandığından emin olun. Ayrıştırıcınız büyük olasılıkla bu gereksinimleri karşılamaktadır.Sorun yaşıyorsanız, Xerces kullanmaya geri dönmek en iyisidir.

Not: Xerces'in en son sürümlerini kullanın. Sürüm 1.4 veya üzeri işinizi görecektir. SOAP ve Xerces 1.3 (.1)'de bir takım buglar var, bu yüzden bu kombinasyonu kullanmamanızı tavsiye ederim.

JavaMail ve JAF paketlerini açın ve jar dosyalarını kütüphanenin yanı sıra sınıf yolunuza ekleyin sabun. kavanoz... Bu jar dosyalarının her biri, ilgili programın kök dizininde veya bir alt dizinde bulunmalıdır. / lib... Tamamlandığında, değişkeniniz sınıf yoluşöyle görünmeli:

Windows için şöyle görünecek:

Son olarak, dizini ekleyin javaxml2 / sabun-2_2 / senin içinde sınıf yolu SOAP örneklerini çalıştırmak için. Bu bölümde birkaç örnek için özelleştirmeyi anlattım.

sunucu

SOAP uyumlu bir sunucu bileşenleri seti oluşturmak için önce bir sunucu uygulaması motoruna ihtiyacınız vardır. Önceki bölümlerde olduğu gibi, bu bölüm için örnek olarak Apache Tomcat'i (http://jakarta.apache.org/ adresinde mevcuttur) kullandım. Müşterinin ihtiyaç duyduğu her şeyi eklemeniz gerekecek sınıf yolu sunucu. Bunu yapmanın en kolay yolu sıfırlamaktır. sabun. kavanoz, aktivasyon.jar ve mail.jar, ayrıştırıcınızın yanı sıra servlet motorunuzun kitaplık dizinine. Tomcat için bu, otomatik yükleme için kitaplıkları içeren / lib dizinidir. Komut dosyası desteği sağlamak istiyorsanız (bu bölümde tartışılmamaktadır, ancak Apache SOAP örneklerinde bulunmaktadır), bsf.jar(http://oss.software.ibm.com/developerworks/projects/bsf adresinde mevcuttur) ve js.jar(http://www.mozilla.org/rhino/ adresinde mevcuttur) aynı dizine.

Not: Xerces'i Tomcat ile kullanıyorsanız, Bölüm 10'da anlattığım numarayı tekrarlamanız gerekecek. ayrıştırıcı.jar v z_parser.jar, a jaxp.jar v z_jaxp.jar emin olmak için xerces.jar ve JAXP'nin dahil edilen sürümü, diğer herhangi bir ayrıştırıcı veya JAXP uygulamasından önce yüklenir.

Ardından, servlet motorunuzu yeniden yükleyin, ardından SOAP sunucu bileşenlerini yazmaya hazırsınız.

Yönlendirici Sunucu Uygulaması ve Yönetici İstemcisi

Temel işlemlerin yanı sıra Apache SOAP, bir yönetici istemcisinin yanı sıra bir yönlendirici sunucu uygulaması içerir. Kullanmayacak olsanız bile SOAP'ın doğru kurulup kurulmadığını test etmek için kurmanızı tavsiye ederim. Bu işlem hangi sunucu uygulaması motorunu kullandığınıza bağlıdır, bu nedenle kendimi Tomcat için yükleme işlemini açıklamakla sınırlayacağım. Diğer sunucu uygulaması motorlarından bazıları için kurulum talimatları http://xml.Apache.org/soap/docs/index.html adresinde bulunabilir.

Tomcat altında kurulum çok kolaydır: sadece dosyayı alın sabun.savaş dizinden sabun-2_2 / webapps ve dizine bırakın $ TOMCAT_HOME / web uygulamaları- bu kadar! Kurulumu kontrol etmek için adresi tarayıcıya girin http: // localhost: 8080 / sabun / sunucu uygulaması / rpcrouter... Şekil 12-2 gibi bir yanıt almalısınız.

Şekil 12-2. RPC yönlendirici sunucu uygulaması

Mesaj bir hata mesajı gibi görünse de her şeyin doğru çalıştığını gösterir. Tarayıcınızda yönetici istemci adresini belirterek aynı yanıtı almalısınız: http: // localhost: 8080 / sabun / sunucu uygulaması / mesaj yönlendirici.

Sunucu ve istemci testinizi tamamlamak için tüm talimatları eksiksiz uyguladığınızdan emin olun. Ardından, RPC yönlendirici sunucu uygulaması için sunucu uygulaması URL'nizi korumak için aşağıda gösterildiği gibi aşağıdaki Java sınıfını çalıştırın:

Yukarıda gösterildiği gibi boş bir hizmet listesi almalısınız. Herhangi bir mesaj alırsanız, http://xml.Apache.org/soap/docs/trouble/index.html adresinde bulunan olası hataların uzun listesine bakın. Bu, karşılaşabileceğiniz sorunların en kapsamlı listesidir. Boş bir liste alırsanız, yapılandırma tamamlanmıştır ve bu bölümdeki örneklere bakmaya hazırsınız demektir.

Başlayalım

Herhangi bir SOAP tabanlı sistem yazmanın üç ana adımı vardır. Listeledikten sonra, her birine kısaca odaklanacağım:

• SOAP-RPC ve SOAP mesajları arasında seçim;
• SOAP hizmeti yazmak veya erişmek;
• SOAP istemcisi yazma veya erişme.

İlk adım, RPC çağrıları (uzaktan prosedürün sunucuda yürütüldüğü yer) veya mesajlar (istemcinin yalnızca sunucuya bilgi parçalarını gönderdiği yer) için SOAP kullanıp kullanmayacağınızı seçmektir. Bu süreçleri aşağıda ayrıntılı olarak tartışıyorum. Bu kararı verdikten sonra, kendi hizmetinize erişmeniz veya oluşturmanız gerekecektir. Tabii ki, hepimiz Java uzmanı olduğumuz için bu bölüm size kendinizinkini nasıl oluşturacağınızı gösterecektir. Ve son olarak, bu hizmet için bir istemci yazmanız gerekiyor, hepsi bu kadar!

RPC veya Mesajlaşma?

İlk görevinizin programlama ile hiçbir ilgisi yoktur ve daha çok tasarım niteliğindedir. RPC hizmetini mi yoksa mesajları mı kullanacağınızı seçmeniz gerekir. RPC'ye aşina olduğunuzu varsayalım (örneğin, kitabımın bölümlerinden birini okuduktan sonra). İstemci, sunucuda bir uzak prosedür yürütür ve ardından bir yanıt alır. Bu senaryoda, SOAP, daha iyi hata işleme ve ağ üzerinden karmaşık veri türlerinin aktarımını sağlayan zengin bir XML-RPC sistemi görevi görür. Bu konsepte zaten aşinasınız ve RPC sistemlerini SOAP'ta yazmak daha kolay olduğu için onlarla başlayacağım. Bu makalede, bir RPC hizmetinin, bir RPC istemcisinin nasıl oluşturulacağı ve sistemin nasıl kurulup çalıştırılacağı anlatılmaktadır.

SABUN'un başka bir tarzı mesajlaşmadır. Uzaktan prosedürler gerçekleştirmek yerine, yalnızca bilgi alışverişi için kullanılır. Tahmin edebileceğiniz gibi, bu, istemcinin herhangi bir sunucunun bireysel yöntemlerini bilmesini gerektirmeyen güçlü bir araçtır. Ayrıca, veri paketlerinin (mecazi olarak, ağ bağlantılı değil) diğer sistemlere iletim için kullanılmasına izin vererek uzak sistemlerin modellenmesini daha izole hale getirir. Aynı zamanda diğer sistemlerin bu verilerle gerçekleştirilen işlemleri bilmesine gerek yoktur. Bu stil, RPC programlamasından daha karmaşıktır, bu yüzden onu burada tekrarlamayacağım. Bunu, işletmeler arası etkileşimlerin diğer ayrıntılarıyla birlikte kitabımda bulacaksınız. İlk olarak, SOAP-RPC programlamaya bir göz atın.

Çoğu tasarım problemi gibi, bu karar tamamen size kalmış. Uygulamanızı analiz edin ve SOAP'ı ne için kullanmanız gerektiğini belirlemeye çalışın. İsteğe bağlı olarak belirli iş işlevlerini gerçekleştiren bir sunucunuz ve bir dizi istemciniz varsa, RPC sizin için daha uygundur. İletişimin sadece talep üzerine belirli iş fonksiyonlarını yerine getirmekten daha fazlası olduğu karmaşık sistemlerde, SOAP mesajları daha çok tercih edilir.

RPC hizmeti

Formaliteler bittiğine göre artık harekete geçme zamanı. Bildiğiniz gibi, RPC'de yöntemleri uzaktan yürütülecek sınıflara ihtiyacınız var.

kod parçacıkları

Sunucunun kod parçacıklarına bakarak başlayacağım. Bu parçacıklar, RPC istemcileri için yürütülen yöntemlere sahip sınıflardır. Örnek olarak kitabımdan kod kullandım. Basit sınıflar kullanmak yerine, SOAP'ın gücünü olabildiğince açık bir şekilde göstermek için daha karmaşık bir örnek seçtim. Bu yüzden örnek olarak CD sınıfını kullandım. İlk önce elementi tanımlıyoruz. harita standart olmayan her parametre türü için. öznitelik için kodlamaStyle en azından Apache SOAP 2.2'de. http://schemas.xmlsoap.org/soap/encoding/ değerini vermelisiniz. Şu anda, desteklenen tek kodlama budur. Kullanıcı tanımlı tür için bir ad alanı ve ardından bu tür için bir ad alanı öneki ile sınıf adı sağlamanız gerekir. Bizim durumumuzda, bu amaçlar için hayali bir ad alanı ve basit bir önek kullandım " x". Ardından özniteliği kullanarak javaType, Java sınıfının gerçek adını ayarlayın (bu durumda - javaxml2.CD). Ve son olarak, niteliklerle kuralesil java2XMLSınıfAdı ve xml2JavaSınıfAdı... Java'dan XML'e veya tam tersi şekilde dönüştüren bir sınıfı tanımlamak için kullanılırlar. Apache SOAP'ta da bulunan son derece kullanışlı BeanSerializer sınıfını kullandım. Özel parametreniz JavaBean biçimindeyse, bu seri hale getirici ve seri hale getirici, sizi kendinizinkini yazma zahmetinden kurtaracaktır. Varsayılan kurucuya sahip bir sınıfa ihtiyacınız var (unutmayın, CD sınıfı için herhangi bir parametre olmadan basit bir kurucu ayarladım) ve bu sınıfın tüm verilerini yöntemleri kullanarak yayınlayın. setXXX ve almakXXX... sınıftan beri CD tüm bu gereksinimleri mükemmel bir şekilde karşılar, BeanSerileştirici mükemmel çalışıyor.

Not: ne sınıf CD gereksinimleri karşılar BeanSerileştirici... gerçekten önemli değil. Sınıfların çoğu kolayca bu biçime dönüştürülebilir. Bu nedenle, kendi serileştiricilerinizi ve serileştiricilerinizi yazmaktan kaçınmanızı tavsiye ederim. Bu ekstra bir baş ağrısıdır (karmaşık bir şey değil ama çok zahmetli) ve biraz enerji tasarrufu yapmanızı ve özel parametrelerinizde çöp kutusu dönüştürmeyi kullanmanızı öneririm. Çoğu durumda, fasulye dönüşümleri, sınıfınızda yalnızca varsayılan bir kurucu (parametre yok) gerektirir.

Şimdi yeniden oluşturalım kavanoz hizmetimizi dosyalayın ve yeniden konumlandırın:

Dikkat: Sunucu uygulaması motorunuzu çalışır durumda bırakır ve hizmeti aynı anda yeniden konumlandırırsanız, SOAP hizmeti için yeni sınıfları etkinleştirmek ve hizmeti yeniden konumlandırmak için sunucu uygulaması motorunu yeniden başlatmanız gerekir.

Şimdi, yeni sınıfları ve yöntemleri kullanmak için istemciyi değiştirmeye devam ediyor. Örnek 12-10, istemci sınıfının değiştirilmiş bir sürümünü içerir CDAdder... Önceki sürümde yapılan değişiklikler vurgulanır.

Örnek 12-10: Güncellenmiş CDAdder sınıfı

Gerçekten ilginç olan tek değişiklik, sınıfın gösterimi ile ilgili. CD:

Bu, özel bir parametrenin ağ üzerinden nasıl kodlanabileceği ve aktarılabileceğidir. Sana zaten sınıfın nasıl olduğunu söyledim BeanSerileştirici sınıf gibi JavaBean formatında parametreleri işlemek için kullanılabilir CD... Onları sunucuya yönlendirmek için bir dağıtım tanımlayıcısı kullandım, ancak şimdi istemciye bu serileştiriciyi ve seri kaldırıcıyı kullanmasını söylemem gerekiyor. Bu işlev sınıf tarafından gerçekleştirilir. SABUNHaritalamaKayıt Defteri... Yöntem mapTypes ()şifreli bir dize alır (yine bunun için sabiti kullanmak daha iyidir NS_URI_SOAP_ENC) ve özel serileştirmenin kullanılması gereken parametrenin türü hakkında bilgi. Önce QName belirtilir. Bu nedenle dağıtım tanımlayıcısında garip bir ad alanı kullanıldı. Burada aynı URN'yi ve yerel öğe adını (bu örnek için "CD"), ardından Java nesnesini belirtmeniz gerekir. Sınıf seri hale getirilecek sınıf ( CD.sınıf) ve son olarak serileştirme ve seri durumdan çıkarma için sınıfın bir örneği. Bu örnek için, her iki durumda da bir örnek olacak BeanSerileştirici... Tüm bu ayarlar kayıt defterine girildikten sonra bunu nesneye bildirin. Telefon etmek yöntemi kullanmak setSOAPMapping-Registry ().

Bu sınıfı daha önce gösterildiği gibi bir CD ekleyerek çalıştırabilirsiniz ve her şey beklendiği gibi çalışmalıdır:

sınıf değişikliğini bıraktım CDLister Senin için. Her şey aynı düzeni takip ediyor. Kendinizi test etmek için kitabımdaki bu güncellenmiş sınıfları içeren örneklerle dosyalara başvurabilirsiniz.

Not: Buna dersten itibaren karar verebilirsiniz. CDLister doğrudan nesne ile etkileşime girmez CD(yönteme göre döndürülür liste ()önemli olan tür Hashtable), o zaman herhangi bir değişiklik yapmanız gerekmez. Ancak, döndürülen sınıf Hashtable nesne örnekleri içerir CD... SOAP bunları nasıl seri durumdan çıkaracağını bilmiyorsa, istemci bir hata mesajı verir. Bu durumda, sorunu çözmek için nesnede belirtmeniz gerekir. Telefon etmek kopyalamak SABUNHaritalamaKayıt Defteri.

Verimli hata işleme

Artık özel nesnelere, RPC çağrıları yapmaya vb. aşina olduğunuza göre, daha az heyecan verici bir konudan bahsetmeme izin verin: hata işleme. Herhangi bir ağ işleminde birçok hata meydana gelebilir. Hizmet başlamıyor, sunucuda bir hata var, nesne bulunamıyor, sınıflar eksik ve daha birçok sorun var. Şimdiye kadar sadece yöntemi kullandım hata.getString () hata mesajları oluşturmak için. Ancak bu yöntem her zaman yardımcı olmayabilir. Eylem halinde görmek için yapıcıdaki yorumu temizleyin CDKatalog:

Yeniden derleyin, sunucu uygulaması motorunu yeniden başlatın ve yeniden bölümlere ayırın. Bu bir istisna ile sonuçlanacaktır. NullPointerException bir sınıf kurucusu başlatılmamış bir CD'ye bir CD eklemeye çalıştığında Hashtable... İstemciyi başlatırken bir hata mesajı görünecektir, ancak çok bilgilendirici olmayacaktır:

Bu, hatayı tespit etmenize ve düzeltmenize yardımcı olabilecek türden bilgiler değildir. Ancak, çerçeve hataları ele alma konusunda iyi bir iş çıkarır. Hatırlıyor musun DOMFaultListeneröğe değeri olarak belirlediğiniz hata Dinleyici? Oyuna girme zamanı gelmişti. Hata durumunda döndürülen nesne Arıza DOM'yi (Belge Nesne Modeli) içerir org.w3c.dom.Öğe Hata hakkında ayrıntılı bilgi ile. Önce import ifadesini kaynak kodunuza ekleyin java.util.Iterator:

Şimdi list() yöntemindeki hataları işlemek için değişiklikler yapalım:

Yöntemi kullanma getDetailEntries () desteklenen bir SOAP hizmetine ve sorunla ilgili bilgiler içeren ham veri sunucusuna erişirsiniz. Kod onları yeniden işler (genellikle yalnızca bir öğe vardır, ancak yakın dikkat gerektirir) ve DOM'yi yakalar eleman her girişte yer alır. Temel olarak, işte çalıştığınız XML:

Başka bir deyişle, Fault nesnesi, SOAP zarfının hatalar içeren kısmına erişmenizi sağlar. Apache SOAP ayrıca hata olması durumunda bunları düzeltmek için gereken ayrıntılı bilgileri sağlayan bir Java yığın izlemesi sağlar. Bir elemanı yakalayarak yığın izleme ve düğüm değerini yazdırma Metin bu öğeden müşteriniz bir sunucu yığını izlemesi yazdırabilir. Bu değişiklikleri derlemek ve istemciyi yeniden başlatmak size aşağıdaki çıktıyı verecektir:

Bu çok daha iyi değil, ama en azından bir istisna atıldığına dair güzel bilgiler görebilirsiniz. NullPointerException hatta bu sorunun oluştuğu sunucu sınıflarındaki satır numaralarını bile bulun. Bu son değişikliklerin sonucu, hata işleme sorununu görsel olarak anlamanızı sağlamıştır. Şimdi sunucu sınıflarınızı hatalar için kontrol etmelisiniz. Evet, neredeyse unutuyordum, ondan önce, sınıfını geri değiştirmeyi unutma CDKatalog netlik için bilerek yaptığımız hatalardan kurtulmak için!

1. SOAP'ı SMTP (hatta Jabber) gibi diğer protokoller üzerinde çalıştırmak hakkında çok fazla konuşma var. SOAP standardı henüz bunu sağlamamaktadır, ancak gelecekte benzer yetenekler eklenebilir. Bu nedenle, bu konuda aktif tartışmalarla karşılaşırsanız şaşırmayın.

SABUN nedir?

SOAP, Basit Nesne Erişim Protokolü anlamına gelir. Umarım makaleyi okuduktan sonra sadece şaşıracaksınız: "Bu garip isim nedir?"

Mevcut haliyle SOAP, bir ağ üzerinden bir Uzaktan Yordam Çağrısı (RPC) yöntemidir. (Evet, belgeleri XML olarak aktarmak için de kullanılır, ancak şimdilik bunu atlayacağız.)

Anlayalım. Belirli bir hisse senedi sembolü için hisse senedi fiyatı döndüren bir hizmetiniz olduğunu hayal edin. Nasdaq sitesine veri gönderir ve döndürülen HTML'ye göre istenen sonucu üretir. Ayrıca, diğer geliştiricilerin kendi uygulamalarında kullanmasına izin vermek için bu hizmeti İnternet üzerinden teklifler hakkında bilgi bulan bir bileşene dönüştürürsünüz. Bir gün Nasdaq sayfalarının düzenini değiştirene kadar harika çalışıyor. Bileşenin tüm mantığını gözden geçirmeniz ve onu kullanan tüm geliştiricilere güncellemeler göndermeniz gerekir. Ve sırayla, tüm kullanıcılarına güncelleme göndermeleri gerekiyor. Bu düzenli olarak az ya da çok olursa, diğer geliştiriciler arasında çok sayıda düşman edinebilirsiniz. Ve programcılarda bildiğiniz gibi şakalar kötüdür. Yarın ofis öğütücüsünden sevgili kedinizin fotoğrafını çekmek istemezsiniz, değil mi?

Ne yapalım? Bir bakalım ... tek ihtiyacınız olan, girdi olarak (dize türünden) bir kayan nokta alacak ve bir hisse senedi fiyatı (kayan veya çift türden) döndürecek bir işlev sağlamak. Öyleyse, geliştiricilerinizin bu işlevi İnternet üzerinden bir şekilde çağırmasına izin vermek daha kolay olmaz mıydı? İyi! Ayrıca benim için bir haber var, bunu yıllardır yapan COM ve Corba ve Java var ... bu doğru, ancak bu yöntemler hatasız değil. Uzak COM yapılandırması önemsiz değildir. Ayrıca, güvenlik duvarında açılacak o kadar çok port var ki, bira sysadmin'ine doyamazsınız. Evet ve Windows dışındaki tüm işletim sistemlerinin kullanıcılarını unutmanız gerekecek. Ancak Linux kullanıcıları bazen değiş tokuşla da ilgileniyorlar.

DCOM kullanan Linux kullanıcıları için her şey kaybolmamış gibi görünse de, burada daha fazlası var: http://www.idevresource.com/com/library/res/articles/comonlinux.asp.

Corba ve Java hakkında söyleyebileceğim pek bir şey yok, bu yüzden bir alıştırma olarak okuyucuları bu yaklaşımların olumsuz taraflarını bulmaya davet ediyorum.

SOAP, böyle bir uzaktan çağırmayı ve sonucun ne türde döndürüleceğini tanımlamanıza izin veren bir standarttır. Bu nedenle, işlevinizi şebeke üzerinden erişilebilen bir uygulamaya yerleştirmeniz ve aramaları SOAP paketleri şeklinde almanız gerekir. Bundan sonra girişi doğrular, işlevinizi çalıştırır ve sonucu yeni bir SOAP paketinde döndürürsünüz. Tüm süreç HTTP üzerinden çalıştırılabilir, bu nedenle güvenlik duvarınızda bir sürü bağlantı noktası açmanız gerekmez. Basit, değil mi?

Bu makale ne hakkında

Sabun ve XML

Tüm SOAP paketleri XML formatındadır. Bunun anlamı ne? Görelim. Bu fonksiyona bir göz atın (Pascal):
function GetStockQuote (Sembol: dize): double; Harika görünüyor, ama sorun şu ki Pascal. Bir Java geliştiricisi için bu basit tanımın kullanımı nedir? Veya VB ile çalışan biri için? Herkesin, hatta VB programcılarının bile anlayacağı bir şeye ihtiyacımız var. Bu yüzden onlara aynı bilgileri (parametreler, alıntı değerleri, vb.) içeren XML verin. Temelde işlevinize yapılan bir çağrı olan ve herhangi bir platformdaki herhangi bir uygulamanın anlayabilmesi için XML'e sarılmış bir SOAP paketi oluşturursunuz. Şimdi SOAP çağrımızın neye benzediğini görelim:
xmlns: xsi = "http://www.w3.org/1999/XMLSchema-instance"
xmlns: xsd = "http://www.w3.org/1999/XMLSchema">

IBM


Bilgilendirici, değil mi? SABUN gözlerimizin önünde basitleştirilmiştir. Tamam şaka bir yana. Şimdi sizlere bu SABUN çağrısını nasıl anlamanız gerektiğini açıklamaya çalışacağım.

Etiketlerin kodunu çözme