Introduction to XML-RPC and SOAP Programming Guide
Contents:
Who Should Read This Document
Organization of This Document
XML-RPC and SOAP Programming Guide describes how to use Apple Script and the Apple Event Manager in Mac OS X to make remote procedure calls using the XML-RPC and SOAP (Simple Object Access Protocol) protocols.
XML-RPC is a protocol for using XML and HTTP to make remote procedure calls over the Internet. SOAP (Simple Object Access Protocol) is a remote procedure call protocol designed for exchanging information in a distributed environment, where a server may consist of a hierarchy of objects.
This book describes only how to send XML-RPC and SOAP requests, not how to serve them.
Note: Web service protocols such as XML-RPC and SOAP are evolving, as is the support for them in Mac OS X. The scripts and code samples in this document depend on third-party web services that are also subject to change. Though the samples have been tested as published, your experience may vary.
The sample code in this book can be adapted for Carbon applications, Cocoa applications, simple tools, or other code. However, there is no specific Cocoa class support provided.
Who Should Read This Document
To take full advantage of this document, you should be familiar with AppleScript, either through writing AppleScript scripts or creating scriptable applications. You can learn more about these topics in AppleScript Documentation. In particular, see AppleScript Overview and Apple Events Programming Guide.
You should also be familiar with the XML-RPC and SOAP protocols. You can find information on these protocols at third-party websites. For example, the XML-RPC specification is currently described at http://www.xmlrpc.com/spec and the SOAP specification at http://www.w3.org/TR/.
Organization of This Document
This document is organized into the following chapters:
“About AppleScript’s Support for XML-RPC and SOAP” provides a brief introduction to the XML-RPC and SOAP protocols, then describes the scripting support in Mac OS X version 10.1 (and later) for these protocols, including the syntax for script statements and the APIs for making remote procedure calls from applications or other code.
“Making Remote Procedure Calls From Scripts” provides sample scripts and step by step descriptions for making XML-RPC and SOAP requests from scripts.
“Making Remote Procedure Calls From Applications” provides sample code and step by step descriptions for making XML-RPC and SOAP requests from applications and other code.
“Document Revision History” describes the history of this book.
© 2001, 2005 Apple Computer, Inc. All Rights Reserved. (Last updated: 2005-03-03)