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)
