net.openhft.chronicle.wire

Class VanillaWireParser

java.lang.Object

net.openhft.chronicle.wire.VanillaWireParser

All Implemented Interfaces:

Consumer<WireIn>, WireParser

public class VanillaWireParser
extends Object
implements WireParser

Provides an implementation of WireParser that maps field names or ids to WireParselets. Named parselets are looked up via namedConsumer and numbered fields via numberedConsumer. A defaultConsumer handles fields that are not explicitly registered and fieldNumberParselet deals with unmapped numeric identifiers.

Field Summary

Fields inherited from interface net.openhft.chronicle.wire.WireParser

SKIP_READABLE_BYTES

Constructor Summary

Constructors

Constructor and Description
VanillaWireParser(@NotNull WireParselet defaultConsumer, @NotNull FieldNumberParselet fieldNumberParselet) Creates a parser using the supplied handlers.

Method Summary

Modifier and Type	Method and Description
WireParselet	getDefaultConsumer() Retrieves the WireParselet used when a field name encountered in the input does not match any explicitly registered parselet.
WireParselet	lookup(CharSequence name) Returns the parselet registered for name or null if none.
void	parseOne(@NotNull WireIn wireIn) Reads one field from wireIn.
@NotNull VanillaWireParser	register(String keyName, WireParselet valueInConsumer) Registers valueInConsumer to handle the field named keyName.
@NotNull VanillaWireParser	register(@NotNull WireKey key, WireParselet valueInConsumer) Registers valueInConsumer for both the text and numeric forms of key.

Methods inherited from class java.lang.Object

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

Methods inherited from interface net.openhft.chronicle.wire.WireParser

accept, registerOnce, skipReadable, wireParser, wireParser

Methods inherited from interface java.util.function.Consumer

andThen

Constructor Detail

VanillaWireParser

public VanillaWireParser(@NotNull
                         @NotNull WireParselet defaultConsumer,
                         @NotNull
                         @NotNull FieldNumberParselet fieldNumberParselet)

Creates a parser using the supplied handlers.

Parameters:

defaultConsumer - consumer for unregistered named fields. Must not be null.

fieldNumberParselet - handler for unregistered numeric ids. Must not be null.

Method Detail

getDefaultConsumer

public WireParselet getDefaultConsumer()

Description copied from interface: WireParser

Retrieves the WireParselet used when a field name encountered in the input does not match any explicitly registered parselet.

Specified by:

getDefaultConsumer in interface WireParser

Returns:

the default consumer for unmatched field names.

parseOne

public void parseOne(@NotNull
                     @NotNull WireIn wireIn)
              throws net.openhft.chronicle.core.util.InvocationTargetRuntimeException,
                     net.openhft.chronicle.core.io.InvalidMarshallableException

Reads one field from wireIn. Binary fields (identified by BinaryWireCode.FIELD_NUMBER) are handled by parseOneBinary(WireIn). Otherwise the field name is read into sb and the matching parselet located via namedConsumer. If no match is found, getDefaultConsumer() is used. The chosen parselet and name are cached for the next call.

Specified by:

parseOne in interface WireParser

Parameters:

wireIn - the source of the field

Throws:

net.openhft.chronicle.core.util.InvocationTargetRuntimeException - if a parselet throws a checked exception

net.openhft.chronicle.core.io.InvalidMarshallableException - if the wire data is malformed

register

@NotNull
public @NotNull VanillaWireParser register(@NotNull
                                                    @NotNull WireKey key,
                                                    WireParselet valueInConsumer)

Registers valueInConsumer for both the text and numeric forms of key.

Specified by:

register in interface WireParser

Parameters:

key - the key to associate with the parselet

valueInConsumer - the parselet to register

Returns:

this instance for method chaining

register

@NotNull
public @NotNull VanillaWireParser register(String keyName,
                                                    WireParselet valueInConsumer)

Registers valueInConsumer to handle the field named keyName. Also associates it with keyName.hashCode() for binary ids.

Specified by:

register in interface WireParser

Parameters:

keyName - textual field name

valueInConsumer - parselet invoked for this field

Returns:

this parser instance

lookup

public WireParselet lookup(CharSequence name)

Returns the parselet registered for name or null if none.

Specified by:

lookup in interface WireParser

Parameters:

name - the field name whose parselet is to be retrieved

Returns:

the matching WireParselet, or null if none exists