ACBrLib.Core 1.2.44

ACBrLib.Core

Biblioteca base em C# para integração com as bibliotecas ACBrLib, fornecendo classes, enums e contratos para configuração, manipulação e uso das funcionalidades ACBr em aplicações .NET.

Escopo

Este pacote concentra os tipos compartilhados da ACBrLib.Core:

• contratos base das bibliotecas;
• classes de configuração comuns;
• enums reutilizados entre módulos;
• exceções base.

Getting Started

Instale o pacote ACBrLib.Core via NuGet no projeto consumidor.

.NET CLI

dotnet add package ACBrLib.Core

PackageReference no .csproj

<ItemGroup>
  <PackageReference Include="ACBrLib.Core" Version="[1.2.41,)" />
</ItemGroup>

Version="[1.2.41,)" permite restaurar a versão 1.2.41 ou superior.

Após a instalação, referencie os tipos base conforme a necessidade do pacote consumidor (por exemplo, IACBrLibBase, ACBrLibConfig e ACBrLibConfigBase).

Principais Classes e Interfaces

• ACBrLibBase
  Classe abstrata base para bibliotecas ACBrLib em C#.
• IACBrLibBase
  Interface base com as operações comuns entre bibliotecas.
• ACBrLibHandleBase
  Classe base para integração com bibliotecas nativas (carregamento e execução de métodos nativos).
• ACBrLibConfigBase
  Classe base para sessões de configuração.
• ACBrLibConfig
  Classe indicada para centralizar configurações comuns a todas as bibliotecas ACBrLib.
• ACBrLibDFeConfig
  Classe base de configuração comum para bibliotecas de documentos fiscais eletrônicos (DFe).
• DFeConfig
  Sessão de configuração comum a todos os DFes.
• ACBrLibException / ACBrLibTimeoutException
  Exceções base para erros e timeout.

Principais Enums

• ACBrSessao
  Enumera as sessões de configuração.
• TipoResposta
  Define o formato de resposta (INI, XML, JSON).
• CodResposta
  Define a codificação da resposta (UTF8, ANSI).
• NivelLog
  Define o nível de detalhamento do log.
• ACBrPessoa
  Enumera os tipos de pessoa.

Outras Funcionalidades Disponíveis

Além dos tipos principais, este pacote também fornece utilitários compartilhados para leitura/escrita de INI e mapeamento de propriedades:

• ACBrIniFile
  Manipulação de arquivo INI e coleção de seções.
• ACBrIniSection
  Representa uma seção INI com leitura e escrita de chaves.
• IniUtil
  Métodos de apoio para serializar e desserializar objetos para/de INI.
• IniValueWrapper
  Conversão de tipos para valores de INI e vice-versa.
• IniKeyAttribute
  Permite mapear nome de chave INI diferente do nome da propriedade.
• IniIgnoreAttribute
  Ignora propriedades durante a leitura/escrita de INI.
• EnumValueAttribute
  Define representação textual personalizada para valores de enum em INI.

Nota

A refatoração das classes C# está em andamento. Este documento descreve apenas conceitos e tipos gerais já disponíveis no projeto, sem exemplos de uso específicos.

Recomendações de Herança e Interfaces

• Prefira programar contra interfaces: interfaces específicas dos pacotes consumidores devem herdar de IACBrLibBase.
• Classes de configuração devem receber no tipo genérico uma interface que implemente IACBrLibBase (padrão: where TLib : IACBrLibBase).
• Use ACBrLibConfig para centralizar configurações comuns entre bibliotecas.
• Em bibliotecas de DFe, utilize ACBrLibDFeConfig para reaproveitar configurações compartilhadas.
• Use ACBrLibConfigBase para criar sessões de configuração específicas.
• Evite criar dependência nova sobre classes marcadas para descontinuação.

Documentação

• Wiki ACBrLib
• Notícia oficial da refatoração
• Consulte os comentários XML nas classes para detalhes de cada método e propriedade.