اجزای اصلی یک پیام SOAP :
یک پیام SOAP ، یک فایل معمولی XML است که المنت های زیرا را حتما بایستی شامل شود :
- یک المنت به نام Envelope ، که تعیین می کند ، این سند XML یک پیام SOAP است .
- یک المنت Header که شامل اطلاعاتی کلی و پایه درباره پیام SOAP است .
- یک المنت Body که شامل اطلاعات اصلی و پیام SOAP است .
- یک المنت Fault که می تواند شامل error های احتمالی و اطلاعاتی درباره وضعیت پیام SOAP باشد .
هر یک از المنت های فوق را در یک بخش مجزا ، تشریح خواهیم کرد .
تمامی المنت های بالا و نحوه کارکرد آنها ، در یک NameSpace مشخص تعریف شده اند ، که با ارجاع سند در المنت Envelope به آدرس آن ، از خواص و تعاریف آن استفاده می شود .
لینک های ارجاع عبارتند از :
www.w3.org/2001/12/soap-envelope
www.w3.org/2001/12/soap-envelope
قوانین مهم در نوشتن پیام های SOAP :
- یک پیام SOAP حتما بایستی به زبان XML نوشته شده و انکد شود .
- یک پیام SOAP حتما بایستی دارای یک Envelope NameSpace باشد .
- یک پیام SOAP حتما بایستی از یک Encoding NameSpace استفاده کند .
- یک پیام SOAP ، نباید شامل DTD در XML یا کدهای پردازشی XML باشد .
نمونه کلی فایل XML یک پیام SOAP :
کد نمونه یک فایل SOAP |
<?xml version=”1.0″ ?> <soap:envelope xmlns:soap=”http://www.w3.org/2001/12/soap-envelope” soap:encodingstyle=”http://www.w3.org/2001/12/soap-encoding”> <soap:header> … بخش هدر </soap:header> <soap:body> … بخش بدنه <soap:fault> … بخش خطا های احتمالی </soap:fault> </soap:body> </soap:envelope> |