Alterator/module/backend: различия между версиями

Материал из ALT Linux Wiki
Нет описания правки
 
(не показаны 3 промежуточные версии 2 участников)
Строка 1: Строка 1:
[[Category:Sisyphus]]
<onlyinclude>
 
=== Бэкенд ===
=== Бэкенд ===
Существует два вида бэкендов: нативные и внешние. Размещаются эти бэкенды в каталогах ''/usr/lib/alterator/backend2'' и ''/usr/lib/alterator/backend3'' соответственно.
Существует два вида бэкендов: нативные и внешние. Размещаются эти бэкенды в каталогах ''/usr/lib/alterator/backend2'' и ''/usr/lib/alterator/backend3'' соответственно.
Строка 15: Строка 14:


Пример простейшего бэкенда на shell:
Пример простейшего бэкенда на shell:
<pre>#!/bin/sh -f
<source lang="bash">
#!/bin/sh -f


po_domain="alterator-foo"
po_domain="alterator-foo"
Строка 42: Строка 42:
}
}


message_loop</pre>
message_loop
</source>
 
В данном примере:  
В данном примере:  
*'''message_loop''' — запуск цикла обработки событий
*'''message_loop''' — запуск цикла обработки событий
Строка 55: Строка 57:


Пример аналогичного бэкенда на perl:
Пример аналогичного бэкенда на perl:
<pre>#!/usr/bin/perl -w
<source lang="perl">
#!/usr/bin/perl -w
use strict;
use strict;
use Alterator::Backend3;
use Alterator::Backend3;
Строка 78: Строка 81:
}
}


message_loop(\&on_message);</pre>
message_loop(\&on_message);
</source>


Здесь, как ив shell-бэкенде:
Здесь, как и в shell-бэкенде:
*'''message_loop''' — запуск цикла обработки событий
*'''message_loop''' — запуск цикла обработки событий
*'''on_message''' — обработчик входящих сообщений.
*'''on_message''' — обработчик входящих сообщений.


Обработчику передается ссылка на хэш с входными переменными. Выходные печатаются при помощи функций ''write_*'' .   
Обработчику передаётся ссылка на хэш с входными переменными. Выходные печатаются при помощи функций ''write_*'' .   


При обращении из интерфейса по адресу ''/&lt;name&gt;/foo/bar'', то в бэкенде &lt;name&gt; в этом хэше будет присутствовать //_objects// равный "foo/bar" (то есть "хвост" адреса), если обращались по адресу ''/&lt;name&gt;'', то //_objects// равно "/".
При обращении из интерфейса по адресу ''/&lt;name&gt;/foo/bar'', то в бэкенде &lt;name&gt; в этом хэше будет присутствовать //_objects// равный "foo/bar" (то есть "хвост" адреса), если обращались по адресу ''/&lt;name&gt;'', то //_objects// равно "/".


Более подробная информация по написанию бэкендов на perl находится [[Alterator/perl|здесь]].
Более подробная информация по написанию бэкендов на perl находится [[Alterator/perl|здесь]].
</onlyinclude>


==== Типы параметров ====


Иногда необходимо производить валидацию введённых пользователем данных. Можно это делать в бакенде, но гораздо удобнее назначить параметрам типы. В этом случае проверка будет происходить автоматически до передачи данных в бакенд.
{{Alterator modules-nav}}
 
Делается это следующим образом. В бакенде добавляется ответ на запрос типа "type". В ответе перечисляются параметры, с которыми работает бакенд, и их типы. Для формирования правильного ответа стоит воспользоваться стандартной библиотекой, например для бакенда на shell объявление типов будет выглядить следующим образом.
 
<pre>
. alterator-sh-functions
 
on_message()
{
case "$in_action" in
  type)
    write_type_item a ipv4-address
    write_type_item b hostname
    ;;
  read)
  ...
esac
}
</pre>

Текущая версия от 12:57, 2 декабря 2008

Бэкенд

Существует два вида бэкендов: нативные и внешние. Размещаются эти бэкенды в каталогах /usr/lib/alterator/backend2 и /usr/lib/alterator/backend3 соответственно.

Нативные бэкенды пишутся только на языке scheme и работают внутри процесса alterator. Написание нативных бэкендов требует достаточно большого опыта программирования и большой аккуратности.

Внешний бэкенд может быть написан на произвольном языке программирования, при этом настоятельно рекомендуется использовать готовые библиотеки, предоставляющие API для взаимодействия с alterator. Все библиотеки построены по одному и тому же принципу - есть главный цикл взаимодействующий с alterator и есть функция-обработчик пришедших сообщений. В функции обработчике:

  • анализируется вид запроса (параметр action)
  • анализируется url запроса, а также значения входных параметров
  • вычисляются и выводятся значения выходных параметров.

Простейший бэкенд на shell

Пример простейшего бэкенда на shell:

#!/bin/sh -f

po_domain="alterator-foo"
api_version=1

. alterator-sh-functions

on_message()
{
        case "$in_action" in
               list)
                         write_enum_item "item1" "label1"
                         write_enum_item "item2"  "label2"
                         ;;
               read)
                      case "$in__objects" in
                         url1) write_string_param param1 "value1";;
                         url2) write_bool_param param2  "yes";;
                      esac
                      ;;
                write)
                    [ -n "$in_param1" ] && echo "$in_param1" >/tmp/file1
                    test_bool "$in_param2" && echo "yes">/tmp/file2
                    ;;
        esac
}

message_loop

В данном примере:

  • message_loop — запуск цикла обработки событий
  • on_message — обработчик входящих сообщний. Входные переменные выглядят как переменные $in_<имя>. Выходные печатаются при помощи функций write_* .
  • alterator_api_version — текущая версия API для взаимодействия с alterator.

Если к к бэкенду <name> обращались из интерфейса по адресу /<name>/foo/bar, то переменная $in__objects будет равна "foo/bar" (то есть "хвост" адреса), если обращались по адресу /<name>, то $in__objects будет равна "/".

Более подробная информация по написанию бэкендов на shell находится здесь.

Простейший бэкенд на perl

Пример аналогичного бэкенда на perl:

#!/usr/bin/perl -w
use strict;
use Alterator::Backend3;

$TEXTDOMAIN='alterator-foo';
$DEBUG = 1;

sub on_message{
  my message=shift;
  if ($message->{action} eq 'list'){
    write_named_auto_list('item1', 'label', 'label1');
    write_named_auto_list('item2', 'label', 'label2');
  }
  elsif ($message->{action} eq 'read'){
     write_string_param('param1', 'value1');
     write_bool_param('param2',  'yes');
  }
  elsif ($message->{action} eq 'write'){
    print F1 $message->{param1} if (exists($message->{param1}));
    print F2 ($message->{param2} eq '#t')? 'yes':'no' if (exists($message->{param2}));
  }
}

message_loop(\&on_message);

Здесь, как и в shell-бэкенде:

  • message_loop — запуск цикла обработки событий
  • on_message — обработчик входящих сообщений.

Обработчику передаётся ссылка на хэш с входными переменными. Выходные печатаются при помощи функций write_* .

При обращении из интерфейса по адресу /<name>/foo/bar, то в бэкенде <name> в этом хэше будет присутствовать //_objects// равный "foo/bar" (то есть "хвост" адреса), если обращались по адресу /<name>, то //_objects// равно "/".

Более подробная информация по написанию бэкендов на perl находится здесь.