Attach a POJO into PojoCache. It will also recursively put any sub-POJO into the cache system. A POJO can be the following and have the consqeuences when attached:
it is Replicable, that is, it has been annotated with {@link @org.jboss.cache.pojo.annotation.Replicable} annotation (or via XML),and has been "instrumented" either compile- or load-time. The POJO will be mapped recursively to the system and fine-grained replication will be performed. It is Serializable. The POJO will still be stored in the cache system. However, it is treated as an "opaque" object per se. That is, the POJO will neither be intercepted (for fine-grained operation) or object relantionship will be maintained. Neither of above. In this case, a user can specify whether it wants this POJO to be stored (e.g., replicated or persistent). If not, a PojoCacheException will be thrown.
@param id An id String to identify the object in the cache. To promoteconcurrency, we recommend the use of hierarchical String separating by a designated separator. Default is "/" but it can be set differently via a System property, jbosscache.separator in the future release. E.g., "ben", or "student/joe", etc.
@param pojo object to be inerted into the cache. If null, it will nullifythe fqn node.
@return Existing POJO or null if there is none.
@throws PojoCacheException Throws if there is an error related to the cache operation.