us.bpsm.edn.printer

Class Printers

java.lang.Object

us.bpsm.edn.printer.Printers

public class Printers
extends Object

Factory for creating Printers and related Objects.

Method Summary

Methods

Modifier and Type	Method and Description
static Protocol<Printer.Fn<?>>	defaultPrinterProtocol() Return the default printer Protocol.
static Protocol.Builder<Printer.Fn<?>>	defaultProtocolBuilder() Returns a Protocol.Builder configured to produce a Protocol which knows how to print these types of values: BigDecimal BigInteger Boolean Byte (as an integer) CharSequence (as a string literal) Character (as a character literal) Date (as #inst) Double Float GregorianCalendar (as #inst) Integer Keyword List Long Map Set Short (as an integer) Symbol Tag TaggedValue Timestamp (as #inst) UUID (as #uuid)
static Printer	newPrinter(Appendable out) Return a new Printer with the default printing protocol.
static Printer	newPrinter(Protocol<Printer.Fn<?>> fns, Appendable out) Return a new Printer with the printing protocol given as fns.
static Protocol<Printer.Fn<?>>	prettyPrinterProtocol()
static Protocol.Builder<Printer.Fn<?>>	prettyProtocolBuilder()
static String	printString(Object ednValue) Print ednValue to a new String using the default printing protocol.
static String	printString(Protocol<Printer.Fn<?>> fns, Object ednValue) Print ednValue to a new String using the printing protocol given as fns.

Methods inherited from class java.lang.Object

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

Method Detail

newPrinter

public static Printer newPrinter(Appendable out)

Return a new Printer with the default printing protocol. Everything the printer prints will be appended to out. Printer.close() will close out, provided out implements Closeable.

Parameters:

out - to which values will be printed. Never null.

Returns:

a Printer with default configuration, never null.

printString

public static String printString(Object ednValue)

Print ednValue to a new String using the default printing protocol.

Parameters:

ednValue - the value to be returned as a String in edn syntax.

Returns:

A string in edn syntax. Not null, not empty.

printString

public static String printString(Protocol<Printer.Fn<?>> fns,
                 Object ednValue)

Print ednValue to a new String using the printing protocol given as fns.

Parameters:

fns - a Protocol which knows how to print all the classes of objects that we'll be asking our Printer to print. Never null. Never null.

ednValue - the value to be returned as a String in edn syntax.

Returns:

A string in edn syntax. Not null, not empty.

newPrinter

public static Printer newPrinter(Protocol<Printer.Fn<?>> fns,
                 Appendable out)

Return a new Printer with the printing protocol given as fns. Everything the printer prints will be appended to writer. Printer.close() will close out, if out implements Closeable.

Parameters:

fns - a Protocol which knows how to print all the classes of objects that we'll be asking our Printer to print. Never null. Never null.

out - to which values will be printed. Never null.

Returns:

a Printer, never null.

defaultProtocolBuilder

public static Protocol.Builder<Printer.Fn<?>> defaultProtocolBuilder()

Returns a Protocol.Builder configured to produce a Protocol which knows how to print these types of values:

• BigDecimal
• BigInteger
• Boolean
• Byte (as an integer)
• CharSequence (as a string literal)
• Character (as a character literal)
• Date (as #inst)
• Double
• Float
• GregorianCalendar (as #inst)
• Integer
• Keyword
• List
• Long
• Map
• Set
• Short (as an integer)
• Symbol
• Tag
• TaggedValue
• Timestamp (as #inst)
• UUID (as #uuid)

Returns:

a Protocol.Builder initialized with the default implementations for printing.

defaultPrinterProtocol

public static Protocol<Printer.Fn<?>> defaultPrinterProtocol()

Return the default printer Protocol. This is equivalent to defaultProtocolBuilder().build().

Returns:

the default printing Protocol, never null.

prettyProtocolBuilder

public static Protocol.Builder<Printer.Fn<?>> prettyProtocolBuilder()

prettyPrinterProtocol

public static Protocol<Printer.Fn<?>> prettyPrinterProtocol()