Page

Method Summary
	addChartToPage(Chart chart) Adds the specified chart to the page.
	addData(Data data) Adds the specified Data to this response.
boolean	addDataList(DataList list) Adds the specified list to a page
boolean	addDataMap(String id, Data data) Registers the data in the response with the specified id.
boolean	addDataMaps(String keyColumn, DataList list) Extracts the records from the list and registers them in the response using the values in the key column. Limited to 500 records per response.
boolean	addDataRecord(String id, DataRecord dataRecord) Registers the DataRecord in the response with the specified id. Limited to 500 records per response.
boolean	addJavascript(String script) Adds javascript commands to the page. The commands run in the order added after all CloudPiston code has completed. Returns false if the script is not allowed.
	addPayload(Payload payload) Adds the payload to this response.
	alert(String message) Performs a javascript alert with the message when the page loads.
	allowHTML(String key) Permits any rendering target with the specified key to be rendered as HTML.
	allowPageCache(boolean allow) By default we do not allow caching of the page (form submits) for security reasons. By calling this method, passing true, the cache directive is turned off and the page/form post can be cached.
boolean	checkServer(String action, int delay, String target) Tells the response object to do an AJAX call to the server starting delay seconds after the page loads passing 'action' to the controller and display the results in the element with id 'target'. See Controller.createAjaxResponse(Fragment).
boolean	enableAjaxUpload(String type, int kilobytes) See enableUpload. This method additionally requires you to provide a client-side javascript function to handle the results of the upload. See the ajax-handler attribute of c:button and c:a.
boolean	enableUpload(String type, int kilobytes) Enables file upload and restricts the upload to type and maximum file size. type can be * (all types) or a comma delimited string of types. kilobytes cannot exceed the pal activation settings.
String	get(String key) Returns the value associated with key if it exists, null otherwise.
Boolean	getBoolean(String field) Returns the given field as a boolean. The value must be true or false. Throws exception if the value does not exist or cannot be cast to the correct type.
Boolean	getCommonBoolean(String field) Returns the given field as a boolean. The value must be any of the following combinations: [true/false], [1/0], [yes,no], [on,off]. Throws exception if the value does not exist or cannot be cast to the correct type.
Data	getData() Returns the Data object for this response.
Date	getDate(String field) Returns the given field as a Date. Throws exception if the value does not exist or cannot be cast to the correct type.
Boolean	getDefaultBoolean(String field, Boolean defaultBoolean) Returns the given field as a boolean. If the field does not exist or refers to a non-boolean field, it returns the default value
Date	getDefaultDate(String field, Date defaultDate) Returns the given field as a date. If the field does not exist or refers to a non-date field, it returns the default value
Double	getDefaultDouble(String field, Number defaultDouble) Returns the given field as a double. If the field does not exist or refers to a non-double field, it returns the default value
Integer	getDefaultInt(String field, Number defaultInt) Returns the given field as an int. If the field does not exist or refers to a non-int field, it returns the default value
String	getDefaultValue(String field, String defaultValue, boolean emptyIsNull) Returns the given field. If the field does not exist, it returns the default value. If the field exists but is value is empty, this method returns defaultValue only if emptyIsNull=true.
Double	getDouble(String key) Returns the given value of the given key as a double. Throws exception if the value does not exist or cannot be cast to the correct type.
Integer	getInt(String key) Returns the given value of the given key as an Java Int which is smaller than a Javascript Int. Throws exception if the value does not exist or cannot be cast to the correct type.
Long	getLong(String key) Returns the given value of the given key as Java Long which is larger. Throws exception if the value does not exist or cannot be cast to the correct type.
String	getValue(String key) Returns the value associated with key if it exists, null otherwise.
	removeDataList(String name) Removes the datalist from the payload
	removeDataMap(String id) Removes the data in the response with the specified id.
	removeSessionLayer() Removes the rendering layer, if any.
	removeValue(String key) Removes the associated key from the response.
boolean	set(String name, Object value) Sets the string value referenced by name. Returns false on fail (e.g. if the column does not exist, etc). The object must be capable of being serialized as a String.
boolean	setBoolean(String name, Boolean value) Sets the boolean value referenced by name. Returns false on fail (e.g. if the column does not exist, etc).
boolean	setData(String id, Data data) Registers the data in the response with the specified id.
boolean	setDate(String name, Date value) Sets the date value referenced by name. Returns false on fail (e.g. if the column does not exist, etc).
boolean	setDouble(String name, Number double) Sets the decimal value referenced by name. Returns false on fail (e.g. if the column does not exist, etc).
	setHTML(String key, String xhtml) Adds the given XHTML to the page (the XHTML should ideally be well-formed). You must use the c:html tag for displaying the content. Throws exception if the content contains illegal tags or attributes. You should avoid inline scripts or script blocks.
boolean	setInt(String name, Number value) Sets the integer value referenced by name. Returns false on fail (e.g. if the column does not exist, etc).
	setSessionLayer(Payload payload) Sets a rendering layer based on content stored in the payload. Supported files: images, css, script.
boolean	setString(String name, String value) Sets the string value referenced by name. Returns false on fail (e.g. if the column does not exist, etc).
	setValue(String key, Object value) Sets the string value referenced by name. The object must be capable of being serialized as a String.
PdfFile	toPdf(String fileName) Creates PDF file from this page. File will reflect current page state. Further modifications of page will not have effect on file contents.
String	toString() Returns a description of this object.

Method Detail

---

addChartToPage(Chart chart)

Adds the specified chart to the page.

Parameters:

• Chart   chart

Since: 10-30-2008

---

addData(Data data)

Adds the specified Data to this response.

Parameters:

• Data   data

Since: 05-28-2010

---

boolean addDataList(DataList list)

Adds the specified list to a page

Parameters:

• DataList   list

Returns:  boolean

Since: 07-11-2008

---

boolean addDataMap(String id, Data data)

Registers the data in the response with the specified id.

Parameters:

• String   id Required parameter.
• Data   data Required parameter.

Returns:  boolean

Since: 05-28-2010

---

boolean addDataMaps(String keyColumn, DataList list)

Extracts the records from the list and registers them in the response using the values in the key column. Limited to 500 records per response.

Parameters:

• String   keyColumn Required parameter.
• DataList   list Required parameter.

Returns:  boolean

Since: 05-28-2010

---

boolean addDataRecord(String id, DataRecord dataRecord)

Registers the DataRecord in the response with the specified id. Limited to 500 records per response.

Parameters:

• String   id Required parameter.
• DataRecord   dataRecord Required parameter.

Returns:  boolean

Since: 11-09-2010

---

boolean addJavascript(String script)

Adds javascript commands to the page. The commands run in the order added after all CloudPiston code has completed. Returns false if the script is not allowed.

Parameters:

• String   script

Returns:  boolean

Since: 01-29-2009

---

addPayload(Payload payload)

Adds the payload to this response.

Parameters:

• Payload   payload

Since: 07-20-2010

---

alert(String message)

Performs a javascript alert with the message when the page loads.

Parameters:

• String   message

Since: 07-20-2009

---

allowHTML(String key)

Permits any rendering target with the specified key to be rendered as HTML.

Parameters:

• String   key Required parameter.

Since: 08-02-2017

---

allowPageCache(boolean allow)

By default we do not allow caching of the page (form submits) for security reasons. By calling this method, passing true, the cache directive is turned off and the page/form post can be cached.

Parameters:

• boolean   allow  - Default is false..

Since: 07-31-2020

---

boolean checkServer(String action, int delay, String target)

Tells the response object to do an AJAX call to the server starting delay seconds after the page loads passing 'action' to the controller and display the results in the element with id 'target'. See Controller.createAjaxResponse(Fragment).

Parameters:

• String   action Required parameter.
• int   delay Required parameter.
• String   target Required parameter.

Returns:  boolean

Since: 01-29-2009

---

boolean enableAjaxUpload(String type, int kilobytes)

See enableUpload. This method additionally requires you to provide a client-side javascript function to handle the results of the upload. See the ajax-handler attribute of c:button and c:a.

Parameters:

• String   type Required parameter.
• int   kilobytes Required parameter.

Returns:  boolean

Since: 02-28-2013

---

boolean enableUpload(String type, int kilobytes)

Enables file upload and restricts the upload to type and maximum file size. type can be * (all types) or a comma delimited string of types. kilobytes cannot exceed the pal activation settings.

Parameters:

• String   type Allowed values: *, har, json, dat, csv, tsv, excel, word, ppoint, pdf, tiff, txt, rtf, jpg, gif, png, ico, calc, writer, impress, xml, html, psd, office, ooffice, image, zip, pal, mp3, 3gpp, vcf, wav, audio, mp4, mov, video, pem, log, cfg, dat, mf, vcf, cnf, qbo, qfx, ofx.
• int   kilobytes

Returns:  boolean

Since: 01-19-2011

---

String get(String key)

Returns the value associated with key if it exists, null otherwise.

Parameters:

• String   key

Returns:  String

Since: 08-28-2018

---

Boolean getBoolean(String field)

Returns the given field as a boolean. The value must be true or false. Throws exception if the value does not exist or cannot be cast to the correct type.

Parameters:

• String   field

Returns:  Boolean

Since: 07-11-2008

---

Boolean getCommonBoolean(String field)

Returns the given field as a boolean. The value must be any of the following combinations: [true/false], [1/0], [yes,no], [on,off]. Throws exception if the value does not exist or cannot be cast to the correct type.

Parameters:

• String   field

Returns:  Boolean

Since: 08-22-2008

---

Data getData()

Returns the Data object for this response.

Returns:  Data

Since: 05-31-2007

---

Date getDate(String field)

Returns the given field as a Date. Throws exception if the value does not exist or cannot be cast to the correct type.

Parameters:

• String   field

Returns:  Date

Since: 07-11-2008

---

Boolean getDefaultBoolean(String field, Boolean defaultBoolean)

Returns the given field as a boolean. If the field does not exist or refers to a non-boolean field, it returns the default value

Parameters:

• String   field
• Boolean   defaultBoolean

Returns:  Boolean

Since: 09-05-2008

---

Date getDefaultDate(String field, Date defaultDate)

Returns the given field as a date. If the field does not exist or refers to a non-date field, it returns the default value

Parameters:

• String   field
• Date   defaultDate

Returns:  Date

Since: 09-05-2008

---

Double getDefaultDouble(String field, Number defaultDouble)

Returns the given field as a double. If the field does not exist or refers to a non-double field, it returns the default value

Parameters:

• String   field
• Number   defaultDouble

Returns:  Double

Since: 09-05-2008

---

Integer getDefaultInt(String field, Number defaultInt)

Returns the given field as an int. If the field does not exist or refers to a non-int field, it returns the default value

Parameters:

• String   field
• Number   defaultInt

Returns:  Integer

Since: 09-05-2008

---

String getDefaultValue(String field, String defaultValue, boolean emptyIsNull)

Returns the given field. If the field does not exist, it returns the default value. If the field exists but is value is empty, this method returns defaultValue only if emptyIsNull=true.

Parameters:

• String   field
• String   defaultValue
• boolean   emptyIsNull

Returns:  String

Since: 09-05-2008

---

Double getDouble(String key)

Returns the given value of the given key as a double. Throws exception if the value does not exist or cannot be cast to the correct type.

Parameters:

• String   key Required parameter.

Returns:  Double

Since: 07-11-2008

---

Integer getInt(String key)

Returns the given value of the given key as an Java Int which is smaller than a Javascript Int. Throws exception if the value does not exist or cannot be cast to the correct type.

Parameters:

• String   key Required parameter.

Returns:  Integer

Since: 07-11-2008

---

Long getLong(String key)

Returns the given value of the given key as Java Long which is larger. Throws exception if the value does not exist or cannot be cast to the correct type.

Parameters:

• String   key Required parameter.

Returns:  Long

Since: 05-28-2022

---

String getValue(String key)

Returns the value associated with key if it exists, null otherwise.

Parameters:

• String   key

Returns:  String

Since: 07-11-2008

---

removeDataList(String name)

Removes the datalist from the payload

Parameters:

• String   name  - name of data list in payload. Required parameter.

Since: 06-29-2021

---

removeDataMap(String id)

Removes the data in the response with the specified id.

Parameters:

• String   id Required parameter.

Since: 12-21-2017

---

removeSessionLayer()

Removes the rendering layer, if any.

Since: 12-08-2017

---

removeValue(String key)

Removes the associated key from the response.

Parameters:

• String   key

Since: 05-28-2010

---

boolean set(String name, Object value)

Sets the string value referenced by name. Returns false on fail (e.g. if the column does not exist, etc). The object must be capable of being serialized as a String.

Parameters:

• String   name
• Object   value

Returns:  boolean

Since: 08-28-2018

---

boolean setBoolean(String name, Boolean value)

Sets the boolean value referenced by name. Returns false on fail (e.g. if the column does not exist, etc).

Parameters:

• String   name
• Boolean   value

Returns:  boolean

Since: 08-28-2018

---

boolean setData(String id, Data data)

Registers the data in the response with the specified id.

Parameters:

• String   id Required parameter.
• Data   data Required parameter.

Returns:  boolean

Since: 02-11-2019

---

boolean setDate(String name, Date value)

Sets the date value referenced by name. Returns false on fail (e.g. if the column does not exist, etc).

Parameters:

• String   name
• Date   value

Returns:  boolean

Since: 08-28-2018

---

boolean setDouble(String name, Number double)

Sets the decimal value referenced by name. Returns false on fail (e.g. if the column does not exist, etc).

Parameters:

• String   name
• Number   double

Returns:  boolean

Since: 08-28-2018

---

setHTML(String key, String xhtml)

Adds the given XHTML to the page (the XHTML should ideally be well-formed). You must use the c:html tag for displaying the content. Throws exception if the content contains illegal tags or attributes. You should avoid inline scripts or script blocks.

Parameters:

• String   key
• String   xhtml

Since: 07-11-2008

---

boolean setInt(String name, Number value)

Sets the integer value referenced by name. Returns false on fail (e.g. if the column does not exist, etc).

Parameters:

• String   name
• Number   value

Returns:  boolean

Since: 08-28-2018

---

setSessionLayer(Payload payload)

Sets a rendering layer based on content stored in the payload. Supported files: images, css, script.

Parameters:

• Payload   payload Required parameter.

Since: 12-08-2017

---

boolean setString(String name, String value)

Sets the string value referenced by name. Returns false on fail (e.g. if the column does not exist, etc).

Parameters:

• String   name
• String   value

Returns:  boolean

Since: 08-28-2018

---

setValue(String key, Object value)

Sets the string value referenced by name. The object must be capable of being serialized as a String.

Parameters:

• String   key
• Object   value

Since: 07-11-2008

---

PdfFile toPdf(String fileName)

Creates PDF file from this page. File will reflect current page state. Further modifications of page will not have effect on file contents.

Parameters:

• String   fileName  - file name. Required parameter.

Returns:  PdfFile

Since: 11-02-2010

---

String toString()

Returns a description of this object.

Returns:  String

Since: 10-30-2008