Súmario

• Instanciar Componente
• Configurar Propriedades
• Gerar Boletos
• Despachar Boletos
• Gerar Arquivo de Remessa
• Gerar Boletos HTML
• Gerar Boletos PDF

Instanciar o Componente

Antes de qualquer coisa, é necessário instanciar a classe no projeto para fazer as modificações necessárias em suas propriedades e também utilizar os seus métodos.

Aqui iremos te mostrar passo a passo como instanciar a classe na linguagem Java.

JAVA

public class BoletoFactory
extends java.lang.Object

Classe principal do sistema.
Esta classe deve ser instanciada e configurada para a geração de um boleto.

Os dados obrigatórios para a geração de um boleto são os seguintes:

• Banco
  
• Agência
• Cedente
• Carteira
• Nosso Número
• Valor
• Vencimento

Configurar Propriedades

Antes de utilizar os métodos e funções do componente, é necessário configurar as suas propriedades. Elas podem ser configuradas através do código fonte.

EXEMPLO

BoletoFactory factory = new BoletoFactory();

factory.setBanco( "001" );
factory.setAgencia( "4500" );
factory.setCodBeneficiario( "12304" );
factory.setCarteira( "17" );
factory.setNossoNumero( "378" );
factory.setValor( "350,00" );
factory.setVencimento( "17/03/2021" );

Boleto boleto = factory.createBoleto();

Eventualmente um banco exige que campos adicionais sejam informados.

Atenção: Esta classe não é thread-safe, em caso de acesso concorrente deve ser criada uma nova instância para cada boleto a ser gerado.

Gerar Boletos

CreateBoleto()

Método de geração de boletos, como o próprio nome diz, será utilizada para para geração de um arquivo HTML contendo o(s) boleto(s) de acordo com as variáveis previamente atribuídas.

Método

public com.boletobancario.boleto.Boleto createBoleto()

Retorno

Retorna o HTML gerado de acordo com os dados configurados na classe principal do sistema (BoletoFactory).

Despachar Boletos

Class BoletoDiretoDispatcher

Classe que despacha os boletos do sistema Boleto Direto.
O destino dos boletos pode ser uma impressora, e-mail, ambos ou um diretório.

public class BoletoDiretoDispatcher
extends java.lang.Object

Constutores

• BoletoDiretoDispatcher

  public BoletoDiretoDispatcher()

  Carrega configurações dos arquivos padrão.

   

  public BoletoDiretoDispatcher(java.lang.String configFileName)

  Carrega configurações do arquivo especificado, o mesmo deve estar no classpath da aplicação.

   

  public BoletoDiretoDispatcher(java.util.Properties properties)

  Carrega configurações do objeto Properties passado como parâmetro.

Gerar Arquivos de Remessa

Class RemessaWriter

public class RemessaWriter
extends java.lang.Object

Construtor

• RemessaWriter

public RemessaWriter()

Métodos

• getInstance

  public static RemessaWriter getInstance()

  Retorna a instância única.

• writeBoletos

  public void writeBoletos(java.util.List<com.boletobancario.boleto.Boleto> boletos,
                  java.io.OutputStream os)

  Gera um arquivo de remessa para a saída (os) com base nos boletos listados, utilizando codificação e finais de linha padrão CNAB (ISO-8859-1 - \r\n).

Gerar Boletos em Formato HTML

Class BoletoHTMLFormatter

public abstract class BoletoHTMLFormatter
extends java.lang.Object

Classe responsável por gerar boletos em formato HTML.

Construtor

• BoletoHTMLFormatter

public BoletoHTMLFormatter()

Métodos

• asSlimWebPage

  public static java.lang.String asSlimWebPage(com.boletobancario.boleto.Boleto boleto)

  Gera um boleto HTML com recibo fino. Formato mais comumente utilizado.

• asSlimWebPage

  public static java.lang.String asSlimWebPage(java.util.List<com.boletobancario.boleto.Boleto> boletos)

  Gera múltiplos boletos com recibo fino em um único HTML.
  Há uma quebra de página entre entre os boletos. Ao visualizar em um browser é possível notá-la no modo de previsão de impressão.

• asFullWebPage

  public static java.lang.String asFullWebPage(com.boletobancario.boleto.Boleto boleto)

  Gera um boleto HTML com recibo completo.

• asFullWebPage

  public static java.lang.String asFullWebPage(java.util.List<com.boletobancario.boleto.Boleto> boletos)

  Gera múltiplos boletos com recibo completo em um único HTML.
  Há uma quebra de página entre os boletos. Ao visualizar em um browser é possível notá-la no modo de previsão de impressão.

Gerar Boletos em Formato PDF

Class BoletoPDFFormatter

public class BoletoPDFFormatter
extends java.lang.Object

Classe responsável por gerar boletos em formato PDF.

Constutores

• BoletoPDFFormatter

BoletoPDFFormatter(com.boletobancario.boleto.Boleto boleto, int layout, java.io.OutputStream outputStream)

• BoletoPDFFormatter

BoletoPDFFormatter(java.util.Collection<com.boletobancario.boleto.Boleto> boletos, int layout, java.io.OutputStream outputStream)

Métodos

• format

  public void format()

  Gera os boletos conforme parâmetros passados no construtor.

• loadImageAsBase64

  public static com.bb.itext.Image loadImageAsBase64(java.lang.String resource)

Definir Layout

• LAYOUT_NORMAL

  public static final int LAYOUT_NORMAL

  Layout normal com recibo fino.

• LAYOUT_COMPLETO

  public static final int LAYOUT_COMPLETO

  Layout normal com recibo completo.

• LAYOUT_DUPLO

  public static final int LAYOUT_DUPLO

• LAYOUT_TRIPLO

  public static final int LAYOUT_TRIPLO

• LAYOUT_CARNET

  public static final int LAYOUT_CARNET

• LAYOUT_A5

  public static final int LAYOUT_A5

• LAYOUT_TOP

  public static final int LAYOUT_TOP

  Layout normal com recibo fino e boleto no topo da folha.

• LAYOUT_MARGEM

  public static final int LAYOUT_MARGEM

  Semelhante ao layout normal, porém com margens laterais maiores.

• LAYOUT_MINIMO

  public static final int LAYOUT_MINIMO