Протокол Beanstalk - История изменений

imported>Supportadmin: /* Протокол */

2014-05-08T12:48:28Z

Протокол

← Предыдущая версия		Версия от 15:48, 8 мая 2014
Строка 16:		Строка 16:
	Если клиент нарушает протокол (например, отправив не очень хорошо сформированный запрос или несуществующую команду) или в сервере произошла ошибка, сервер ответит одним из следующих сообщений об ошибке:		Если клиент нарушает протокол (например, отправив не очень хорошо сформированный запрос или несуществующую команду) или в сервере произошла ошибка, сервер ответит одним из следующих сообщений об ошибке:

	*OUT_OF_MEMORY\r\n - Сервер не может выделить память для задачи. Клиенту нужно попробовать еще раз позже.		*'''OUT_OF_MEMORY\r\n''' - Сервер не может выделить память для задачи. Клиенту нужно попробовать еще раз позже.
	*INTERNAL_ERROR\r\n - Эта ошибка сигнализирует о критической ошибке сервера. Такого не должно случиться никогда. Если такое произойдет, пожалуйста сообщите по адресу http://groups.google.com/group/beanstalk-talk.		*'''INTERNAL_ERROR\r\n''' - Эта ошибка сигнализирует о критической ошибке сервера. Такого не должно случиться никогда. Если такое произойдет, пожалуйста сообщите по адресу http://groups.google.com/group/beanstalk-talk.
	*BAD_FORMAT\r\n - Клиент послал неверно сформированную команду. Это может случится в случаях, если команда не заканчивается символом \r\n, если в позиции где ожидаются целое число, а находится иное, если неправильное количество аргументов или если командная строка неправильно формируется любым другим способом.		*'''BAD_FORMAT\r\n''' - Клиент послал неверно сформированную команду. Это может случится в случаях, если команда не заканчивается символом \r\n, если в позиции где ожидаются целое число, а находится иное, если неправильное количество аргументов или если командная строка неправильно формируется любым другим способом.
	*UNKNOWN_COMMAND\r\n - Клиент послал неизвестную для сервера команду		*'''UNKNOWN_COMMAND\r\n''' - Клиент послал неизвестную для сервера команду

	Эти ошибки не будут описаны в каждой команде индивидуально, но они неявно включены в описание всех команд. Клиенты должны быть готовы получать в ответ ошибку после любой команды.		Эти ошибки не будут описаны в каждой команде индивидуально, но они неявно включены в описание всех команд. Клиенты должны быть готовы получать в ответ ошибку после любой команды.

imported>Supportadmin: /* Команды исполнителей */

2014-05-08T10:15:19Z

Команды исполнителей

← Предыдущая версия		Версия от 13:15, 8 мая 2014
Строка 103:		Строка 103:
	**<tube> - Имя канала, который стал текущим		**<tube> - Имя канала, который стал текущим

	==Команды исполнителей==		==Команды исполнителей задач==

	Клиент, который хочет получить задачу из очереди должен использовать команды «'''reserve'''», «'''delete'''», «'''release'''» и «'''bury'''» (прим переводчика: если точнее, то это набор команд исполнителя для работы с очередью в канале).		Клиент, который хочет получить задачу из очереди должен использовать команды «'''reserve'''», «'''delete'''», «'''release'''» и «'''bury'''» (прим переводчика: если точнее, то это набор команд исполнителя для работы с очередью в канале).
Строка 212:		Строка 212:

	* '''<count>''' целое число каналов в текущем watch list.		* '''<count>''' целое число каналов в текущем watch list.


	==Другие команды==		==Другие команды==

imported>Supportadmin: /* Команды генерации. */

2014-05-08T10:14:56Z

Команды генерации.

← Предыдущая версия		Версия от 13:14, 8 мая 2014
Строка 66:		Строка 66:
	Каналы создаются по запросу, всякий раз когда на них ссылаются. Если канал пуст (это означает, что он не содержит задач со статусом «'''ready'''», «'''delayed'''» или «'''buried'''») и нет подписанных клиентов, канал будет удален.		Каналы создаются по запросу, всякий раз когда на них ссылаются. Если канал пуст (это означает, что он не содержит задач со статусом «'''ready'''», «'''delayed'''» или «'''buried'''») и нет подписанных клиентов, канал будет удален.

	==Команды ~~генерации.~~==		==Команды генераторов задач==
	===put===		===put===
	Команда «'''put'''» предназначена для любого клиента, который желает добавить задачу в очередь. Она включает в себя строку команды с последующей строкой «тела» задачи:		Команда «'''put'''» предназначена для любого клиента, который желает добавить задачу в очередь. Она включает в себя строку команды с последующей строкой «тела» задачи:

imported>Supportadmin: /* ignore */

2014-05-08T07:44:56Z

ignore

← Предыдущая версия		Версия от 10:44, 8 мая 2014
Строка 447:		Строка 447:
	Формат команды:		Формат команды:

	'''ignore <tube>~~'''~~\r\n		'''ignore <tube>\r\n'''

	Возможен один из вариантов ответа:		Возможен один из вариантов ответа:

imported>Supportadmin: /* pause-tube */

2014-05-08T07:43:41Z

pause-tube

← Предыдущая версия		Версия от 10:43, 8 мая 2014
Строка 429:		Строка 429:

	Команда '''pause-tube''' позволяет приостановить резервирование новых задач на определенное время.		Команда '''pause-tube''' позволяет приостановить резервирование новых задач на определенное время.


	Формат команды:		Формат команды:


	'''pause-tube <tube-name> <delay>\r\n'''		'''pause-tube <tube-name> <delay>\r\n'''


	* '''<tube>''' - название приостанавливаемого канала		* '''<tube>''' - название приостанавливаемого канала
	* '''<delay>''' - целое число секунд до момента восстановления возможности резервирования задач из очереди.		* '''<delay>''' - целое число секунд до момента восстановления возможности резервирования задач из очереди.

	Возможны два варианта ответа:		Возможны два варианта ответа:


	* '''PAUSED\r\n''' - сигнализирует об успешном выполнении.		* '''PAUSED\r\n''' - сигнализирует об успешном выполнении.

imported>Supportadmin: /* quit */

2014-05-08T07:43:18Z

quit

← Предыдущая версия		Версия от 10:43, 8 мая 2014
Строка 420:		Строка 420:

	===quit===		===quit===
	Команда '''quit''' просто закрывает соединение. ~~Формат команды:~~		Команда '''quit''' просто закрывает соединение.

			Формат команды:

	'''quit\r\n'''		'''quit\r\n'''

imported>Supportadmin: /* reserve, reserve-with-timeout */

2014-05-08T07:42:41Z

reserve, reserve-with-timeout

← Предыдущая версия		Версия от 10:42, 8 мая 2014
Строка 131:		Строка 131:

	*'''RESERVED <id><bytes>\r\n''' - успешное резервирование задачи		*'''RESERVED <id><bytes>\r\n''' - успешное резервирование задачи
	**<id>''' - ~~'''~~имя канала, который стал текущим		**'''<id>''' - имя канала, который стал текущим
	**<bytes> - целое число указывающее размер тела задачи, не включая граничные символы "\r\n".		**'''<bytes>''' - целое число указывающее размер тела задачи, не включая граничные символы "\r\n".
	*'''<dаta>\r\n''' - тело успешно зарезервированной задачи — последовательность байтов длиной <bytes> указанной в строке команды. Это точная копия байтов, которые были изначально отправлены на сервер командой «'''put'''» в этой задаче.		*'''<dаta>\r\n''' - тело успешно зарезервированной задачи — последовательность байтов длиной <bytes> указанной в строке команды. Это точная копия байтов, которые были изначально отправлены на сервер командой «'''put'''» в этой задаче.

imported>Supportadmin: /* list-tubes-watched */

2014-05-08T07:41:39Z

list-tubes-watched

← Предыдущая версия		Версия от 10:41, 8 мая 2014
Строка 412:		Строка 412:

	'''list-tubes-watched\r\n'''		'''list-tubes-watched\r\n'''


	Ответ сервера:		Ответ сервера:


	'''OK <bytes>\r\n<data>\r\n'''		'''OK <bytes>\r\n<data>\r\n'''
			*'''<bytes> - '''размер последующей секции данных в байтах.
			*'''<data>''' - последовательность байт длиной <bytes> указанной в предыдущей строке. Это YAML файл содержащий названия всех каналов на которые есть подписка в виде списка строк.
	'''<bytes> - '''размер последующей секции данных в байтах.

	'''<data>''' - последовательность байт длиной <bytes> указанной в предыдущей строке. Это YAML файл содержащий названия всех каналов на которые есть подписка в виде списка строк.

	===quit===		===quit===

imported>Supportadmin: /* list-tube-used */

2014-05-08T07:41:15Z

list-tube-used

← Предыдущая версия		Версия от 10:41, 8 мая 2014
Строка 396:		Строка 396:
	===list-tube-used===		===list-tube-used===
	Команда '''list-tube-used''' возвращает канал, используемый клиентом в настоящее время.		Команда '''list-tube-used''' возвращает канал, используемый клиентом в настоящее время.


	Формат команды:		Формат команды:


	'''list-tube-used\r\n'''		'''list-tube-used\r\n'''


	Ответ сервера:		Ответ сервера:


	'''USING <tube>\r\n'''		'''USING <tube>\r\n'''
			*'''<tube>''' название используемого конала.

	- '''<tube>''' название используемого конала.

	===list-tubes-watched===		===list-tubes-watched===

imported>Supportadmin: /* list-tubes */

2014-05-08T07:40:55Z

list-tubes

← Предыдущая версия		Версия от 10:40, 8 мая 2014
Строка 384:		Строка 384:

	Команда '''list-tubes''' возвращает список всех существующих каналов.		Команда '''list-tubes''' возвращает список всех существующих каналов.


	Формат команды:		Формат команды:


	'''list-tubes\r\n'''		'''list-tubes\r\n'''


	Ответ сервера:		Ответ сервера:
			'''OK <bytes>\r\n<data>\r\n'''

	'''OK <bytes>\r\n~~'''~~

	~~'''~~<data>\r\n'''


	* '''<bytes> - '''размер последующей секции данных в байтах.		* '''<bytes> - '''размер последующей секции данных в байтах.
	* '''<data>''' - последовательность байт длиной <bytes> указанной в предыдущей строке. Это YAML файл содержащий названия всех каналов в виде списка строк.		* '''<data>''' - последовательность байт длиной <bytes> указанной в предыдущей строке. Это YAML файл содержащий названия всех каналов в виде списка строк.