code: public void invalidateById(Object id, boolean waitOnInvalidation, DCache cache) {
          invalidateById(id, CachePerf.DIRECT, waitOnInvalidation, cache, Cache.CHECK_PREINVALIDATION_LISTENER);
      }
docs: This invalidates all cache entries in all caches whose cache id
  or data id is specified. Assumes this is the result of a direct
  invalidation.
  
  @param id The id (cache id or data id) that is used to to
  invalidate fragments.
  @param waitOnInvalidation True indicates that this method should
  not return until all invalidations have taken effect.
  False indicates that the invalidations will take effect the next
  time the BatchUpdateDaemon wakes.
  @param causeOfInvalidation The cause of this invalidation.