[ 
https://issues.apache.org/jira/browse/IGNITE-8419?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
 ]

Anton Vinogradov updated IGNITE-8419:
-------------------------------------
    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

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

  was:
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 remote -
eg. GridDhtTxRemote
flags: dht | remote 


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




> Clear javadoc for tx markers
> ----------------------------
>
>                 Key: IGNITE-8419
>                 URL: https://issues.apache.org/jira/browse/IGNITE-8419
>             Project: Ignite
>          Issue Type: Task
>            Reporter: Anton Vinogradov
>            Priority: Major
>
> 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
> P.s. 
>  "How about we explain it in javadocs and properly document on wiki?" (c) 
> Yakov (see. devlist discussion)



--
This message was sent by Atlassian JIRA
(v7.6.3#76005)

Reply via email to