Spry User Guide - Support - Adobe

Dynamic Region Example
var dsPhotos = new Spry.Data.XMLDataSet("/photos.php", "/gallery/photos/photo", {
method: "POST", postData: "galleryid=2000&offset=20&limit=10", headers: { "Content-Type":
"application/x-www-form-urlencoded; charset=UTF-8" } });
. . .
If you use the POST method, but don’t specify a content type, the default content type is set to "application/xwww-form-urlencoded;
charset=UTF-8".
The following table shows the HTTP-related constructor options that you can specify.
Option Description
method The HTTP method to use when fetching the XML data. Must be the string "GET" or "POST".
postData Can be a string containing url encode form arguments or any value supported by the
XMLHttpRequest object. If a "Content-Type" header is not specified in conjunction with the
postData option, the "application/x-www-form-urlencoded;
charset=UTF-8" content type is used.
username The server username to use when accessing the XML data.
password The password to use in conjunction with username when accessing the XML data.
headers An object or associative array that uses the HTTP request field name as its property and key
to store values.
Turn off data caching
By default, Spry caches any XML datathat a data set loaded on the client. If a data set attempts to load the XML data
for a given URL that is already in the cache, Spry returns a reference to the cached data to the data set. If multiple
data sets attempt to load the same URL at the same time, all load requests are combined into a single HTTP request
to save bandwidth.
Use of data caching and of combining requests can greatly improve performance, especially when multiple data sets
refer to the same XML data; at times you might need to load the data directly from the server (for example, if you
have a URL that might return different data each time someone accesses it).
❖ To force a data set to load XML data directly from the server, set the useCache XMLDataSet constructor option
to false, as follows:
var dsPhotos = new Spry.Data.XMLDataSet("/photos.php?galleryid=2000",
"/gallery/photos/photo", {useCache: false })
SPRY
User Guide
122