Services

The code for this tutorial is located in the "tutorial-service" module of the appfuse-demos project on Google Code. Use the following command to check it out from Subversion:

svn checkout http://appfuse-demos.googlecode.com/svn/trunk/tutorial-service

All service.*Manager beans will automatically be configured by Spring to wrap PROPOGATION_REQUIRED transactions around their method executions. This is done by the following Spring AOP configuration in appfuse-service.jar.

<aop:config>     
    ...     
    <aop:advisor id="managerTx" advice-ref="txAdvice"          
        pointcut="execution(* *..service.*Manager.*(..))" order="2"/> 
</aop:config>

<bean id="personManager" class="org.appfuse.service.impl.GenericManagerImpl">     
    <constructor-arg>         
        <bean class="org.appfuse.dao.hibernate.GenericDaoHibernate" autowire="byType">             
            <constructor-arg value="org.appfuse.tutorial.model.Person"/>         
        </bean>     
    </constructor-arg> 
</bean>

<bean id="personManager" class="org.appfuse.service.impl.GenericManagerImpl">     
    <constructor-arg ref="personDao"/> 
</bean>

public void setPersonManager(GenericManager<Person, Long> personManager) {
    this.personManager = personManager; 
}

package org.appfuse.tutorial.service;

import org.appfuse.service.GenericManager;
import org.appfuse.tutorial.model.Person;

import java.util.List;

public interface PersonManager extends GenericManager<Person, Long> {
    List<Person> findByLastName(String lastName);
}

package org.appfuse.tutorial.service.impl;

import org.appfuse.service.impl.BaseManagerMockTestCase;
import org.appfuse.tutorial.dao.PersonDao;
import org.appfuse.tutorial.model.Person;
import org.appfuse.tutorial.service.impl.PersonManagerImpl;
import org.jmock.Expectations;
import org.junit.After;
import org.junit.Before;
import org.junit.Test;

import java.util.ArrayList;
import java.util.List;

import static org.junit.Assert.*;

public class PersonManagerImplTest extends BaseManagerMockTestCase {
    private PersonManagerImpl manager = null;
    private PersonDao dao = null;

    @Before
    public void setUp() {
        dao = context.mock(PersonDao.class);
        manager = new PersonManagerImpl(dao);
    }

    @After
    public void tearDown() {
        manager = null;
    }

    @Test
    public void testGetPerson() {
        log.debug("testing get...");

        final Long id = 7L;
        final Person person = new Person();

        // set expected behavior on dao
        context.checking(new Expectations() {{
            one(dao).get(with(equal(id)));
            will(returnValue(person));
        }});

        Person result = manager.get(id);
        assertSame(person, result);
    }

    @Test
    public void testGetPersons() {
        log.debug("testing getAll...");

        final List persons = new ArrayList();

        // set expected behavior on dao
        context.checking(new Expectations() {{
            one(dao).getAll();
            will(returnValue(persons));
        }});

        List result = manager.getAll();

        assertSame(persons, result);
    }

    @Test
    public void testSavePerson() {
        log.debug("testing save...");

        final Person person = new Person();
        // enter all required fields
        
        // set expected behavior on dao
        context.checking(new Expectations() {{
            one(dao).save(with(same(person)));
        }});

        manager.save(person);
    }

    @Test
    public void testRemovePerson() {
        log.debug("testing remove...");

        final Long id = -11L;

        // set expected behavior on dao
        context.checking(new Expectations() {{
            one(dao).remove(with(equal(id)));
        }});

        manager.remove(id);
    }
}

package org.appfuse.tutorial.service.impl;

import org.appfuse.tutorial.dao.PersonDao;
import org.appfuse.tutorial.model.Person;
import org.appfuse.tutorial.service.PersonManager;
import org.appfuse.service.impl.GenericManagerImpl;

import java.util.List;

public class PersonManagerImpl extends GenericManagerImpl<Person, Long> implements PersonManager {
    PersonDao personDao;

    public PersonManagerImpl(PersonDao personDao) {
        super(personDao);
        this.personDao = personDao;
    }

    public List<Person> findByLastName(String lastName) {
        return personDao.findByLastName(lastName);
    }
}

import org.springframework.stereotype.Service;

@Service("personManager")
public class PersonManagerImpl extends GenericManagerImpl<Person, Long> implements PersonManager {

If you registered the personDao using the @Repository("personDao") annotation instead of src/main/webapp/WEB-INF/applicationContext.xml file you will need to auto-wire the PersonDao variable in the PersonManagerImpl class:

@Autowired
public PersonManagerImpl(PersonDao personDao) {
    super(personDao);
    this.personDao = personDao;
}

<bean id="personManager" class="org.appfuse.tutorial.service.impl.PersonManagerImpl">
    <constructor-arg ref="personDao"/>
</bean>

The Web application tutorials assume that you will be using the GenericManager. If you follow them after making this change, you will need to change all the references in their code from the GenericManager to your new PersonManager interface. For example:

@Autowired
private PersonManager personManager;

<dependencies>
    ...
    <dependency>
        <groupId>org.easymock</groupId>
        <artifactId>easymock</artifactId>
        <version>2.2</version>
        <scope>test</scope>
    </dependency>
</dependencies>

package org.appfuse.tutorial.service.impl;

import junit.framework.TestCase;
import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;
import org.appfuse.tutorial.dao.PersonDao;
import org.appfuse.tutorial.model.Person;
import org.appfuse.tutorial.service.impl.PersonManagerImpl;

import java.util.ArrayList;
import java.util.List;

import static org.easymock.EasyMock.*;

public class PersonManagerImplTest extends TestCase {
    private final Log log = LogFactory.getLog(PersonManagerImplTest.class);
    private PersonManagerImpl manager = null;
    private PersonDao dao = null;
    private Person person = null;

    protected void setUp() throws Exception {
        log.debug("setUpDao for PersonManagerImplTest");
        dao = createStrictMock(PersonDao.class);
        manager = new PersonManagerImpl((PersonDao) dao);
    }

    public void testGetPerson() {
        log.debug("testing getPerson");

        Long id = 7L;
        person = new Person();

        // set expected behavior on dao
        expect(dao.get(id)).andReturn(person);
        replay(dao);

        Person result = manager.get(id);
        assertSame(person, result);
        verify(dao);
    }

    public void testGetPersons() {
        log.debug("testing getPersons");

        List people = new ArrayList();

        // set expected behavior on dao
        expect(dao.getAll()).andReturn(people);
        replay(dao);

        List result = manager.getAll();
        assertSame(people, result);
        verify(dao);
    }

    public void testGetByLastName() {
        log.debug("testing getByLastName");

        List people = new ArrayList();
        String lastName = "Smith";

        // set expected behavior on dao
        expect(dao.findByLastName(lastName)).andReturn(people);
        replay(dao);

        List result = manager.findByLastName(lastName);
        assertSame(people, result);
        verify(dao);
    }

    public void testSavePerson() {
        log.debug("testing savePerson");

        person = new Person();

        // set expected behavior on dao
        expect(dao.save(person)).andReturn(person);
        replay(dao);

        manager.save(person);
        verify(dao);
    }

    public void testRemovePerson() {
        log.debug("testing removePerson");

        Long id = 11L;
        person = new Person();

        // set expected behavior on dao
        dao.remove(id);
        replay(dao);

        manager.remove(id);
        verify(dao);
    }
}