The current API is confusing and can cause the wrong method to be invoked. See mail list thread for discussion, but the best approach seems to be to follow a 'buider' style API, e.g.,

cache.withFlags(FLAG1, FLAG2, FLAG3).put(k, v);