Copy Page

You are not logged in. Any changes you make will be marked as anonymous. You may want to Log In if you already have an account. You can also Sign Up for a new account.

<h2>Overview</h2>

The UnitOfWorkProtocol aspect makes the <a class="confluence-link" href="/display/AWARE/Unit+Of+Work" data-linked-resource-id="3415" data-linked-resource-type="page" data-linked-resource-default-alias="Unit Of Work" data-base-url="http://docs.codehaus.org">Unit Of Work</a> management transparent in the user code.

It will allow you to write your code like this:

<table class="wysiwyg-macro" data-macro-name="code" data-macro-default-parameter="java" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e2NvZGU6amF2YX0&amp;locale=en_GB&amp;version=2); background-repeat: no-repeat;" data-macro-body-type="PLAIN_TEXT"><tr><td class="wysiwyg-macro-body"><pre>
AddressBook book = new AddressBook(...);
book.addContact(contact);
</pre></td></tr></table>

Instead of like this:
<table class="wysiwyg-macro" data-macro-name="code" data-macro-default-parameter="java" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e2NvZGU6amF2YX0&amp;locale=en_GB&amp;version=2); background-repeat: no-repeat;" data-macro-body-type="PLAIN_TEXT"><tr><td class="wysiwyg-macro-body"><pre>
UnitOrWork unitOfWork = UnitOfWork.begin();
try {
 AddressBook book = new AddressBook(...);
 unitOfWork.registerNew(book); 
 book.addContact(contact);
 unitOfWork.registerDirty(book); 
 unitOfWork.commit();
} 
catch(Exception e) {
 unitOfWork.rollback(); 
}
finally {
 unitOfWork.dispose();
}
</pre></td></tr></table>

and still all the transaction and persistence management will take place.

<h2>Definition</h2>

The UnitOfWorkProtocol aspect has abstract pointcuts that you have to define in your aop.xml file (a &quot;transactional object&quot; is an object that is set to participate in the Unit Of Work transaction, meaning that the Unit Of Work will keep track of its state):

<ul>
	<li><code>txRequires</code> - picks out all points in the code where you want a TX REQUIRES transaction to begin, commit and rollback</li>
	<li><code>txRequiresNew</code> - picks out all points in the code where you want a TX REQUIRES_NEW transaction to begin, commit and rollback</li>
	<li><code>txSupports</code> - picks out all points in the code where you want a TX SUPPORTS transaction to begin, commit and rollback</li>
	<li><code>txMandatory</code> - picks out all points in the code where you want a TX MANDATORY transaction to begin, commit and rollback</li>
	<li><code>txNever</code> - picks out all points in the code where you want a TX NEVER transaction to begin, commit and rollback</li>
	<li><code>transactionalObjects</code> - picks out all transactional object, this pointcut is used by the <a class="confluence-link" href="/display/AWARE/Transactional+Mixin" data-linked-resource-id="3595" data-linked-resource-type="page" data-linked-resource-default-alias="Transactional Mixin" data-base-url="http://docs.codehaus.org">Transactional Mixin</a></li>
	<li><code>transactionalObjectCreationPoints</code> - picks out all points in the code where a transactional object is created</li>
	<li><code>transactionalObjectModificationPoints</code> - picks out all points in the code where a transactional object is being modified (best done with a <code>set(...)</code> pointcut)</li>
</ul>

Here is an example on how to define this in XML:

<table class="wysiwyg-macro" data-macro-name="code" data-macro-default-parameter="xml" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e2NvZGU6eG1sfQ&amp;locale=en_GB&amp;version=2); background-repeat: no-repeat;" data-macro-body-type="PLAIN_TEXT"><tr><td class="wysiwyg-macro-body"><pre>
&lt;aspect class="org.codehaus.aware.unitofwork.UnitOfWorkProtocol">
 &lt;pointcut name="txSupports" expression="execution(* org.codehaus.aware.app.service.*.*(..))"/>
 &lt;pointcut name="txRequires" expression="execution(* org.codehaus.aware.app.domain.*.*(..))"/>

&lt;pointcut name="transactionalObjects" expression="within(org.codehaus.aware.app.domain.*)"/>
 &lt;pointcut name="transactionalObjectCreationPoints" expression="call(org.codehaus.aware.app.domain.*.new(..))"/>
 &lt;pointcut name="transactionalObjectModificationPoints" expression="set(* org.codehaus.aware.app.domain.*.*)"/>
&lt;/aspect>
</pre></td></tr></table>