Module com.aoapps.encoding

Package com.aoapps.encoding

Interface LdJson

All Superinterfaces:

Encode

All Known Implementing Classes:

JavaScriptWriter, JsonWriter, LdJsonWriter, TextWriter, XhtmlWriter

@ThreadSafe
public interface LdJson
extends Encode

Encodes JSON linked data for safe output.

Author:

AO Industries, Inc.

Method Summary

Modifier and Type	Method	Description
MediaWriter	encode(MediaType contentType)	Deprecated. Encoding of arbitrary content types is not expected since all supported types have per-type methods.
default LdJson	encode(MediaType contentType, char ch)	Deprecated. Encoding of arbitrary content types is not expected since all supported types have per-type methods.
default LdJson	encode(MediaType contentType, char[] cbuf)	Deprecated. Encoding of arbitrary content types is not expected since all supported types have per-type methods.
default LdJson	encode(MediaType contentType, char[] cbuf, int offset, int len)	Deprecated. Encoding of arbitrary content types is not expected since all supported types have per-type methods.
default <Ex extends Throwable> LdJson	encode(MediaType contentType, MediaWritable<Ex> content)	Deprecated. Encoding of arbitrary content types is not expected since all supported types have per-type methods.
default <Ex extends Throwable> LdJson	encode(MediaType contentType, IOSupplierE<?,Ex> content)	Deprecated. Encoding of arbitrary content types is not expected since all supported types have per-type methods.
LdJson	encode(MediaType contentType, CharSequence csq)	Deprecated. Encoding of arbitrary content types is not expected since all supported types have per-type methods.
LdJson	encode(MediaType contentType, CharSequence csq, int start, int end)	Deprecated. Encoding of arbitrary content types is not expected since all supported types have per-type methods.
LdJson	encode(MediaType contentType, Object content)	Deprecated. Encoding of arbitrary content types is not expected since all supported types have per-type methods.
default LdJsonWriter	ldJson()	Writes the given JSON linked data with proper encoding.
default LdJson	ldJson(char ch)	Writes the given JSON linked data with proper encoding.
default LdJson	ldJson(char[] cbuf)	Writes the given JSON linked data with proper encoding.
default LdJson	ldJson(char[] cbuf, int offset, int len)	Writes the given JSON linked data with proper encoding.
default <Ex extends Throwable> LdJson	ldJson(LdJsonWritable<Ex> ldJson)	Writes the given JSON linked data with proper encoding.
default <Ex extends Throwable> LdJson	ldJson(IOSupplierE<?,Ex> ldJson)	Writes the given JSON linked data with proper encoding.
default LdJson	ldJson(CharSequence csq)	Writes the given JSON linked data with proper encoding.
default LdJson	ldJson(CharSequence csq, int start, int end)	Writes the given JSON linked data with proper encoding.
default LdJson	ldJson(Object ldJson)	Writes the given JSON linked data with proper encoding.

Method Details

encode

@Deprecated
default LdJson encode(MediaType contentType,
 char ch)
               throws IOException

Deprecated.

Encoding of arbitrary content types is not expected since all supported types have per-type methods.

Encodes the given nested type with proper encoding.

Adds prefixes and suffixes by media type, such as "…".

Specified by:

encode in interface Encode

Returns:

this writer

Throws:

IOException

encode

@Deprecated
default LdJson encode(MediaType contentType,
 char[] cbuf)
               throws IOException

Deprecated.

Encoding of arbitrary content types is not expected since all supported types have per-type methods.

Encodes the given nested type with proper encoding.

Adds prefixes and suffixes by media type, such as "…".

Specified by:

encode in interface Encode

Returns:

this writer

Throws:

IOException

encode

@Deprecated
default LdJson encode(MediaType contentType,
 char[] cbuf,
 int offset,
 int len)
               throws IOException

Deprecated.

Encoding of arbitrary content types is not expected since all supported types have per-type methods.

Encodes the given nested type with proper encoding.

Adds prefixes and suffixes by media type, such as "…".

Specified by:

encode in interface Encode

Returns:

this writer

Throws:

IOException

encode

@Deprecated
LdJson encode(MediaType contentType,
 CharSequence csq)
       throws IOException

Deprecated.

Encoding of arbitrary content types is not expected since all supported types have per-type methods.

Encodes the given nested type with proper encoding.

Adds prefixes and suffixes by media type, such as "…".

If the string is translated, comments will be added giving the translation lookup id to aid in translation of server-translated values.

Specified by:

encode in interface Encode

Returns:

this writer

Throws:

IOException

encode

@Deprecated
LdJson encode(MediaType contentType,
 CharSequence csq,
 int start,
 int end)
       throws IOException

Deprecated.

Encoding of arbitrary content types is not expected since all supported types have per-type methods.

Encodes the given nested type with proper encoding.

Adds prefixes and suffixes by media type, such as "…".

If the string is translated, comments will be added giving the translation lookup id to aid in translation of server-translated values.

Specified by:

encode in interface Encode

Returns:

this writer

Throws:

IOException

encode

@Deprecated
LdJson encode(MediaType contentType,
 Object content)
       throws IOException

Deprecated.

Encoding of arbitrary content types is not expected since all supported types have per-type methods.

Encodes the given nested type with proper encoding.

Adds prefixes and suffixes by media type, such as "…".

If the string is translated, comments will be added giving the translation lookup id to aid in translation of server-translated values.

Specified by:

encode in interface Encode

Returns:

this writer

Throws:

IOException

encode

@Deprecated
default <Ex extends Throwable> LdJson encode(MediaType contentType,
 IOSupplierE<?,Ex> content)
                                      throws IOException,
Ex

Deprecated.

Encoding of arbitrary content types is not expected since all supported types have per-type methods.

Encodes the given nested type with proper encoding.

Adds prefixes and suffixes by media type, such as "…".

If the string is translated, comments will be added giving the translation lookup id to aid in translation of server-translated values.

Specified by:

encode in interface Encode

Type Parameters:

Ex - An arbitrary exception type that may be thrown

Returns:

this writer

Throws:

IOException

Ex

encode

@Deprecated
default <Ex extends Throwable> LdJson encode(MediaType contentType,
 MediaWritable<Ex> content)
                                      throws IOException,
Ex

Deprecated.

Encoding of arbitrary content types is not expected since all supported types have per-type methods.

Encodes the given nested type with proper encoding.

Adds prefixes and suffixes by media type, such as "…".

Does not perform any translation markups.

Specified by:

encode in interface Encode

Type Parameters:

Ex - An arbitrary exception type that may be thrown

Returns:

this writer

Throws:

IOException

Ex

encode

@Deprecated
MediaWriter encode(MediaType contentType)
            throws IOException

Deprecated.

Encoding of arbitrary content types is not expected since all supported types have per-type methods.

Encodes the given nested type with proper encoding. This is well suited for use in a try-with-resources block.

Adds prefixes and suffixes by media type, such as "…".

Does not perform any translation markups.

Specified by:

encode in interface Encode

Returns:

A new writer that may be used for the given content type. This writer must be closed for completed calls to MediaEncoder.writeSuffixTo(java.lang.Appendable, boolean).

The returned writer will be of the specific subclass of MediaWriter matching contentType (see MediaType.getMediaWriterClass(). This means MediaWriter.getValidMediaInputType() will be contentType.

Throws:

IOException

ldJson

default LdJson ldJson(char ch)
               throws IOException

Writes the given JSON linked data with proper encoding.

Adds prefixes and suffixes by media type, such as <script type="application/ld+json">…</script>.

Returns:

this writer

Throws:

IOException

ldJson

default LdJson ldJson(char[] cbuf)
               throws IOException

Writes the given JSON linked data with proper encoding.

Adds prefixes and suffixes by media type, such as <script type="application/ld+json">…</script>.

Returns:

this writer

Throws:

IOException

ldJson

default LdJson ldJson(char[] cbuf,
 int offset,
 int len)
               throws IOException

Writes the given JSON linked data with proper encoding.

Adds prefixes and suffixes by media type, such as <script type="application/ld+json">…</script>.

Returns:

this writer

Throws:

IOException

ldJson

default LdJson ldJson(CharSequence csq)
               throws IOException

Writes the given JSON linked data with proper encoding.

Adds prefixes and suffixes by media type, such as <script type="application/ld+json">…</script>.

If the string is translated, comments will be added giving the translation lookup id to aid in translation of server-translated values.

Returns:

this writer

Throws:

IOException

ldJson

default LdJson ldJson(CharSequence csq,
 int start,
 int end)
               throws IOException

Writes the given JSON linked data with proper encoding.

Adds prefixes and suffixes by media type, such as <script type="application/ld+json">…</script>.

If the string is translated, comments will be added giving the translation lookup id to aid in translation of server-translated values.

Returns:

this writer

Throws:

IOException

ldJson

default LdJson ldJson(Object ldJson)
               throws IOException

Writes the given JSON linked data with proper encoding.

Adds prefixes and suffixes by media type, such as <script type="application/ld+json">…</script>.

If the string is translated, comments will be added giving the translation lookup id to aid in translation of server-translated values.

Returns:

this writer

Throws:

IOException

ldJson

default <Ex extends Throwable> LdJson ldJson(IOSupplierE<?,Ex> ldJson)
                                      throws IOException,
Ex

Writes the given JSON linked data with proper encoding.

Adds prefixes and suffixes by media type, such as <script type="application/ld+json">…</script>.

If the string is translated, comments will be added giving the translation lookup id to aid in translation of server-translated values.

Type Parameters:

Ex - An arbitrary exception type that may be thrown

Returns:

this writer

Throws:

IOException

Ex

ldJson

default <Ex extends Throwable> LdJson ldJson(LdJsonWritable<Ex> ldJson)
                                      throws IOException,
Ex

Writes the given JSON linked data with proper encoding.

Adds prefixes and suffixes by media type, such as <script type="application/ld+json">…</script>.

Does not perform any translation markups.

Type Parameters:

Ex - An arbitrary exception type that may be thrown

Returns:

this writer

Throws:

IOException

Ex

ldJson

default LdJsonWriter ldJson()
                     throws IOException

Writes the given JSON linked data with proper encoding. This is well suited for use in a try-with-resources block.

Adds prefixes and suffixes by media type, such as <script type="application/ld+json">…</script>.

Does not perform any translation markups.

Returns:

A new writer that may be used for arbitrary JSON linked data. This writer must be closed for completed calls to MediaEncoder.writeSuffixTo(java.lang.Appendable, boolean).

Throws:

IOException