]> High performance streaming character encoding in a JSP environment.

]]>&tld_description;

Both implementations are interoperable and may be used simultaneously under different prefixes.

This taglib is part of an extensible suite of interoperable, context-aware, auto-encoding taglibs. All auto-encoding tags generate correct output for their context, provide context information for nested tags, and validate the output of nested tags. For example, <ao:message> within <encoding:psql> will write its output encoded as PSQL.

This suite includes, but is not limited to:

]]>

&tld_displayName;

6.0.0

encoding

&tld_uri; Manually establishes an encoding context when automatic detection is not possible.

The content type depends on the value provided to the type attribute. The content is checked for well-formedness based on its type:

css or text/css - must be well-formed CSS content. (Note: Currently only checks character values.)
javascript, application/javascript, or text/javascript - no validation
json or application/json - no validation
ld_json or application/ld+json - no validation
text or text/plain - no validation
url or text/url - must be a valid URL
xhtml or application/xhtml+xml - must be well-formed XHTML content. (Note: Currently only checks character values.)
xhtml_attribute or application/xhtml+xml+attribute - must be a valid XHTML attribute.
mysql or text/x+mysql - must be valid MySQL command "mysql" input
psql or text/x+psql - must be valid PostgreSQL command "psql" input
sh or text/x+sh - must be valid shell script

]]> encoding

&package;.EncodingTag

com.aoapps.encoding.taglib.EncodingTagTEI

&JSP;

Specifies the type of content contained in the tag body

]]> type true true java.lang.Object Manually establishes a JavaScript context when automatic detection is not possible. The body of this tag is a valid JavaScript.

The content type of this tag is application/javascript.

For more advanced scenarios, please use <ao:script>.

]]> javascript

&package;.JavaScriptTag

&JSP;

Manually establishes a JSON context when automatic detection is not possible. The body of this tag is valid JSON.

The content type of this tag is application/json.

For more advanced scenarios, please use <ao:script>.

]]> json

&package;.JsonTag

&JSP;

Manually establishes a JSON Linked Data context when automatic detection is not possible. The body of this tag is valid JSON-LD.

The content type of this tag is application/json.

For more advanced scenarios, please use <ao:script>.

]]> ldJson

&package;.LdJsonTag

&JSP;

Manually establishes a MySQL context when automatic detection is not possible. The body of this tag is valid MySQL command "mysql" input.

The content type of this tag is text/x+mysql.

]]> mysql

&package;.MysqlTag

&JSP;

Writes the value with proper escaping based on the context of the tag. Supports data types beyond <c:out>.

In addition to the usual set of coercions expected for <c:out>, also supports writing XML nodes such as for HTML snippets.

The content type depends on the value provided to the type attribute, and defaults to text/plain. The content is checked for well-formedness based on its type:

css or text/css - must be well-formed CSS content. (Note: Currently only checks character values.)
javascript, application/javascript, or text/javascript - no validation
json or application/json - no validation
ld_json or application/ld+json - no validation
text or text/plain - no validation
url or text/url - must be a valid URL
xhtml or application/xhtml+xml - must be well-formed XHTML content. (Note: Currently only checks character values.)
xhtml_attribute or application/xhtml+xml+attribute - must be a valid XHTML attribute.
mysql or text/x+mysql - must be valid MySQL command "mysql" input
psql or text/x+psql - must be valid PostgreSQL command "psql" input
sh or text/x+sh - must be valid shell script

To be able to use nested <ao:value> and <ao:type> tags, use the compatible <ao:out>.

]]> out

&package;.OutTag

com.aoapps.encoding.taglib.OutTagTEI

empty

The value to be written.

]]> value true true java.lang.Object The default value if the resulting value is null.

]]> default false

java.lang.Object

Specifies the type of content contained in the value. Defaults to text/plain.

]]> type false true java.lang.Object Manually establishes a PostgreSQL context when automatic detection is not possible. The body of this tag is valid PostgreSQL command "psql" input.

The content type of this tag is text/x+psql.

]]> psql

&package;.PsqlTag

&JSP;

Manually establishes a shell script context when automatic detection is not possible. The body of this tag is a valid shell script.

The content type of this tag is text/x+sh.

]]> sh

&package;.ShTag

&JSP;

Manually establishes a CSS context when automatic detection is not possible. The body of this tag is valid CSS.

The content type of this tag is text/css.

For more advanced scenarios, please use <ao:style>.

]]> style

&package;.StyleTag

&JSP;

Manually establishes a plaintext context when automatic detection is not possible. The body of this tag contains any arbitrary plain text.

In some contexts, such as contained in a JavaScript string, this may be binary transparent.

In other contexts, it may result in an error when a character may not be encoded to the container's system. An example would be a NULL character in an XML document.

End of line conversions may also occur in some contexts.

When contained in CSS, this will automatically be surrounded by double quotes. The double quotes are automatically added to clearly separate data from code. Please note that this auto-quoting applies to all forms of data in all tags, not just this text tag.

When contained in JavaScript, this will automatically be surrounded by double quotes and will be binary transparent through \uxxxx escape codes. The double quotes are automatically added to clearly separate data from code.

The content type of this tag text/plain.

]]> text

&package;.TextTag

&JSP;

Manually establishes a URL context when automatic detection is not possible. The body of this tag, after trimming, is valid RFC 3986 URI or RFC 3987 IRI.

Depending on context, the URL will be passed through HttpServletResponse.encodeURL to add any URL-based session state. Session state will never be added to external links.

When contained in CSS, this will automatically be surrounded by url("…"). Please note that this auto-quoting applies to all forms of data in all tags, not just this css tag.

The content type of this tag is text/url.

To establish a URL context with more full-featured URL manipulation, see also <ao:url>.

]]> url

&package;.UrlTag

&JSP;

Manually establishes an XHTML attribute context when automatic detection is not possible. The body of this tag contains well-formed XHTML 1.0-compliant attribute.

The content type of this tag is application/xhtml+xml+attribute.

]]> xhtmlAttribute

&package;.XhtmlAttributeTag

&JSP;

Manually establishes an XHTML context when automatic detection is not possible. The body of this tag contains well-formed XHTML 1.0-compliant markup.

The content type of this tag is application/xhtml+xml.

Note: For performance, this implementation currently only checks character values. This ensures that no encodings are violated and overall XML validation by the browser should catch problems.

]]> xhtml

&package;.XhtmlTag

&JSP;

Gets the current Doctype.

]]> getDoctype

com.aoapps.encoding.taglib.Functions

com.aoapps.encoding.Doctype getDoctype()

${encoding:getDoctype()}]]> Gets the current Serialization.

]]> getSerialization

com.aoapps.encoding.taglib.Functions

com.aoapps.encoding.Serialization getSerialization()

${encoding:getSerialization()}]]>