You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@ignite.apache.org by "Anton Vinogradov (JIRA)" <ji...@apache.org> on 2018/12/17 11:29:00 UTC

[jira] [Updated] (IGNITE-8419) Clear javadoc for tx markers

     [ 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

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)

  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 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)


> 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
> 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)



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