Merge pull request #629 from ITriskTI/patch-1

Update aria2c.rst
pull/632/head
Tatsuhiro Tsujikawa 2016-04-18 22:20:08 +09:00
commit d7391f9e0d
1 changed files with 70 additions and 31 deletions

View File

@ -2371,9 +2371,9 @@ RPC-метод `system.multicall` обрабатывается особым об
против RPC-интерфейса. Поэтому рекомендуется отдавать предпочтение пакетным
или `system.multicall` запросам, когда это необходимо.
`system.listMethods` может выполняться без секретного маркера. Так он
просто возвращает все доступные методы, и ничего не изменяет, это
безопасно без секретного маркера.
`system.listMethods` и `system.listNotifications` могут выполняться без секретного маркера. Так они
просто возвращает доступные методы/уведомления, и ничего не изменяют, они
безопасны без секретного маркера.
Методы
~~~~~~
@ -2723,6 +2723,15 @@ RPC-метод `system.multicall` обрабатывается особым об
``name``
имя в разделе info. Используется ``name.utf-8``, если доступно.
``verifiedLength``
Количество проверенных байт во время проверки хэша. Это поле
появляется только тогда, когда загрузка начинает проверять хэш.
``verifyIntegrityPending``
``true`` - если эта загрузка ожидает в очереди проверки хэша.
Это поле появляется только тогда, когда эта загрузка находится
в очереди.
**Пример JSON-RPC**
Следующий пример получает информацию о загрузке с GID#2089b05ecca3d829::
@ -3607,6 +3616,36 @@ RPC-метод `system.multicall` обрабатывается особым об
>>> s.system.listMethods()
['aria2.addUri', 'aria2.addTorrent', ...
.. function:: system.listNotifications()
Этот метод возвращает все доступные RPC-методы в массиве строк.
В отличие от других методов, этот метод не требует секретный маркер.
Это безопасно, потому что этот метод просто возвращает названия доступных
уведомлений.
**Пример JSON-RPC**
::
>>> import urllib2, json
>>> from pprint import pprint
>>> jsonreq = json.dumps({'jsonrpc':'2.0', 'id':'qwer',
... 'method':'system.listNotifications'})
>>> c = urllib2.urlopen('http://localhost:6800/jsonrpc', jsonreq)
>>> pprint(json.loads(c.read()))
{u'id': u'qwer',
u'jsonrpc': u'2.0',
u'result': [u'aria2.onDownloadStart',
u'aria2.onDownloadPause',
...
**Пример XML-RPC**
::
>>> import xmlrpclib
>>> s = xmlrpclib.ServerProxy('http://localhost:6800/rpc')
>>> s.system.listNotifications()
['aria2.onDownloadStart', 'aria2.onDownloadPause', ...
Обработка ошибок
~~~~~~~~~~~~~~~~