`xmlrpc.client.md`

425 строк · 32.4 КБ · обычная страница · сырой текст · скачать
1> **Источник:** https://python-all.ru/3.6/library/xmlrpc.client.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# 21.26. [`xmlrpc.client`](https://python-all.ru/3.6/library/xmlrpc.client.html#module-xmlrpc.client) – клиентский доступ XML-RPC89**Исходный код:** [Lib/xmlrpc/client.py](https://python-all.ru/src/3.6/Lib/xmlrpc/client.py)1011---1213XML-RPC – это метод удалённого вызова процедур (Remote Procedure Call), использующий XML, передаваемый через HTTP(S) в качестве транспорта. С его помощью клиент может вызывать методы с параметрами на удалённом сервере (сервер задаётся URI) и получать структурированные данные. Этот модуль предназначен для написания кода XML-RPC клиента; он берёт на себя все детали преобразования между совместимыми объектами Python и XML, передаваемыми по сети.1415> **Предупреждение**16>17> Модуль [`xmlrpc.client`](https://python-all.ru/3.6/library/xmlrpc.client.html#module-xmlrpc.client) не защищён от вредоносных данных. Если требуется разбирать непроверенные или неаутентифицированные данные, см. [уязвимости XML](https://python-all.ru/3.6/library/xml.html#xml-vulnerabilities).1819Изменено в версии 3.5: Для HTTPS URI [`xmlrpc.client`](https://python-all.ru/3.6/library/xmlrpc.client.html#module-xmlrpc.client) теперь по умолчанию выполняет все необходимые проверки сертификата и имени хоста.2021#### `class xmlrpc.client.ServerProxy(uri, transport=None, encoding=None, verbose=False, allow_none=False, use_datetime=False, use_builtin_types=False, *, context=None)`2223Изменено в версии 3.3: Добавлен флаг *use\_builtin\_types*.2425Экземпляр [`ServerProxy`](https://python-all.ru/3.6/library/xmlrpc.client.html#xmlrpc.client.ServerProxy) – это объект, управляющий связью с удалённым XML-RPC сервером. Обязательный первый аргумент – URI (Uniform Resource Indicator), обычно это URL сервера. Второй необязательный аргумент – экземпляр транспортной фабрики; по умолчанию для URL https: используется внутренний экземпляр `SafeTransport`, а в остальных случаях – внутренний экземпляр HTTP `Transport`. Третий необязательный аргумент – кодировка, по умолчанию UTF-8. Четвёртый необязательный аргумент – флаг отладки.2627Следующие параметры управляют использованием возвращаемого экземпляра прокси. Если *allow\_none* равен true, константа Python `None` будет преобразована в XML; по умолчанию `None` вызывает исключение [`TypeError`](https://python-all.ru/3.6/library/exceptions.html#TypeError). Это часто используемое расширение спецификации XML-RPC, но оно поддерживается не всеми клиентами и серверами; описание см. на [http://ontosys.com/xml-rpc/extensions.php](https://python-all.ru/3.6/library/xmlrpc.client.html). Флаг *use\_builtin\_types* можно использовать, чтобы значения даты/времени представлялись как объекты [`datetime.datetime`](https://python-all.ru/3.6/library/datetime.html#datetime.datetime), а двоичные данные – как объекты [`bytes`](https://python-all.ru/3.6/library/stdtypes.html#bytes); по умолчанию этот флаг равен false. Объекты [`datetime.datetime`](https://python-all.ru/3.6/library/datetime.html#datetime.datetime), [`bytes`](https://python-all.ru/3.6/library/stdtypes.html#bytes) и [`bytearray`](https://python-all.ru/3.6/library/stdtypes.html#bytearray) могут передаваться в вызовы. Устаревший флаг *use\_datetime* аналогичен *use\_builtin\_types*, но применяется только к значениям даты/времени.2829Как HTTP-, так и HTTPS-транспорты поддерживают расширение синтаксиса URL для базовой аутентификации HTTP: `http://user:pass@host:port/path`. Часть `user:pass` будет закодирована в base64 как HTTP-заголовок 'Authorization' и отправлена на удалённый сервер в процессе подключения при вызове метода XML-RPC. Это нужно использовать только в том случае, если удалённый сервер требует имя пользователя и пароль для базовой аутентификации. Если указан HTTPS URL, *context* может быть [`ssl.SSLContext`](https://python-all.ru/3.6/library/ssl.html#ssl.SSLContext) и настраивает параметры SSL нижележащего HTTPS-соединения.3031Возвращаемый экземпляр – это прокси-объект с методами, которые можно использовать для вызова соответствующих RPC-вызовов на удалённом сервере. Если удалённый сервер поддерживает API интроспекции, прокси также можно использовать для запроса методов, которые он поддерживает (обнаружение служб), и получения других метаданных, связанных с сервером.3233Типы, которые являются совместимыми (т.е. могут быть преобразованы в XML), включают следующие (и, если не указано иное, они десериализуются как те же типы Python):3435| Тип XML-RPC | Тип Python |36| --- | --- |37| `boolean` | [`bool`](https://python-all.ru/3.6/library/functions.html#bool) |38| `int`, `i1`, `i2`, `i4`, `i8` or `biginteger` | [`int`](https://python-all.ru/3.6/library/functions.html#int) в диапазоне от -2147483648 до 2147483647. Значения получают тег `<int>`. |39| `double` или `float` | [`float`](https://python-all.ru/3.6/library/functions.html#float). Значения получают тег `<double>`. |40| `string` | [`str`](https://python-all.ru/3.6/library/stdtypes.html#str) |41| `array` | [`list`](https://python-all.ru/3.6/library/stdtypes.html#list) или [`tuple`](https://python-all.ru/3.6/library/stdtypes.html#tuple), содержащие совместимые элементы. Массивы возвращаются как [`lists`](https://python-all.ru/3.6/library/stdtypes.html#list). |42| `struct` | [`dict`](https://python-all.ru/3.6/library/stdtypes.html#dict). Ключи должны быть строками, значения могут быть любого совместимого типа. Можно передавать объекты пользовательских классов; передаётся только их атрибут [`__dict__`](https://python-all.ru/3.6/library/stdtypes.html#object.__dict__). |43| `dateTime.iso8601` | [`DateTime`](https://python-all.ru/3.6/library/xmlrpc.client.html#xmlrpc.client.DateTime) или [`datetime.datetime`](https://python-all.ru/3.6/library/datetime.html#datetime.datetime). Возвращаемый тип зависит от значений флагов *use\_builtin\_types* и *use\_datetime*. |44| `base64` | [`Binary`](https://python-all.ru/3.6/library/xmlrpc.client.html#xmlrpc.client.Binary), [`bytes`](https://python-all.ru/3.6/library/stdtypes.html#bytes) или [`bytearray`](https://python-all.ru/3.6/library/stdtypes.html#bytearray). Возвращаемый тип зависит от значения флага *use\_builtin\_types*. |45| `nil` | Константа `None`. Передача разрешена только если *allow\_none* равен true. |46| `bigdecimal` | [`decimal.Decimal`](https://python-all.ru/3.6/library/decimal.html#decimal.Decimal). Только возвращаемый тип. |4748Это полный набор типов данных, поддерживаемых XML-RPC. Вызовы методов также могут возбуждать специальный экземпляр [`Fault`](https://python-all.ru/3.6/library/xmlrpc.client.html#xmlrpc.client.Fault) для сообщения об ошибках XML-RPC сервера, или [`ProtocolError`](https://python-all.ru/3.6/library/xmlrpc.client.html#xmlrpc.client.ProtocolError) для сообщения об ошибке в транспортном слое HTTP/HTTPS. И [`Fault`](https://python-all.ru/3.6/library/xmlrpc.client.html#xmlrpc.client.Fault), и [`ProtocolError`](https://python-all.ru/3.6/library/xmlrpc.client.html#xmlrpc.client.ProtocolError) наследуются от базового класса `Error`. Обратите внимание, что модуль xmlrpc.client в настоящее время не выполняет маршалинг экземпляров подклассов встроенных типов.4950При передаче строк символы, специальные для XML, такие как `<`, `>` и `&`, автоматически экранируются. Однако вызывающая сторона должна гарантировать, что строка не содержит символов, запрещённых в XML, например управляющих символов с ASCII-кодами от 0 до 31 (за исключением табуляции, новой строки и возврата каретки); несоблюдение этого требования приведёт к тому, что XML-RPC запрос не будет корректным XML. Если необходимо передать произвольные байты через XML-RPC, используйте классы [`bytes`](https://python-all.ru/3.6/library/stdtypes.html#bytes) или [`bytearray`](https://python-all.ru/3.6/library/stdtypes.html#bytearray), или класс-обёртку [`Binary`](https://python-all.ru/3.6/library/xmlrpc.client.html#xmlrpc.client.Binary), описанный ниже.5152`Server` сохранён как псевдоним для [`ServerProxy`](https://python-all.ru/3.6/library/xmlrpc.client.html#xmlrpc.client.ServerProxy) для обратной совместимости. В новом коде следует использовать [`ServerProxy`](https://python-all.ru/3.6/library/xmlrpc.client.html#xmlrpc.client.ServerProxy).5354Изменено в версии 3.5: Добавлен аргумент *context*.5556Изменено в версии 3.6: Добавлена поддержка тегов типов с префиксами (например, `ex:nil`). Добавлена поддержка демаршалинга дополнительных типов, используемых реализацией Apache XML-RPC для числовых значений: `i1`, `i2`, `i8`, `biginteger`, `float` и `bigdecimal`. См. [http://ws.apache.org/xmlrpc/types.html](https://python-all.ru/3.6/library/xmlrpc.client.html) для описания.5758> **См. также**59>60> **[Руководство по XML-RPC](https://python-all.ru/3.6/library/xmlrpc.client.html)**61>62> Хорошее описание работы XML-RPC и клиентского ПО на нескольких языках. Содержит практически всё, что нужно знать разработчику XML-RPC клиента.63>64> **[Интроспекция XML-RPC](https://python-all.ru/3.6/library/xmlrpc.client.html)**65>66> Описывает расширение протокола XML-RPC для интроспекции.67>68> **[Спецификация XML-RPC](https://python-all.ru/3.6/library/xmlrpc.client.html)**69>70> Официальная спецификация.71>72> **[Неофициальные исправления XML-RPC](https://python-all.ru/3.6/library/xmlrpc.client.html)**73>74> «Неофициальные исправления» Фредрика Лунда, предназначенные для разъяснения некоторых деталей спецификации XML-RPC, а также для указания на «лучшие практики» при разработке собственных реализаций XML-RPC.7576## 21.26.1. Объекты ServerProxy7778Экземпляр [`ServerProxy`](https://python-all.ru/3.6/library/xmlrpc.client.html#xmlrpc.client.ServerProxy) имеет метод, соответствующий каждому удаленному вызову процедуры, принимаемому XML-RPC сервером. Вызов метода выполняет RPC, диспетчеризуемый по имени и сигнатуре аргументов (например, одно и то же имя метода может быть перегружено несколькими сигнатурами аргументов). RPC завершается возвратом значения, которое может быть либо возвращенными данными в совместимом типе, либо [`Fault`](https://python-all.ru/3.6/library/xmlrpc.client.html#xmlrpc.client.Fault) или [`ProtocolError`](https://python-all.ru/3.6/library/xmlrpc.client.html#xmlrpc.client.ProtocolError) объектом, указывающим на ошибку.7980Серверы, поддерживающие API интроспекции XML, предоставляют несколько общих методов, сгруппированных в зарезервированном атрибуте `system`:8182#### `ServerProxy.system.listMethods()`8384Этот метод возвращает список строк, по одной для каждого (не системного) метода, поддерживаемого XML-RPC сервером.8586#### `ServerProxy.system.methodSignature(name)`8788Этот метод принимает один параметр – имя метода, реализованного XML-RPC сервером. Он возвращает массив возможных сигнатур для этого метода. Сигнатура – это массив типов. Первый из этих типов – возвращаемый тип метода, остальные – параметры.8990Поскольку допускается несколько сигнатур (т.е. перегрузка), этот метод возвращает список сигнатур, а не один элемент.9192Сигнатуры ограничены параметрами верхнего уровня, ожидаемыми методом. Например, если метод ожидает один массив структур в качестве параметра и возвращает строку, его сигнатура – просто «string, array». Если он ожидает три целых числа и возвращает строку, его сигнатура – «string, int, int, int».9394Если для метода не определена сигнатура, возвращается не-массив. В Python это означает, что тип возвращаемого значения будет чем-то отличным от list.9596#### `ServerProxy.system.methodHelp(name)`9798Этот метод принимает один параметр – имя метода, реализованного XML-RPC сервером. Он возвращает строку документации, описывающую использование этого метода. Если такая строка отсутствует, возвращается пустая строка. Строка документации может содержать HTML-разметку.99100Изменено в версии 3.5: Экземпляры [`ServerProxy`](https://python-all.ru/3.6/library/xmlrpc.client.html#xmlrpc.client.ServerProxy) поддерживают протокол [менеджера контекста](https://python-all.ru/3.6/glossary.html#term-context-manager) для закрытия нижележащего транспорта.101102Далее следует работающий пример. Код сервера:103104```python105from xmlrpc.server import SimpleXMLRPCServer106107def is_even(n):108    return n % 2 == 0109110server = SimpleXMLRPCServer(("localhost", 8000))111print("Listening on port 8000...")112server.register_function(is_even, "is_even")113server.serve_forever()114```115116Клиентский код для указанного сервера:117118```python119import xmlrpc.client120121with xmlrpc.client.ServerProxy("http://localhost:8000/") as proxy:122    print("3 is even: %s" % str(proxy.is_even(3)))123    print("100 is even: %s" % str(proxy.is_even(100)))124```125126## 21.26.2. Объекты DateTime127128#### `class xmlrpc.client.DateTime`129130Этот класс можно инициализировать секундами с начала эпохи, временным кортежем, строкой даты/времени в формате ISO 8601 или экземпляром [`datetime.datetime`](https://python-all.ru/3.6/library/datetime.html#datetime.datetime). Он имеет следующие методы, поддерживаемые в основном для внутреннего использования кодом маршалинга/демаршалинга:131132#### `decode(string)`133134Принимает строку в качестве нового значения времени экземпляра.135136#### `encode(out)`137138Записывает XML-RPC кодировку этого элемента [`DateTime`](https://python-all.ru/3.6/library/xmlrpc.client.html#xmlrpc.client.DateTime) в потоковый объект *out* .139140Он также поддерживает некоторые встроенные операторы Python через методы rich comparison и [`__repr__()`](https://python-all.ru/3.6/reference/datamodel.html#object.__repr__).141142Далее следует работающий пример. Код сервера:143144```python145import datetime146from xmlrpc.server import SimpleXMLRPCServer147import xmlrpc.client148149def today():150    today = datetime.datetime.today()151    return xmlrpc.client.DateTime(today)152153server = SimpleXMLRPCServer(("localhost", 8000))154print("Listening on port 8000...")155server.register_function(today, "today")156server.serve_forever()157```158159Клиентский код для указанного сервера:160161```python162import xmlrpc.client163import datetime164165proxy = xmlrpc.client.ServerProxy("http://localhost:8000/")166167today = proxy.today()168# преобразует строку в формате ISO8601 в объект datetime169converted = datetime.datetime.strptime(today.value, "%Y%m%dT%H:%M:%S")170print("Today: %s" % converted.strftime("%d.%m.%Y, %H:%M"))171```172173## 21.26.3. Объекты Binary174175#### `class xmlrpc.client.Binary`176177Этот класс можно инициализировать данными bytes (которые могут содержать NUL-символы). Основной доступ к содержимому объекта [`Binary`](https://python-all.ru/3.6/library/xmlrpc.client.html#xmlrpc.client.Binary) предоставляется через атрибут:178179#### `data`180181Двоичные данные, инкапсулированные экземпляром [`Binary`](https://python-all.ru/3.6/library/xmlrpc.client.html#xmlrpc.client.Binary). Данные предоставляются как объект [`bytes`](https://python-all.ru/3.6/library/stdtypes.html#bytes).182183Объекты [`Binary`](https://python-all.ru/3.6/library/xmlrpc.client.html#xmlrpc.client.Binary) имеют следующие методы, предназначенные в основном для внутреннего использования кодом маршалинга/демаршалинга:184185#### `decode(bytes)`186187Принимает объект base64 [`bytes`](https://python-all.ru/3.6/library/stdtypes.html#bytes) и декодирует его как новые данные экземпляра.188189#### `encode(out)`190191Записывает XML-RPC base64-кодировку этого двоичного объекта в потоковый объект *out*.192193Закодированные данные будут содержать переводы строки каждые 76 символов в соответствии с [**RFC 2045, раздел 6.8**](https://python-all.ru/3.6/library/xmlrpc.client.html), что было фактическим стандартом спецификации base64 на момент написания спецификации XML-RPC.194195Он также поддерживает некоторые встроенные операторы Python через [`__eq__()`](https://python-all.ru/3.6/reference/datamodel.html#object.__eq__) и [`__ne__()`](https://python-all.ru/3.6/reference/datamodel.html#object.__ne__).196197Пример использования двоичных объектов. Мы собираемся передать изображение через XMLRPC:198199```python200from xmlrpc.server import SimpleXMLRPCServer201import xmlrpc.client202203def python_logo():204    with open("python_logo.jpg", "rb") as handle:205        return xmlrpc.client.Binary(handle.read())206207server = SimpleXMLRPCServer(("localhost", 8000))208print("Listening on port 8000...")209server.register_function(python_logo, 'python_logo')210211server.serve_forever()212```213214Клиент получает изображение и сохраняет его в файл:215216```python217import xmlrpc.client218219proxy = xmlrpc.client.ServerProxy("http://localhost:8000/")220with open("fetched_python_logo.jpg", "wb") as handle:221    handle.write(proxy.python_logo().data)222```223224## 21.26.4. Объекты Fault225226#### `class xmlrpc.client.Fault`227228Объект [`Fault`](https://python-all.ru/3.6/library/xmlrpc.client.html#xmlrpc.client.Fault) инкапсулирует содержимое тега ошибки (fault tag) XML-RPC. Объекты Fault имеют следующие атрибуты:229230#### `faultCode`231232Строка, указывающая тип ошибки.233234#### `faultString`235236Строка, содержащая диагностическое сообщение, связанное с ошибкой.237238В следующем примере мы намеренно вызовем [`Fault`](https://python-all.ru/3.6/library/xmlrpc.client.html#xmlrpc.client.Fault), возвращая объект сложного типа. Код сервера:239240```python241from xmlrpc.server import SimpleXMLRPCServer242243# Произойдёт ошибка маршалинга, потому что возвращается244# комплексное число245def add(x, y):246    return x+y+0j247248server = SimpleXMLRPCServer(("localhost", 8000))249print("Listening on port 8000...")250server.register_function(add, 'add')251252server.serve_forever()253```254255Клиентский код для указанного сервера:256257```python258import xmlrpc.client259260proxy = xmlrpc.client.ServerProxy("http://localhost:8000/")261try:262    proxy.add(2, 5)263except xmlrpc.client.Fault as err:264    print("A fault occurred")265    print("Fault code: %d" % err.faultCode)266    print("Fault string: %s" % err.faultString)267```268269## 21.26.5. Объекты ProtocolError270271#### `class xmlrpc.client.ProtocolError`272273Объект [`ProtocolError`](https://python-all.ru/3.6/library/xmlrpc.client.html#xmlrpc.client.ProtocolError) описывает протокольную ошибку на уровне нижележащего транспорта (например, ошибку 404 «не найдено», если сервер по указанному URI не существует). Он имеет следующие атрибуты:274275#### `url`276277URI или URL, вызвавший ошибку.278279#### `errcode`280281Код ошибки.282283#### `errmsg`284285Сообщение об ошибке или диагностическая строка.286287#### `headers`288289Словарь (dict), содержащий заголовки HTTP/HTTPS-запроса, вызвавшего ошибку.290291В следующем примере мы намеренно вызовем [`ProtocolError`](https://python-all.ru/3.6/library/xmlrpc.client.html#xmlrpc.client.ProtocolError), предоставив неверный URI:292293```python294import xmlrpc.client295296# Создание ServerProxy с URI, который не отвечает на XMLRPC-запросы297proxy = xmlrpc.client.ServerProxy("http://google.com/")298299try:300    proxy.some_method()301except xmlrpc.client.ProtocolError as err:302    print("A protocol error occurred")303    print("URL: %s" % err.url)304    print("HTTP/HTTPS headers: %s" % err.headers)305    print("Error code: %d" % err.errcode)306    print("Error message: %s" % err.errmsg)307```308309## 21.26.6. Объекты MultiCall310311Объект [`MultiCall`](https://python-all.ru/3.6/library/xmlrpc.client.html#xmlrpc.client.MultiCall) позволяет инкапсулировать несколько вызовов к удалённому серверу в один запрос [1](https://python-all.ru/3.6/library/xmlrpc.client.html#id6).312313#### `class xmlrpc.client.MultiCall(server)`314315Создаёт объект для группировки вызовов методов. *server* – конечная цель вызова. Вызовы могут направляться результирующему объекту, но они сразу же возвращают `None`, и сохраняют только имя метода и параметры в объект [`MultiCall`](https://python-all.ru/3.6/library/xmlrpc.client.html#xmlrpc.client.MultiCall). Вызов самого объекта приводит к передаче всех сохранённых вызовов в виде одного запроса `system.multicall`. Результатом этого вызова является [generator](https://python-all.ru/3.6/glossary.html#term-generator); итерация по этому генератору даёт отдельные результаты.316317Далее приведён пример использования этого класса. Серверный код:318319```python320from xmlrpc.server import SimpleXMLRPCServer321322def add(x, y):323    return x + y324325def subtract(x, y):326    return x - y327328def multiply(x, y):329    return x * y330331def divide(x, y):332    return x // y333334# Простой сервер с простыми арифметическими функциями335server = SimpleXMLRPCServer(("localhost", 8000))336print("Listening on port 8000...")337server.register_multicall_functions()338server.register_function(add, 'add')339server.register_function(subtract, 'subtract')340server.register_function(multiply, 'multiply')341server.register_function(divide, 'divide')342server.serve_forever()343```344345Клиентский код для указанного сервера:346347```python348import xmlrpc.client349350proxy = xmlrpc.client.ServerProxy("http://localhost:8000/")351multicall = xmlrpc.client.MultiCall(proxy)352multicall.add(7, 3)353multicall.subtract(7, 3)354multicall.multiply(7, 3)355multicall.divide(7, 3)356result = multicall()357358print("7+3=%d, 7-3=%d, 7*3=%d, 7//3=%d" % tuple(result))359```360361## 21.26.7. Вспомогательные функции362363#### `xmlrpc.client.dumps(params, methodname=None, methodresponse=None, encoding=None, allow_none=False)`364365Преобразует *params* в запрос XML-RPC. Или в ответ, если *methodresponse* истинно. *params* может быть кортежем аргументов или экземпляром [`Fault`](https://python-all.ru/3.6/library/xmlrpc.client.html#xmlrpc.client.Fault) класса исключения. Если *methodresponse* истинно, только одно значение может быть возвращено, то есть *params* должен иметь длину 1. *encoding*, если указан, это кодировка для генерируемого XML; по умолчанию UTF-8. Значение [`None`](https://python-all.ru/3.6/library/constants.html#None) Python не может использоваться в стандартном XML-RPC; чтобы разрешить его использование через расширение, передайте истинное значение для *allow\_none*.366367#### `xmlrpc.client.loads(data, use_datetime=False, use_builtin_types=False)`368369Преобразует XML-RPC запрос или ответ в объекты Python, `(params, methodname)`. *params* – кортеж аргументов; *methodname* – строка или `None`, если имя метода отсутствует в пакете. Если XML-RPC пакет представляет собой условие ошибки, эта функция возбуждает исключение [`Fault`](https://python-all.ru/3.6/library/xmlrpc.client.html#xmlrpc.client.Fault). Флаг *use\_builtin\_types* можно использовать, чтобы значения даты/времени представлялись как объекты [`datetime.datetime`](https://python-all.ru/3.6/library/datetime.html#datetime.datetime), а бинарные данные – как объекты [`bytes`](https://python-all.ru/3.6/library/stdtypes.html#bytes); по умолчанию этот флаг выключен.370371Устаревший флаг *use\_datetime* похож на *use\_builtin\_types*, но применяется только к значениям даты/времени.372373Изменено в версии 3.3: Добавлен флаг *use\_builtin\_types*.374375## 21.26.8. Пример использования клиента376377```python378# простая тестовая программа (из спецификации XML-RPC)379from xmlrpc.client import ServerProxy, Error380381# server = ServerProxy("http://localhost:8000") # локальный сервер382with ServerProxy("http://betty.userland.com") as proxy:383384    print(proxy)385386    try:387        print(proxy.examples.getStateName(41))388    except Error as v:389        print("ERROR", v)390```391392Для доступа к XML-RPC серверу через HTTP-прокси необходимо определить собственный транспорт. В следующем примере показано, как это сделать:393394```python395import http.client396import xmlrpc.client397398class ProxiedTransport(xmlrpc.client.Transport):399400    def set_proxy(self, host, port=None, headers=None):401        self.proxy = host, port402        self.proxy_headers = headers403404    def make_connection(self, host):405        connection = http.client.HTTPConnection(*self.proxy)406        connection.set_tunnel(host, headers=self.proxy_headers)407        self._connection = host, connection408        return connection409410transport = ProxiedTransport()411transport.set_proxy('proxy-server', 8080)412server = xmlrpc.client.ServerProxy('http://betty.userland.com', transport=transport)413print(server.examples.getStateName(41))414```415416## 21.26.9. Пример использования клиента и сервера417418См. [пример SimpleXMLRPCServer](https://python-all.ru/3.6/library/xmlrpc.server.html#simplexmlrpcserver-example).419420Сноски421422**[1](https://python-all.ru/3.6/library/xmlrpc.client.html#id5)**423424Этот подход был впервые представлен в [обсуждении на xmlrpc.com](https://python-all.ru/3.6/library/xmlrpc.client.html).425