FWExecStatement

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

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

Atalhos

Páginas filhas