Календарь на Май 2024 года: calendar2008.ru/2024/may/
Навигация
Главная »  Xml 

Введение в WML (исходники, документация)


Источник: arutunyan
Перевод Жаркова Алексея
Вступление

WML - язык разметки, основанный на XML (extensible Markup Language). Официальная спецификация WML разработана и поддерживается WAP Forum, производственным консорциумом, основанном Nokia, Phone.com, Motorola и Ericsson. Эта спецификация определяет синтаксис, переменные и элементы используемые в файлах WML. Последнее определение типа документа (Document Type Definition) для тех, кто знаком с XML, доступны по адресу: http://www.wapforum.org/DTD/wml_1.1.xml Любой правильный XML-файл должен соответствовать этому DTD. В противном случае он не будет правильно обработан. В этом руководстве, мы расскажем об основах XML и представим пример. Этот пример демонстрирует обработку событий, навигацию и обмен информацией с расположенным на сервере скриптом. Понимание WML

WML базируется на XML, языке разметки получившем невероятную поддержку благодаря своей способности описывать данные (HTML, кстати, используется для описания представления данных). HTML - предопределяет те тэги, которые могут быть использованы для описания страницы так, чтобы ее смог правильно понять и обработать броузер. XML, в свою очередь, позволяет создателю документа определять такой набор тэгов, которой он считает необходимым. Этот набор тэгов группируется затем в набор грамматических "правил", называемых по-другому Определение Типа Документа или проще DTD. Как уже упоминалось ранее, DTD, используемый для описания WML, расположен по адресу: http://www.wapforum.org/DTD/wml_1.1.xml В телефоне или в любом другом коммуникационном устройстве, заявленном как WAP-совместимое, загружено специальное программное обеспечение (известное как микроброузер), которое полностью понимает, как обрабатывать все вариации WML 1.1 DTD. Самая первая фраза внутри любого XML-документа называется пролог. Поскольку стандартен, он содержит две строчки кода: определение версии XML и DTD (указатель на файл, содержащий DTD) Пролог выглядит следующим образом.
  
Следом за прологом, в каждом XML-документе содержится один единственный элемент, который содержит в себе остальные подэлементы и entities. Так же как и в HTML этими элементами являются угловые скобки: <> и . Например: data. В документе должен содержаться только один элемент описывающий сам документ. В WML этим элементом является . Все остальные элементы содержатся уже внутри него. Два самых распространенных способа хранения информации внутри XML-документа это элементы и их атрибуты. Элементы определяют структурную разметку внутри документа открытием и закрытием определенных тэгов. Элементы, в свою очередь могут содержать подэлементы. Атрибуты в основном используются для описания элементов. В качестве примера можно привести следующий кусочек кода:
  Please select your user name.  
В этом примере элемент card содержит атрибуты id и title. Комментарий в WML, также как и в HTML заключается между тэгами . В дальнейшем мы будем использовать элементы и их атрибуты для написания примеров. Правильные WML элементы.

В WML описывается набор элементов, которые можно комбинировать для создания WML-документа. Эти элементы можно условно разделить на две группы: Элементы типа Deck/Card и элементы обработки событий. Элементы типа Deck/Card
wml card template head access meta 
Элементы обработки событий
do ontimer onenterforward onenterbackward onpick onevent postfield 
Задачи
go prev refresh noop 
Переменные

setvar
Ввод пользователя

input select option optgroup fieldset
Анкоры, Картинки и Таймеры
a anchor img timer
Форматирование текста

br p table tr td
Каждый их этих элементов может быть использован в документе используя следующий синтаксис. <элемент> значение элемента Если элемент не содержит внутри себя какую либо информацию (обычно такое случается с элементом форматирования
), вы можете использовать тэг с добавленным к нему "/" (например
). Строительство приложений с помощью WML

WML был разработан для для устройств с низкой пропускной способностью и маленьким дисплеем. В качестве составной этого дизайна была применена концепция дек и карт. Один WML-документ (а точнее элементы, содержащиеся внутри элемента ) называется декой (deck). Интерактивное взаимодействие с пользователем осуществляется с помощью карт (card). Достоинство такой реализации заключается в том, что несколько экранов могут быть загружены на клиентское устройство за один раз. Используя WMLScript, обработка действий пользователя может быть произведена с использованием находящихся в одной деке карт, исключая тем самым множественные транзакции с сервером. Конечно, в связи с ограниченными ресурсами клиентского устройства возникает другая проблема. Поэтому вам вполне возможно придется разбрасывать ваши карты по разным деками во избежании чрезмерного увеличения объема одного файла. Использование переменных

Поскольку, как мы говорили ранее, в одной деке может содержаться несколько карт, нам потребуется механизм хранения информации из одной карты для ее последующего использования в другой. Этот механизм обеспечивается переменными. Переменные могут быть созданы и определены, используя несколько различных методов.
  • Используя элемент в качестве результата выполнения пользователем определенных действий. Кроме того, этот элемент может быть использован для определения переменной внутри следующих элементов: , , . Следующий элемент создает переменную x и присваивает ей значение "123".
      
  • Переменным также присваивается значение через использование элементов ,
Несмотря на то, что мы не описывает WMLScript, следует отметить, что WML и WMLScript используют одни и те же переменные в рамках одной деки. Создаем деку

В этом примере, мы начнем создавать деку, которая позволяет нам сначала выбрать имя пользователя из предложенного списка, затем ввести пароль после чего выводит на экран полученные данные.
        UserName:  

Password:

You entered:
Name: $(name)
Password: $(password)


Как вы наверно уже заметили, вначале примера идет пролог, в котором мы определяем версию XML и DTD для нашего документа. Затем следует элемент , дека которая содержит три карты: Login, Password и Result. Каждая из этих карт определяется с использованием элемента . Поскольку карты Login и Password определяют события, они используют элемент для определения события которое произойдет, когда пользователь закончит ввод. Если мы определяем элемент типом "accept" он появляется на экране в качестве опции Выбор этой опции приведет к анализу введенной пользователем информации. Атрибут "href" тега работает так же, как и в элементе из HTML. Также как и в HTML, для того, чтобы на экран вывелась другая карты из активной деки, на нее надо сослаться используя символ "#" перед именем карты.
 
Эта карта обрабатывает пользовательский ввод и используя определенные в предыдущей карте переменные выводит их содержимое на экран. Вызов переменных осуществляется следующим образом:
$(variable_name) 
Вызов скрипта

Без возможности производить различные операции с информацией на сервере, WML остался бы просто средством форматированного вывода текста. Добавление такой возможности, напротив, открывает любому WAP-совместимому устройству пути передачи сообщений через Интернет, промышленному использованию на предприятии и электронной коммерции. WAP-совместимое устройство взаимодействуют с подобными источниками информации через WAP-шлюз. Этот шлюз должен уметь взаимодействовать с различными стандартами сотовой связи, такими как CDMA, GSM или GPRS. Однако, вполне возможно установить тестовый шлюз в сочетании с популярными веб-серверами (такими как MS IIS или Apache) прямо в вашей локальной сети. Мы не будем тут сильно вдаваться в детали процесса установки шлюза, однако нельзя не предостеречь вас от самой распространенной ошибки. Вам обязательно необходимо добавить определения следующих типов в конфигурацию веб-сервера.
WML text/vnd.wap.wml wml WMLScript text/vnd.wap.wmlscript wmls 
Теперь мы рассмотрим небольшой примерчик в котором пользователю будет предложено сделать выбор какой-то одной опции а затем на основе этого выбора с сервера будет загружена определенная информация. Для этого примера мы используем ASP. С тем же успехом мы могли написать скрипт использую Javascript, Servlets, Perl или любой другой язык. В следующем листинге приведен исходный код для нашей новой деки. В ней содержится всего один элемент

Скрипт показанный на листинге 3 обрабатывает полученную из деки информацию и выводит на экран результат.
<% Dim Body If Request.Form("Items") = "Books" Then Body = "You selected Books!" ElseIf Request.Form("Items") = "Video" Then Body = "You selected Video!" ElseIf Request.Form("Items") = "Software" Then Body = "You selected Software!" ElseIf Request.Form("Items") = "Music" Then Body = "You selected Music!" End If Response.ContentType = "text/vnd.wap.wml"%>      <%Response.write(Body)%> 

Несколько вещей необходимо напомнить для тех, кто захочет повторить этот пример в своих условиях. Вы обязательно должны "зарегистрировать" MIME типы на своем сервере для того, чтобы файлы WML и WMLScript правильно обрабатывались и отображались сервером.
.wml text/vnd.wap.wml .wmls text/vnd.wap.wmlscript 
Если вы хотите использовать картинки (WBMP) вам также необходимо добавить и этот MIME-тип:
.wbmp image/vnd.wap.wbmp 
Заключение

WML предоставляет разработчикам совершенно новую замечательную платформу для создания приложений. Эта платформа бросает нам новый вызов. Новые нюансы, связанные с низкой пропускной способностью, маленьким экраном и различными серверными заморочками, добавятся в процесс дизайна. Несмотря на то, что производителям придется пройти различные стадии осознания новых возможностей и ограничений для того чтобы суметь наконец достаточно внятно сформулировать коммерческое предложение, WAP открывает широкие двери в новую эру разработки и развертывания приложений. Описание тегов (переведено из документации Motorola SDK) :

Деки. Дека определяется элементом wml
    Hello World!

Задачи

Элемент: Do Атрибуты: type - указывает микроброузеру назначение кнопки. В WML определяется девять типов, но в подавляющем большинстве случаев используются "accept" и "options". label - значение этого атрибута используется для замены названия кнопки. Это помогает кастомизировать приложения. Количество символов на кнопке ограничено возможностями устройства. name - установка этого атрибута дает возможность разработчику воспользоваться преимуществами иерархической структуры WML-документа. Элемент "do" с именем "one" унаследует свойства определенные элементу с таким же именем в элементе "template" этой деки. optional - указывает микроброузеру на необязательность показа этой кнопки в случае если атрибуту присвоено значение true. Элемент Go Атрибуты: href - URL. sendreferer - этот атрибут необходим серверу в списках контроля доступа. Его значение указывает броузеру на то, что необходимо отослать на сервер URL минимально возможной длины. method - может принимать значение либо "post" либо "get". Значение аналогично HTML. accept-charset - указывает кодировку, в которой микроброузер должен посылать ссылку. Небольшой пример простейшей навигации.
       Hello World!

Next Card!

Элемент Setvar Атрибуты: name - имя, присваемое переменной. Переменная так же может выполнять эту функцию, например:
.
value - значение, присваемое переменной. Элемент Postfield Атрибут: name имя, присваемое переменной. Переменная так же может выполнять эту функцию, например:
. 
value - значение, присваемое переменной.
            Hello World!

Элемент Anchor Атрибуты: title - имя элемента. Микроброузер может воспользоваться этим атрибутом по своему усмотрению. При перемещении курсора на анкор, микроброузер может вывести его имя в софт-кнопке. Элемент A Атрибут: href - URL на который ссылается анкор. У этого элемента нет дополнительных атрибутов позволяющих указать статус ссылки или ее метод. Если необходимы эти опции можно воспользоваться элементом "anchor" с внедренным в него элементом "go":
 click me   click me 
События

Элемент Onevent Атрибуты: type - Тип события, которое будет обрабатываться Существует четыре типа событий: onenterbackward
Сработает при выборе элемента "prev" onenterforward
Сработает при вызове карты onpick
Сработает при выборе опции в списке элемента "select" ontimer
Сработает по истечении времени у элемента "timer".
       Choose Accept.

Choose Accept

Choose Accept.

Структура

Элемент Access Атрибуты: domain - имя домена для запрета доступа. Микроброузер будет просматривать и сравнивать со значением этого атрибута все имена доменов встречающиеся в документе. Так если "" броузер сможет зайти на "http://www.motorola.com/", но не сможет зайти на "http://www.rola.com/" или на "http://www.motorola.net/". path - путь для сравнения. Работает примерно так же как и атрибут домен. Так если "" путь "/internal/wml" пройдет проверку, в то время как "/internal-wml" - нет. Элемент "access" с примерно такими атрибутами: "" разрешит ссылку на деку только со следующих адресов: http://www.motorola.com/spin/getuid.cgi
https://www.motorola.com/spin/index.wml
http://www.motorola.com/spin/madk/create_index.cgi?x=123&y=234 А с этих запретит: http://www.mot.com/spin/getuid.cgi
http://www.motorola.com/internal/spin/getuid.cgi Элемент Card События: onenterbackward
Сработает при выборе элемента "prev" onenterforward
Сработает при вызове карты ontimer
Сработает по истечении времени у элемента "timer". Атрибуты: id - атрибут, позволяющий сослаться на эту карточку из других элементов. Ссылка на карточку состоит из символа "#" и значения ее атрибута id (#nextcard). title - значение этого атрибута может быть использовано для озаглавливания экрана, в котором отображается карточка, а также может появится в списке ранее посещенных страниц, а также в любом другом месте по усмотрению микроброузера. newcontext - может быть использован для того, чтобы сбросить состояние деки. Этот атрибут может иметь значение "true" или "false". ordered - сообщает микроброузеру принадлежит ли эта карта к упорядоченному списку карт или нет. Разработчики могут использовать этот атрибут по своему усмотрению и разрабатывать либо деку с последовательным просмотром карточек, либо состоящую из одной большой карточки. Немного более сложная дека в качестве примера:
         Start Here. 

Card Accept

Card Accept2

Управление

Управляющими элементами в WML являются элементы "select" и "input". У каждого есть несколько подэлементов, а также механизм группировки, для приведения нескольких относящихся друг к другу элемементов ввода к одной логике. Также тут присутствует атрибут tabindex. этот атрибут определяет последовательность в которой происходит передвижение по элементам. Элемент Select Атрибуты multiple - по умолчанию равно "off". При включении этого атрибута пользователь может выбрать несколько элементов из предложенного списка. name - обозначает имя переменной в которой будет храниться значение введенной в этом поле информации. value - значение элемента по умолчанию. iname - имя выбранного элемента(ов) списка. Значение "0" означает, что в списке нет элементов. Нумерация элементов списка начинается с "1" и постепенно увеличивается. ivalue - имя переменной, в которой содержится значение(я) выбранных элементов списка. Несколько значений можно ввести, разделяя их ";", например (1;2) . Нельзя вводить пустое значение переменной. Так значение (1;;2) - неправильно. title - заголовок. Указывается для того, что бы микроброузер определил тип навигационного элемента. tabindex - очередь следования этого элемента относительно других. Реализация зависит от броузера. Элемент: Option Атрибуты: value - значение, присваемое переменной элемента select, в случае выбора этой опции title - заголовок. В зависимости от микроброузера может не выводиться на экран. onpick - URL на который пойдет микроброузер, в случае выбора этой опции. Элемент: Optgroup Атрибуты: title - заголовок. В зависимости от микроброузера может не выводиться на экран.
     Bogus:  



Pick your fav Stooge:

Pick your fav Marx Bro.

Your fav was $fav.

Элемент: Input Атрибуты: name - то же, что и в элементе select. обозначает имя переменной в которой будет храниться значение введенной в этом поле информации. value - значение поля по-умолчанию. type - имеет значение либо "text" либо "password". В зависимости от микроброузера поле типа "password" может отображаться на дисплее видимым текстом. format - маска ввода. A - Любая буква в верхнем регистре [A-Z]
a Любая буква в нижнем регистре и пунктуация [a-z]
N - любая цифра [0-9]
X - любой символ в верхнем регистре [A-Z,0-9]
x - любой символ в нижнем регистре [a-z,0-9]
M - любой символ
m - любой символ
*f - любое количество символов определенного формата, например *N -любое количество цифр
nf - "n" это целое число так например "3A" означает 3 буквы в верхнем регистре или пунктуации.
\c - символ ввода, так например "\(3N\)\ \3N\-4N" означает номер телефона с кодом местности в американском формате.
emptytok - разрешает пустой ввод size - ширина поля ввода. Реализация зависит от броузера. Maxlength - определяет максимальное количество вводимых. Title - заголовок, показывается броузером в некоторых случаях. Рекомендуется использовать атрибут title во всех элементах, которые им располагают, потому что в некоторых телефонах заполнение поля ввода реализовано в виде отдельного окошка, при этом title будет выводится в качестве напоминания, какое именно поле в настоящий момент заполняет пользователь. Элемент: Fieldset - Использование зависит от микроброузера. Атрибуты: title - Заголовок
      Field Type:  

First Name: Last Name: Gender:

$fname $lname is a $gender.

Input a password:
Min 3 chars.

Password was $passwd.

Таймер

Элемент: timer Атрибуты: value - промежуток времени в десятых долях секунды.
     Wait ten seconds

Подождите минутку

Текст

У элемента p нет атрибутов У элемента br нет атрибутов



 

 
Введение в WML (исходники, документация).
 ABBYY FineReader 10 Corporate Edition.
 Новая модификация троянца Android.Spy превращает смартфон в "зомби".
 Autodesk Flame Premium 2012: инструменты для полного контроля над творческим процессом.
 Oracle Enterprise Pack for Eclipse 11g ускоряет разработку Java-приложений и приложений Oracle Fusion Application.


Главная »  Xml 

© 2024 Team.Furia.Ru.
Частичное копирование материалов разрешено.