93

In the context of ORM / Lazy loading of entities, my understanding of the term "Hydration" is as follows:

"Hydrating" describes the process of populating some or all of the previously unpopulated attributes of an entity fetched using lazy loading.

Eg: class Author is loaded from the database:

@Entity
class Author
{
     @Id
     long id;
     List<Book> books;
}

Initially, the books collection is not populated.

It is my understanding that the process of loading the books collection from the database is referred to as "Hydrating" the collection.

Is this definition correct, and is the term common place? Is there another more common term I should be using for this process?

0

6 Answers 6

156

Hydrate began as a term for populating an instantiated (but empty) value-object/model from a db, (specifically in Hibernate.)

Various other ORMs and tools like BizTalk use Hydrate and other related terminology, (e.g. BizTalk uses the term Dehydrated to mean an instance is available but not yet populated.)

Personally I'm averse to redundant terminology overhauls, populated means the same thing, without re-inventing language. It adds nothing and leads to confusion (common first thought on encountering re-invented terms: is this somehow different and magical?).

The BizTalk extension of this style of language, specifically Dehydrated is redundant. I expect people haven't forgotten how to say, empty, or clear?

Hydrated and its related metaphors are essentially marketing tools, invented to differentiate Hibernate from competing products.

At this point Hibernate and other ORM products have used these terms for many years, so Hydrate (and Dehydrate) are here to stay.

11
  • 20
    Of course it is, however, it was first, it's simple and as such it's far less convoluted. You may have also realised at this point that pretty much everything on the software layer, even a bit value being "true/false" or "1/0" is metaphorical... Should we start calling 'true' something else now? How about 'almost certainly' in respect to Heisenberg?
    – ocodo
    Apr 4, 2011 at 20:46
  • 20
    I think "hydrate" is a far better metaphor than "populate". Populate brings to mind a group of colonizers moving to a foreign or virgin territory and "populating" it. There is an empty space and you fill it with something unrelated (but presumably belongs there). Where when hydrating something, say a dried fig, the essence of the substance is there but it lacks fullness. That's exactly what happens when you "hydrate" an object. Far from being "marketing fluff", hydrate is an excellent metaphor. Jan 7, 2014 at 23:16
  • 8
    @KyleMathews Well, it's three years on since I posted my answer, I didn't make explicitly clear that "Populated" was the pre-existing term for the same activity, at this point "Hydrated" is still a marginal term, and is only used in certain language/product cultures, while "Populated" remains as the generic and more broadly used term. By all means go ahead and use "Hydrate" if it pleases you, personally I find it pretentious and affected.
    – ocodo
    Jan 8, 2014 at 14:51
  • 27
    If you use "hydrate" around people who don't understand that word, you're going to have to explain it. Why not just use a word that's already going to be understandable by your audience, even if it's not the most precise word possible? Feb 19, 2014 at 19:40
  • 13
    The fact that nobody knows what hydrate is supposed to mean without looking it up shows that it is a stupid buzz word that is unfortunately now entrenched in many ORM frameworks.
    – BadHorsie
    Sep 14, 2016 at 22:30
20

Entity loaded state

When you are fetching an entity, Hibernate will try to load it either from the second-level cache or the database.

Entity loaded state

If the entity is not stored in the second-level cache, then a query is executed and the JDBC ResultSet is transformed into an Object[] that contains the loading-time entity property values.

The second-level cache stores this Object[] when caching an entity. So, when loading an entity either from the DB or the second-level cache, you will get the Object[] entity property value array.

The process of transforming the Object[] loaded state into a Java entity object is called hydration, and it looks as follows:

final Object[] values = persister.hydrate(
    rs, id, object,
    rootPersister, cols, eagerPropertyFetch, session
);

The loaded state is saved in the currently running Persistence Context as an EntityEntry object, and it will be used later for the default dirty checking mechanism, which compares the current entity data against the loading-time snapshot.

The loaded state is also used as the cache entry value for the second-level entity cache.

The inverse operation of transforming the entity to an Object[] that's used when binding SQL parameter values for INSERT, UPDATE or DELETE statements is called dehydration.

4

"Hydration" is a loose term. In our company we use "rehydration" as the term to load all the object properties of an entire object graph. Here is a post that talks about various levels of hydration (again this is a general usage though they are using in the context of Hibernate).

1
2

I think the term 'hydrate(s)' in the context of ORM simply means the framework gives you objects. So the objects are 'hydrated' by the ORM after the data is pulled from the store. The term can be applied anytime an ORM framework gives you an object/graph that is represented in the store.

0

the term hydration is extensively used in the guts of the hibernate library to refer to the process of setting the fields of a recently loaded object, and is indeed related to the object graph populaton.
but it's different than the concept of lazy loading, that is, giving the user a half-filled object and letting the rest be loaded on demand.
the hydration is always performed, lazily or eagerly and it's hibernate stuff.
lazy loading is just for convenience

replace hibernate with the name of your orm of choice

-1

Hydration is a general ORM domain term meaning a method by which the query result is returned. It's not a process, not a verb, not an action or event that occurs but a noun. Therefore to hydrate simply means to use a hydration method. Hydration method creates a structure that represents data. There's a popular misconception, though, that every hydration not only instantiates an object but also populates it before returning its reference. That's not a rule. While a specific hydration can also populate an object, not all hydrations do that. Different hydrations return different structures:

  • singular scalar
  • array of scalars
  • array of arrays
  • array of objects
  • object collecting scalars
  • object collecting arrays
  • object collecting other objects
  • ...more

It's an ORM implementation detail. Some ORMs provide multiple hydrations and you can choose one by passing an argument to query builder, some don't give you that control and replace it by convention trying to be smart about it (which is the source of the hydration/population misconception mentioned above). More advanced ones allow you to write your own hydrators for custom objects that can map field types. The term itself is closely related to deserialization (which is more general and doesn't necessarily involve a database or an ORM).

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge that you have read and understand our privacy policy and code of conduct.

Not the answer you're looking for? Browse other questions tagged or ask your own question.