asteroid.statements

Class TryCatchStatementBuilder

java.lang.Object

asteroid.statements.TryCatchStatementBuilder

public class TryCatchStatementBuilder
extends java.lang.Object

This builder tries to make it easier to build a try/catch statement.

AST

TryCatchStatement stmt = A.STMT.tryCatchSBuilder()
        .tryStmt(protectedStmt)
        .addCatchStmt(Exception, 'ex', handlerOneStmt)
        .addCatchStmt(IllegalStatementException, 'ix', handlerTwoStmt)
        // ... add as many catch as you need
        .finallyStmt(finallyStatement)
        .build()

Result

try {
    // protectedStmt
   } catch(Exception ex) {
    // handlerOneStmt
   } catch(IllegalStateException ix) {
    // handlerTwoStmt
   } finally {
    // finallyStatement
   }

Since:

0.2.3

Constructor Summary

Constructors

Constructor and Description
TryCatchStatementBuilder()

Method Summary

Modifier and Type	Method and Description
TryCatchStatementBuilder	addCatchStmt(ClassNode exceptionType, java.lang.String exceptionVarName, Statement stmt) Adds one catch statement to catch a specific exception giving a specific name for the exception variable.
TryCatchStatementBuilder	addCatchStmt(java.lang.Class exceptionType, java.lang.String exceptionVarName, Statement stmt) Adds one catch statement to catch a specific exception giving a specific name for the exception variable.
TryCatchStatement	build() Returns the created TryCatchStatement instance.
TryCatchStatementBuilder	finallyStmt(Statement stmt) Adds the statement that will be placed inside the finally block
TryCatchStatementBuilder	tryStmt(Statement stmt) Adds the try statement

Methods inherited from class java.lang.Object

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

Constructor Detail

TryCatchStatementBuilder

public TryCatchStatementBuilder()

Method Detail

tryStmt

public TryCatchStatementBuilder tryStmt(Statement stmt)

Adds the try statement

Parameters:

stmt - the code you want to protect

Returns:

the current builder instance

Since:

0.2.3

addCatchStmt

public TryCatchStatementBuilder addCatchStmt(java.lang.Class exceptionType,
                                             java.lang.String exceptionVarName,
                                             Statement stmt)

Adds one catch statement to catch a specific exception giving a specific name for the exception variable.

IMPORTANT: This method uses Class to specify the class of the Exception. Don't use it if you are targetting a very early compilation stage. If so use the method using ClassNode

Parameters:

exceptionType - the Class of the exception you want to catch

exceptionVarName - the name of the exception variable

stmt - the code handling the exception

Returns:

the current builder instance

Since:

0.2.3

addCatchStmt

public TryCatchStatementBuilder addCatchStmt(ClassNode exceptionType,
                                             java.lang.String exceptionVarName,
                                             Statement stmt)

Adds one catch statement to catch a specific exception giving a specific name for the exception variable.

Parameters:

exceptionType - the ClassNode of the exception you want to catch

exceptionVarName - the name of the exception variable

stmt - the code handling the exception

Returns:

the current builder instance

Since:

0.2.3

finallyStmt

public TryCatchStatementBuilder finallyStmt(Statement stmt)

Adds the statement that will be placed inside the finally block

Parameters:

stmt - the code executed in the finally block

Returns:

the current builder instance

Since:

0.2.3

build

public TryCatchStatement build()

Returns the created TryCatchStatement instance. At least the "try" statement and the "finally" statement must be provided. Otherwise it will throw a IllegalStateException

Returns:

a TryCatchStatement instance

Throws:

java.lang.IllegalStateException - if neither try nor finally statements are provided

Since:

0.2.3