There are some scenarios where this method is called only once, for example in Unidirectional ManyToOne where the RowKey matches the Entity, but in the bidirectional and unidirectional case it is called twice.

I will update the javadoc.