Actuate Java Component URIs use encoding for characters that a browser can misinterpret. You use hexadecimal encoding in these circumstances to avoid misinterpretation. Use the encoding only when the possibility of misinterpreting a character exists. Always encode characters that have a specific meaning in a URI when you use them in other ways.
Table 1-1 describes the available character substitutions. An ampersand introduces a parameter in a URI, so you must encode an ampersand that appears in a value string. For example, use:
If you customize Actuate Java Component by writing code that creates URI parameters, encode the entire parameter value string with the encode( ) method. The encode( ) method is included in encoder.js, which is provided in the Actuate Java Component <context root>/js directory. The following example encodes the folder name /Training/Sub Folder before executing the getFolderItems action:
The encode( ) method converts the folder parameter value from:
UTF-8 encoding is also the default encoding that web browsers support. All Java Component communication also uses UTF-8 encoding. For 8-bit (single byte) characters, UTF-8 content appears the same as ANSI content. If, however, extended characters are used (typically for languages that require large character sets), UTF-8 encodes these characters with two or more bytes.