Transaction in the example firstFoundationClient

bardelman — Fri, 10 Aug 2012 09:13:44 GMT

hello,I'm new alfresco and I started to learn its APIs ..In the example with the SDK : the firstFoundationClient, I found this snippet in the the project main:/ / Use to wrap TransactionWork service calls in a user transactionTransactionService transactionService serviceRegistry.getTransactionServic

Re: Transaction in the example firstFoundationClient

jonash — Wed, 15 Aug 2012 17:15:42 GMT

Hi,

This is the Java syntax for an anonymous class.


        RetryingTransactionCallback<Object> exampleWork = new RetryingTransactionCallback<Object>()
        {
            public Object execute() throws Exception
            {
                doExample(serviceRegistry);
                return null;
            }
        };
        transactionService.getRetryingTransactionHelper().doInTransaction(exampleWork);
‍‍‍‍‍‍‍‍‍‍‍

The code above is a shorthand way of writing the following:


class ExampleWork implements RetryingTransactionCallback<Object> {
            private ServiceRegistry serviceRegistry;

            public ExampleWork(ServiceRegistry serviceRegistry) {
                        this.serviceRegistry = serviceRegistry;
            }

            // doExample method should be added here

            public Object execute() throws Exception
            {
                doExample(serviceRegistry);
                return null;
            }
}

…

RetryingTransactionCallback<Object> exampleWork = new ExampleWork(serviceRegistry);
transactionService.getRetryingTransactionHelper().doInTransaction(exampleWork);
‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍

As you can see, using an anonymous class makes the code shorter (you don't have to create a whole new class) and—in my opinion—much more readable.

Anonymous inner classes are used a lot in Alfresco to pass a piece of code around. In this case it is used to create a unit of work that is executed in a new transaction using the RetryingTransactionHelper. Here the body of the execute() method is what gets executed in the transaction.

Generics (the <Object> part) are used to parametrize the type of the value that is returned by the unit of work. Generics probably remind you of collections because that's where they are used most often in Java.

I hope this helps.

topic Transaction in the example firstFoundationClient in Alfresco Archive

Transaction in the example firstFoundationClient

Re: Transaction in the example firstFoundationClient