Browse Source

[DOCUMENTATION] Russian:
- New translations - Zend_Queue: Introduction, Example


git-svn-id: http://framework.zend.com/svn/framework/standard/trunk@20329 44c647ce-9c0f-0410-b52a-842ac1e357ba

denis.baklikov 16 years ago
parent
commit
9eadbf8f9a

+ 53 - 0
documentation/manual/ru/module_specs/Zend_Queue-Example.xml

@@ -0,0 +1,53 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- Reviewed: no -->
+<sect1 id="zend.queue.example">
+    <title>Примеры использования</title>
+
+    <para>
+        The below example of <classname>Zend_Queue</classname> shows a variety of
+        features, including queue creation, queue retrieval, message retrieval,
+        message deletion, and sending messages.
+		
+		Приведённый ниже пример показывает варианты использования 
+		<classname>Zend_Queue</classname>: создание очереди сообщений, 
+		получение, отправку и удаление сообщений.
+    </para>
+
+    <programlisting language="php"><![CDATA[
+// Конфигурационные параметры
+// @see Zend_Queue_Adapater::__construct()
+$options = array(
+    'name' => 'queue1',
+);
+
+// Создание очереди на основе массива
+$queue = new Zend_Queue('Array', $options);
+
+// Получение списка очередей
+foreach ($queue->getQueues() as $name) {
+    echo $name, "\n";
+}
+
+// Создание новой очереди
+$queue2 = $queue->createQueue('queue2');
+
+// Подсчёт количества сообщений в очереди (реализует интерфейс Countable из SPL)
+echo count($queue);
+
+// Получение 5 сообщений из очереди
+$messages = $queue->receive(5);
+
+foreach ($messages as $i => $message) {
+    echo $message->body, "\n";
+
+    // Сообщение обработано, его можно удалить
+    $queue->deleteMessage($message);
+}
+
+// Отправка сообщения в текущую очередь
+$queue->send('My Test Message');
+
+// Удаление созданной очереди и всех сообщений в ней
+$queue->deleteQueue('queue2');
+]]></programlisting>
+</sect1>

+ 57 - 0
documentation/manual/ru/module_specs/Zend_Queue-Introduction.xml

@@ -0,0 +1,57 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- Reviewed: no -->
+<sect1 id="zend.queue.introduction">
+    <title>Введение</title>
+
+    <para>
+        <classname>Zend_Queue</classname> представляет собой фабрику 
+		для создания подключений к  очередям сообщений.
+    </para>
+
+    <para>
+		Очередь сообщений – это средство для распределенной обработки данных. 
+		Например, приложение для поиска работы может принимать резюме из 
+		множества различных источников.
+    </para>
+
+    <para>
+        Вы можете создать очередь "<filename>/queue/applications</filename>", 
+		у которой будут отправитель и получатель. Отправителем может быть любой 
+		источник информации, который может подключаться к службе сообщений либо 
+		напрямую, либо через приложение, имеющее доступ к ней.
+    </para>
+
+    <para>
+        Отправитель отсылает сообщение в очередь:
+    </para>
+
+    <programlisting language="xml"><![CDATA[
+<resume>
+    <name>Вася Пупкин</name>
+    <location>
+        <city>Москва</city>
+        <state>Московская область</state>
+    </location>
+    <skills>
+        <programming>PHP</programming>
+        <programming>Perl</programming>
+    </skills>
+</resume>
+]]></programlisting>
+
+    <para>
+        Получатель или обработчик очереди получает сообщение и обработает данные из резюме.
+    </para>
+
+    <para>
+	Существует много паттернов, которые могут быть применены к очередям сообщений для того,
+	чтобы абстрагировать поток сообщений от кода и предоставить метрики, 
+	трансформации и мониторинг очередей сообщений.
+	
+        <ulink
+            url="http://www.amazon.com/Enterprise-Integration-Patterns-Designing-Addison-Wesley/dp/0321200683">Enterprise
+            Integration Patterns: Designing, Building, and Deploying Messaging Solutions
+            (Addison-Wesley Signature Series)</ulink> (ISBN-10 0321127420; ISBN-13 978-0321127426) 
+	- хорошая книга об использовании очередей сообщений.
+    </para>
+</sect1>