WML基本知识.doc

WAP建站进阶WAP建站进阶 在对WAP的概念有了初步的了解之后，读者将要重点学习如何使用WML标记语言和WMLScript脚本语言进行开发。本章首先介绍了一些流行的WAP工具包，然后深入浅出地介绍了WML和WMLScript，并且还有详尽的实例供初学者参考。详细的WML标记和WMLScript函数库是难得的中文参考资料。一、 WAP工具包 目前WAP技术还处于初步的发展阶段，但是它的出现引起了公众的强烈兴趣。WAP业务在欧洲开展得较早，目前将有更多的业务在北美和亚洲展开。很多WAP开发商推出了一些WAP应用工具，以进一步加快WAP应用的发展。WAP工具包 目前WAP技术还处于初步的发展阶段，但是它的出现引起了公众的强烈兴趣。WAP业务在欧洲开展得较早，目前将有更多的业务在北美和亚洲展开。很多WAP开发商推出了一些WAP应用工具，以进一步加快WAP应用的发展。在这里将要介绍一下目前四个主流的WAP工具包：o Ericsson WapIDE 2.0 o Nokia WAP Toolkit 1.2 o P UP.SDK 4.0 o Motorola ADK 1.0 虽然这四家公司都是WAP论坛的主要成员，但是他们的开发工具包在很多方面都有所不同。如果读者正打算开发第一个WAP应用，建议使用Nokia WAP Toolkit作为入门工具。阅读工具包中所带的例子是学习WAP好方法。下面主要整体介绍各种工具包，具体的功能与操作可以参考前面对Nokia WAP Toolkit的功能介绍。Ericsson WapIDE 2.0 Ericsson WapIDE 2.0具有集成化的WAP开发平台。它由一系列能支持设计和WAP测试的应用工具构成。同时它支持自己设计和更换测试设备的外形。WapIDE的SDK目前只能在Windows NT 4.0和Windows 95/98下使用。在WapIDE中还有用于测试服务器应用的程序。这些包括Perl 5.0、Tcl/Tk和Xitami Web Server。安装WapIDE需要首先安装IDE，然后安装SDK。还需要注意的是：如果不安装Xitami Web服务器，那么整个安装过程就失败了。所以如果读者已经有了其他的Web服务器，可以先关闭它。等安装完成后关闭Xitami Web服务器，再恢复原来的Web服务。在安装的时候，最好安装全部功能选项。如果不需要Xitami Web服务器，那么就不要选择Xitami Web服务器自动启动这一项。否则在重新启动机器的时候IIS会与Xitami Web服务器产生冲突！图 3-1 WapIDE 2.0 图3-1所示是WapIDE的一个界面，其中包括浏览器（用于测试应用程序）、应用设计器（用于编写应用程序）和一系列服务器端工具集（一些工具诸如：WML/WMLScript编译器和一个语义分析器）。图 3-2 浏览器 浏览器（图3-2）支持使用不同的设备（缺省情况下设备显示的是R320s的样子），允许使用者测试工具包中带有的WAP URLs例子，或测试自己编写的应用，这些WAP应用例子包括金融、股票和日程等的应用。在使用这个浏览器的时候有一个十分有意思的事情：必须按住开机按钮，才能启动浏览器并开始使用。否则，读者就会弄不懂它为什么不工作。 读者的大部分时间将会花费在应用程序设计上。这个部分集成了一个WML编辑器和一个WapIDE浏览器，这样编程序和测试将在一起实现。这是一个十分朴素的开发环境，相关文档也比较少，只有一些Adobe Acrobat的文档可供下载。 Nokia WAP Toolkit 1.2 Nokia的WAP工具包在某些方面很类似于Ericsson的WapIDE。两个产品都有图形开发环境、浏览器和WML/WMLScript编译器。Nokia工具包目前只能在Windows NT 4.0上运行。要注意的是Nokia WAP Toolkit需要Java运行环境。所以需要先到Sun的Java站点下载一个Java 2 SDK或者Java 2 Runtime Environment（JRE）才可以安装和使用Nokia WAP Toolkit。 工具包安装完之后，可以看到WAP工具包程序组中包括一个工具包IDE。还有很多关于WAP、WML和WMLScript的详细文档以及工具包本身的使用指导。该工具包支持在同一个应用下进行编辑、修改和测试WML/WMLScript文件等工作。 用户可以通过输入WAP应用的URLs或通过WAP网关进行浏览网页。Nokia还出售一个独立的基于WAP 服务器的Java Servlet。该产品将应用服务器功能和WAP网关功能集成到一个产品中。总体来说，Nokia WAP产品相对于Ericsson WapIDE产品显得较成熟、实用。P UP.SDK 4.0 P公司的UP.SDK产品适用于Windows 95/98/NT 和 Solaris。与Nokia和Ericsson的产品有稍许区别，它不带有图形的IDE。也没有提供编辑和测试WML/WMLScript程序代码的集成环境。UP.SDK更着重于提供一系列可由不同语言（如：WML、Perl、C、C+和VB等）重复使用的代码库。P是WAP微浏览器制造的领先者，很多WAP手机中采用的都是P公司提供的WAP微型浏览器。模拟器UP.Simulator如图3-3所示。模拟器目前只能在Windows平台上运行。图 3-3 UP.SimulatorUP.Simulator在启动的时候将自动连接P开发者站点，所以需要保持与Internet的连接。UP.Simulator无法脱机使用，也无法直接打开WML文件。推荐大家去试用一下该产品，它会很直观地让读者感觉到WAP的用途。在一两秒之内就能使用UP.Simulator查到本地的天气情况，看到世界各地的新闻。UP.SDK还包括有供Perl和C语言使用的库函数，可以用来生成WML文件，控制HTTP请求等。另外，UP.SDK有请求并安装SSL证书的安全性工具。P除了提供标准的WAP功能外，它还扩展了更多的WAP功能如传真、通知等。Motorola Mobile ADK 1.0 从总体上来说MADK提供了一个完整的集成开发环境和浏览器。使用的时候会发现它的工作方式和Visual Studio的工作方式很像（图3-4）。因此对于习惯于使用微软产品的开发人员来说将是十分顺手的。另外MADK还提供了比较完整的帮助文档，里面除了介绍WML和WMLScript以外，还介绍了VoXML。图 3-4 MADK集成开发界面图 3-5 模拟器 如果操作系统为WinNT或者Win98，那么在安装MADK之前必须更新Java虚拟机，否则安装过程就会失败。在安装的过程当中，还将附带地安装Voice Agent。在使用的过程当中，读者会发现MADK不如Nokia WAP Toolkit成熟。例如：如果直接输入中文，就会引起编辑界面的混乱；在每次模拟完成之后，必须停止模拟器（图3-5）再重新打开，否则无法进行新的测试工作；再每次编译之后留下一大堆的WMLC文件；更奇特的是在Nokia WAP Toolkit编译通过的页面，在MADK上就可能通不过。 其他工具包工具包编辑器模拟器调试工具例子程序在线文档Nokia WAP Toolkit 1.2/main.htmlMADK 1.0WapIDE SDK 1.2/developerszone/UP.SDK 4.0WAPObjects/wapobjects/en/WAPPage 1.0/Products.aspCardONEhttp:/www.peso.de/wap_en/index.htmWAP Developer Toolkit 1.0/wap/index.htmlPWOT WML Toolshttp:/pwot.co.uk/wml/二、WML简介 WML是一种基于XML（扩展标记语言）的一种标记语言。这种语言是为无线设备用户提供交互界面而设计的。这些无线设备包括电话、呼机和个人数字助理（Personal Digital Assistants）等等。 WML是一种基于XML（扩展标记语言）的一种标记语言。这种语言是为无线设备用户提供交互界面而设计的。这些无线设备包括电话、呼机和个人数字助理（Personal Digital Assistants）等等。 WML是为具有以下特点的设备而设计的：体积小（相对于个人计算机）。 有限的内存和CPU大小。 通讯带宽窄和时延长。 现在支持WML的设备大致分为两大类： 电话棗其特点就是只有410行的文本屏幕。用户通过电话的按钮进行输入。 个人数字助理（PDA）棗其特点就是能支持100100分辨率（或者更好）。用户能够通过键盘、鼠标或者手写输入。 现在正期待着其他的手持设备同样能支持WML。 因为WML支持许多功能不同的设备，因此文档中列出了这些设备至少应有的功能或者是参考设备。参考设备有以下的特点： 有一个显示屏幕，能显示4行字符，每行12个字符。包括保留给功能按钮的那一行。 支持ASCII的可打印码。 支持数字和字符的输入。 支持使用箭头或者数字按钮进行选择。 两个可编程功能键，ACCEPT和OPTIONS，并且显示在接近键盘的屏幕下。 一个PREV导航键。 支持垂直滚动的箭头按键。 支持水平滚动（不是使用自动换行）。 字符集 WML使用XML的字符集棗也就是当前使用的通用的字符集ISO/IEC-10646（Unicode 2.0）并且支持其他系列的子集（例如：US-ASCII、ISO-8859-1或者UTF-8）。不必使用整个Unicode（UCS-4）编码，除非正在使用的不是UTF-8编码。大小写敏感 不象HTML，WML是一种大小写敏感的语言。所有的标签、属性和枚举属性都必须使用小写。在编写WML页面的时候，必须注意到大小写。包括参数的名字和参数的数值都是大小写敏感的。例如：variable1、Variable1和vaRiable1都是不同的参数。不显示的字符 表3-2中包括了在WML中不显示的字符：表 3-2 不显示的字符字符8位十进制值换行10回车13空格32水平制表符9除非特别的指定，WML将一个或多个连续的换行、回车、水平制表和空格转换成一个空格。换句话说，忽略所有的多于一个以上的不显示字符。例子1：Some text例子2： Some text 上面的例子中，手工地使用换行和回车保证程序的可读性，但不是很必要。文件开场白 所有的WML页面必须在文件的开头处声明XML文件类型： 为了将这个开场白自动地加入到页面中，读者可以使用函数调用来实现。 注意：为了确定WAP浏览器的类型和版本，可以通过捕获HTTP头中的USER_AGENT来进行。Content Type 为了建立一个有效的WML信息实体（MIME type），必须在文件的开场白之前指定文件的类型：Content-type: text/vnd.wap.wml 注意：必须（至少）在Content Type和XML文件声明之前保留一段空行。如果省略了，将造成编译器错误。过多的空行同样也会造成错误。属性 许多WML标记有一个或多个属性标记，有些是必须的，有些是可选择的。属性可以指定附加的信息，用来确定设备如何解释这些标签。WML标记有以下两种使用方式： content 必须使用成对的单引号或者双引号将属性值包含在内，每个属性之间使用空格分开。引用变量 很像UNIX下的Shell变量，可以在格式化的文本、URL、选择文本等等文本内容中使用变量。 使用变量的语法如下：$(myvar)。特殊字符 WML的保留字符：“”、“”、“”和“&”。为了在文本中显示这些字符，必须按照表3-3中规定的方式指定。表 3-3 指定特殊字符字符指定方式>'"&$连续空格 -­ 分号是字符标签的一个部分，不能省略。如果省略了，将可能会造成WML编译器错误。 注意：与HTML不同的是，当在URL中使用&的时候必须使用&来代替字符&。三、WML重点在对WML有初步了解的基础上，下面将要讲述的是WML语法中的重点部分。了解这些部分就等于对WML有了一个比较全面的了解。基本规则 WML使用XML文档字符集，目前支持Unicode 2.0。与HTML不同，WML的所有标签、属性和规定的枚举值必须小写。卡片的名字和变量也是区分大小写。和HTML一样，对于连续的空字符，只显示一个空格。标签内属性的值必须用双引号或者单引号括起来。属性名、等号和值之间不能有空格。对于不成对出现的标签，必须在“”前加“/”。比如：。在对变量的引用上和HTML基本相同，有以下三种形式： $(var1:esc) $(var1:noesc) $(var1:unesc) 三种形式，具体含义可参见HTML的相关部分。在对保留字符的处理上也基本相同，对应的替代字符请详见“字符实体”。这里要指出的是在URL的传递过程中，用来连接参数的&必须转化为&。基本格式和文件头 wml文件的一般格式： Some contents. 结构看上去和HTML文件很类似，对于每一个页面，在其文档开头必须指明以下的类型声明： 千万注意字母的大小写。对于一个页面，其文件大小最好不要超过1.2K。 标签和HTML中的标签一样，用来表明这是一个WML的页面。它有一个可选的“xml:lang”属性来制定文档的语言，比如表示文档语言为中文。 和HTML一样标签包含了该页面的相关信息。标签之间可以包含一个标签和多个标签。 相当于HTML中的标签，指定该页面的访问控制信息。它用两个可选的属性，domain用来指定域，默认值为当前域；path用来指定路径，默认值为“/”，即根目录。由于单独使用，所以要用“/”结尾，以后对于类似的情况不再赘述。 和HTML中的类似，提供了该页面的meta信息。属性是必选的，包括以下三种情况：o name=name UP.Link Server忽略meta数据。 o http-equiv=name UP.Link Server将meta数据转为HTTP响应头（同HTML）。 o user-agent=agent UP.Link Server直接将meta数据传给手机设备。 content属性也是必选的，其内容根据属性而定。scheme属性目前尚不支持。forua为可选属性，指定在该wml文件传到客户端之前，标签是不是被中间代理删除（因为传输的协议可能改变），默认值为false。 目前支持的meta数据： 指定页面在手机内存缓存中的存储时间段，默认的为30天（除非内存耗尽）。在此期间，手机对于访问过的页面直接从缓存里调用。如果信息是对时间敏感的，可以用max-age指定页面在缓存里的生存期，最小单位是秒。如果指定为0，则每次都需通过连接服务器来调用该页面 类似于普通浏览器的书签功能。当用户将一个卡片做了书签后，手机浏览器首先用一个标记记录该卡片。这个标记默认的是标签中的title属性（以后会讲到）。然后当用户选择了该书签以后，浏览器就会打开被记录的URL。但是因为在默认的情况下，手机会记录所有的页面。所以，一般被用来使手机不要记录当前的URL，即。此外，如果要为书签指定不同于当前页面的URL，用。 一个页面可以包含多个卡片，每个卡片的内容可能不止一屏显示，注意页面、卡片和屏幕显示范围的关系。一个卡片用和包含。可以包含以下可选的属性： id属性用来指定卡片的名字，可用来在卡片间跳转，相当于在HTML中在页内跳转时用。 title属性用来作为书签的标记，该属性一般不会显示在屏幕上。 newcontext属性（默认值为false）用来指示当跳转到本卡片时，手机是不是要清除以前保留的信息。包括变量、堆栈里的历史记录、重新设置手机状态等。 ordered属性（默认值是true）表明该卡片里的内容是按固定的顺序显示，还是按用户的选择顺序来显示。这点和HTML不同，卡片里的内容可以按一定的顺序显示。默认的是按线性顺序显示，即按代码的顺序。但是，要注意的是，以下三个标签必须按以下顺序来写：、（这和以后要讲的“事件”有关）。这样做是为了方便填表单，当ordered设置为true时，如果一个表单的内容不能在一屏里显示完，就分成多屏显示；当ordered设置为false时，手机可以显示一个概要卡片来总结有效的选项，用户可以从中选取表单选项来填写。 onXXXX属性，类似于HTML标签中的onXXXX属性，用来捕捉事件。当事件被触发时执行指定的操作（任务），在这里是转向某个URL。显示文本 在文本的显示上WML基本和HTML相同。文字段落包含在和之间。align属性指定该段文字的对齐方式，默认的是left。其他可选择right和center；mode属性指定当一行显示不下所有的文字时是否自动换行。默认的是自动换行wrap。如果选nowrap，则在一行中显示，浏览器会通过类似于水平滚动条的机制来显示所有文字。 换行标签也一样为。这里先提一下，在表单中如果有多个或者，其间不要用，否则会使手机浏览器认为是断点而把表单分页显示。 文字的修饰标签有、和，意义和HTML里的相同。表格的显示标签也和HTML相近，使用、和来显示。的title属性用来给表格取个名字，columns属性指定表的列数，不能为0。可选的align属性和前面提到的一样是对齐方式。表格中可以包含文字和图片。 请研究下面的例子程序： Hello World! 1-1 1-2 2-1 2-2 图3-6是使用Nokia WAP Toolkit的测试结果（表单很漂亮！）。图 3-6 表单测试结果显示图片显示图片（1位黑白BMP图片）的标签一样类似于HTML。 属性中alt和src是必须要有的，其他是可选的。另外要注意的是要放在里，不能放在和等功能健标签和选单标签里。 alt属性用来指定当手机不支持图片显示时用来显示的文字。 src属性指定图片的URL，但当有了以下的localsrc属性时，手机浏览器就忽略src属性。 localsrc属性用来指定显示存在手机ROM中的图标，如果找不到，则到UP.Link Server上去找。 可选的align属性用来表明图片同当前行文本的对齐方式，默认值为bottom，可选to和middle。 height、width、vspace、hspace属性分别指定图片的长宽和距环绕文字的间距，目前不是所有的WAP手机都支持这些属性。 请研究下面的例子程序： 锚和任务 链接是HTML页面里最基本的功能，在WML里也一样用和来包括用来建立链接的文字。必选属性href指定了要打开的URL；可选的title属性给该链接取个标记名字，这个名字将作为软按钮之一的ACCEPT键的标记显示在屏幕的软按钮区，所以通常可以将属性作为提示文字使用。 然而，以上的链接在WML里只是任务的一种情况。为了能够使用其他任务，所以引进了新的标签任务标签文本。其实是当任务标签为时的简单表示方式。 News Sports WML里的任务标签有以下几种，除了用于，还可以用在事件中： 用来指示浏览器显示指定的URL，包括页面的第一个卡片或者指定的卡片。语法如下：其中href属性为必选，其他属性为可选。 sendreferer属性表示是否传递调用href所指定的URL的页面的URL。也就是当前页的URL，即HTTP头中的HTTP_REFERER。默认值为false，可选值为true。 method和HTML中的表单FORM的method属性一样，指定表单是以get的方式还是post的方式递交，以便CGI处理。默认的值为get，但如果未指定method但与间存在，手机自动以post方式传递。 accept-charset属性可以覆盖HTTP头里指定的字符集。可以写多个字符集，如accept-charset=UTF-8,US-ASCII, ISO-8859-1。 可以看作是HTML表单FORM中的，通过它可以向指定的URL传递以“变量名/值”形式的数据。name和value属性都是必选的。注意只有这里的变量是用来递交给CGI程序的。 除了，还可以在和之间加入一句或者多句。该语句的意思是，当触发某一事件时，给变量赋值。 要注意的是：当和之间没有任何语句时，要用的形式，这点比较特别。比如：News。 用来将当前页面的URL压入URL历史堆栈，并打开此前的URL。若该URL不存在，则无效。语法类似： 和之间可加入一句或多句。若不加，则必须变成的形式。 用来刷新当前的页面，从而使得页面内的变量刷新，语法为： 表示什么也不做。该标签不能用在中，一般用在覆盖页面级的事件模板。显示表单 类似于HTML的。可用来包括一组表单选项，但不是必须的。前面说过，当的ordered设置为false时，手机可以显示一个概要卡片来总结有效的选项，方便用户从中选取表单选项来填写。概要卡片就是根据和独立的输入框以及选单来总结的。语法为： 表单内容可选的title属性除了可以用来表示表单的名字外，还在概要卡片里作为选择项的标题。表单内容可以是嵌套的，输入框，选单和必要的提示文本。 用来输入文本，除了name属性是必要的，其他可选。 name属性，指定了用来存储该输入文本的变量名字。 title属性，该输入框的名字，同样可被用来作为概要card页中的选项名。 type属性，默认值为text，如选择password，则输入的数据显示为*。 value属性，在语法和行为上等同于下面的default属性。 default属性，指定输入框的默认值，即name属性指定变量的默认值，当用户输入新值时，该值无效，如果该值不符合以下format属性的规定，则手机忽略该默认值。 format属性，用来格式化输入的数据，可用的标记如下，使用时可用“一位数字标记”和“*标记”的形式，前者代表N个标记型字符，如3X，后者代表任意个（小于maxlength属性的值）标记型字符。表3-4中包括了在format中常用的枚举数值及其意义。 表 3-4 格式化标记标记描述A任何符号或者大写字母（不包括数字）A任何符号或者小写字母（不包括数字）N任何数字（不包括符号或者字母）X任何符号、数字或者大写字母（不可改变为小写字母）X任何符号、数字或者小写字母（不可改变为大写字母）M任何符号、数字或者大写字母（可改变为小写字母）或者多个字符，默认为首字大写M任何符号、数字或者小写字母（可改变为大写字母）或者多个字符，默认为首字小写 maxlength属性，指定了用户可输入的最大字符长度，最大限制为256个字符。 emptyok属性，表示用户可否不填输入框，默认为false，即要填。 size属性，输入框显示长度，目前未被支持。 tabindex属性，类似于在HTML表单中按TAB键后，焦点落在哪个选项上，该值决定了选择顺序，数字大的排在后面。目前未被支持。 为了说明输入格式对用户的影响，请看下面的例子程序： USERNAME: PASSWORD: COMMENTS: 启动Nokia WAP Toolkit，并选择“Go”下的“Open Location”，在输入URL地址后，可以看到模拟器上出现图3-7所示的内容。注意光标默认地指在PASSWORD的编辑框内。图 3-7 用户输入界面 选择“Options”进行编辑，多按几次按钮。在输入没有满8个之前选择“OK”，模拟器没有任何反应；当超过8个以后就无法再输入。这就是8x的限制在起作用。并且由于PASSWORD输入属性type为“password”因此显示出来的都是“*”（图3-8）。要注意的是：在输入的时候不要太快，否则总在一个字符上切换。如果读者用过手机，应该知道这点。图 3-8 Password输入界面 在删除所有的字符时候，“Clear”变成了“Back”（图3-9）。模拟器返回以前的页面。图 3-9 删除所有的字符 当编辑“User Name”的时候，发现输入的自动都变成大写（图3-10）。这是因为M起作用。如果输入超过12个字符，那么将无法再输入字符。这是maxlength在起作用。图 3-10 编辑User Name 当然可以使用这个按钮，将输入方式切换到小写（图3-11）。图 3-11 切换大小写的按钮 现在可以输入小写字符了！（图3-12）图 3-12 输入小写字符 如果这个时候按“OK”，那么USERNAME就变成了“GJTMW.g”（图3-13）。这是由于M前面是“*”的缘故。它不限制输入字符的数目。但是如果将“User Name”中所有的字符清除，再选择“OK”就不行。这是emptyok在起作用。它要求至少输入一个字符。读者自己试试吧！图 3-13 User Name已经改变 将上例中的ordered的值改为“true”试试看，然后再在和内加入和试试看。（Nokia WAP Toolkit好像对这些变化视而不见） 选单类似于HTML表单中的。和间可包含和标签，语法如下，所有属性都为可选： 选单内容 事件或者文本 title属性，如以上的title属性。 multiple属性，指定用户可否进行多项选择，默认值为false。 name属性，用来存储用户选择项的变量名，其值为标签的value属性。若用户没有选择又没有用default属性指定默认值，则手机将改变量赋值为空字符串（），对于多项选择，每个值用“;”分开。 default属性，可为name属性指定的变量赋成默认值。 iname属性，用来记录用户选择项的位置，相应的值从1开始。若没选，则该值为0。 ivalue属性，用来记录默认值所在的位置。 可用来将多个分组，和间还可包括和，该标签目前尚未被支持。 ，类似于HTML中选单的，用来表示选单的可选项。和间可包括事件和选单的显示文本。的属性为可选，其中value属性用来提供值。当选到该项后，将该值赋给的name属性所指定的变量。onpick属性，用来指定用户选到该项并按ACCEPT键后所打开页面的URL。 为了说明选择项的工作方式，请看下面的例子： Please select a city. Beijing