I have upgraded the QueryString API from an all static utility class to a much more robust API which now supports parsing, inspecting and modifying query strings.

The new QueryString API retrieves a query string for a Flex application via ExternalInterface. Therefore a query string which has been supplied to an application can be retrieved from an html wrapper (e.g. .html, .jsp, .aspx, etc) as well as a .swf file.

Developers can also utilize the new API to perform CRUD operations on an arbitrary query string supplied to the QueryString constructor. I have also added complete support for encoding and decoding a query string as well as appending a query string to separate URLs.

Modifications of a QueryString are now fully supported and allow parameters in a QueryString object to be created, read, updated and deleted.

The QueryString constructor takes a url as an argument. This argument is optional, and, if specified instructs the QueryString object to use the specified url for all subsequent operations. If the url is not specified the QueryString object will assume the aplication query string is to be used for all operations.

Unfortunately, ActionScript 3 does not support constructor / method overloading so the url parameter is used to achieve the correct functionality based on context.

Below is a typical use-case which demonstrates how to instantiate a new QueryString object which defaults to the application’s querystring:

Optionally, you can choose to use a specific QueryString by passing it to the constructor:

Additional usage examples for all method can be found in the accompanying ASDoc.

You can view the source for the IQueryString interface and concrete QueryString implementation as well as the asdocs.

QueryString API is protected under the MIT license.

This article was posted on Friday, September 21st, 2007 at 6:35 am under: News. You can follow any comments to this entry through the RSS 2.0 feed. Both comments and pings are currently closed.