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>

<p>The <strong>Transactional Mixin</strong> is a mixin that allows you to add additional behaviour to the objects that you have defined as <em>transactional</em>. </p>

<p>It provides convience methods that the developer can use to interact with 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>. </p>

<p>Here is the <code>org.codehaus.aware.unitofwork.Transactional</code> interface that you can use to access the introduced methods:</p>

<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>
public interface Transactional {
    /**
     * Stores the persistable object in persistent storage.
     */
    void create();

/**
     * Removes the persistable object from persistent storage.
     */
    void remove();

/**
     * Clones the persistable object.
     *
     * @return a clone of the persistable object
     */
    Object clone();

/**
     * Checks if the persistable object exists in the persistent storage.
     *
     * @return true if the object exists in the persistent storage
     */
    boolean exists();

/**
     * Marks the persistable object as dirty. &lt;p/>Is handled automatically by the framework but this method exists for
     * the users to be able to do it explicitly.
     */
    void markDirty();

/**
     * Marks the current UnitOfWork and attached transaction as restoreObject only.
     */
    void setRollbackOnly();

/**
     * Returns the current UnitOfWork.
     *
     * @return the current UnitOfWork
     */
    UnitOfWork getUnitOfWork();

/**
     * Returns the current transaction.
     *
     * @return the current transaction
     */
    TransactionContext getTransaction();
}
</pre></td></tr></table>

<p>To access the methods you have to cast the instance to the interface:</p>

<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>
((Transactional)this).setRollbackOnly()
</pre></td></tr></table>

<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>
((Transactional)targetInstance).create()
</pre></td></tr></table>

<h2>Definition</h2>

<p>The <strong>Transactional Mixin</strong> is an inner class of the <a class="confluence-link" href="/display/AWARE/UnitOfWorkProtocol" data-linked-resource-id="3460" data-linked-resource-type="page" data-linked-resource-default-alias="UnitOfWorkProtocol" data-base-url="http://docs.codehaus.org">UnitOfWorkProtocol</a> and is defined using the <code>transactionalObjects</code> pointcut. </p>

<p>This is how you can define it in the XML definition:</p>

<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="transactionalObjects" expression="within(org.codehaus.aware.app.domain.*)"/>
    ...
&lt;/aspect>
</pre></td></tr></table>