IAtomicReference is a member of CP Subsystem API.
For detailed information, see the CP Subsystem chapter.
IAtomicLong is very useful if you need to deal with a long,
but in some cases you need to deal with a reference. That is why Hazelcast
also supports the
IAtomicReference which is the distributed version of
Here is an IAtomicReference example.
Config config = new Config();
HazelcastInstance hz = Hazelcast.newHazelcastInstance(config);
IAtomicReference<String> ref = hz.getCPSubsystem().getAtomicReference("reference");
When you execute the above example, the output is as follows:
IAtomicReference has methods that accept a
'function' as an argument, such as
There are two big advantages of using these methods:
From a performance point of view, it is better to send the function to the data than the data to the function. Often the function is a lot smaller than the data and therefore cheaper to send over the line. Also the function only needs to be transferred once to the target machine and the data needs to be transferred twice.
You do not need to deal with concurrency control. If you would perform a load, transform, store, you could run into a data race since another thread might have updated the value you are about to overwrite.
The following are some considerations you need to know when you use IAtomicReference:
IAtomicReferenceworks based on the byte-content and not on the object-reference. If you use the
compareAndSetmethod, do not change to the original value because its serialized content will then be different. It is also important to know that if you rely on Java serialization, sometimes (especially with hashmaps) the same object can result in different binary content.
All methods returning an object return a private copy. You can modify the private copy, but the rest of the world is shielded from your changes. If you want these changes to be visible to the rest of the world, you need to write the change back to the
IAtomicReference; but be careful about introducing a data-race.
The 'in-memory format' of an
binary. The receiving side does not need to have the class definition available unless it needs to be deserialized on the other side, e.g., because a method like 'alter' is executed. This deserialization is done for every call that needs to have the object instead of the binary content, so be careful with expensive object graphs that need to be deserialized.
If you have an object with many fields or an object graph and you only need to calculate some information or need a subset of fields, you can use the
applymethod. With the
applymethod, the whole object does not need to be sent over the line; only the information that is relevant is sent.