Package com.google.common.flogger.parser

Class BraceStyleMessageParser

java.lang.Object

com.google.common.flogger.parser.MessageParser

com.google.common.flogger.parser.BraceStyleMessageParser

Direct Known Subclasses:

DefaultBraceStyleMessageParser

public abstract class BraceStyleMessageParser
extends MessageParser

A specialized MessageParser for processing log messages in the "brace style", as used by MessageFormat. This is an abstract parser which knows how to process and extract place-holder terms at a high level, but does not impose its own semantics on formatting extensions (eg, "{0,number,#.##}").

Typically you should not subclass this class, but instead subclass DefaultBraceStyleMessageParser, which provides default behavior for simple place-holders.

Field Summary

Fields inherited from class com.google.common.flogger.parser.MessageParser

MAX_ARG_COUNT

Constructor Summary

Constructors

Constructor	Description
BraceStyleMessageParser()

Method Summary

Modifier and Type	Method	Description
protected <T> void	parseImpl(MessageBuilder<T> builder)	Abstract parse method implemented by specific subclasses to modify parsing behavior.
void	unescape(StringBuilder out, String message, int start, int end)	Appends the unescaped literal representation of the given message string (assumed to be escaped according to this parser's escaping rules).

Methods inherited from class java.lang.Object

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

Constructor Detail

BraceStyleMessageParser

public BraceStyleMessageParser()

Method Detail

unescape

public final void unescape(StringBuilder out,
                           String message,
                           int start,
                           int end)

Description copied from class: MessageParser

Appends the unescaped literal representation of the given message string (assumed to be escaped according to this parser's escaping rules). This method is designed to be invoked from a callback method in a MessageBuilder instance.

Specified by:

unescape in class MessageParser

Parameters:

out - the destination into which to append characters

message - the escaped log message

start - the start index (inclusive) in the log message

end - the end index (exclusive) in the log message

parseImpl

protected final <T> void parseImpl(MessageBuilder<T> builder)
                            throws ParseException

Description copied from class: MessageParser

Abstract parse method implemented by specific subclasses to modify parsing behavior.

Note that when extending parsing behavior, it is expected that specific parsers such as DefaultPrintfMessageParser or DefaultBraceStyleMessageParser will be sub-classed. Extending this class directly is only necessary when an entirely new type of format needs to be supported (which should be extremely rare).

Implementations of this method are required to invoke the MessageBuilder.addParameterImpl(int, int, com.google.common.flogger.parameter.Parameter) method of the supplied builder once for each parameter place-holder in the message.

Specified by:

parseImpl in class MessageParser

Throws:

ParseException