Packagecom.ericfeminella.application
Interfacepublic interface IQueryString
ImplementorsQueryString

Defines the contract for classes which must provide a robust API which allows detailed inspection of a QueryString



Public Properties
 PropertyDefined by
  isProvided : Boolean
[read-only] Determines if parameters have been provided to the application
IQueryString
Public Methods
 MethodDefined by
  
addParameter(name:String, value:*):void
Adds a new parameter ( name / value ) pair to the querystring

If the parameter name which has been specified currently exists in the querystring then it is simply ignored.

IQueryString
  
appendToURL(url:String, decode:Boolean = false):String
Appends the current state of the querystring to a URL
IQueryString
  
containsParameter(name:String):Boolean
Determines if the specified parameter has been provided to the query string
IQueryString
  
containsValue(value:*):Boolean
Determines if the specified value has been provided to the query string
IQueryString
  
getName(value:String):String
Retrieves a specific parameter name based on the parameters value
IQueryString
  
getNames():Array
Retrieves the parameter names provided to the application
IQueryString
  
Retrieves each name / value pair provided to the application and returns an Array of Objects which contain each parameter name and value
IQueryString
  
getQueryString(decode:Boolean = false):String
Retrieves the raw query string provided to the application
IQueryString
  
getValue(name:String):String
Retrieves the value of the specified parameter name.
IQueryString
  
getValues():Array
Retrieves the parameter values provided to the application
IQueryString
  
length():int
Determines the length of the query string based on the amount of name value pairs which have been supplied to the QueryString
IQueryString
  
removeParameter(name:String):void
Removes an existing parameter from the querystring
IQueryString
  
setValue(name:String, value:*):void
Assigns a new value to the specified querystring parameter
IQueryString
Property detail
isProvidedproperty
isProvided:Boolean  [read-only]

Determines if parameters have been provided to the application

Implementation
    public function get isProvided():Boolean
Method detail
addParameter()method
public function addParameter(name:String, value:*):void

Adds a new parameter ( name / value ) pair to the querystring

If the parameter name which has been specified currently exists in the querystring then it is simply ignored.

If you need to overwrite an existing parameter or modify the value of an existing parameter use setValue instead

Parameters
name:String — the name of the parameter
 
value:* — the value to assigned to the specified parameter name
appendToURL()method 
public function appendToURL(url:String, decode:Boolean = false):String

Appends the current state of the querystring to a URL

Parameters
url:String — the url to which the querystring is to be appended
 
decode:Boolean (default = false) — specifies if the querystring is to be URL decoded /encoded

Returns
String — the specified url with the querystring appended
containsParameter()method 
public function containsParameter(name:String):Boolean

Determines if the specified parameter has been provided to the query string

Parameters
name:String — the paramter to determine

Returns
Boolean — true if supplied, false if not
containsValue()method 
public function containsValue(value:*):Boolean

Determines if the specified value has been provided to the query string

Parameters
value:* — the value in which to determine

Returns
Boolean — true if the value has been provided, false if not
getName()method 
public function getName(value:String):String

Retrieves a specific parameter name based on the parameters value

Parameters
value:String — the value of the parameter which is to be located

Returns
String — parameter name to which the specified value has been assigned
getNames()method 
public function getNames():Array

Retrieves the parameter names provided to the application

Returns
Array — each query string parameter name
getParameters()method 
public function getParameters():IMap

Retrieves each name / value pair provided to the application and returns an Array of Objects which contain each parameter name and value

Returns
IMap — IMap containing key / values as specified in the querystring
getQueryString()method 
public function getQueryString(decode:Boolean = false):String

Retrieves the raw query string provided to the application

Parameters
decode:Boolean (default = false) — if the query string is to be URL decoded

Returns
String — the raw query string which has been supplied / modified
getValue()method 
public function getValue(name:String):String

Retrieves the value of the specified parameter name. If the parameter does not exist a null value is returned. If the name has not been provided in the querystring then a null value is returned

Parameters
name:String — the name of the parameter

Returns
String — the value of the specified paramter name
getValues()method 
public function getValues():Array

Retrieves the parameter values provided to the application

Returns
Array — each query string parameter value
length()method 
public function length():int

Determines the length of the query string based on the amount of name value pairs which have been supplied to the QueryString

Returns
int — the length of the query string
removeParameter()method 
public function removeParameter(name:String):void

Removes an existing parameter from the querystring

Parameters
name:String — the name of the parameter which is to b removed
setValue()method 
public function setValue(name:String, value:*):void

Assigns a new value to the specified querystring parameter

Parameters
name:String — the name of the parameter
 
value:* — the value to assigned to the specified parameter name