ignite-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Alexandr Kuramshin (JIRA)" <j...@apache.org>
Subject [jira] [Created] (IGNITE-4795) Inherit TransactionException and update Javadoc
Date Tue, 07 Mar 2017 05:45:32 GMT
Alexandr Kuramshin created IGNITE-4795:
------------------------------------------

             Summary: Inherit TransactionException and update Javadoc
                 Key: IGNITE-4795
                 URL: https://issues.apache.org/jira/browse/IGNITE-4795
             Project: Ignite
          Issue Type: Improvement
          Components: cache, SQL, website
    Affects Versions: 1.8
            Reporter: Alexandr Kuramshin
             Fix For: 2.0


Understanding transactional behaviour is not clear in Javadoc at this point of time. Even
after reading website some doubt remain.

Proposal.

1. Create {{TransactionException}} as the marker of transactional methods and inherit from
it all the existed transactional exceptions like {{TransactionTimeoutException}}, {{TransactionRollbackException}},
{{TransactionHeuristicException}}, {{TransactionOptimisticException}}, etc.

2. Update all the transactional methods ({{get}}, {{put}}, {{invoke}}, etc) as throwing the
base {{TransactionException}}. Comment all the {{IgniteCache}} methods whether they are transactional
or not, add {{@see TransactionException}} annotation.

3. Make extensive documentation in the header of {{TransactionException}} to get understanding
of transactional and non-transactional methods behaviour.

4. Update website and Javadoc to clarify the fact that {{put}} value is cached within the
transaction and affects successive {{get}}.



--
This message was sent by Atlassian JIRA
(v6.3.15#6346)

Mime
View raw message