CalculatorHandler (JavaUtils / JExpression 3.1.0-beta API)

java.lang.Object
- tecgraf.javautils.jexpression.util.CalculatorHandler

All Implemented Interfaces:

JExpressionHandler
```
public class CalculatorHandler
extends Object
implements JExpressionHandler
```
Implementação de um tratador de expressões que adota as seguintes convenções:
1. Operadores aritméticos operam sobre Double.
2. Operadores relacionais operam sobre Boolean.
3. Operações aritméticas operam usado uma tolerância que pode ser definida no construtor.
4. Variáveis podem ser definidas a partir do método addVariable(String, Object).
5. Funções podem ser definidas a partir do método addFunction(JExpressionFunction).
Author:

Tecgraf

Constructor Summary

Constructors
Constructor and Description

CalculatorHandler()
Construtor.

CalculatorHandler(double tolerance)
Construtor.

Constructors
Constructor and Description
`CalculatorHandler()` Construtor.
`CalculatorHandler(double tolerance)` Construtor.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`addFunction(JExpressionFunction function)` Adiciona uma função.
`void`	`addVariable(String name, Object value)` Adiciona uma variável e seu respectivo valor.
`List<String>`	`getFunctionNames()` Retorna a lista com o nome das funções definidas.
`List<String>`	`getVarNames()` Retorna a lista com o nome das variáveis definidas.
`Object`	`handleAnd(Object first, Object second)` Callback da operação `&&`.
`Object`	`handleDivision(Object first, Object second)` Callback de operação `/`.
`Object`	`handleDouble(Double value)` Callback para valores `Double`.
`Object`	`handleEqual(Object first, Object second)` Callback da operação `==`.
`Object`	`handleField(Object object, String field)` Callback de acesso a um campo de objeto.
`Object`	`handleFunctionCall(String functionName, List<Object> params)` Callback de chamada de função.
`Object`	`handleGreater(Object first, Object second)` Callback da operação `>`.
`Object`	`handleGreaterEqual(Object first, Object second)` Callback da operação `>=`.
`Object`	`handleIndex(Object object, Object index)` Callback de indexação.
`Object`	`handleLower(Object first, Object second)` Callback da operação `<`.
`Object`	`handleLowerEqual(Object first, Object second)` Callback da operação `<=`.
`Object`	`handleMinus(Object first, Object second)` Callback de operação `-`.
`Object`	`handleNot(Object object)` Callback do operador unário `!`.
`Object`	`handleNotEqual(Object first, Object second)` Callback da operação `!=`.
`Object`	`handleOr(Object first, Object second)` Callback de operação `\|\|`.
`Object`	`handlePlus(Object first, Object second)` Callback da operação `+`.
`Object`	`handlePow(Object first, Object second)` Callback da operação `^`.
`Object`	`handleQuestion(Object condition, Object then, Object otherwise)` Callback do operador ternário if-then-else `(a ? b : c)`
`Object`	`handleString(String value)` Callback para valores `String`.
`Object`	`handleTimes(Object first, Object second)` Callback de operação `*`.
`Object`	`handleUnaryMinus(Object object)` Callback do operador unário `-`.
`Object`	`handleVar(String name)` Callback de variável.
`boolean`	`hasFunction(String name)` Retorna true se existir uma função com o dado nome, false caso contrário.
`boolean`	`hasVariable(String name)` Retorna true se existir uma variável com o dado nome, false caso contrário.
`void`	`registerBasicFunctions()` Registra funções básicas.
`void`	`removeAllFunctions()` Remove todas as funções.
`void`	`removeAllVariables()` Remove todas as variáveis.
`void`	`removeFunction(String name)` Remove função.
`void`	`removeVariable(String name)` Remove variável.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - CalculatorHandler
```
public CalculatorHandler()
```
    Construtor.
  - CalculatorHandler
```
public CalculatorHandler(double tolerance)
```
    Construtor.
    
    Parameters:
    
    tolerance - tolerância nas operações de double.
- Method Detail
  - registerBasicFunctions
```
public void registerBasicFunctions()
```
    Registra funções básicas.
  - addVariable
```
public void addVariable(String name,
                        Object value)
```
    Adiciona uma variável e seu respectivo valor.
    
    Parameters:
    
    name - nome da variável.
    
    value - valor.
  - hasVariable
```
public boolean hasVariable(String name)
```
    Retorna true se existir uma variável com o dado nome, false caso contrário.
    
    Parameters:
    
    name - nome da variável.
    
    Returns:
    
    flag que define se existe uma variável com o dado nome.
  - removeVariable
```
public void removeVariable(String name)
```
    Remove variável.
    
    Parameters:
    
    name - nome da variável.
  - removeAllVariables
```
public void removeAllVariables()
```
    Remove todas as variáveis.
  - addFunction
```
public void addFunction(JExpressionFunction function)
```
    Adiciona uma função.
    
    Parameters:
    
    function - função.
  - hasFunction
```
public boolean hasFunction(String name)
```
    Retorna true se existir uma função com o dado nome, false caso contrário.
    
    Parameters:
    
    name - nome da função.
    
    Returns:
    
    flag que define se existe uma variável com o dado nome.
  - removeFunction
```
public void removeFunction(String name)
```
    Remove função.
    
    Parameters:
    
    name - nome da função.
  - removeAllFunctions
```
public void removeAllFunctions()
```
    Remove todas as funções.
  - getVarNames
```
public List<String> getVarNames()
```
    Retorna a lista com o nome das variáveis definidas.
    
    Returns:
    
    lista com as variáveis.
  - getFunctionNames
```
public List<String> getFunctionNames()
```
    Retorna a lista com o nome das funções definidas.
    
    Returns:
    
    lista com as funções.
  - handleDouble
```
public Object handleDouble(Double value)
                    throws Exception
```
    Callback para valores Double.
    
    Specified by:
    
    handleDouble in interface JExpressionHandler
    
    Parameters:
    
    value - valor.
    
    Returns:
    
    resultado.
    
    Throws:
    
    Exception - em caso de erro.
  - handleString
```
public Object handleString(String value)
                    throws JExpressionException
```
    Callback para valores String.
    
    Specified by:
    
    handleString in interface JExpressionHandler
    
    Parameters:
    
    value - valor.
    
    Returns:
    
    resultado.
    
    Throws:
    
    JExpressionException
  - handlePlus
```
public Object handlePlus(Object first,
                         Object second)
                  throws Exception
```
    Callback da operação +.
    
    Specified by:
    
    handlePlus in interface JExpressionHandler
    
    Parameters:
    
    first - primeiro operando.
    
    second - segundo operando.
    
    Returns:
    
    resultado.
    
    Throws:
    
    Exception - em caso de erro.
  - handleMinus
```
public Object handleMinus(Object first,
                          Object second)
                   throws Exception
```
    Callback de operação -.
    
    Specified by:
    
    handleMinus in interface JExpressionHandler
    
    Parameters:
    
    first - primeiro operando.
    
    second - segundo operando.
    
    Returns:
    
    resultado.
    
    Throws:
    
    Exception - em caso de erro.
  - handleTimes
```
public Object handleTimes(Object first,
                          Object second)
                   throws Exception
```
    Callback de operação *.
    
    Specified by:
    
    handleTimes in interface JExpressionHandler
    
    Parameters:
    
    first - primeiro operando.
    
    second - segundo operando.
    
    Returns:
    
    resultado.
    
    Throws:
    
    Exception - em caso de erro.
  - handleDivision
```
public Object handleDivision(Object first,
                             Object second)
                      throws Exception
```
    Callback de operação /.
    
    Specified by:
    
    handleDivision in interface JExpressionHandler
    
    Parameters:
    
    first - primeiro operando.
    
    second - segundo operando.
    
    Returns:
    
    resultado.
    
    Throws:
    
    Exception - em caso de erro.
  - handlePow
```
public Object handlePow(Object first,
                        Object second)
                 throws Exception
```
    Callback da operação ^.
    
    Specified by:
    
    handlePow in interface JExpressionHandler
    
    Parameters:
    
    first - primeiro operando.
    
    second - segundo operando.
    
    Returns:
    
    resultado.
    
    Throws:
    
    Exception - em caso de erro.
  - handleOr
```
public Object handleOr(Object first,
                       Object second)
                throws Exception
```
    Callback de operação ||.
    
    Specified by:
    
    handleOr in interface JExpressionHandler
    
    Parameters:
    
    first - primeiro operando.
    
    second - segundo operando.
    
    Returns:
    
    resultado.
    
    Throws:
    
    Exception - em caso de erro.
  - handleAnd
```
public Object handleAnd(Object first,
                        Object second)
                 throws Exception
```
    Callback da operação &&.
    
    Specified by:
    
    handleAnd in interface JExpressionHandler
    
    Parameters:
    
    first - primeiro operando.
    
    second - segundo operando.
    
    Returns:
    
    resultado.
    
    Throws:
    
    Exception - em caso de erro.
  - handleEqual
```
public Object handleEqual(Object first,
                          Object second)
                   throws Exception
```
    Callback da operação ==.
    
    Specified by:
    
    handleEqual in interface JExpressionHandler
    
    Parameters:
    
    first - primeiro operando.
    
    second - segundo operando.
    
    Returns:
    
    resultado.
    
    Throws:
    
    Exception - em caso de erro.
  - handleNotEqual
```
public Object handleNotEqual(Object first,
                             Object second)
                      throws Exception
```
    Callback da operação !=.
    
    Specified by:
    
    handleNotEqual in interface JExpressionHandler
    
    Parameters:
    
    first - primeiro operando.
    
    second - segundo operando.
    
    Returns:
    
    resultado.
    
    Throws:
    
    Exception - em caso de erro.
  - handleGreater
```
public Object handleGreater(Object first,
                            Object second)
                     throws Exception
```
    Callback da operação >.
    
    Specified by:
    
    handleGreater in interface JExpressionHandler
    
    Parameters:
    
    first - primeiro operando.
    
    second - segundo operando.
    
    Returns:
    
    resultado.
    
    Throws:
    
    Exception - em caso de erro.
  - handleGreaterEqual
```
public Object handleGreaterEqual(Object first,
                                 Object second)
                          throws Exception
```
    Callback da operação >=.
    
    Specified by:
    
    handleGreaterEqual in interface JExpressionHandler
    
    Parameters:
    
    first - primeiro operando.
    
    second - segundo operando.
    
    Returns:
    
    resultado.
    
    Throws:
    
    Exception - em caso de erro.
  - handleLower
```
public Object handleLower(Object first,
                          Object second)
                   throws Exception
```
    Callback da operação <.
    
    Specified by:
    
    handleLower in interface JExpressionHandler
    
    Parameters:
    
    first - primeiro operando.
    
    second - segundo operando.
    
    Returns:
    
    resultado.
    
    Throws:
    
    Exception - em caso de erro.
  - handleLowerEqual
```
public Object handleLowerEqual(Object first,
                               Object second)
                        throws Exception
```
    Callback da operação <=.
    
    Specified by:
    
    handleLowerEqual in interface JExpressionHandler
    
    Parameters:
    
    first - primeiro operando.
    
    second - segundo operando.
    
    Returns:
    
    resultado.
    
    Throws:
    
    Exception - em caso de erro.
  - handleQuestion
```
public Object handleQuestion(Object condition,
                             Object then,
                             Object otherwise)
                      throws Exception
```
    Callback do operador ternário if-then-else (a ? b : c)
    
    Specified by:
    
    handleQuestion in interface JExpressionHandler
    
    Parameters:
    
    condition - condição.
    
    then - ação.
    
    otherwise - caso contrário.
    
    Returns:
    
    resultado.
    
    Throws:
    
    Exception - em caso de erro.
  - handleUnaryMinus
```
public Object handleUnaryMinus(Object object)
                        throws Exception
```
    Callback do operador unário -.
    
    Specified by:
    
    handleUnaryMinus in interface JExpressionHandler
    
    Parameters:
    
    object - operando.
    
    Returns:
    
    resultado.
    
    Throws:
    
    Exception - em caso de erro.
  - handleNot
```
public Object handleNot(Object object)
                 throws Exception
```
    Callback do operador unário !.
    
    Specified by:
    
    handleNot in interface JExpressionHandler
    
    Parameters:
    
    object - operando.
    
    Returns:
    
    resultado.
    
    Throws:
    
    Exception - em caso de erro.
  - handleVar
```
public Object handleVar(String name)
                 throws Exception
```
    Callback de variável.
    
    Specified by:
    
    handleVar in interface JExpressionHandler
    
    Parameters:
    
    name - nome da variável.
    
    Returns:
    
    resultado.
    
    Throws:
    
    Exception - em caso de erro.
  - handleFunctionCall
```
public Object handleFunctionCall(String functionName,
                                 List<Object> params)
                          throws Exception
```
    Callback de chamada de função.
    
    Specified by:
    
    handleFunctionCall in interface JExpressionHandler
    
    Parameters:
    
    functionName - nome função.
    
    params - lista de parâmetros.
    
    Returns:
    
    resultado da chamada de função.
    
    Throws:
    
    Exception - em caso de erro.
  - handleIndex
```
public Object handleIndex(Object object,
                          Object index)
                   throws Exception
```
    Callback de indexação.
    
    Specified by:
    
    handleIndex in interface JExpressionHandler
    
    Parameters:
    
    object - objeto a ser indexado.
    
    index - índice.
    
    Returns:
    
    resultado da indexação.
    
    Throws:
    
    Exception - em caso de erro.
  - handleField
```
public Object handleField(Object object,
                          String field)
                   throws Exception
```
    Callback de acesso a um campo de objeto.
    
    Specified by:
    
    handleField in interface JExpressionHandler
    
    Parameters:
    
    object - primeiro operando.
    
    field - campo.
    
    Returns:
    
    resultado.
    
    Throws:
    
    Exception - em caso de erro.

Class CalculatorHandler

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

CalculatorHandler

CalculatorHandler

Method Detail

registerBasicFunctions

addVariable

hasVariable

removeVariable

removeAllVariables

addFunction

hasFunction

removeFunction

removeAllFunctions

getVarNames

getFunctionNames

handleDouble

handleString

handlePlus

handleMinus

handleTimes

handleDivision

handlePow

handleOr

handleAnd

handleEqual

handleNotEqual

handleGreater

handleGreaterEqual

handleLower

handleLowerEqual

handleQuestion

handleUnaryMinus

handleNot

handleVar

handleFunctionCall

handleIndex

handleField