[IGNITE-8419] Clear javadoc for tx markers

• Type: Task
• Status: Open
• Priority: Major
• Resolution: Unresolved
• Assignee: Unassigned
• Reporter: Anton Vinogradov (Obsolete, actual is "av")
• Created: 28/Apr/18 09:53
• Updated: 18/May/23 15:11

Description

Currently, newcomers have problems with tx code understanding since markers are not clear

I propose to write a clear javadoc for reasonable markers of IgniteInternalTx

• local
• near
• dht
• remote
• colocated

am I missed something?

I see how it works, but it takes a time to understand it again each time I'm working with tx's.

Some tips abouf flags:

Tx created on originating node
eg. GridNearTxLocal
flags: near | local

Tx created on primary node
eg. GridDhtTxLocal
flags: dht | local

Tx created on backup -
eg. GridDhtTxRemote
flags: dht | remote

Near cache's Tx on backup
eg. GridNearTxRemote
flags: near | remote

So, seems near means "near node" or "near cache" depending on the context

collocated means some keys are local.

P.s.
"How about we explain it in javadocs and properly document on wiki?" (c) Yakov (see. devlist discussion)

Issue Links

• links to: devlist discussion