Module com.aoapps.encoding

Package com.aoapps.encoding

Class ShWriter

java.lang.Object

java.io.Writer

java.io.FilterWriter

com.aoapps.lang.io.EncoderWriter

com.aoapps.encoding.MediaWriter

com.aoapps.encoding.WhitespaceWriter

com.aoapps.encoding.ShWriter

All Implemented Interfaces:

Encode, Sh, Text, ValidMediaFilter, ValidMediaInput, ValidMediaOutput, Whitespace, NoClose, Closeable, Flushable, Appendable, AutoCloseable

@ThreadSafe
public final class ShWriter
extends WhitespaceWriter
implements Text, Sh

Streaming versions of media encoders.

Author:

AO Industries, Inc.

See Also:

• MediaEncoder

Field Summary

Fields inherited from class com.aoapps.encoding.MediaWriter

DEFAULT_CLOSER, DEFAULT_IS_NO_CLOSE

Fields inherited from class java.io.FilterWriter

out

Fields inherited from class java.io.Writer

lock

Fields inherited from interface com.aoapps.encoding.Text

NBSP

Fields inherited from interface com.aoapps.encoding.Whitespace

INDENT_SPACES, NL, SPACE

Constructor Summary

Constructors

Constructor	Description
ShWriter(EncodingContext encodingContext, MediaEncoder encoder, Writer out)	Simplified constructor.
ShWriter(EncodingContext encodingContext, MediaEncoder encoder, Writer out, boolean outOptimized, Whitespace indentDelegate, Predicate<? super MediaWriter> isNoClose, IOConsumer<? super MediaWriter> closer)

Method Summary

Modifier and Type	Method	Description
ShWriter	append(char c)
ShWriter	append(CharSequence csq)
ShWriter	append(CharSequence csq, int start, int end)
ShWriter	decDepth()	Decrements the indentation depth, if enabled.
MediaWriter	encode(MediaType contentType)	Deprecated. Encoding of arbitrary content types is not expected since all supported types have per-type methods.
ShWriter	encode(MediaType contentType, char ch)	Deprecated. Encoding of arbitrary content types is not expected since all supported types have per-type methods.
ShWriter	encode(MediaType contentType, char[] cbuf)	Deprecated. Encoding of arbitrary content types is not expected since all supported types have per-type methods.
ShWriter	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.
<Ex extends Throwable> ShWriter	encode(MediaType contentType, MediaWritable<Ex> content)	Deprecated. Encoding of arbitrary content types is not expected since all supported types have per-type methods.
<Ex extends Throwable> ShWriter	encode(MediaType contentType, IOSupplierE<?,Ex> content)	Deprecated. Encoding of arbitrary content types is not expected since all supported types have per-type methods.
ShWriter	encode(MediaType contentType, CharSequence csq)	Deprecated. Encoding of arbitrary content types is not expected since all supported types have per-type methods.
ShWriter	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.
ShWriter	encode(MediaType contentType, Object content)	Deprecated. Encoding of arbitrary content types is not expected since all supported types have per-type methods.
MediaType	getValidMediaInputType()	Gets the input type.
ShWriter	incDepth()	Increments the indentation depth, if enabled.
ShWriter	indent()	Writes the current indentation when indentation enabled.
ShWriter	indent(int depthOffset)	Writes the current indentation with a depth offset when indentation enabled.
ShWriter	nbsp()	Writes one non-breaking space character.
ShWriter	nbsp(int count)	Writes the given number of non-breaking space characters.
ShWriter	nl()	Writes a newline.
ShWriter	nli()	Writes a newline, followed by current indentation when indentation enabled.
ShWriter	nli(int depthOffset)	Writes a newline, followed by current indentation with a depth offset when indentation enabled.
ShWriter	setDepth(int depth)	Sets the indentation depth.
ShWriter	setIndent(boolean indent)	Enables or disabled indentation.
ShWriter	sh()	Deprecated. Already writing Bourne shell script
ShWriter	sh(char ch)	Deprecated. Already writing Bourne shell script
ShWriter	sh(char[] cbuf)	Deprecated. Already writing Bourne shell script
ShWriter	sh(char[] cbuf, int offset, int len)	Deprecated. Already writing Bourne shell script
<Ex extends Throwable> ShWriter	sh(ShWritable<Ex> sh)	Deprecated. Already writing Bourne shell script
<Ex extends Throwable> ShWriter	sh(IOSupplierE<?,Ex> sh)	Deprecated. Already writing Bourne shell script
ShWriter	sh(CharSequence csq)	Deprecated. Already writing Bourne shell script
ShWriter	sh(CharSequence csq, int start, int end)	Deprecated. Already writing Bourne shell script
ShWriter	sh(Object sh)	Deprecated. Already writing Bourne shell script
ShWriter	sp()	Writes one space character.
ShWriter	sp(int count)	Writes the given number of space characters.
ShWriter	text(char ch)	Writes the given text with proper encoding.
ShWriter	text(char[] cbuf)	Writes the given text with proper encoding.
ShWriter	text(char[] cbuf, int offset, int len)	Writes the given text with proper encoding.
<Ex extends Throwable> ShWriter	text(TextWritable<Ex> text)	Writes the given text with proper encoding.
<Ex extends Throwable> ShWriter	text(IOSupplierE<?,Ex> text)	Writes the given text with proper encoding.
ShWriter	text(CharSequence csq)	Writes the given text with proper encoding.
ShWriter	text(CharSequence csq, int start, int end)	Writes the given text with proper encoding.
ShWriter	text(Object text)	Writes the given text with proper encoding.

Methods inherited from class com.aoapps.encoding.WhitespaceWriter

getDepth, getIndent

Methods inherited from class com.aoapps.encoding.MediaWriter

canSkipValidation, close, getEncoder, getEncodingContext, getValidMediaOutputType, isNoClose, isValidatingMediaInputType

Methods inherited from class com.aoapps.lang.io.EncoderWriter

getOut, write, write, write, write, write, writePrefix, writeSuffix, writeSuffix

Methods inherited from class java.io.FilterWriter

flush

Methods inherited from class java.io.Writer

nullWriter

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.aoapps.encoding.Text

text

Constructor Details

ShWriter

public ShWriter(EncodingContext encodingContext,
 MediaEncoder encoder,
 Writer out,
 boolean outOptimized,
 Whitespace indentDelegate,
 Predicate<? super MediaWriter> isNoClose,
 IOConsumer<? super MediaWriter> closer)

Parameters:

out - Conditionally passed through Coercion.optimize(java.io.Writer, com.aoapps.lang.io.Encoder)

outOptimized - Is out already known to have been passed through Coercion.optimize(java.io.Writer, com.aoapps.lang.io.Encoder)?

indentDelegate - When non-null, indentation depth is get/set on the provided Whitespace, otherwise tracks directly on this writer. This allows the indentation to be coordinated between nested content types.

isNoClose - Called to determine result of MediaWriter.isNoClose()

closer - Called on MediaWriter.close(), which may optionally perform final suffix write and/or close the underlying writer, will only be called to be idempotent, implementation can assume will only be called once.

ShWriter

public ShWriter(EncodingContext encodingContext,
 MediaEncoder encoder,
 Writer out)

Simplified constructor.

Parameters:

out - Passed through Coercion.optimize(java.io.Writer, com.aoapps.lang.io.Encoder)

See Also:

• MediaWriter.DEFAULT_IS_NO_CLOSE
• MediaWriter.DEFAULT_CLOSER

Method Details

getValidMediaInputType

public MediaType getValidMediaInputType()

Description copied from class: MediaWriter

Gets the input type.

Gets the media type this specific type of media writer represents. This is a one-to-one relationship: every media type has a specific writer.

Specified by:

getValidMediaInputType in interface ValidMediaInput

Specified by:

getValidMediaInputType in class MediaWriter

append

public ShWriter append(char c)
                throws IOException

Specified by:

append in interface Appendable

Overrides:

append in class WhitespaceWriter

Throws:

IOException

append

public ShWriter append(CharSequence csq)
                throws IOException

Specified by:

append in interface Appendable

Overrides:

append in class WhitespaceWriter

Throws:

IOException

append

public ShWriter append(CharSequence csq,
 int start,
 int end)
                throws IOException

Specified by:

append in interface Appendable

Overrides:

append in class WhitespaceWriter

Throws:

IOException

encode

@Deprecated
public ShWriter 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

Specified by:

encode in interface Sh

Specified by:

encode in interface Text

Overrides:

encode in class WhitespaceWriter

Returns:

this writer

Throws:

IOException

encode

@Deprecated
public ShWriter 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

Specified by:

encode in interface Sh

Specified by:

encode in interface Text

Overrides:

encode in class WhitespaceWriter

Returns:

this writer

Throws:

IOException

encode

@Deprecated
public ShWriter 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

Specified by:

encode in interface Sh

Specified by:

encode in interface Text

Overrides:

encode in class WhitespaceWriter

Returns:

this writer

Throws:

IOException

encode

@Deprecated
public ShWriter 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

Specified by:

encode in interface Sh

Specified by:

encode in interface Text

Overrides:

encode in class WhitespaceWriter

Returns:

this writer

Throws:

IOException

encode

@Deprecated
public ShWriter 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

Specified by:

encode in interface Sh

Specified by:

encode in interface Text

Overrides:

encode in class WhitespaceWriter

Returns:

this writer

Throws:

IOException

encode

@Deprecated
public ShWriter 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

Specified by:

encode in interface Sh

Specified by:

encode in interface Text

Overrides:

encode in class WhitespaceWriter

Returns:

this writer

Throws:

IOException

encode

@Deprecated
public <Ex extends Throwable> ShWriter 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

Specified by:

encode in interface Sh

Specified by:

encode in interface Text

Overrides:

encode in class WhitespaceWriter

Type Parameters:

Ex - An arbitrary exception type that may be thrown

Returns:

this writer

Throws:

IOException

Ex

encode

@Deprecated
public <Ex extends Throwable> ShWriter 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

Specified by:

encode in interface Sh

Specified by:

encode in interface Text

Overrides:

encode in class WhitespaceWriter

Type Parameters:

Ex - An arbitrary exception type that may be thrown

Returns:

this writer

Throws:

IOException

Ex

encode

@Deprecated
public 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

Specified by:

encode in interface Sh

Overrides:

encode in class MediaWriter

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

nl

public ShWriter nl()
            throws IOException

Description copied from interface: Whitespace

Writes a newline.

This is '\n' on all platforms. If a different newline is required, such as "\r\n" for email, filter the output.

Specified by:

nl in interface Whitespace

Overrides:

nl in class WhitespaceWriter

Returns:

this writer

Throws:

IOException

See Also:

• Whitespace.NL
• Whitespace.nli()
• Whitespace.nli(int)

nli

public ShWriter nli()
             throws IOException

Description copied from interface: Whitespace

Writes a newline, followed by current indentation when indentation enabled.

This is '\n' on all platforms. If a different newline is required, such as "\r\n" for email, filter the output.

Specified by:

nli in interface Whitespace

Overrides:

nli in class WhitespaceWriter

Returns:

this writer

Throws:

IOException

See Also:

• Whitespace.nli(int)
• Whitespace.nl()
• Whitespace.indent()
• Whitespace.getIndent()
• Whitespace.setIndent(boolean)

nli

public ShWriter nli(int depthOffset)
             throws IOException

Description copied from interface: Whitespace

Writes a newline, followed by current indentation with a depth offset when indentation enabled.

This is '\n' on all platforms. If a different newline is required, such as "\r\n" for email, filter the output.

Specified by:

nli in interface Whitespace

Overrides:

nli in class WhitespaceWriter

Parameters:

depthOffset - A value added to the current indentation depth. For example, pass -1 when performing a newline before a closing tag or ending curly brace.

Returns:

this writer

Throws:

IOException

See Also:

• Whitespace.nli()
• Whitespace.nl()
• Whitespace.indent(int)
• Whitespace.getIndent()
• Whitespace.setIndent(boolean)

indent

public ShWriter indent()
                throws IOException

Description copied from interface: Whitespace

Writes the current indentation when indentation enabled.

Specified by:

indent in interface Whitespace

Overrides:

indent in class WhitespaceWriter

Returns:

this writer

Throws:

IOException

See Also:

• Whitespace.indent(int)
• Whitespace.INDENT_SPACES
• Whitespace.nli()
• Whitespace.getIndent()
• Whitespace.setIndent(boolean)

indent

public ShWriter indent(int depthOffset)
                throws IOException

Description copied from interface: Whitespace

Writes the current indentation with a depth offset when indentation enabled.

Specified by:

indent in interface Whitespace

Overrides:

indent in class WhitespaceWriter

Parameters:

depthOffset - A value added to the current indentation depth. For example, pass -1 when performing a newline before a closing tag or ending curly brace.

Returns:

this writer

Throws:

IOException

See Also:

• Whitespace.indent()
• Whitespace.INDENT_SPACES
• Whitespace.nli(int)
• Whitespace.getIndent()
• Whitespace.setIndent(boolean)

setIndent

public ShWriter setIndent(boolean indent)

Description copied from interface: Whitespace

Enables or disabled indentation.

Specified by:

setIndent in interface Whitespace

Overrides:

setIndent in class WhitespaceWriter

Returns:

this writer

setDepth

public ShWriter setDepth(int depth)

Description copied from interface: Whitespace

Sets the indentation depth.

Specified by:

setDepth in interface Whitespace

Overrides:

setDepth in class WhitespaceWriter

Returns:

this writer

incDepth

public ShWriter incDepth()

Description copied from interface: Whitespace

Increments the indentation depth, if enabled.

Specified by:

incDepth in interface Whitespace

Overrides:

incDepth in class WhitespaceWriter

Returns:

this writer

decDepth

public ShWriter decDepth()

Description copied from interface: Whitespace

Decrements the indentation depth, if enabled.

Specified by:

decDepth in interface Whitespace

Overrides:

decDepth in class WhitespaceWriter

Returns:

this writer

sp

public ShWriter sp()
            throws IOException

Description copied from interface: Whitespace

Writes one space character.

Specified by:

sp in interface Whitespace

Overrides:

sp in class WhitespaceWriter

Returns:

this writer

Throws:

IOException

See Also:

• Whitespace.sp(int)
• Whitespace.SPACE

sp

public ShWriter sp(int count)
            throws IOException

Description copied from interface: Whitespace

Writes the given number of space characters.

Specified by:

sp in interface Whitespace

Overrides:

sp in class WhitespaceWriter

Parameters:

count - When count <= 0, nothing is written.

Returns:

this writer

Throws:

IOException

See Also:

• Whitespace.sp()
• Whitespace.SPACE

nbsp

public ShWriter nbsp()
              throws IOException

Description copied from interface: Text

Writes one non-breaking space character.

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

Specified by:

nbsp in interface Text

Returns:

this writer

Throws:

IOException

See Also:

• Text.nbsp(int)
• Text.NBSP

nbsp

public ShWriter nbsp(int count)
              throws IOException

Description copied from interface: Text

Writes the given number of non-breaking space characters.

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

Specified by:

nbsp in interface Text

Parameters:

count - When count <= 0, nothing is written.

Returns:

this writer

Throws:

IOException

See Also:

• Text.nbsp()
• Text.NBSP

text

public ShWriter text(char ch)
              throws IOException

Description copied from interface: Text

Writes the given text with proper encoding.

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

Specified by:

text in interface Text

Returns:

this writer

Throws:

IOException

text

public ShWriter text(char[] cbuf)
              throws IOException

Description copied from interface: Text

Writes the given text with proper encoding.

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

Specified by:

text in interface Text

Returns:

this writer

Throws:

IOException

text

public ShWriter text(char[] cbuf,
 int offset,
 int len)
              throws IOException

Description copied from interface: Text

Writes the given text with proper encoding.

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

Specified by:

text in interface Text

Returns:

this writer

Throws:

IOException

text

public ShWriter text(CharSequence csq)
              throws IOException

Description copied from interface: Text

Writes the given text 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:

text in interface Text

Returns:

this writer

Throws:

IOException

text

public ShWriter text(CharSequence csq,
 int start,
 int end)
              throws IOException

Description copied from interface: Text

Writes the given text 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:

text in interface Text

Returns:

this writer

Throws:

IOException

text

public ShWriter text(Object text)
              throws IOException

Description copied from interface: Text

Writes the given text 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:

text in interface Text

Returns:

this writer

Throws:

IOException

text

public <Ex extends Throwable> ShWriter text(IOSupplierE<?,Ex> text)
                                     throws IOException,
Ex

Description copied from interface: Text

Writes the given text 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:

text in interface Text

Type Parameters:

Ex - An arbitrary exception type that may be thrown

Returns:

this writer

Throws:

IOException

Ex

text

public <Ex extends Throwable> ShWriter text(TextWritable<Ex> text)
                                     throws IOException,
Ex

Description copied from interface: Text

Writes the given text with proper encoding.

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

Does not perform any translation markups.

Specified by:

text in interface Text

Type Parameters:

Ex - An arbitrary exception type that may be thrown

Returns:

this writer

Throws:

IOException

Ex

sh

@Deprecated
public ShWriter sh(char ch)
            throws IOException

Deprecated.

Already writing Bourne shell script

Writes the given shell script with proper encoding.

Adds prefixes and suffixes by media type.

Specified by:

sh in interface Sh

Returns:

this writer

Throws:

IOException

sh

@Deprecated
public ShWriter sh(char[] cbuf)
            throws IOException

Deprecated.

Already writing Bourne shell script

Writes the given shell script with proper encoding.

Adds prefixes and suffixes by media type.

Specified by:

sh in interface Sh

Returns:

this writer

Throws:

IOException

sh

@Deprecated
public ShWriter sh(char[] cbuf,
 int offset,
 int len)
            throws IOException

Deprecated.

Already writing Bourne shell script

Writes the given shell script with proper encoding.

Adds prefixes and suffixes by media type.

Specified by:

sh in interface Sh

Returns:

this writer

Throws:

IOException

sh

@Deprecated
public ShWriter sh(CharSequence csq)
            throws IOException

Deprecated.

Already writing Bourne shell script

Writes the given shell script with proper encoding.

Adds prefixes and suffixes by media type.

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

Specified by:

sh in interface Sh

Returns:

this writer

Throws:

IOException

sh

@Deprecated
public ShWriter sh(CharSequence csq,
 int start,
 int end)
            throws IOException

Deprecated.

Already writing Bourne shell script

Writes the given shell script with proper encoding.

Adds prefixes and suffixes by media type.

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

Specified by:

sh in interface Sh

Returns:

this writer

Throws:

IOException

sh

@Deprecated
public ShWriter sh(Object sh)
            throws IOException

Deprecated.

Already writing Bourne shell script

Writes the given shell script with proper encoding.

Adds prefixes and suffixes by media type.

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

Specified by:

sh in interface Sh

Returns:

this writer

Throws:

IOException

sh

@Deprecated
public <Ex extends Throwable> ShWriter sh(IOSupplierE<?,Ex> sh)
                                   throws IOException,
Ex

Deprecated.

Already writing Bourne shell script

Writes the given shell script with proper encoding.

Adds prefixes and suffixes by media type.

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

Specified by:

sh in interface Sh

Type Parameters:

Ex - An arbitrary exception type that may be thrown

Returns:

this writer

Throws:

IOException

Ex

sh

@Deprecated
public <Ex extends Throwable> ShWriter sh(ShWritable<Ex> sh)
                                   throws IOException,
Ex

Deprecated.

Already writing Bourne shell script

Writes the given shell script with proper encoding.

Adds prefixes and suffixes by media type.

Does not perform any translation markups.

Specified by:

sh in interface Sh

Type Parameters:

Ex - An arbitrary exception type that may be thrown

Returns:

this writer

Throws:

IOException

Ex

sh

@Deprecated
public ShWriter sh()
            throws IOException

Deprecated.

Already writing Bourne shell script

Writes the given shell script with proper encoding. This is well suited for use in a try-with-resources block.

Adds prefixes and suffixes by media type.

Does not perform any translation markups.

Specified by:

sh in interface Sh

Returns:

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

Throws:

IOException