docs: public void putMerged(DbEntity e) {
      CachedDbEntity cachedDbEntity = new CachedDbEntity();
      cachedDbEntity.setEntity(e);
      cachedDbEntity.setEntityState(MERGED);
      cachedDbEntity.determineEntityReferences();
      // no copy required
  
      putInternal(cachedDbEntity);
    }