BT

Facilitating the Spread of Knowledge and Innovation in Professional Software Development

Write for InfoQ
News Articles Presentations Podcasts Guides

Topics

Choose your language

QCon New York

Find real-world practical inspiration from the world’s most innovative software leaders. Attend in-person.
QCon San Francisco

Learn what's next in software from world-class leaders pushing the boundaries. Attend in-person or get video-only pass to recordings.
The Software Architects' Newsletter

Your monthly guide to all the topics, technologies and techniques that every professional needs to know about. Subscribe for free.

InfoQ Homepage News Envers Joins Hibernate

QCon New York (June 13-15): Learn best practices from senior developers at early adopter companies.

Envers Joins Hibernate

Leia em Português

This item in japanese

Bookmarks

Dec 01, 2008 1 min read

Write for InfoQ

Join a community of experts. Increase your visibility.
Grow your career.Learn more

Envers is an open-source project from JBoss which aims to provide easy versioning of persistent JPA classes. InfoQ provided information about the first GA release, 1.0.0, back in July of 2008. Since then Envers 1.1.0 was released which provided several new features.

The primary focus for the 1.1.0 release was the addition of support for persistent collections. Adam Warski, founder of Envers, described the new feature:

You can now version any relation, collections of “simple” types, maps, etc. All collection mappings defined by JPA are now supported, and most of what Hibernate additionally allows also.

The latest release also included some other improvements and bug fixes, as well as updates to the demos. With the continuing improvements to Envers, there is other news which was the source for this news item. On October 30, 2008 Envers officially became a module of Hibernate. The Envers website, documentation and forum will stay at there original home page for some time to come. The primary major changes were listed by Adam Warski on his blog:

  • The code is now in the hibernate-core repository (envers module). There will be no more commits to the old repository.
  • Issue tracking moved to Hibernate’s JIRA. All open issues from the old JIRA have been moved there.
  • Envers is now built using maven2, which replaces the old ant build

It's exciting times for Adam Warski and other contributors to Envers. The move to the Hibernate family should aid in the continued development of the Envers module and the further expansion into developers toolbelts when it comes to persisting Java objects.

Rate this Article

Adoption
Style

This content is in the Java topic

Related Topics:

Hello stranger!

You need to Register an InfoQ account or or login to post comments. But there's so much more behind being registered.

Get the most out of the InfoQ experience.

Allowed html: a,b,br,blockquote,i,li,pre,u,ul,p

Community comments

  • How does envers handle circular references?

    by peter lin,

    Your message is awaiting moderation. Thank you for participating in the discussion.

    I'm curious, how does envers handles a situation where there's circular references? For example, say we have a model with bi-directional references like this.

    Person - has a collection of addresses
    Address - has a reference to the person

    How does envers know to skip a bidirectional reference and only traverse down the object graph and not back up.

    Back to top
  • Re: How does envers handle circular references?

    by Adam Warski,

    Your message is awaiting moderation. Thank you for participating in the discussion.

    When saving changes, it's only needed to traverse 0 or 1 levels deep (depending on the settings).

    When loading changes, there is a "first-level cache", so you always attempt to load each entity at a revision once.

    Hope this answers your question :)

    Adam

    Back to top
  • Re: How does envers handle circular references?

    by peter lin,

    Your message is awaiting moderation. Thank you for participating in the discussion.

    Thanks for responding. I looked for envers design docs late last night and couldn't find any. I finally decided to read the code, but couldn't quite make out the overall design.

    It sounds like the @versioned annotation gives users the ability to set the depth. I have another question, which I couldn't figure out from the website or forum.

    Say I have a large object graph and all the entities in that graph are versioned. Here is a hypothetical model.


    plan
     - Customer
       - list of addresses
     - PlanDetails
       - list of services
     - PlanRegion
       - list of region restrictions
          - PlanRestriction
     - PlanOptions
       - list of optios the customer has
          - PlanOption
     - ServiceHistory
       - list of service calls
          - ServiceCall


    If I add a new ServiceCall, does it revision the entire graph in the global revision, or does it maintain a parts list?

    thanks

    peter

    Back to top
  • Re: How does envers handle circular references?

    by Adam Warski,

    Your message is awaiting moderation. Thank you for participating in the discussion.

    Hello,
    no, only a new revision for ServiceCall will be generated. If the relation with ServiceHistory is bidirectional, and a certain configuation option is set, a revision for ServiceHistory will also be generated.

    --
    Adam

    Back to top
  • Re: How does envers handle circular references?

    by peter lin,

    Your message is awaiting moderation. Thank you for participating in the discussion.

    Sounds like Envers maintains a parts list. By that I mean does it keeps a list of all the records (id + version + timestamp) for each global version. I forgot to mention in the previous comment, the entire plan needs to be versioned including all the objects hanging off it. Is my interpretation correct or totally wrong.

    thanks

    peter

    Back to top

Allowed html: a,b,br,blockquote,i,li,pre,u,ul,p

Allowed html: a,b,br,blockquote,i,li,pre,u,ul,p

BT