Descrição:
Classe derivada da FWPreparedStatement e que encapsula a classe FwExecCachedQuery.
Ela possui todos os métodos da FWPreparedStatement (FWPreparedStatement) e utiliza os conceitos do cache de queries(FWExecCachedQuery)
É utilizada para fazer cache ou não das queries executadas e realiza o bind de queries diretamente no banco de dados, o que torna o plano de execução das queries melhor aproveitado, gerando ganho de performance.
Importante
Classe disponível a partir da lib label 20211116
A query e o bind de valores é feito com base na função TCGenQry2, portanto as regras e limitações estão alinhadas com o uso da TCGenQry2 e devem ser respeitadas para evitar problemas e exceções diversas. Consulte a documentação para maiores detalhes aqui.
Métodos:
New()
Sintaxe:
FWExecStatement():New( cQuery ) ->
Descrição:
Construtor da carga
Parâmetros:
| Nome | Tipo | Descrição |
|---|---|---|
| cQuery | Caracter | Query a ser executada com parâmetros para bind |
OpenAlias()
Sintaxe:
FWExecStatement():OpenAlias( cAlias , cLifeTime, cTimeout) -> cAlias
Descrição:
Executa a query e retorna o alias criado
Parâmetros:
| Nome | Tipo | Descrição | Obrigatório |
|---|---|---|---|
| cAlias | Caracter | Alias a ser criado | Não. |
| cLifetime | Caracter | Define se a query vai ficar no cache da dbapi e qual o tempo de vida dela. | Não. Mas caso o parâmetro cTimeout seja enviado sim |
| cTimeOut | Caracter | Define se a query vai ficar no cache da dbapi e qual o tempo de timeout dela | Não. Mas caso o parâmetro cLifetime seja enviado, sim |
Retorno:
cAlias
ExecScalar()
Sintaxe:
FWExecStatement():ExecScalar( cColumn, cLifeTime, cTimeout) -> xValue
Descrição:
Executa a query scalar (que retorna uma coluna) e retorna seu valor. Ela tem o mesmo comportamento da função MPSysExecScalar
Parâmetros:
| Nome | Tipo | Descrição | Obrigatório |
|---|---|---|---|
| cColumn | Caracter | Nome da coluna a ser retornada da query | Sim. |
| cLifetime | Caracter | Define se a query vai ficar no cache da dbapi e qual o tempo de vida dela. | Não. Mas caso o parâmetro cTimeout seja enviado sim |
| cTimeOut | Caracter | Define se a query vai ficar no cache da dbapi e qual o tempo de timeout dela | Não. Mas caso o parâmetro cLifetime seja enviado, sim |
Retorno:
xValue
Exemplo de Uso da Classe
#include 'protheus.ch'
user Function myExec()
Local cQuery as character
Local cAlias as character
local oExec as object
cQuery := "SELECT ? FROM SE1T10 WHERE E1_FABOV = ? AND D_E_L_E_T_ = ?"
cQuery := ChangeQuery(cQuery)
oExec := FwExecStatement():New(cQuery)
oExec:SetUnsafe(1,'E1_NUM')
oExec:SetNumeric(2,0)
oExec:SetString(3,' ')
cAlias := oExec:OpenAlias()
//Também existe o método ExecScalar para esta classe, que se comporta bem parecido com a
//função FwExecScalar
//cQuery := "SELECT COUNT(*) CNT FROM SE1T10 WHERE E1_FABOV = ? AND D_E_L_E_T_ = ?"
//...........................
//oExec:ExecScalar('CNT')
(cAlias)→(DbCloseArea())
oExec:Destroy()
oExec := nil
Return