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 2019/09/13 06:41: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

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)

  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

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)


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



--
This message was sent by Atlassian Jira
(v8.3.2#803003)