Changes

{| width='100%'

| width='120' | '''Signatures'''

|{{Func|web:content-type|$path as xs:string|xs:string}}<br/>

| '''Summary'''

|Returns the content type of a path by analyzing its file suffix. <code>application/octet-stream</code> is returned if the file suffix is unknown.

| '''Examples'''

|

{| width='100%'

| width='120' | '''Signatures'''

|{{Func|web:create-url|$url as xs:string, $parameters as map(*)|xs:string}}<br/>{{Func|web:create-url|$url as xs:string, $parameters as map(*), $anchor as xs:string|xs:string}}<br/>

| '''Summary'''

|Creates a new URL from the specified <code>$url</code> string, query string <code>$parameters</code> and an optional {{Code|$anchor}} reference. The keys and values of the map entries will be converted to strings, URL-encoded (see {{Function||web:encode-url}}), and appended to the URL as query parameters. If a map entry has more than a single item, all of them will be appended as single parameters.

| '''Examples'''

|

{| width='100%'

| width='120' | '''Signatures'''

|{{Func|web:encode-url|$string as xs:string|xs:string}}<br/>

| '''Summary'''

|Encodes a string to a URL. Spaces are rewritten to {{Code|+}}; {{Code|*}}, {{Code|-}}, {{Code|.}} and {{Code|_}} are adopted; and all other non-ASCII characters and special characters are percent-encoded.

| '''Examples'''

|

{| width='100%'

| width='120' | '''Signatures'''

|{{Func|web:decode-url|$string as xs:string|xs:string}}<br/>

| '''Summary'''

|Decodes a URL to the original string. Percent-encoded characters are decoded to their UTF8 codepoints, and {{Code|+}} characters are rewritten to spaces.

| '''Examples'''

|

* <code><nowiki>web:decode-url("%E6%97%A5%E6%9C%AC%E8%AA%9E")</nowiki></code> returns <code>日本語</code>.

| '''Errors'''

|{{Error|invalid|#Errors}} the string contains invalid XML characters.

{| width='100%'

| width='120' | '''Signatures'''

|{{Func|web:forward|$path as xs:string|element(rest:forward)}}<br/>{{Func|web:forward|$path as xs:string, $parameters as map(*)|element(rest:forward)}}

| '''Summary'''

|Creates a server-side [[RESTXQ#Forwards and Redirects|RESTXQ forward request]] to the specified {{Code|$path}}:

* Supplied query parameters will be attached to parameters of the current request.

* The {{Code|$parameter}} argument is processed as described in {{Function||web:create-url}}.

| '''Examples'''

|

{| width='100%'

| width='120' | '''Signatures'''

|{{Func|web:redirect|$url as xs:string|element(rest:response)}}<br/>{{Func|web:redirect|$url as xs:string, $parameters as map(*)|element(rest:response)}}<br/>{{Func|web:redirect|$url as xs:string, $parameters as map(*), $anchor as xs:string|element(rest:response)}}<br/>

| '''Summary'''

|Creates a [[RESTXQ#Forwards and Redirects|RESTXQ redirection]] to the specified {{Code|$url}}. The returned response will only work if no other items are returned by the RESTXQ function.<br/>The {{Code|$parameters}} and {{Code|$anchor}} arguments are processed as described in (see {{Function||web:create-url}}).

| '''Examples'''

|

{| width='100%'

| width='120' | '''Signatures'''

|{{Func|web:response-header||element(rest:response)}}<br/>{{Func|web:response-header|$output as map(*)?|element(rest:response)}}<br/>{{Func|web:response-header|$output as map(*)?, $headers as map(*)?|element(rest:response)}}<br/>{{Func|web:response-header|$output as map(*)?, $headers as map(*)?, $atts as map(*)?|element(rest:response)}}<br/>

| '''Summary'''

|Creates a [[RESTXQ#Response|RESTXQ response header]].<br/>

Header options can be supplied via the <code>$headers</code> argument. Empty string values can be specified to invalidate default values. By default, the following header options will be returned:

* <code>Cache-Control</code>: <code>max-age=3600,public</code>

| '''Examples'''

|

{| width='100%'

| width='120' | '''Signatures'''

|{{Func|web:error|$status as xs:integer, $message as xs:string|none}}<br/>

| '''Summary'''

|Raises an error with the QName {{Code|rest:error}}, the specified {{Code|$message}} and the specified {{Code|$status}} as error value.<br/>Calls to this function are equivalent to <code>fn:error(xs:QName('rest:error'), $message, $status)</code>.

See [[RESTXQ#Raise Errors|RESTXQ: Raise Errors]] to learn how the function is helpful in web applications.

| '''Examples'''

|

* <code><nowiki>web:error(404, "The requested resource cannot be found.")</nowiki></code>

| '''Errors'''

|{{Error|status|#Errors}} The supplied status code is invalid.

! width="110"|Code

|Description

|{{Code|invalid}}

|A string contains invalid XML characters.

|{{Code|status}}

|The supplied status code is invalid.