Request Module - Revision history

CG at 14:23, 9 March 2023

2023-03-09T14:23:27Z

CG: Text replacement - "'''Signatures'''" to "'''Signature'''"

2023-03-09T13:04:34Z

Text replacement - "'''Signatures'''" to "'''Signature'''"

CG at 11:00, 9 March 2023

2023-03-09T11:00:03Z

Show changes

CG at 22:28, 30 January 2023

2023-01-30T22:28:08Z

CG at 06:58, 25 July 2022

2022-07-25T06:58:02Z

CG at 12:20, 20 July 2022

2022-07-20T12:20:35Z

Show changes

CG: Text replacement - "\[\[#([^]:]+:[^|]+)\|([^]:]+:[^|]+)\]\]" to "{{Function||$1}}"

2022-07-18T17:49:59Z

Text replacement - "\[\[#([^]:]+:[^|]+)\|([^]:]+:[^|]+)\]\]" to "{{Function||$1}}"

CG at 16:53, 4 May 2022

2022-05-04T16:53:34Z

CG at 10:14, 15 February 2021

2021-02-15T10:14:17Z

CG at 10:49, 8 July 2020

2020-07-08T10:49:32Z

@@ Line 189: / Line 189: @@
 | width='120' | '''Signature'''
 |<pre>request:parameter(
-   $name     as xs:string
+   $name     as xs:string,
    $default  as xs:string  := ()
 ) as xs:string*</pre>
@@ Line 220: / Line 220: @@
 | width='120' | '''Signature'''
 |<pre>request:header(
-   $name     as xs:string
+   $name     as xs:string,
    $default  as xs:string  := ()
 ) as xs:string?</pre>
@@ Line 245: / Line 245: @@
 | width='120' | '''Signature'''
 |<pre>request:cookie(
-   $name     as xs:string
+   $name     as xs:string,
    $default  as xs:string  := ()
 ) as xs:string?</pre>
@@ Line 272: / Line 272: @@
 | width='120' | '''Signature'''
 |<pre>request:attribute(
-   $name     as xs:string
+   $name     as xs:string,
    $default  as item()*    := ()
 ) as item()*</pre>
@@ Line 291: / Line 291: @@
 | width='120' | '''Signature'''
 |<pre>request:set-attribute(
-   $name   as xs:string
+   $name   as xs:string,
    $value  as item()*
 ) as empty-sequence()</pre>

@@ Line 24: / Line 24: @@
 {| width='100%'
 |- valign="top"
-| width='120' | '''Signatures'''
+| width='120' | '''Signature'''
 |<pre>request:method() as xs:string</pre>
 |- valign="top"
@@ Line 36: / Line 36: @@
 {| width='100%'
 |- valign="top"
-| width='120' | '''Signatures'''
+| width='120' | '''Signature'''
 |<pre>request:scheme() as xs:string</pre>
 |- valign="top"
@@ Line 49: / Line 49: @@
 {| width='100%'
 |- valign="top"
-| width='120' | '''Signatures'''
+| width='120' | '''Signature'''
 |<pre>request:hostname() as xs:string</pre>
 |- valign="top"
@@ Line 62: / Line 62: @@
 {| width='100%'
 |- valign="top"
-| width='120' | '''Signatures'''
+| width='120' | '''Signature'''
 |<pre>request:port() as xs:integer</pre>
 |- valign="top"
@@ Line 75: / Line 75: @@
 {| width='100%'
 |- valign="top"
-| width='120' | '''Signatures'''
+| width='120' | '''Signature'''
 |<pre>request:path() as xs:string</pre>
 |- valign="top"
@@ Line 88: / Line 88: @@
 {| width='100%'
 |- valign="top"
-| width='120' | '''Signatures'''
+| width='120' | '''Signature'''
 |<pre>request:query() as xs:string?</pre>
 |- valign="top"
@@ Line 101: / Line 101: @@
 {| width='100%'
 |- valign="top"
-| width='120' | '''Signatures'''
+| width='120' | '''Signature'''
 |<pre>request:uri() as xs:anyURI</pre>
 |- valign="top"
@@ Line 115: / Line 115: @@
 {| width='100%'
 |- valign="top"
-| width='120' | '''Signatures'''
+| width='120' | '''Signature'''
 |<pre>request:context-path() as xs:string</pre>
 |- valign="top"
@@ Line 127: / Line 127: @@
 {| width='100%'
 |- valign="top"
-| width='120' | '''Signatures'''
+| width='120' | '''Signature'''
 |<pre>request:address() as xs:string</pre>
 |- valign="top"
@@ Line 137: / Line 137: @@
 {| width='100%'
 |- valign="top"
-| width='120' | '''Signatures'''
+| width='120' | '''Signature'''
 |<pre>request:remote-hostname() as xs:string</pre>
 |- valign="top"
@@ Line 147: / Line 147: @@
 {| width='100%'
 |- valign="top"
-| width='120' | '''Signatures'''
+| width='120' | '''Signature'''
 |<pre>request:remote-address() as xs:string</pre>
 |- valign="top"
@@ Line 157: / Line 157: @@
 {| width='100%'
 |- valign="top"
-| width='120' | '''Signatures'''
+| width='120' | '''Signature'''
 |<pre>request:remote-port() as xs:string</pre>
 |- valign="top"
@@ Line 170: / Line 170: @@
 {| width='100%'
 |- valign="top"
-| width='120' | '''Signatures'''
+| width='120' | '''Signature'''
 |<pre>request:parameter-names() as xs:string*</pre>
 |- valign="top"
@@ Line 187: / Line 187: @@
 {| width='100%'
 |- valign="top"
-| width='120' | '''Signatures'''
+| width='120' | '''Signature'''
 |<pre>request:parameter(
    $name     as xs:string
@@ Line 208: / Line 208: @@
 {| width='100%'
 |- valign="top"
-| width='120' | '''Signatures'''
+| width='120' | '''Signature'''
 |<pre>request:header-names() as xs:string*</pre>
 |- valign="top"
@@ Line 218: / Line 218: @@
 {| width='100%'
 |- valign="top"
-| width='120' | '''Signatures'''
+| width='120' | '''Signature'''
 |<pre>request:header(
    $name     as xs:string
@@ Line 233: / Line 233: @@
 {| width='100%'
 |- valign="top"
-| width='120' | '''Signatures'''
+| width='120' | '''Signature'''
 |<pre>request:cookie-names() as xs:string*</pre>
 |- valign="top"
@@ Line 243: / Line 243: @@
 {| width='100%'
 |- valign="top"
-| width='120' | '''Signatures'''
+| width='120' | '''Signature'''
 |<pre>request:cookie(
    $name     as xs:string
@@ Line 259: / Line 259: @@
 {| width='100%'
 |- valign="top"
-| width='120' | '''Signatures'''
+| width='120' | '''Signature'''
 |<pre>request:attribute-names() as xs:string*</pre>
 |- valign="top"
@@ Line 270: / Line 270: @@
 {| width='100%'
 |- valign="top"
-| width='120' | '''Signatures'''
+| width='120' | '''Signature'''
 |<pre>request:attribute(
    $name     as xs:string
@@ Line 289: / Line 289: @@
 {| width='100%'
 |- valign="top"
-| width='120' | '''Signatures'''
+| width='120' | '''Signature'''
 |<pre>request:set-attribute(
    $name   as xs:string

@@ Line 1: / Line 1: @@
 This [[Module Library|XQuery Module]] contains functions for retrieving information on an HTTP request that has triggered the query. It is mostly useful when building [[Web Application]]s.
-The module is based on the [http://exquery.github.com/expath-specs-playground/request-module-1.0-specification.html EXQuery Request Module] draft.
+The module is based on the [http://exquery.github.io/expath-specs-playground/request-module-1.0-specification.html EXQuery Request Module] draft.
 =Conventions=

@@ Line 12: / Line 12: @@
 <pre>
-   foo://example.com:8042/over/there?name=ferret
+   foo://example.com:8042/over/there?name=ferret&code=7
-   \_/   \_________/ \__/\_________/ \_________/
+   \_/   \_________/ \__/\_________/ \________________/
-    |         |       |       |          |
+    |         |       |       |              |
-  scheme   hostname  port    path      query
+  scheme   hostname  port    path          query
 </pre>
@@ Line 95: / Line 95: @@
 |- valign="top"
 | '''Example'''
-|For the example given in the introduction, this function would return <code>name=ferret</code>.<br/>
+|For the example given in the introduction, this function would return <code>name=ferret&code=7</code>.<br/>
 |}
@@ Line 108: / Line 108: @@
 |- valign="top"
 | '''Example'''
-|For the example given in the introduction, this method would return <code>foo://example.com:8042/over/there?name=ferret</code>.<br/>
+|For the example given in the introduction, this method would return <code>foo://example.com:8042/over/there?name=ferret&code=7</code>.<br/>
 |}
@@ Line 194: / Line 194: @@
 |- valign="top"
 | '''Example'''
-|For the example given in the introduction, the function call {{Code|request:parameter('name')}} would return {{Code|ferret}}.<br/>
+|For the example given in the introduction, the function call {{Code|request:parameter('code')}} would return {{Code|7}}.<br/>
 |- valign="top"
 | '''Errors'''

@@ Line 297: / Line 297: @@
 ;Version 9.3
-* Added: [[#request:attribute-names|request:attribute-names]], [[#request:set-attribute|request:set-attribute]]
+* Added: {{Function||request:attribute-names}}, {{Function||request:set-attribute}}
-* Updated: [[#request:attribute|request:attribute]]: return type generalized, default argument added
+* Updated: {{Function||request:attribute}}: return type generalized, default argument added
 ;Version 7.9
-* Updated: The returned values of [[#request:parameter-names|request:parameter-names]], [[#request:parameter|request:parameter]] now also include form field parameters.
+* Updated: The returned values of {{Function||request:parameter-names}}, {{Function||request:parameter}} now also include form field parameters.
 ;Version 7.8
-* Added: [[#request:context-path|request:context-path]]
+* Added: {{Function||request:context-path}}
 ;Version 7.7
-* Added: [[#request:attribute|request:attribute]]
+* Added: {{Function||request:attribute}}
 This module was introduced with Version 7.5.

@@ Line 282: / Line 282: @@
 | '''Summary'''
 |Binds the specified {{Code|$value}} to the request attribute with the specified {{Code|$name}}.
 |}
@@ Line 292: / Line 289: @@
 ! width="110"|Code
 |Description
 |-
 |{{Code|parameter}}

@@ Line 11: / Line 11: @@
 The following example illustrated what components a URI may consist of (the example is derived from [http://tools.ietf.org/html/rfc3986 RFC 3986]):
-<syntaxhighlight>
+<pre>
    foo://example.com:8042/over/there?name=ferret
    \_/   \_________/ \__/\_________/ \_________/
     |         |       |       |          |
   scheme   hostname  port    path      query
-</syntaxhighlight>
+</pre>
 =General Functions=