Repolode
Enviar
javers

javers/javers

Uma biblioteca Java leve para auditar alterações em objetos, comparar diferenças e manter um histórico de versões dos seus dados.

Ver no GitHubSite
Estrelas
1,577
Forks
395
Issues abertas
90
Último commit
há 25 dias

O que é?

JaVers é uma biblioteca Java que oferece auditoria no estilo de controle de versão para objetos comuns, como entidades, POJOs e objetos de dados. Ela compara grafos complexos de objetos em uma única chamada, informa o que mudou e registra cada alteração com metadados do commit, autor e data e hora.

Além de comparar diferenças, JaVers mantém um log de auditoria do histórico dos objetos e oferece consultas shadow que reconstroem como um objeto estava em determinado momento. A biblioteca se integra ao Spring Boot e ao Spring Data, onde a anotação @JaversSpringDataAuditable habilita a auditoria em repositórios.

JaVers oferece opções flexíveis de persistência, incluindo MongoDB, SQL por meio de Hibernate/JPA e uma opção polimórfica. As dependências são publicadas no Maven Central, com starters para Spring Boot nas variantes SQL e Mongo.

Recursos principais

  • 01Compara grafos complexos de objetos em uma única chamada para gerar um diff
  • 02Registra automaticamente cada alteração com metadados do commit, autor e data e hora
  • 03Oferece consultas shadow para reconstituir o estado de um objeto em um momento passado
  • 04Integra-se a repositórios do Spring Data por meio de uma única anotação
  • 05Persiste o histórico de auditoria no MongoDB ou em SQL por meio de Hibernate/JPA

Casos de uso

  • Rastrear quem alterou quais campos de uma entidade e quando, em um serviço Java
  • Auditar gravações em repositórios de uma aplicação Spring Boot com o mínimo de código
  • Reconstituir o estado histórico de objetos de negócio para investigação ou geração de relatórios

Início rápido

  1. 1

    Adicione a dependência Spring Boot SQL starter (Gradle ou Maven; consulte o README)

  2. 2

    Clone o repositório

    git clone https://github.com/javers/javers.git
  3. 3

    Acesse o diretório do projeto

    cd javers
  4. 4

    Compile o JaVers e execute os testes unitários

    ./gradlew build

Antes de usar

  • Alguns recursos empresariais, como a interface Audit Explorer e a multilocação, fazem parte do JaVers Pro, uma oferta paga separada que está em acesso antecipado.

Tópicos

#java#audit#object-diff#spring-boot#spring-data#hibernate#mongodb#change-tracking#hacktoberfest

Perguntas frequentes

O que é javers?
Uma biblioteca Java leve para auditar alterações em objetos, comparar diferenças e manter um histórico de versões dos seus dados. JaVers é uma biblioteca Java que oferece auditoria no estilo de controle de versão para objetos comuns, como entidades, POJOs e objetos de dados. Ela compara grafos complexos de objetos em uma única chamada, informa o que mudou e registra cada alteração com metadados do commit, autor e data e hora.
javers é gratuito? Qual é a licença?
javers é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
javers ainda é mantido?
Manutenção ativa. O último commit de javers foi em 12 de out. de 2026.
Para que posso usar javers?
Rastrear quem alterou quais campos de uma entidade e quando, em um serviço Java Auditar gravações em repositórios de uma aplicação Spring Boot com o mínimo de código Reconstituir o estado histórico de objetos de negócio para investigação ou geração de relatórios
Como instalar javers?
Adicione a dependência Spring Boot SQL starter (Gradle ou Maven; consulte o README) Clone o repositório: git clone https://github.com/javers/javers.git Acesse o diretório do projeto: cd javers Compile o JaVers e execute os testes unitários: ./gradlew build
Onde consigo javers?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/javers/javers

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados