{"id":603,"date":"2011-10-26T09:22:00","date_gmt":"2011-10-26T09:22:00","guid":{"rendered":"http:\/\/www.javacodegeeks.com\/2012\/10\/spring-3-testing-with-junit-4-contextconfiguration-and-abstracttransactionaljunit4springcontexttests.html"},"modified":"2012-10-21T20:24:07","modified_gmt":"2012-10-21T20:24:07","slug":"spring-3-testing-with-junit-4","status":"publish","type":"post","link":"https:\/\/www.javacodegeeks.com\/2011\/10\/spring-3-testing-with-junit-4.html","title":{"rendered":"Spring 3 Testing with JUnit 4 – ContextConfiguration and AbstractTransactionalJUnit4SpringContextTests"},"content":{"rendered":"
Looking in the internet for a way to test my Spring 3 application, I found many articles that describe how to test your application by using JUnit. Most of them are incomplete examples that do not really work.<\/p>\n

With this article I will try to fill this gap and write a concise yet simple article on how to test a spring 3 application with Junit 4. Ta make it easier to read and go through, I will not use my application which is now quite big, but I will use the sample given from viralpatel<\/a>. The link to download the project is this<\/a>.<\/p>\n

Download this application and import it into eclipse.<\/p>\n

Execute the following in you db:<\/p>\n

create database contact;\r\nuse contact;\r\nCREATE TABLE CONTACTS\r\n(\r\n    id              INT PRIMARY KEY AUTO_INCREMENT,\r\n    firstname    VARCHAR(30),\r\n    lastname    VARCHAR(30),\r\n    telephone   VARCHAR(15),\r\n    email         VARCHAR(30),\r\n    created     TIMESTAMP DEFAULT NOW()\r\n);\r\n<\/pre>\n
Inside your pom.xml add the following dependencies:<\/p>\n
<dependency>\r\n <groupId>org.springframework.data<\/groupId>\r\n <artifactId>spring-data-jpa<\/artifactId>\r\n <version>1.0.1.RELEASE<\/version>\r\n<\/dependency>\r\n<dependency>\r\n <groupId>org.junit<\/groupId>\r\n <artifactId>com.springsource.org.junit<\/artifactId>\r\n <version>4.7.0<\/version>\r\n <scope>test<\/scope>\r\n<\/dependency>\r\n<dependency>\r\n <groupId>org.springframework<\/groupId>\r\n <artifactId>org.springframework.test<\/artifactId>\r\n <version>${org.springframework.version}<\/version>\r\n <scope>test<\/scope>\r\n<\/dependency>\r\n<dependency> <groupId>javax.transaction<\/groupId>\r\n <artifactId>com.springsource.javax.transaction<\/artifactId>\r\n <version>1.1.0<\/version>\r\n<\/dependency>\r\n<\/pre>\n
Also add the following for repositories:<\/p>\n
<repositories>\r\n <repository>\r\n  <id>com.springsource.repository.bundles.release<\/id>\r\n  <name>SpringSource Enterprise Bundle Repository - SpringSource Releases<\/name>\r\n  <url>http:\/\/repository.springsource.com\/maven\/bundles\/release<\/url>\r\n <\/repository>\r\n <repository>\r\n  <id>com.springsource.repository.bundles.external<\/id>\r\n  <name>SpringSource Enterprise Bundle Repository - External Releases<\/name>\r\n  <url>http:\/\/repository.springsource.com\/maven\/bundles\/external<\/url>\r\n <\/repository>\r\n <repository>\r\n  <id>com.springsource.repository.bundles.milestone<\/id>\r\n  <name>SpringSource Enterprise Bundle Repository - SpringSource Milestones<\/name>\r\n  <url>http:\/\/repository.springsource.com\/maven\/bundles\/milestone<\/url>\r\n <\/repository>\r\n <repository>\r\n  <id>com.springsource.repository.bundles.snapshot<\/id>\r\n  <name>SpringSource Enterprise Bundle Repository - Snapshot Releases<\/name>\r\n  <url>http:\/\/repository.springsource.com\/maven\/bundles\/snapshot<\/url>\r\n <\/repository>\r\n <repository>\r\n  <id>repository.springframework.maven.release<\/id>\r\n  <name>Spring Framework Maven Release Repository<\/name>\r\n  <url>http:\/\/maven.springframework.org\/release<\/url>\r\n <\/repository>\r\n <repository>\r\n  <id>repository.springframework.maven.milestone<\/id>\r\n  <name>Spring Framework Maven Milestone Repository<\/name>\r\n  <url>http:\/\/maven.springframework.org\/milestone<\/url>\r\n <\/repository>\r\n <repository>\r\n  <id>repository.springframework.maven.snapshot<\/id>\r\n  <name>Spring Framework Maven Snapshot Repository<\/name>\r\n  <url>http:\/\/maven.springframework.org\/snapshot<\/url>\r\n <\/repository>\r\n <repository>\r\n  <id>jboss<\/id>\r\n  <name>JBoss repository<\/name>\r\n  <url>https:\/\/repository.jboss.org\/nexus\/content\/repositories\/releases<\/url>\r\n <\/repository>\r\n<\/repositories>\r\n<\/pre>\n
Under the directory src\/test\/java create the following package:
\nnet.viralpatel.contact.form<\/span>
 
<\/div> <\/div><\/p>\n
Inside the package you just created create a class called:
\nAbstractContactTests<\/span><\/p>\n
Under src\/test\/resources create the following:
\nnet\/viralpatel\/contact\/form<\/span><\/p>\n
Inside there create the following file:
\nAbstractContactTests-context.xml<\/span><\/p>\n
Attention! Make sure that the directories, packages, classes and xml files are created exactly where mentioned above. You will see that the xml file takes the name of the test class plus \u201c-context.xml\u201d and that it is created under the same directory structure. This is important because spring automatically looks for the xml file with the specified name and also under the same directory.<\/p>\n
Now insert the following content in the AbstractContactTests class:<\/p>\n
package net.viralpatel.contact.form;\r\n\r\nimport net.viralpatel.contact.dao.ContactDAO;\r\nimport net.viralpatel.contact.service.ContactService;\r\nimport org.junit.Test;\r\nimport org.springframework.beans.factory.annotation.Autowired;\r\nimport org.springframework.test.context.ContextConfiguration;\r\nimport org.springframework.test.context.junit4.AbstractTransactionalJUnit4SpringContextTests;\r\n\r\n@ContextConfiguration\r\npublic class AbstractContactTests extends AbstractTransactionalJUnit4SpringContextTests {\r\n @Autowired\r\n protected ContactDAO contact;\r\n @Autowired\r\n protected ContactService contactService;\r\n @Test\r\n public void sampleTest(){\r\n   System.out.println(\"Number of rows is: \" + contactService.listContact().size());\r\n  System.out.println(\"Creating a new contact\");\r\n  Contact cont = new Contact();\r\n  cont.setEmail(\"giannis@gmail.com\");\r\n  cont.setLastname(\"ntantis\");\r\n  cont.setFirstname(\"ioannis\");\r\n  cont.setTelephone(\"00306985587996\");\r\n  System.out.println(\"Before saving contact\");\r\n  contactService.addContact(cont);\r\n  System.out.println(\"After saving contact. Id if contact is: \" + cont.getId());\r\n  System.out.println(\"Number of rows now is: \" + contactService.listContact().size());\r\n }\r\n}\r\n<\/pre>\n
The @ContextConfiguration<\/a> annotation tells spring how to load and configure the application context. We could also tell spring where it would explicitly find the file, e.g. :<\/p>\n
@ContextConfiguration(locations={\u201cexample\/test-context.xml\u201d}, loader=CustomContextLoader.class)<\/i><\/p>\n
By providing no parameters, spring will look for the xml file under the same directory as the package of the class, and for a file named class.name-context.xml (remember the HINT above).<\/p>\n
Pay attention that our class extends the AbstractTransactionalJUnit4SpringContextTests<\/a> from org.springframework.test.context.junit4. By extending this class, we give our methods transactional support at the class level. If we did not do this, and we wanted transactional support, we would have to either annotate our methods with @Transactional<\/a> or configure our transaction manager with the @TransactionConfiguration<\/a> annotation.<\/p>\n
Inside the AbstractContactTests-context.xml put the following content:<\/p>\n
<?xml version=\"1.0\" encoding=\"UTF-8\"?>\r\n<beans xmlns=\"http:\/\/www.springframework.org\/schema\/beans\" xmlns:xsi=\"http:\/\/www.w3.org\/2001\/XMLSchema-instance\"\r\n  xmlns:p=\"http:\/\/www.springframework.org\/schema\/p\"\r\n  xmlns:context=\"http:\/\/www.springframework.org\/schema\/context\"\r\n  xmlns:jdbc=\"http:\/\/www.springframework.org\/schema\/jdbc\"\r\n  xmlns:tx=\"http:\/\/www.springframework.org\/schema\/tx\"\r\n  xsi:schemaLocation=\"\r\n   http:\/\/www.springframework.org\/schema\/beans http:\/\/www.springframework.org\/schema\/beans\/spring-beans.xsd\r\n   http:\/\/www.springframework.org\/schema\/context http:\/\/www.springframework.org\/schema\/context\/spring-context.xsd\r\n   http:\/\/www.springframework.org\/schema\/jdbc http:\/\/www.springframework.org\/schema\/jdbc\/spring-jdbc.xsd\r\n   http:\/\/www.springframework.org\/schema\/tx http:\/\/www.springframework.org\/schema\/tx\/spring-tx.xsd\">\r\n <context:property-placeholder location=\"classpath:jdbc.properties\"\/>\r\n <context:annotation-config\/>\r\n <tx:annotation-driven\/>\r\n <bean id=\"dataSource\" class=\"org.apache.commons.dbcp.BasicDataSource\" destroy-method=\"close\"\r\n   p:driverClassName=\"com.mysql.jdbc.Driver\" p:url=\"jdbc:mysql:\/\/localhost:3306\/contact\"\r\n   p:username=\"root\" p:password=\"123456\"\/>\r\n <bean id=\"sessionFactory\"\r\n  class=\"org.springframework.orm.hibernate3.LocalSessionFactoryBean\">\r\n  <property name=\"dataSource\" ref=\"dataSource\" \/>\r\n  <property name=\"configLocation\">\r\n   <value>classpath:hibernate.cfg.xml<\/value>\r\n  <\/property>\r\n  <property name=\"configurationClass\">\r\n   <value>org.hibernate.cfg.AnnotationConfiguration<\/value>\r\n  <\/property>\r\n  <property name=\"hibernateProperties\">\r\n   <props>\r\n    <prop key=\"hibernate.dialect\">${jdbc.dialect}<\/prop>\r\n    <prop key=\"hibernate.show_sql\">true<\/prop>\r\n   <\/props>\r\n  <\/property>\r\n <\/bean>\r\n <bean id=\"transactionManager\" class=\"org.springframework.orm.hibernate3.HibernateTransactionManager\">\r\n  <property name=\"sessionFactory\" ref=\"sessionFactory\" \/>\r\n <\/bean>\r\n <bean id=\"contactDAO\" class=\"net.viralpatel.contact.dao.ContactDAOImpl\"><\/bean>\r\n <bean id=\"contactService\" class=\"net.viralpatel.contact.service.ContactServiceImpl\"><\/bean>\r\n<\/beans>\r\n<\/pre>\n
Inside here you will see many definitions which are defined in the spring-servlet.xml. In my example they are the same with spring-servlet.xml, but you could freely alter them. With this, Spring gives the opportunity to create a different data source for example, for the testing process, or even different data source for each test class.<\/p>\n
Now execute the AbstractContactTests class as a junit test. You should take the following output:<\/p>\n
Hibernate: select contact0_.ID as ID0_, contact0_.EMAIL as EMAIL0_, contact0_.FIRSTNAME as FIRSTNAME0_, contact0_.LASTNAME as LASTNAME0_, contact0_.TELEPHONE as TELEPHONE0_ from CONTACTS contact0_\r\nNumber of rows is: 0\r\nCreating a new contact\r\nBefore saving contact\r\nHibernate: insert into CONTACTS (EMAIL, FIRSTNAME, LASTNAME, TELEPHONE) values (?, ?, ?, ?)\r\nAfter saving contact. Id if contact is: 2\r\nHibernate: select contact0_.ID as ID0_, contact0_.EMAIL as EMAIL0_, contact0_.FIRSTNAME as FIRSTNAME0_, contact0_.LASTNAME as LASTNAME0_, contact0_.TELEPHONE as TELEPHONE0_ from CONTACTS contact0_\r\nNumber of rows now is: 1<\/code><\/pre>\n
Thats all you need folks. Happy coding and don’t forget to share! <\/p>\n
Reference: <\/i><\/strong>Spring 3 Testing with JUnit 4. Using @ContextConfiguration and AbstractTransactionalJUnit4SpringContextTests<\/a> from our JCG partner<\/a> Ioannis Ntantis at the Giannisapi blog<\/a>.<\/p>\n
Related Articles :<\/i><\/strong><\/div>\n