org.jamplate.impl.compiler

Class FirstCompileCompiler

java.lang.Object

org.jamplate.impl.compiler.FirstCompileCompiler

All Implemented Interfaces:

Compiler

public class FirstCompileCompiler
extends java.lang.Object
implements Compiler

A compiler that tris compiling using multiple other compilers in order and returns the results of the first compiler to succeed.

Since:

0.2.0 ~2021.05.21

Version:

0.2.0

Author:

LSafer

Field Summary

Fields

Modifier and Type	Field and Description
protected @NotNull java.util.List<Compiler>	compilers The compilers backing this compiler.

Constructor Summary

Constructors

Constructor and Description
FirstCompileCompiler(Compiler... compilers) Construct a new order-compiler that uses the given compilers.
FirstCompileCompiler(@NotNull java.util.List<Compiler> compilers) Construct a new order-compiler that uses the given compilers.

Method Summary

Modifier and Type	Method and Description
@Nullable Instruction	compile(@NotNull Compiler compiler, @NotNull Compilation compilation, @NotNull Tree tree) Compile the given tree and the trees in it.

Methods inherited from class java.lang.Object

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

Field Detail

compilers

@NotNull
protected final @NotNull java.util.List<Compiler> compilers

The compilers backing this compiler. (ordered)

Since:

0.2.0 ~2021.05.21

Constructor Detail

FirstCompileCompiler

public FirstCompileCompiler(@Nullable
                            Compiler... compilers)

Construct a new order-compiler that uses the given compilers.
Null compilers in the given array will be ignored.

Parameters:

compilers - the compilers (in-order) to be used by the constructed compiler.

Throws:

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

Since:

0.2.0 ~2021.05.21

FirstCompileCompiler

public FirstCompileCompiler(@NotNull
                            @NotNull java.util.List<Compiler> compilers)

Construct a new order-compiler that uses the given compilers.
Null compilers in the given list will be ignored.

Parameters:

compilers - the compilers (in-order) to be used by the constructed compiler.

Throws:

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

Since:

0.2.0 ~2021.05.21

Method Detail

compile

@Nullable
public @Nullable Instruction compile(@NotNull
                                                @NotNull Compiler compiler,
                                                @NotNull
                                                @NotNull Compilation compilation,
                                                @NotNull
                                                @NotNull Tree tree)

Description copied from interface: Compiler

Compile the given tree and the trees in it. If this compiler cannot If this compiler encountered a tree that it cannot compile, this compiler will pass it to the given fallback compiler with the given compiler as the fallback compiler.
Unless this compiler want to change the default compiler, this compiler will invoke the given compiler with itself as the default compiler.

Specified by:

compile in interface Compiler

Parameters:

compiler - a compiler this compiler must use when dealing with other entities this compiler cannot compile.

compilation - the compilation the given tree was taken from.

tree - the tree to parse any instruction in it.

Returns:

the compiled instruction. Or null if this compiler failed to compile the given tree into an instruction.