org.jamplate.impl.parser

Class MergeByWeightParser

java.lang.Object

org.jamplate.impl.parser.MergeByWeightParser

All Implemented Interfaces:

Parser

Direct Known Subclasses:

MergeFlatByWeightParser

public class MergeByWeightParser
extends java.lang.Object
implements Parser

A parser that uses multiple other parsers for parsing. Any clash in the results returned from them will be fixed by taking the results of the more preferred parser on the clash depending on a predefined list.

Since:

0.2.0 ~2021.05.17

Version:

0.2.0

Author:

LSafer

Field Summary

Fields

Modifier and Type	Field and Description
protected @NotNull java.util.List<Parser>	parsers The parsers in order.

Constructor Summary

Constructors

Constructor and Description
MergeByWeightParser(@NotNull java.util.List<Parser> parsers) Construct a new parser that uses the given parsers preferring the results from the parsers at the start that the results from the parsers that at the end when a clash occur between their results.
MergeByWeightParser(Parser... parsers) Construct a new parser that uses the given parsers preferring the results from the parsers at the start that the results from the parsers that at the end when a clash occur between their results.

Method Summary

Modifier and Type	Method and Description
protected boolean	check(@NotNull Tree primary, @NotNull Tree secondary) Check if the down-structure of the given secondary can be alongside with the given primary in its structure.
@NotNull java.util.Set<Tree>	parse(@NotNull Compilation compilation, @NotNull Tree tree) Parse the given sketch with respect to the given compilation.

Methods inherited from class java.lang.Object

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

Field Detail

parsers

@NotNull
protected final @NotNull java.util.List<Parser> parsers

The parsers in order.

Since:

0.2.0 ~2021.05.17

Constructor Detail

MergeByWeightParser

public MergeByWeightParser(@Nullable
                           Parser... parsers)

Construct a new parser that uses the given parsers preferring the results from the parsers at the start that the results from the parsers that at the end when a clash occur between their results.
Null parsers in the array will be ignored.

Parameters:

parsers - the parsers to be used by the constructed parser.

Throws:

java.lang.NullPointerException - if the given parsers is null.

Since:

0.2.0 ~2021.05.18

MergeByWeightParser

public MergeByWeightParser(@NotNull
                           @NotNull java.util.List<Parser> parsers)

Construct a new parser that uses the given parsers preferring the results from the parsers at the start that the results from the parsers that at the end when a clash occur between their results.
Null parsers in the list will be ignored.

Parameters:

parsers - the parsers to be used by the constructed parser.

Throws:

java.lang.NullPointerException - if the given parsers is null.

Since:

0.2.0 ~2021.05.18

Method Detail

parse

@NotNull
public @NotNull java.util.Set<Tree> parse(@NotNull
                                                    @NotNull Compilation compilation,
                                                    @NotNull
                                                    @NotNull Tree tree)

Description copied from interface: Parser

Parse the given sketch with respect to the given compilation.

Specified by:

parse in interface Parser

Parameters:

compilation - the compilation taking the given sketch.

tree - the sketch to be parsed.

Returns:

the parsed sketches.

check

@Contract(pure=true)
protected boolean check(@NotNull
                                              @NotNull Tree primary,
                                              @NotNull
                                              @NotNull Tree secondary)

Check if the down-structure of the given secondary can be alongside with the given primary in its structure.

Parameters:

primary - the primary tree that is always wins.

secondary - the slave tree that might win or might lose depending on if it clashes with the primary or not.

Returns:

true, if the given secondary can be with the given primary.

Throws:

java.lang.NullPointerException - if the given primary or secondary is null.

Since:

0.2.0 ~2021.05.18