DEV Community: Edivan Carvalho

Debug de Objetos com ToStringBuilder e Logger

Edivan Carvalho — Tue, 06 Jan 2026 11:49:13 +0000

Documentação: Debug de Objetos com ToStringBuilder e Logger

Autor: Edivan Carvalho

Data de Criação: 06 de janeiro de 2025

Versão: 1.0

Resumo: Este documento fornece instruções detalhadas sobre como utilizar ToStringBuilder com Logger para debug profissional de objetos Java, seguindo as melhores práticas recomendadas pelo SonarQube.

Palavras-chave: Java, Debug, ToStringBuilder, Logger, SLF4J, Apache Commons Lang, SonarQube, Reflexão

Histórico de Revisões

Data	Versão	Autor	Descrição
06/01/2025	1.0	Edivan Carvalho	Criação inicial do documento.

1. Introdução

Durante o processo de debug de aplicações Java, frequentemente precisamos visualizar o conteúdo completo de objetos para identificar problemas. Este documento apresenta a forma profissional e recomendada pelo SonarQube para realizar essa tarefa.

2. Problema

Abordagem Incorreta (não recomendada pelo SonarQube)

System.out.println(objeto);  // Evitar
System.out.println("ID: " + objeto.getId());  // Evitar

Problemas identificados:

Não segue padrão de logging profissional
Não permite controle de níveis (INFO, DEBUG, ERROR)
Dificulta filtragem de logs em produção
SonarQube reporta violação de qualidade de código

3. Solução

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.apache.commons.lang3.builder.ToStringBuilder;
import org.apache.commons.lang3.builder.ToStringStyle;

public class NfeMB extends BaseCrudManagedBean {

    private static final Logger logger = LoggerFactory.getLogger(NfeMB.class);

    public void emitirNotaFiscal(Long idNotaFiscal) {
        logger.info("Dados da Nota Fiscal:");
        logger.info(ToStringBuilder.reflectionToString(
            this.notaFiscal, 
            ToStringStyle.MULTI_LINE_STYLE
        ));
    }
}

4. Por que usar ToStringBuilder

4.1 Impressão Automática

Sem ToStringBuilder:

logger.info("ID: " + notaFiscal.getId());
logger.info("Total: " + notaFiscal.getTotalNfe());
// ... muitas linhas

Com ToStringBuilder:

logger.info(ToStringBuilder.reflectionToString(notaFiscal, ToStringStyle.MULTI_LINE_STYLE));

Vantagem: Imprime TODOS os atributos automaticamente usando reflexão Java.

5. Dependências Necessárias

Maven (pom.xml)

<dependency>
    <groupId>org.apache.commons</groupId>
    <artifactId>commons-lang3</artifactId>
    <version>3.12.0</version>
</dependency>

<dependency>
    <groupId>org.slf4j</groupId>
    <artifactId>slf4j-api</artifactId>
    <version>1.7.36</version>
</dependency>

6. Estilos de Formatação

MULTI_LINE_STYLE (Recomendado)

ToStringStyle.MULTI_LINE_STYLE

Resultado:

NotaFiscal[
  id=165
  totalNfe=125.00
]

DEFAULT_STYLE

ToStringStyle.DEFAULT_STYLE

Resultado: NotaFiscal[id=165,totalNfe=125.00]

7. Níveis de Log

logger.trace("Detalhes muito específicos");
logger.debug("Informações de debug");
logger.info("Informações gerais");           // Use para debug
logger.warn("Avisos");
logger.error("Erros", exception);

8. Como Funciona a Reflexão

ToStringBuilder.reflectionToString(objeto, estilo)

Processo:

Usa Java Reflection para acessar a classe
Obtém todos os atributos (incluindo privados)
Lê o valor de cada atributo
Formata conforme o estilo
Retorna String formatada

9. Comparação de Abordagens

Característica	System.out	logger.info + ToStringBuilder
Profissional	X	OK
Controle de nível	X	OK
Impressão automática	X	OK
SonarQube aprova	X	OK

10. Boas Práticas

Fazer

private static final Logger logger = LoggerFactory.getLogger(MinhaClasse.class);

logger.info(ToStringBuilder.reflectionToString(objeto, ToStringStyle.MULTI_LINE_STYLE));

if (objeto != null) {
    logger.info(ToStringBuilder.reflectionToString(objeto, ToStringStyle.MULTI_LINE_STYLE));
}

Não Fazer

System.out.println(objeto);  // X

logger.info("ID: " + objeto.getId());  // X Concatenação

private Logger logger = LoggerFactory.getLogger(getClass());  // X Não estático

11. Exemplo Completo

package com.syndata.web.controller;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.apache.commons.lang3.builder.ToStringBuilder;
import org.apache.commons.lang3.builder.ToStringStyle;

public class NfeMB extends BaseCrudManagedBean {

    private static final Logger logger = LoggerFactory.getLogger(NfeMB.class);

    public void emitirNotaFiscal(Long idNotaFiscal) {

        logger.info("====================================");
        logger.info("=== DEBUG NOTA FISCAL ===");
        logger.info("====================================");

        if (this.notaFiscal == null) {
            logger.warn("Nota Fiscal é NULL!");
        } else {
            logger.info("Dados completos:");
            logger.info(ToStringBuilder.reflectionToString(
                this.notaFiscal, 
                ToStringStyle.MULTI_LINE_STYLE
            ));
        }

        logger.info("====================================");

        try {
            // ... código de emissão
            logger.info("Nota fiscal emitida com sucesso");
        } catch (NegocioException e) {
            logger.error("Erro ao emitir nota fiscal", e);
        }
    }
}

12. Conclusão

ToStringBuilder.reflectionToString() com logger.info() é a forma profissional de debug de objetos Java, aprovada pelo SonarQube.

Benefícios:

Impressão automática de TODOS os atributos
Formatação legível
Controle profissional de logs
Fácil manutenção

Documento criado por: Edivan Carvalho

Última atualização: 06 de janeiro de 2025

Validador do Novo CNPJ Alfanumérico em JavaScript

Edivan Carvalho — Wed, 03 Sep 2025 23:12:43 +0000

A Receita Federal do Brasil publicou a Instrução Normativa 2229 de 15 de outubro de 2024 que modifica a regra de formação do CNPJ no Brasil.

Essa ação visa ampliar a capacidade de geração de números de CNPJ para abertura de empresas devido ao esgotamento da modelagem atual.

A repercussão dessa mudança afeta milhares de sistemas, e não será diferente com os sistemas de faturamento e emissão de documentos fiscais eletrônicos e seus respectivos ambientes de autorização mantidos pelas Administrações Tributárias.

Referência oficial:

Estrutura do novo CNPJ

O CNPJ alfanumérico continua com 14 posições.
As 8 primeiras posições são a raiz (alfanuméricas).
As 4 posições seguintes são a ordem (alfanuméricas).
As 2 últimas posições continuam sendo os dígitos verificadores (numéricos).

O cálculo do DV (Dígito Verificador) segue o módulo 11, mas agora cada caractere é convertido em número com a regra:

valor = ASCII - 48

Exemplos:

"0" → 0
"9" → 9
"A" → 17
"B" → 18
"Z" → 42

Código em JavaScript

class CNPJ {
  static tamanhoCNPJSemDV = 12;
  static regexCNPJSemDV = /^([A-Z\d]){12}$/;
  static regexCNPJ = /^([A-Z\d]){12}(\d){2}$/;
  static regexCaracteresMascara = /[./-]/g;
  static cnpjZerado = "00000000000000";
  static pesosDV = [6, 5, 4, 3, 2, 9, 8, 7, 6, 5, 4, 3, 2];

  static isValid(cnpj) {
    let cnpjSemMascara = this.removeMascaraCNPJ(cnpj).toUpperCase();

    if (this.regexCNPJ.test(cnpjSemMascara) && cnpjSemMascara !== this.cnpjZerado) {
      const dvInformado = cnpjSemMascara.substring(this.tamanhoCNPJSemDV);
      const dvCalculado = this.calculaDV(cnpjSemMascara.substring(0, this.tamanhoCNPJSemDV));
      return dvInformado === dvCalculado;
    }
    return false;
  }

  static calculaDV(cnpj) {
    let cnpjSemMascara = this.removeMascaraCNPJ(cnpj).toUpperCase();

    if (this.regexCNPJSemDV.test(cnpjSemMascara) &&
        cnpjSemMascara !== this.cnpjZerado.substring(0, this.tamanhoCNPJSemDV)) {

      let somatorioDV1 = 0;
      let somatorioDV2 = 0;

      for (let i = 0; i < this.tamanhoCNPJSemDV; i++) {
        const asciiDigito = cnpjSemMascara.charCodeAt(i) - 48; // regra oficial
        somatorioDV1 += asciiDigito * this.pesosDV[i + 1];
        somatorioDV2 += asciiDigito * this.pesosDV[i];
      }

      const dv1 = somatorioDV1 % 11 < 2 ? 0 : 11 - (somatorioDV1 % 11);
      somatorioDV2 += dv1 * this.pesosDV[this.tamanhoCNPJSemDV];
      const dv2 = somatorioDV2 % 11 < 2 ? 0 : 11 - (somatorioDV2 % 11);

      return `${dv1}${dv2}`;
    }

    throw new Error("Não é possível calcular o DV pois o CNPJ fornecido é inválido");
  }

  static removeMascaraCNPJ(cnpj) {
    return cnpj.replace(this.regexCaracteresMascara, "");
  }
}

Exemplo de uso

const raiz = "A1B2C3D4E5F6"; // 12 primeiros caracteres
const dv = CNPJ.calculaDV(raiz);

console.log(`DV calculado: ${dv}`);

const cnpjCompleto = raiz + dv;
console.log(`CNPJ completo: ${cnpjCompleto}`);
console.log(`É válido? ${CNPJ.isValid(cnpjCompleto)}`);

Saída esperada (exemplo fictício):

DV calculado: 12
CNPJ completo: A1B2C3D4E5F612
É válido? true

Espero que tenha gostado, agora você já tem um validador pronto em JavaScript para o novo CNPJ alfanumérico.