XML-RPC (сокр. от англ. Extensible Markup Language Remote Procedure Call — XML-вызов удалённых процедур) — стандарт/протокол вызова удалённых процедур, основанный на XML, является прародителем SOAP, отличается исключительной простотой применения. XML-RPC, как и любой другой интерфейс RPC, определяет набор стандартных типов данных и команд, которые программист может использовать для доступа к функциональности другой программы, находящейся на другом компьютере в сети.
Краткая история
Протокол XML-RPC был изначально разработан Дэйвом Винером из компании «UserLand Software» в сотрудничестве с Майкрософт в 1995 году. Однако корпорация Майкрософт вскоре сочла этот протокол слишком упрощённым, и начала расширять его функциональность. После нескольких циклов по расширению функциональности, появилась система, ныне известная как SOAP. Позднее Майкрософт начала широко рекламировать и внедрять SOAP, а изначальный XML-RPC был отвергнут. Но, несмотря на отвержение Майкрософт, стандарт XML-RPC очаровал многих программистов своей необычайной простотой и, за счёт этого, существует по сей день и даже постепенно набирает популярность.
Типы данных
| Имя типа | Пример тега | Описание типа |
|---|---|---|
| array | <array> <value><i4>1404</i4></value> <value><string>Что-нибудь здесь</string></value> <value><i4>1</i4></value> </array> | Массив величин, без ключей |
| base64 | <base64>eW91IGNhbid0IHJlYWQgdGhpcyE=</base64> | Кодированные в Base64 двоичные данные |
| boolean | <boolean>1</boolean> | Логическая (булева) величина (0 или 1) |
| date/time | <dateTime.iso8601>19980717T14:08:55</dateTime.iso8601> | Дата и время |
| double | <double>-12.53</double> | Дробная величина двойной точности |
| integer | <i4>42</i4> | Целое число |
| string | <string>Здравствуй, Мир!</string> | Строка символов (в той же кодировке, что и весь XML-документ) |
| struct | <struct> <member> <name>Что-то</name> <value><i4>1</i4></value> </member> <member> <name>Ещё что-то</name> <value><i4>2</i4></value> </member></struct> | Массив величин, с ключами |
| nil | <nil/> | Нулевая (пустая) величина — это расширение XML-RPC |
Примеры
Типичный пример запроса XML-RPC:
<?xml version=»1.0″?><methodCall> <methodName>examples.getStateName</methodName> <params> <param> <value><i4>41</i4></value> </param> </params></methodCall>
Типичный пример ответа на запрос XML-RPC:
<?xml version=»1.0″?><methodResponse> <params> <param> <value><string>South Dakota</string></value> </param> </params></methodResponse>
Типичный пример отчёта об ошибке в запросе XML-RPC:
<?xml version=»1.0″?><methodResponse> <fault> <value> <struct> <member> <name>faultCode</name> <value><int>4</int></value> </member> <member> <name>faultString</name> <value><string>Too many parameters.</string></value> </member> </struct> </value> </fault></methodResponse>
