TLPP - LANGUAGE
O recurso de annotation foi liberado na versão 17.3.0.3 e o objetivo é possibilitar a declaração de metadados nas nossas classes, métodos e funções, isto é, as configurações deles podem ficar dentro do mesmo código fonte.
Sugere-se que a definição da annotation seja colocada em um TH (TLPP Header File) para que possa ser utilizada em vários fontes.
Como obter o tlpp-core.th ?
- Para todo fonte escrito em TLPP, é recomendado incluir o arquivo "tlpp-core.th";
- O processo de extração desse "th", bem como de todos os demais arquivos de cabeçalho de TLPP, pode ser feito pelo seguinte processo: TLPP - Ambiente de compilação.
exemplo1.th
#include "tlpp-core.th" @annotation ExemploDeAnnotation property1 as char property2 as numeric default 1 @end
Uso da annotation em definição de classe:
exemplo1.tlpp
#include "exemplo1.th" @ExemploDeAnnotation(property1 = "MeuObject") class meuObj public Data data1 public method new() EndClass
Uso da annotation em definição de método:
exemplo2.tlpp
#include "exemplo1.th" class meuObj public Data data1 @ExemploDeAnnotation(property1 = "MetodoNew") public method new() EndClass
Uso da annotation em definição de propriedade:
exemplo3.tlpp
#include "exemplo1.th" class meuObj @ExemploDeAnnotation(property1 = "PropertyData", property2 = 456) public Data data1 EndClass
Uso da annotation em definição de função:
exemplo4.tlpp
#include "exemplo1.th" @ExemploDeAnnotation(property1 = "FunctionTeste", property2 = 123) main Function teste() conout("annotationTest") Return
Novas funções disponíveis para uso juntamente com o recurso de Annotation, as funções foram disponibilizadas dentro do namespace Reflection:
- Reflection.isAnnotationObjectPresent(advplObject,cAnnotationName)
- Reflection.getObjectAnnotation(advplObject,cAnnotationName)
- Reflection.isAnnotationDataPresent(advplObject,cData, cAnnotationName)
- Reflection.getDataAnnotation(advplObject,cData, cAnnotationName)
- Reflection.isAnnotationFunctionPresent(cSourceName,cFunctionName,cAnnotationName)
- Reflection.getFunctionAnnotation(cSourceName,cFunctionName,cAnnotationName)
- Reflection.isAnnotationMethodPresent(advplObject, cMethodName,cAnnotationName)
- Reflection.getMethodAnnotation(advplObject,cMethodName,cAnnotationName)
- Reflection.getClassesByAnnotation(cAnnotationName,[cClassNameFilter])
- Reflection.getFunctionsByAnnotation(cAnnotationName,[cFuncNameFilter])
- Reflection.getDeclaredFields(oAdvplObject)
- Reflection.getDataValue(oObj,cFieldName)
- Reflection.isAnnottationFunctionParamPresent(cSourceName, cFunctionName, nParmPos, cAnnotationName)
- Reflection.getFunctionParamAnnotation(cSourceName, cFunctionName, nParmPos, cAnnotationName)
- Reflection.isAnnottationMethodParamPresent(oObject, cFunctionName, nParmPos, cAnnotationName)
- Reflection.getMethodParmAnnotation(oObject, cFunctionName, nParmPos, cAnnotationName)
- Reflection.getFunctionParmsByAnnotation(cSourceName, cFunctionName, aListParms, cAnnotationName)
- Reflection.getMethodParmsByAnnotation(oObject, cFunctionName, aListParms, cAnnotationName)
- Reflection.getProgramFunctionsByAnnotation(cProgramName, cAnnotationName)
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas