Package br.com.intersys.systextil.function

Class GeraLogParamError

java.lang.Object
br.com.intersys.systextil.function.GeraLogParamError
public class GeraLogParamError extends Object
Grava log na tabela empr_015 e dá alerta ou lança exceptions, conforme estiver configurado em determinado parâmetro de empresa.

Cada instância é configurada conforme um parâmetro de empresa.

  • Nested Class Summary

    Nested Classes
    Modifier and Type
    Class
    Description
    static interface 
    GeraLogParamError.Mensagem
    Executa a validação e, se for necessário dar um alerta, retorna uma mensagem.
    static interface 
    GeraLogParamError.Validacao
    Executa a validação e, se for necessário dar um alerta, lança uma TagException.
    static interface 
    GeraLogParamError.ValidacaoNXJ
    Executa a validação e, se for necessário dar um alerta, lança uma Exception.

  • Constructor Summary

    Constructors
    Constructor
    Description
    GeraLogParamError(br.com.intersys.systextil.connection.AppConnection conn, Mdi mdi, Interactive interactive, String nome_form, String param)
    Configura um "gerador" conforme um parâmetro de empresa.

  • Method Summary

    Modifier and Type
    Method
    Description
    void
    alertar(GeraLogParamError.Mensagem validacao)
    Conveniência para encapsular a validação que retorna a mensagem de alerta.
    void
    alertar(String mensagem)
    Registra e apresenta o alerta com a mensagem informada, se estiver configurado para isso.
    boolean
    alertou()
    Permite saber se algum alerta do tipo 1 (não bloqueia) foi apresentado.
    static void
    executar(br.com.intersys.systextil.connection.AppConnection connection, String param, int tipo_alerta, String processo, int codigo_empresa, int codigo_usuario, String nome_usuario, String mensagem)
    Método legado que não encapsula o controle de exibição das mensagens, e somente registra o alerta na tabela empr_015.
    void
    resetAlertou()
    Quando esta instância é reusada, apaga o indicador de que algum alerta foi apresentado, para só considerar de agora em diante.
    boolean
    temAlerta()
    Informa se será emitido algum alerta.
    void
    validar(UtilTag utilTag, GeraLogParamError.Validacao validacao)
    Conveniência para encapsular a validação que lança a mensagem de alerta.
    void
    validarNXJ(UtilTag utilTag, GeraLogParamError.ValidacaoNXJ validacao)
    Conveniência para encapsular a validação que lança a mensagem de alerta.

    Methods inherited from class java.lang.Object

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

  • Constructor Details

    • GeraLogParamError

      public GeraLogParamError(br.com.intersys.systextil.connection.AppConnection conn, Mdi mdi, Interactive interactive, String nome_form, String param)
      Configura um "gerador" conforme um parâmetro de empresa.
      Parameters:
      conn - a conexão a ser usada para ler o parâmetro de empresa
      mdi - a Mdi com os dados para gravar no log
      interactive - para apresentar mensagens sem interromper o processo; pode ser nulo se com certeza não for usado.
      nome_form - o nome do processo
      param - o nome do parâmetro de empresa

  • Method Details

    • temAlerta

      public boolean temAlerta()
      Informa se será emitido algum alerta.

      É conveniente usar este método antes de aplicar regras de negócio e gerar mensagens desnecessariamente.

      Returns:
      se o tipo de alerta configurado é 1 ou 2, ou não é.

    • alertou

      public boolean alertou()
      Permite saber se algum alerta do tipo 1 (não bloqueia) foi apresentado. Assim pode-se apresentar vários alertas e então tomar uma decisão, por exemplo interromper a execução do método atual.
      Returns:
      se algum alerta foi apresentado
      See Also:

    • resetAlertou

      public void resetAlertou()
      Quando esta instância é reusada, apaga o indicador de que algum alerta foi apresentado, para só considerar de agora em diante.
      See Also:

    • alertar

      public void alertar(String mensagem) throws Msg
      Registra e apresenta o alerta com a mensagem informada, se estiver configurado para isso. Se não estiver, não faz nada.

      Atenção: Se não lançar exceção, este método continua a execução normalmente depois de apresentar a mensagem. Portanto, qualquer tipo de limpeza ou tratamento de dados pode ser feito depois de invocar este método.

      Parameters:
      mensagem - o texto da mensagem; se for nulo, nada será feito
      Throws:
      Msg - se o alerta deve interromper o processo

    • alertar

      public void alertar(GeraLogParamError.Mensagem validacao) throws Msg
      Conveniência para encapsular a validação que retorna a mensagem de alerta. Se não estiver configurado para apresentar alerta, não faz nada.
      Parameters:
      validacao - a função que faz a validação e retorna a mensagem se houver
      Throws:
      Msg - se o alerta deve interromper o processo
      See Also:

    • validar

      public void validar(UtilTag utilTag, GeraLogParamError.Validacao validacao) throws Msg
      Conveniência para encapsular a validação que lança a mensagem de alerta. Se não estiver configurado para apresentar alerta, não faz nada.
      Parameters:
      utilTag - o tradutor a ser usado se for lançada uma mensagem
      validacao - a função que faz a validação e lança uma mensagem se houver
      Throws:
      Msg - se o alerta deve interromper o processo
      See Also:

    • validarNXJ

      public void validarNXJ(UtilTag utilTag, GeraLogParamError.ValidacaoNXJ validacao) throws Msg, Exception
      Conveniência para encapsular a validação que lança a mensagem de alerta. Se não estiver configurado para apresentar alerta, não faz nada.

      Pode ser usado no NXJ, pois lá qualquer acesso SQL pode lançar diversos tipos de Exception.

      Parameters:
      utilTag - o tradutor a ser usado se for lançada uma mensagem
      validacao - a função que faz a validação e lança uma mensagem se houver
      Throws:
      Msg - se o alerta deve interromper o processo
      Exception - se algum outro problema ocorrer
      See Also:

    • executar

      public static void executar(br.com.intersys.systextil.connection.AppConnection connection, String param, int tipo_alerta, String processo, int codigo_empresa, int codigo_usuario, String nome_usuario, String mensagem)
      Método legado que não encapsula o controle de exibição das mensagens, e somente registra o alerta na tabela empr_015.

      Se o tipo de alerta informado não for 1 ou 2, não faz nada.

      Parameters:
      connection - a conexão
      param - o nome do parâmetro de configuração
      tipo_alerta - o tipo de alerta configurado no parâmetro
      processo - o nome do processo
      codigo_empresa - o código da empresa
      codigo_usuario - o código do usuário
      nome_usuario - o nome do usuário (mdi.usuario)
      mensagem - o texto da mensagem a registrar