org.jamplate.impl.compiler

Class ExclusiveCompiler

java.lang.Object

org.jamplate.impl.compiler.ExclusiveCompiler

All Implemented Interfaces:

Compiler

public class ExclusiveCompiler
extends java.lang.Object
implements Compiler

A wrapper compiler that passes a pre-specified fallback compiler to the wrapped compiler.

Since:

0.2.0 ~2021.05.28

Version:

0.2.0

Author:

LSafer

Field Summary

Fields

Modifier and Type	Field and Description
protected @NotNull Compiler	compiler The fallback compiler.
protected @NotNull Compiler	fallback The fallback compiler.

Constructor Summary

Constructors

Constructor and Description
ExclusiveCompiler(@NotNull Compiler compiler) Construct a new exclusive compiler that compiles using the given compiler with itself as the fallback compiler (ignoring the fallback compiler given to it).
ExclusiveCompiler(@NotNull Compiler compiler, @NotNull Compiler fallback) Construct a new exclusive compiler that compiles using the given compiler with the given fallback compiler as the fallback compiler (ignoring the fallback compiler given to it).

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

compiler

@NotNull
protected final @NotNull Compiler compiler

The fallback compiler.

Since:

0.2.0 ~2021.05.28

fallback

@NotNull
protected final @NotNull Compiler fallback

The fallback compiler.

Since:

0.2.0 ~2021.05.28

Constructor Detail

ExclusiveCompiler

public ExclusiveCompiler(@NotNull
                         @NotNull Compiler compiler)

Construct a new exclusive compiler that compiles using the given compiler with itself as the fallback compiler (ignoring the fallback compiler given to it).

Parameters:

compiler - the wrapped compiler.

Throws:

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

Since:

0.2.0 ~2021.05.28

ExclusiveCompiler

public ExclusiveCompiler(@NotNull
                         @NotNull Compiler compiler,
                         @NotNull
                         @NotNull Compiler fallback)

Construct a new exclusive compiler that compiles using the given compiler with the given fallback compiler as the fallback compiler (ignoring the fallback compiler given to it).

Parameters:

compiler - the wrapped compiler.

fallback - the fallback compiler to be passed to the given compiler.

Since:

0.2.0 ~2021.05.28

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.