《MAS参考手册》doc版.doc

mastudio document2019-2-28 69/69中高移动互联应用平台MAS参考手册CHE3003 WD 2007Version 3.0Approved by : Copyright March , 2007 by mastudio Inc.This document and the information contained in it shall not be used, or published, or disclosed outside of mastudio in whole or in part without Mastudios consent. The copyright notice does not imply publication of this document.目 录一、概要3二、快速入门4三、语法结构5四、语法函数7五、对象列表8六、对象定义9七、语法范例43八、表达式48九、正则定义50十、事件接口58十一、资源文件59十二、安全机制65中高移动互联应用平台简称MAS系统或则MASTUDIO无线终端设备指：智能手机、PDA一、概要中高移动互联平台实现各种手机和PDA等掌上设备，便捷访问本地局域网络的所有资源，包括数据库查询、办公文件批阅、文件浏览、文件上传和下载，让用户快速建立个性化的移动应用，系统采用智能客户端技术，一次部署终身免维护。 系统可以识别本地网络中各种常见的数据库，可以无缝挂接到已经运行的各种数据库应用系统、挂接各种办公应用系统，无需二次开发，无需改动原有的数据库应用，即可将本地数据库应用延伸到掌上。 系统与具体业务数据无关，可自定义业务流程和菜单，可自定义客户端界面，支持各种常用类型的数据库，自动识别各种类型的数据字段。系统采用偶尔编程技术，系统定义有常见的功能组件，不需要进行编写程序即可使用，满足一般功能的需求。在少些地方也可通过编写程序来实现复杂功能，MAS系统采用兼容BASIC语法规则。二、快速入门平台分为服务器部分和客户部分，服务器部分用于安装在局域网机器中，客户部分安装于手机上，假设您已经正确安装了系统，并且手机已经通过数据线和服务器同步。对于计算机编程应用，似乎从例程“Hello World”起步已经成为传统。因此，我们第一个目的就是掌握如何让手机显示“Hello World”。首先，新建立一个登陆帐号，打开D:mastudioCommonaccount.ini文件，增加如下内容：wangxhHome=test.masDir=D:mastudiosample在D:mastudiosample目录下新建文本文件，文件名为test.mas。打开该文件输入如下内容：OBJECT wxCOMMON aCommonaCommon.Background= , Menu_Main.bmpOBJECT wxLABEL aLabelaLabel.Rect= 30, 100, 120, 40aLabel.Font= 15, 0x33FF22aLabel.Text= Hello World运行手机上客户端程序，输入用户名为wangxh，密码为空。点菜单确定后登陆进入系统即显示“Hello World”。本例程运用了wxLABEL来实现文本的显示。每一个.mas文件对应于手机的一屏，每一个.mas文件都包含各种类似wxLABEL的组件来控制当前屏幕的显示和动作。根据显示需要可编写任意多的.mas文件，.mas文件之间可进行切换以及相互调用。所有的.mas文件都在服务器端进行编写，即写即所得，手机端不需要任何改变登陆后就可显示最新的内容。关联.mas文件用记事本程序来编辑。三、语法结构MAS语言体系由以下语法规则组成，采用BNF来描述语法元语言（metalanguage）所使用的符号有五种，:= 定义为： 非终端符号 重复0-n| 或则 必选一:= := | | := | | | := | | | | | := := IF THEN ELSE ENDIF:=FOR = TO STEP :=NEXT :=REPEAT :=UNTIL :=WHILE :=WEND :=PRINT | ,|; | :=REM := +|- := *|/ := | | ( ):= := := | := :=.:= OBJECT . . := | := | := := := | | := = := = := = .:= | | := = , := = , := = . , . := . | .:= | | - | _ : | | | := a|b|c|d|e|f|g|h|i|j|k|l|m|n|o|p|q|r|s|t|u|v|w|x|y|z| A|B|C|D|E|F|G|H|I|J|K|L|M|N|O|P|Q|R|S|T|U|V|W|X|Y|Z:= 0|1|2|3|4|5|6|7|8|9:= +|-|*|/|.|,|;|?|_|!|#|$|%|&|*|(|)|:= 256:= Enter Key备注：每个语法单元由.mas文件保存，也可直接运行也可编译成.pkg文件运行。将CommCompiler.exe拷贝到.mas所在目录，运行后将编译成.pkg文件。四、语法函数平台所支持的常用函数：次序函数名参数备注1ITOAint整数转换到字符传2ATOIstring字符串转换到整数3FTOAfloat浮点数字转换到字符串4ATOF string字符串转换到浮点数字5LENstring字符串长度6LEFTstring int取字符串左边n位7RIGHTstring int取字符串右边n位8MIDDLEstring int int取字符串中间n位9TRIMstring去字符串头尾空格10SPLITstring string int拆分字符串11YEAR-当前年12MONTH-当前月13DAY-当前日14HOUR-当前时15MINUTE-当前分16SECOND-当前秒17NOW-当前完整日期时间五、对象列表编号对象名备注页码1wxCOMMON页面背景9wxDEFAULT默认动作92wxMENU菜单10wxPANEL导航按钮11wxHREF快捷方式123wxDATASOURCE数据库13wxQUERY查询15wxPROCEDURE脚本184wxGRID表格20wxFORM表单22wxTEXT文本27wxCURVE曲线285wxLABEL标签296wxDIR目录307wxDOWNLOAD下载328wxUPLOAD上传339wxVIEW视图3410wxNOTIFY事件-11wxINKPAD签字4112wxSHELL命令4213wxREDIRECT重定向4314sysGLOBAL系统全局对象44六、对象定义OBJECT wxCOMMON 对象是用来定义整个页面的背景，所以当需要设置一个页面的背景的时候，可将如下定义放在.mas文件中，注意必须放在文件的最上部分。OBJECT wxCOMMON aCommonaCommon.Background= 0x33B0FF, Menu_Main.bmp设置页面的背景颜色和背景图片，当只选用其中之一的时候，可以分别写成：aCommon.Background= 0x33B0FF或：aCommon.Background= , Menu_Main.bmp (注意这里有,号)一般情况下只需要选择设置颜色或则背景其中一种。OBJECT wxDEFAULT 对象是用来设置页面的默认动作，当没有任何对象定义有Link参数的时候，此默认对象起作用。OBJECT wxDEFALUT aDefaultaDefault.Attachment= 1, 0aDefault.Link= index.mas备注：后续所有Link参数中，当Link串中有%key的形式的时候，其会自动被参数中key所对应的值来替换，这主要应用于根据不通的记录而进入不同的mas文件。OBJECT wxMENU对象是用来显示一个菜单，选中后可以进入连接文件.mas，当第一次鼠标点中时，表示选中该项，第二次鼠标点中的时候表示执行。菜单项太多可分页显示，翻页按钮通过Prompt来定义。OBJECT wxMENU aMenuOBJECT wxITEM aItemaItem.Title= Menu11111菜单选择项目标题aItem.Icon= 3图标编号aItem.Link= Menu.mas连接文件OBJECT wxITEM bItembItem.Title= Menu22222菜单下一选项bItem.Icon= 4图标编号bItem.Link= Menu.mas连接文件aMenu.Rect= 18, 58, 160, 220显示位置范围aMenu.Font= 16, 0x3333FF字体颜色大小aMenu.Banna= 1, 0x3333FF, 0xEEAAEE指示条的风格1=立体 0=平面 ，指示条颜色和字颜色aMenu.Prompt= 100, 80, 18, 32 菜单分页按钮的位置和大小aMenu.Background= , menu_main.bmp菜单的背景和颜色（可选）aMenu.Attachment= 1, 0第一个参数表示按下左键时退回的层数，必须=1第二个参数表示按下右键时是否清除自己 =1清除 =0不清除备注：当向右执行连接文件的需要传递参数，可进行如下定义：OBJECT wxITEM aItem.OBJECT wxPARAMETER aParaaPara.Name= menu每个菜单项目都可以定义自己的参数。OBJECT wxPANEL对象用来显示一个导航面板，定义面板的大小位置以及行数，每行显示的按钮个数。按钮的图标请参看资源文件定义部分。OBJECT wxPANEL aPanelOBJECT wxITEM aItemaItem.Title= Panel面板按钮文字aItem.Icon= 1图标编号aItem.Link= Panel.mas连接文件OBJECT wxITEM bItembItem.Title= Grid面板下一按钮bItem.Icon= 2图标编号bItem.Link= Grid.mas连接文件aPanel.Rect= 18, 58, 180, 220显示位置范围aPanel.Cell= 2, 3面板列数行数aPanel.Font= 12, 0x3333FF字体颜色大小aPanel.Banna= 1, 0x3333FF, 0xEEAAEE选中按钮文字第一个参数保留，后面表示前景和背景aPanel.Prompt= 180, 80, 18, 32 面板分页按钮的位置和大小aPanel.Attachment= 1, 0第一个参数表示按下左键时退回的层数，必须=1第二个参数表示按下右键时是否清除自己 =1清除 =0不清除备注：当向右执行连接文件的需要传递参数方法如同wxMENU所描述。OBJECT wxHREF 对象用来显示一个超链接，分为文字链接和图片按钮链接，第一点鼠标选中，第二点鼠标执行连接。OBJECT wxHREF aHrefaHref.Link= grid.mas连接文件aHref.Attachment= 1, 0连接属性aHref.Rect= 10, 10, 40, 30链接范围aHref.Button= 10, 10, 30, 30按钮图片开始位置和选中后的开始位置aHref.Text= 表格文字链接aHref.Font= 12, 0xFFAAFF, 0xEEFFEE文字大小和颜色以及选中后的颜色备注：必须位于.mas文件的根一级中，wxHREF中同样可以放置wxPARAMETER传递参数给链接页面。aHref.Link= VK_UP表示按下向上aHref.Link= VK_DOWN表示按下向下aHref.Link= VK_LEFT 表示返回上页aHref.Link= VK_RIGHT 表示进入下页aHref.Link= VK_EXIT 表示退出系统可选参数DClick= True 表示必须双点才执行。OBJECT wxDATASOURCE对象用来定义和数据库的连接，该对象包含各种数据库的连接，连接的定义提供给wxQUERY、wxPROCEDURE使用。OBJECT wxDATASOURCE aSourceprivate:aSource.Database= MSSQL数据库类型aSource.Server= 9主机地址aSource.Login= mastudio登陆名aSource.Pwd= mas123密码aSource.Timeout= 10超时标签private: 表示以下语句只允许在服务器中使用，不将此参数传递到客户端中。数据库连接类型分为关系型数据库、Lotus数据库、Mail数据库三种类型，各种数据库的连接参数如下：针对MSSQL SERVER：针对ORACLE： Database= MSSQLDatabase=ORACLE Server=Server=KLMIS Login=mastudioLogin=mastudioPwd= 123Pwd=123Timeout= 10 对于MSSQL SERVER通过可选参数Db=来执行访问的数据库，或者将该数据库设置为登陆帐号默认数据库。针对DB2：针对ODBC：Database=DB2Database=ODBCServer=Dsn=mastudioLogin=MAStudio Co.Ltdlogin=mastudioPwd= 123Pwd=123针对ACCESS：针对 EXCEL：Dabase=ACCESSDatabase= EXCELDbq=“c:tempmy.mdb”Dbq= “c:mastudiosample.xls”针对LOTUS：针对MAIL：Database= DOMINODatabase= MAILServer= maserver/mastudioServer= “”Login= D: Lotusnotesdatauser.idLogin= “”Pwd= 123Pwd= 123Nsf= test.nsfAppellation= Bai针对HTTPDatabase= HTTPServer= /index.aspPort= 80Method= Post or Get可选子对象:OBJECT wxPARAMETER aParaaPara.Preget= 3/iOffice/login.aspx?ReturnUrl=%2fioffice%2fDefault.aspxaPara.Lex= 注意Server=参数必须是全路径的格式，不可以只写域名的形式。可选对象wxPARAMETER是针对Post的情况下用的，其用来预先获取hidden的名字和值，并将其自动处理到Post的数据中。备注：服务器地址：.Server= 和查询页面地址：.Url= 以及提交的参数.Flow= ，其前缀可以通过如下来控制编码方式：-ascii-标准的asciii编码方式，也是系统默认的方式-utf8- UTF8编码方式-unicode- UNICODE编码方式如：aQuery.Url= “-utf8-/index.asp?xxx=123”OBJECT wxQUERY对象用来对连接的数据库进行查询，针对不同类型的数据库连接采用不同的参数模式来查询数据。OBJECT wxQUERY aQuery关系型数据库aQuery.wxDATASOURCE= aSource数据源名aQuery.wxRECORDSET= aRecord数据记录aQuery.Split= 12分页大小aQuery.Page= 1当前第n页private:aQuery.Sql= select ID, Value from dev查询语句参数aQuery.Sql可以是查询语句和存储过程，其中Split和Page参数对于各类型的数据库都通用。参数wxDATASOURCE 和wxRECORDSET在所有的wxQUERY中都必须包含。OBJECT wxQUERY aQueryLotus数据库aQuery.wxDATASOURCE= aSource数据源名aQuery.wxRECORDSET= aRecord数据记录aQuery.Notes= View / Document / Response来自视图文档答复aQuery.From= student / NotesID / NotesID视图名或文档编号aQuery.Field= “name, age” 查询字段aQuery.Temp= “c:/temp/zhangxh” 附件保存位置aQuery.Notes值为View表示查询From中指定的视图student；值为Document或则Response表示查询文档或则文档的答复，From中的参数表示文档编号。aQuery.Notes值为View查询视图的时候，不论Field有几个字段，系统会自动增加一字段显示每个文档的编号，通过此编号可查该文档。aQuery.Field值为查询的字段列表，字段名区分大小写。aQuery.Temp值为保存附件的目录，当查询的字段中包含附件的时候，系统自动创建此目录，并且只保留最后一个文档查看所下载的附件。可通过wxDIR对象将此目录下的附件提供给用户下载或则查看。OBJECT wxQUERY aQueryMail数据库aQuery.wxDATASOURCE= aSource数据源名aQuery.wxRECORDSET= aRecord数据记录aQuery.From= All邮件编号aQuery.Field= No, Date, Subject,Content字段列表aQuery.Temp= “c:/temp”附件的保存目录aQuery.From值表示查询一个邮件或则全部邮件，当值为All查看所有邮件，否则此值作为邮件编号，查询此邮件编号的邮件。默认的每一次查询将自动增加一个字段保存邮件编号，可通过aQuery.Field(5)的形式来获取后传递给下一页面。aQuery.Field值表示查显示的字段列表，字段一共只有No、From、Data、Subject, Content五个参数可选择，分别表示邮件编号、发件人、日期、标题、内容。通过如下方法可为每个登陆用户设置自己的附件保存目录：root= D:/mastudio/Sample/mail/temp/root= root+ sysGLOBAL.USERPRINT aQuery.Temp=, root, OBJECT wxQUERY aQuery访问HTTP数据源aQuery.wxDATASOURCE= aSource数据源名aQuery.wxRECORDSET= aRecord数据记录aQuery.Url=“ /sample.htm”访问数据页面aQuery.Begin= 开始定义点aQuery.End= 结束定义点aQuery.Lex= .+?(.+?).+?(.+?).+?(.+?).+?数据匹配定义可选项：aQuery. Refer=“ ”上下文页面aQuery.Flow= xxxxxxxxxxxxxxxxPOST数据aQuery.Flows= yyyyyyyyyyyyy继续POST数据aQuery.Method= Post采用POSTaQuery.Order= 2, 3, 1排列次序aQuery.Cache= 20缓存数据n秒OBJECT wxPARAMETER aPara可选aPara.Preget= /iOffice/login.aspx?ReturnUrl=%2fioffice%2fDefault.aspxaPara.Lex= 可选：bPara.Order= False表示以上键名和值是相反的aQuery.Lex参数中定义的()中间的内容依次表示取出的第一列、第二列下去，如果要改变次序，则通过Order参数来调整。关于数据匹配定义请参看相关章节语法定义。对于Post数据，在其中增加“-boundary=-7d81992df09a9”则表示将post的数据以Content-Type: multipart/form-data形式发送到服务器。增加着个字段则用来表示其为上传文件的段-attachment=ATTACHMENT。AQuery.Lex参数可以在前面加上-raw参数，将表示获取的值为源代码，形式为：aQuery.Lex= -raw.+?(.+?).+?(.+?)”这个功能用在wxVIEW直接查看某段HTML页面内容的时候。Url和Flow前可以增加raw参数，来让系统保持原文格式，不进行自动编码处理。aQuery.State= “”将获取的VIEWSTATE保存下来，在后续的POST中会自动加上去。OBJECT wxPROCEDURE对象用来执行数据库的脚本程序，包括存储过程、代理等。针对不同的数据库连接，其参数有所变化。所有wxPROCEDURE都具有 .METHOD = POST属性，用来决定该程序执行的时间，=POST表示只在post页面中执行，=REQUEST表示只在请求页面时执行，无设置参数表示均执行。OBJECT wxPROCEDURE aProc关系型数据库aProc.Sql= “delete from list”存储过程aProc.wxDATASOURCE= aSource数据来源OBJECT wxPROCEDURE aProcLotus数据库aProc.Agent= CommitGas代理名称aProc.Document= 1322文档参数aProc.wxDATASOURCE= aSource在文件Resource.ini中定义该脚本执行成功或则失败的反馈信息，依据段名为 Agent名字 ，没有Agent名字默认为“DoProc”，具体用法参看wxFORM对象。OBJECT wxPROCEDURE aProcLotus数据库aProc.Execute= Update / Upload写值或上传aProc.Document= 1322文档参数aProc.Field= name字段列表aProc.Value= 123值列表aProc.wxDATASOURCE= aSourceaProc.Execute值为Update表示将对应的值写到文档对应的字段中，没有该字段自动增加。aProc.Execute值为Upload表示将对应的值文件上传到文档中。此时Value参数为文件的全路径。以上字段列表和值可通过”f1, f2, f3”形式来表示多个字段以及对应的值。OBJECT wxPROCEDURE emSENDMAIL数据库emSEND.To= sysPOST.PARAMETER.pAddremSEND.Subject= sysPOST.PARAMETER.pSubjectemSEND.Content= sysPOST.PARAMETER.pContentemSEND.wxDATASOURCE= aSourceemSEND.METHOD= POSTOBJECT wxPROCEDURE aProcHTTP数据提交aProc.wxDATASOURCE= aSource数据库来源aProc.Refer= /forum/post.asp?action=new&boardid=8aProc.Url= /Save.asp?boardid=8&Body=test&topic=hiaProc.Method= PostOBJECT wxPARAMETER aPara可选aPara.Preget= 3/iOffice/login.aspx?ReturnUrl=%2fioffice%2fDefault.aspxaPara.Lex= Refer 表示HTTP协议中的Referer参数，表示提交页面是从哪里来的，本参数为可选项。OBJECT wxGRID用来显示表格数据，数据来源于wxQUERY，所以在使用wxGRID前必须定义好数据库连接以及查询语句，在 .mas文件中的位置也必须保持前后关系。OBJECT wxGRID aGridaGrid.wxCAPTION= aCaption标题部分定义aGrid.wxCOLUMN= aColumn列部分定义aGrid.wxSECTION= aSection段部分定义aGrid.wxQUERY= aQuery数据源名aGrid.Icon= 36光标编号aGrid.Banna= 0, 0x3333FF, 0xEEAAEE指示条的定义aGrid.Choice= 0, 0xFF3333, 0xAAEEEE多选条的定义aGrid.Pen= 1, 0x20FF30画笔定义aGrid.Rect= 18, 8, 160, 220表格范围aGrid.Background= , menu_main.bmp表格背景OBJECT wxPARAMETER aParaaPara.No= aQuery.Filed(1) 连接参数一aPara.Name= aQuery.Filed(2) 连接参数二aGrid.Prompt= 220, 220, 18, 32上下翻页按钮aGrid.Link= grid.mas 连接文件aGrid.Attachment= 1, 0 参数定义同上aGrid.Automatic= 5000, 4001, 0xFF0000自动刷新数据毫秒，识别编码，变化颜色备注：在使用EXCEL作为数据来源的时候，需要先在电子表格文件编辑状态下选中查询区域，然后使用菜单插入名称定义，定义的名称则为表名。OR SELECT 考生编号,考生姓名,来源 FROM student2$可选参数：aGrid.Choice将表格设置为可多选，多选后的参数可通过如下形式读取每一个选中的值sysPARAMETER.Non ，也可通过sysPARAMETER.No形式读所有值，所有值的排列形式为：xxx,yyy,zzz依次。OBJECT wxGRID需要相关的辅助设置，这些辅助设置信息只可为wxGRID所使用。OBJECT wxCAPTION aCaptionaCaption.Titlel= hello表格标题aCaption.Font= 18,0xDDEEDD字体aCaption.Align= left对齐aCaption.Height= 20高度aCaption.Background= 0xAABBCC背景OBJECT wxCOLUMN aColumnaColumn.Count= 3列数aColumn.Height= 20高度aColumn.Field= name, sex, age字段名称aColumn.Width= 30, 40, 50字段宽度aColumn.Font= 14, 0xDDEEDD字体定义aColumn.Align= left, left, left对齐方式aColumn.Background= 0xAABBCC背景定义aColumn.Color= 0xFF0000, 0x00FF00列数据颜色OBJECT wxSECTION aSectionaSection.Background= 0xAABBCC背景定义aSection.Font= 12, 0xDDEEDD字体定义aSection.Align= left, left, left对齐方式aSection.Dyestuff= 6行数据颜色备注：列数据颜色定义，为0则不起作用；行数据颜色定义表示指定wxQUERY中指定的列数据作为该行的数据颜色值。OBJECT wxFORM用来定义一个输入表单，支持显示如下所有控件，输入完成提交到.mas文件通过数据库连接以及存储过程来实现把数据内容保存到数据库中。OBJECT wxFORM aFormOBJECT wxEDIT aEditaEdit.Name= Name文本框aEdit.Rect= 10, 10, 60, 20大小aEdit.Default= wang01默认值OBJECT wxRICHEDIT aREditaREdit.Name= Name2富文本框aREdit.Rect= 10, 40, 60, 30大小aREdit.Default= wang02默认值OBJECT wxCHECKBOX aCheckBoxaCheckBox.Name= Name3复选择框aCheckBox.Rect= 10, 80, 12, 12大小aCheckBox.Default= 1默认值OBJECT wxCOMBOBOX aComboBoxaComboBox.Name= Name4列表框aComboBox.Rect= 10, 92, 80, 80大小aComboBox.Default= aabbccddeeff默认值OBJECT wxLISTBOX aListBoxaListBox.Name= Name5列表框aListBox.Rect= 10, 122, 80, 80大小aListBox.Default= aabbccddeeff默认值OBJECT wxBUTTON aButtonaButton.Name= Bt1按钮aButton.Rect= 10, 222, 80, 20大小aButton.Default= Back文字aButton.Command= VK_LEFT函数OBJECT wxBUTTON bButtonbButton.Name= Bt2按钮bButton.Rect= 100, 222, 80, 20大小bButton.Default= Forward文字bButton.Command= VK_RIGHT函数aForm.Rect= 18, 58, 160, 140表单大小aForm.Background= , menu_main.bmp表单背景aForm.wxPROCEDURE= aProcaForm.Link= grid.mas连接文件aForm.Attachment= 1, 0连接参数备注：wxBUTTON按钮的.Command定义支持：VK_LEFT、VK_RIGHT、VK_UP、VK_DOWN、VK_PASSWORD、VK_