- 浏览: 2782 次
- 性别:
- 来自: 北京
文章分类
最新评论
XForms xpath使用手册
本文所描述的所有函数为XForms 1.1所提供的xpath函数,这些函数只能在GForms的xpath编辑器中可用,这样才能在运行时识别并执行。
不可在XMLUtil、标准XML DOM中使用这些函数。
GForms平台提供xpath编辑器,该编辑器可以协助开发者完成大多数xpath表达式开发:
1、节点函数
1.1、instance函数
node-setinstance(string?)
An XForms Model can contain more than one instance. This functionallows access to instance data, within the same XForms Model, but outside theinstance data containing the context node.
If the argument is omitted or is equal to the empty string, thenthe root element node (also called the document element node) is returned forthe default instance in the model that contains the current context node.
Otherwise, the argument is converted to a string as if by a callto thestringfunction. This string is treated as an IDREF, which is matchedagainstinstanceelements in the containing document. If a match is located, andthe matching instance data is associated with the same XForms Model as thecurrent context node, this function returns a node-set containing just the rootelement node (also called the document element node) of the referenced instancedata. In all other cases, an empty node-set is returned.
Example:
For instance data corresponding to this XML:
<xforms:instancexmlns="" id="orderform">
<orderForm>
<shipTo>
<firstName>John</firstName>
</shipTo>
</orderForm>
</xforms:instance>
The following expression selects thefirstNamenode. Note that theinstancefunction returns an elementnode, effectively replacing the leftmost location step from the path:
ref="instance('orderform')/shipTo/firstName"
2、字符串函数
2.1、if函数
stringif(boolean,string,string)
Functionifevaluates the first parameter as boolean, returning the secondparameter whentrue, otherwise the third parameter.
2.2、property函数
stringproperty(string)
This function accepts a string identifying a property name. If theproperty name is not recognized, empty string is returned. The propertydefinitions for this function are as follows:
Property |
Return Value |
version |
1.1 |
conformance-level |
full,basicor a string beginning withfullorbasic |
Any otherNCName |
Reserved. Their use results in an exception (see7.5 The XForms Function Libraryfor the exception type) |
QNameButNotNCName |
An implementation-specific property value, such as a locale or timezone for the user agent. If the implementation does not support the property, then empty string is returned. |
Examples:
property('version')
returns1.1
property('conformance-level')
may returnfull
3、数值函数
3.1、avg
numberavg(node-set)
Functionavgreturns the arithmetic average of the result of converting thestring-values of each node in the argument node-set to a number. The sum iscomputed withsum(), and divided withdivby the value computed withcount(). If the parameter is an empty node-set, or if any of the nodesevaluate toNaN, the return value isNaN.
3.2、number
numbermin(node-set)
Functionminreturns the minimum value of the result of converting thestring-values of each node in argumentnode-setto a number."Minimum" is determined with the<operator. If the parameter is an empty node-set, or if any of thenodes evaluate toNaN, the return value isNaN.
3.3、max
numbermax(node-set)
Functionmaxreturns the maximum value of the result of converting thestring-values of each node in argumentnode-setto a number."Maximum" is determined with the<operator. If the parameter is an empty node-set, or if any of thenodes evaluate toNaN, the return value isNaN.
3.4. count-non-empty
numbercount-non-empty(node-set)
Functioncount-non-emptyreturns the number ofnon-empty nodes in argumentnode-set. A node isconsidered non-empty if it is convertible into a string with a greater-thanzero length.
3.5. index
numberindex(string)
Functionindextakes a string argument that is theIDREFof arepeatand returns the current 1-based position of the repeat index forthe identifiedrepeat—see9.3.1 The repeat Elementfor details onrepeatand its associated repeat index. If the specified argument doesnot identify arepeat, the function returnsNaN.
Note:
The IDREF obtained from the function parameter may not uniquelyidentify the desiredrepeatif therepeatelement bearing the matching ID resides in a repeating constructsuch as elementrepeat. The general method described in4.7 Resolving ID References in XFormsis used to determine the desired run-time repeat object.
index
<xforms:trigger>
<xforms:label>Add to ShoppingCart</xforms:label>
<xforms:insertev:event="DOMActivate" position="after"
nodeset="items/item"at="index('cartUI')"/>
</xforms:trigger>
3.6. power
numberpower(number,number)
Raises the first argument to the power of the second argument,returning the result. If the calculation does not result in a real number, thenNaNis returned.
Examples:
power(2, 3)
returns8
power(-1, 0.5)
returnsNaN.
if (prin>0 anddur>0 and rate>0, prin*rate/(1-power(1+rate, -dur)), 0)
returns a compounded interest payment value given a non-zeroprincipal (prin), duration (dur) and periodic interest rate(rate).
3.7. random
numberrandom(boolean?)
This function generates and returns a uniformly distributed randomor pseudorandom number in the range from 0.0 up to but excluding 1.0. Thisfunction accepts an author-optional boolean parameter that isfalseby default. Iftrue, the random number generatorfor this function is first seeded with a source of randomness before generatingthe return value. A typical implementation may seed the random number generatorwith the current system time in milliseconds whenrandom(true)is invoked, and it may apply a linear congruential formula togenerate return values on successive invocations of the function.
Example:
random()
could return0.14159265358979
3.8. compare
numbercompare(string,string)
This function returns -1, 0, or 1, depending on whether the valueof the first argument is respectively less than, equal to, or greater than thevalue of second argument based on lexicographic comparison using Unicode codepoint values[Unicode Collation Algorithm].
Example:
compare('apple','orange')
returns-1
4、布尔函数
booleanboolean-from-string(string)
Functionboolean-from-stringreturnstrueif the required parameterstringis "true" or "1", orfalseif parameterstringis "false", or "0". This is useful whenreferencing a Schemaxsd:booleandatatype in an XPath expression. If the parameter string matchesnone of the above strings, according to a case-insensitive comparison, thereturn value isfalse.
5、时间函数
时间的格式处理,为了简化本地化时间处理,gforms提供对时间的格式进行了可配置处理,按照xsd:date、xsd:dateTime,时间的字符串中会包含T、z等字符串信息,而在大多数编程场景下,一般不需要处理T、z信息,所以为了提供编程开发人员处理时间的效率,GForms对xsd:dateTime的合法格式进行可配置化。
系统默认时间格式:
格式类型 |
标准格式 |
GForms格式 |
xsd:date |
yyyy-MM-ddz |
yyyy-MM-dd |
xsd:dateTime |
yyyy-MM-ddThh:mm:ssz |
yyyy-MM-dd hh:mm:ss |
上述时间格式配置在GForms应用的<webContent>/ghorse/js/conf/config_xx.xsl文件中的date及dateTime。
5.1、now函数
stringnow()
得到当前UTC时间字符串,字符串格式与XSD的数据类型xsd:dateTime格式一致,而在GForms中所返回的时间字符串是按照config_xx.xslt中的dateTime格式进行格式化。
now()
按标准应该返回:2014-03-14T01:04:17Z,但在GForms中将根据config_xx.xslt中的dateTime配置进行返回:2014-03-14 01:04:17以方便本地化编程处理。
5.2、local-date函数
stringlocal-date()
将返回与XSD数据类型xsd:date格式一致的字符串,该时间为本本地区时间,而非UTC时间,在GForms中将根据confgi_xx.xslt中的date配置格式进行格式化返回。
local-date()
返回格式2006-10-13
5.3、local-dateTime
返回与xsd:daeTime格式一致的当前本地区时间,在gforms平台中,该时间将根据config_xx.xslt中的dateTime进行格式化返回。
local-dateTime()
按标准应该返回:2006-10-13T16:04:17-07:00
但在GForms中如果是中国地区则会返回:2006-10-13 16:04:17。
5.4、days-from-date
numberdays-from-date(string)
返回输入时间字符串所含有的天数,输入的时间字符串必须符合xsd:date或xsd:dateTime格式,但在GForms中要求输入字符串符合config_xx.xslt中的date、dateTime格式规范。
将把输入的时间转换为UTC格式,然后计算与1970-01-01时间之间的天数。
如果输入的字符串参数不满足条件则返回NaN.
days-from-date("2002-01-01")
返回:11688
days-from-date("2002-01-01-07:00")
返回:11688,即小时、分钟及秒被忽略掉。
5.5、days-to-date
把输入的天数转换为时间字符串,天数将从1970-01-01之后开始计算,如果输入的天数非法,则返回空字符串。
days-to-date(11688)
返回2002-01-01
days-to-date(-1)
返回1969-12-31
6、工具函数
6.1、加密函数digest
stringdigest(string,Algorithm,encoding?)
对输入的字符串按照加密算法Algorithm加密并使用编码算法encoding进行编码,并把计算结果返回。
其中Algorithm目前支持MD5、SHA-1两种加密算法,encoding支持的有base64、hex,默认为base64。
digest('abc', 'SHA-1','hex')
将返回:a9993e364706816aba3e25717850c26c9cd0d89d.
6.2、匹配函数match
根据正则表达式校验输入的模型实例节点node是否满足regex。
这里的regex需要进行转义处理,如:
/^[\w-]+(\.[\w-]+)*@[\w-]+(\.[\w-]+)+$/
需要编写为:
match( node, '^[\\w-]+(\\.[\\w-]+)*@[\\w-]+(\\.[\\w-]+)+$')
6.3、事件函数event
objectevent(propertyName)
得到当前最新事件属性值,如:
event('response-reason-phrase')
如果后端发生内部错误,则得到的信息为一个字符串值:Internal Server Error
具体事件的可用属性信息是不一样的,可以参考相关控件。
6.4、合法性校验is-valid
booleanis-valid(nodeSet)
校验所输入的节点是否合法,如果合法则返回true,否则返回false。
根据数据节点的绑定、schema等进行校验。
7.xpath特殊字符
如果需要在xpath中输出这些特殊字符必须在xpath中使用转义字符。
特殊字符 |
特殊含义 |
实体编码 |
> |
开始标记 |
> |
< |
结束标记 |
< |
" |
引号 |
" |
' |
撇号 |
' |
& |
"&"符 |
& |
8.参考手册
1.XForms提供的XPath函数详解请参考XForms标准:
http://www.w3.org/TR/2009/REC-xforms-20091020/#expr
2.XPath2.0标准:
3.xpath使用手册
http://www.w3school.com.cn/xpath/
相关推荐
共收录网页计4143页,包括AJAX,CSS,DOM,HTML,Javascript,NSS,RDF,RSS,SVG,XBL,XForms,XML,XML Web Services,Xpath,XSLT,XUL等技术手册,以及Mozilla系列浏览器的技术信息,为网页开发人员之必备手册...
XML教程:XML DTD XML DOM XSL XSLT XSL-FO XPath XQuery XLink XPointer Schema XForms SOAP WSDL RDF RSS WAP Web Services 多媒体:Media SMIL SVG 建站手册:网站构建 万维网联盟 (W3C) 浏览器信息 网站品质 ...
内容包括: HTML教程:HTML XHTML CSS TCP/IP 浏览器脚本:JavaScript ...FO XPath XQuery XLink XPointer Schema XForms SOAP WSDL RDF RSS WAP Web Services 多媒体:Media SMIL
XPath XQuery XLink XPointer Schema XForms SOAP WSDL RDF RSS WAP Web Services 浏览器脚本 JavaScript HTML DOM DHTML VBScript AJAX E4X WMLScript 服务器脚本 SQL ASP ADO PHP .NET...
XForms SOAP WSDL RDF RSS WAP Web Services 浏览器脚本 JavaScript HTML DOM DHTML VBScript AJAX E4X WMLScript 服务器脚本 SQL ASP ADO PHP .NET(dotnet) .NET Microsoft .NET ASP .NET Mobile 多媒体 Media SMIL...
我花时间用软件将w3school网站的学习手册内容打包成一个cmh文件,从些查询任何编程资料,只要有他就可以 HTML教程 HTML XHTML CSS TCP/IP XML教程 XML DTD XML DOM XSL XSLT XSL-FO XPath XQuery XLink ...
XPath XQuery XLink XPointer Schema XForms SOAP WSDL RDF RSS WAP Web Services 浏览器脚本 JavaScript HTML DOM DHTML VBScript AJAX jQuery E4X WMLScript 服务器脚本 SQL ASP ADO PHP ...
XPath XQuery XLink XPointer Schema XForms SOAP WSDL RDF RSS WAP Web Services 浏览器脚本 JavaScript HTML DOM jQuery AJAX JSON DHTML VBScript E4X WMLScript 服务器脚本 SQL ASP ADO PHP .NET(dotnet) .NET ...
XForms SOAP WSDL RDF RSS WAP Web Services 浏览器脚本 JavaScript HTML DOM DHTML VBScript AJAX jQuery JSON E4X WMLScript 服务器脚本 SQL ASP ADO PHP .NET(dotnet) .NET Microsoft .NET ...
XPath XQuery XLink XPointer Schema XForms SOAP WSDL RDF RSS WAP Web Services 浏览器脚本 JavaScript HTML DOM DHTML VBScript AJAX E4X WMLScript 服务器脚本 SQL ASP ADO PHP .NET...
内容包括: ....NET(dotnet):.NET Microsoft .NET ASP .NET ...XML教程:XML DTD XML DOM XSL XSLT XSL-FO XPath XQuery XLink XPointer Schema XForms SOAP WSDL RDF RSS WAP Web Services 多媒体:Media SMIL SVG
XForms WML 1.1 SOAP HTML 颜色 WSDL W3C 术语表 RDF 字符集 RSS HTML 字符集 WAP HTML ASCII Web Services HTML ISO-8859-1 浏览器脚本 HTML 符号 JavaScript 实例/案例 HTML DOM HTML ...
XML教程:XML DTD XML DOM XSL XSLT XSL-FO XPath XQuery XLink XPointer Schema XForms SOAP WSDL RDF RSS WAP Web Services 多媒体:Media SMIL SVG 建站手册:网站构建 万维网联盟 (W3C) 浏览器信息 网站品质 ...
XForms SOAP WSDL RDF RSS WAP Web Services 浏览器脚本 JavaScript HTML DOM DHTML VBScript AJAX E4X WMLScript 服务器脚本 SQL ASP ADO PHP .NET(dotnet) .NET Microsoft...
很全的教程,包括:HTML ,XHTML ,CSS ,TCP/IP ,XML ,DTD ,XML DOM ,XSL ,XSLT ,XSL-FO ,XPath ,XQuery ,XLink ,XPointer ,Schema ,XForms ,SOAP ,WSDL ,RDF ,RSS ,WAP ,Web Services ,JavaScript ,HTML DOM ,DHTML ,...
通过使用我们的在线编辑器,你可以编辑这些例子,并对代码进行实验。 快捷易懂的学习方式 一寸光阴一寸金,因此,我们为您提供快捷易懂的学习内容。 在这里,您可以通过一种易懂的便利的模式获得您需要的任何知识...
XPath XQuery XLink XPointer Schema XForms SOAP WSDL RDF RSS WAP Web Services 浏览器脚本 JavaScript HTML DOM DHTML VBScript AJAX E4X WMLScript 服务器脚本 SQL ASP ADO PHP .NET...
XML教程:XML DTD XML DOM XSL XSLT XSL-FO XPath XQuery XLink XPointer Schema XForms SOAP WSDL RDF RSS WAP Web Services 多媒体:Media SMIL SVG 建站手册:网站构建 万维网联盟 (W3C) 浏览器信息 网站品质 ...
W3CSchool网站上的所有教程 包括html、 xhtml、 html5 、Css、 tcp/ip、 Xml 、Xsl 、Xslt、 Xsl-fo 、Xqery 、Xlink Xpointer、 Xpath、 DTD 、Schema 、XML DOM 、XForms 、SOAP 、WSDL 、RDF 、RSS 、WAP、 Web ...
包含以下东东,当手册用非常好.本人开发常参考 HTML教程 HTML XHTML CSS TCP/IP XML教程 XML DTD XML DOM XSL XSLT XSL-FO XPath XQuery XLink XPointer Schema XForms SOAP WSDL RDF RSS WAP ...