org.jamplate.impl.compiler

Class MandatoryCompiler

java.lang.Object

org.jamplate.impl.compiler.MandatoryCompiler

All Implemented Interfaces:

Compiler

public class MandatoryCompiler
extends java.lang.Object
implements Compiler

A compiler that delegates to another compiler and raises an exception if that other compiler failed to compile.

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 wrapped compiler.

Constructor Summary

Constructors

Constructor and Description
MandatoryCompiler(@NotNull Compiler compiler) Construct a new compiler wrapper that wraps the given compiler and throws an exception if it fails to compile.

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 wrapped compiler.

Since:

0.2.0 ~2021.05.28

Constructor Detail

MandatoryCompiler

public MandatoryCompiler(@NotNull
                         @NotNull Compiler compiler)

Construct a new compiler wrapper that wraps the given compiler and throws an exception if it fails to compile.

Parameters:

compiler - the compiler to be wrapped.

Throws:

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

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.