The Option API allows you to override certain behaviours of the cache on a per invocation basis. This involves creating an instance of org.jboss.cache.config.Option , setting the options you wish to override on the Option object and passing it in the InvocationContext before invoking your method on the cache.

E.g., to override the default node versioning used with optimistic locking:

   DataVersion v = new MyCustomDataVersion();

   cache.getInvocationContext().getOptionOverrides().setDataVersion(v);

   Node ch = cache.getRoot().addChild(Fqn.fromString("/a/b/c"));

E.g., to suppress replication of a put call in a REPL_SYNC cache:

   Node node = cache.getChild(Fqn.fromString("/a/b/c"));

   cache.getInvocationContext().getOptionOverrides().setLocalOnly(true);

   node.put("localCounter", new Integer(2));

         

See the javadocs on the Option class for details on the options available.