Beginner's Guide to Spring Framework

Beginning of Spring Part - 1 Author: Santosh Kumar Kar santosh.bsil@yahoo.co.in

Who This Tutor Is For? This tutor is for them who just start learning Springs. After going through this session, you will have the basic understandings of Spring Framework. You will able to write small applications using Spring. Also you can understand other complicated Spring projects after going through this session. I would suggest you to refer other good Spring books and tutors to understand Springs in depth. Remember, you can understand only the basics of Springs through this tutor which will be helpful to go depth into Springs. You can also download the source code of the examples from Download Links available at http://springs-download.blogspot.com/ Good Luck… Santosh

Introduction: In many books or sites, you will find about Spring that Spring supports inversion of control (IOC) and that it is a lightweight framework. You might be confused, what is inversion of control (IOC)? What is the purpose of using IOC? Why this feature is desirable?

Course Contents ,[object Object]

Understanding ApplicationContextand method getBean("<BEAN NAME>")

ApplicationContext in Different Applications/java Frameworks

new FileSystemXmlApplicationContext

Using new ClassPathXmlApplicationContext

Using new XmlWebApplicationContext

Using WebApplicationContextUtils.getWebApplicationContext(ServletContext),[object Object]

Problem: There is a well known car racing computer game –NeedForSpeed. I have taken this example because most of us had played this game. You can Google if you want to know about this game ;)… In this game, there are the participants use varieties of cars, such as Ferrari Jaguar McLaren Ford Each type of car do have their own specifications say grip, accelerator, speed etc. Now let’s write a program for this game. There will be 1 generic class having common behavior. All the above different cars must inherit the common behavior of this generic class. We will name the generic class as:- NeedForSpeedCar which should be an interface. Other car classes such as Ferrari, Jaguar, McLaren, Fordetc. must implement that interface.

The generic class which contains the declaration of the common behavior of all the cars. This is NeedForSpeedCar.java //NeedForSpeedCar.java package spring.test.santosh.game; public interface NeedForSpeedCar{ String startEngine(); String accelerate(); } Now we do have variety of cars. The specification of Ferrari is different from Jaguar and McLaren. Similarly McLaren specification is different from other cars. So each variety of car do have it's own implementaton. So let's see the implementation of those cars.

//Ferrari.java package spring.test.santosh.game; public class Ferrari implements NeedForSpeedCar{ public String startEngine(){ return ("Start engine of your Ferrari Car"); } public String accelerate(){ return ("Accelerate and run fast your Ferrari Car"); } } //Jaguar.java package spring.test.santosh.game; public class Jaguar implements NeedForSpeedCar{ public String startEngine(){ return ("Start engine of your Jaguar Car"); } public String accelerate(){ return ("Accelerate and run fast your Jaguar Car"); } }

//McLaren.java package spring.test.santosh.game; public class McLaren implements NeedForSpeedCar{ public String startEngine(){ return ("Start engine of your McLaren Car"); } public String accelerate(){ return ("Accelerate and run fast your McLaren Car"); } } //Ford.java package spring.test.santosh.game; public class Ford implements NeedForSpeedCar{ public String startEngine(){ return ("Start engine of your Ford Car"); } public String accelerate(){ return ("Accelerate and run fast your Ford Car"); } }

The Race is going to be started. So let’s write that class… //Race.java package spring.test.santosh.game; public class Race{ public void startRace(){ //You choose your car-Ferrari NeedForSpeedCarmyracingcar= new Ferrari(); System.out.println(myracingcar.startEngine()); System.out.println(myracingcar.accelerate()); } } class Race has a dependency to class Ferrari The class Race has a dependency to class Ferrari. Now the car modules are ready. The race is ready. Let’s ask the Participant to start the race. The participant is ready to use Ferrari.

// Participant.java package spring.test.santosh.game; public class Participant{ public static void main(){ //You choose your car-Ferrari Racerace = new Race(); race.startRace(); } } Compile all the programs. And run Participant. The output would be: Now it looks pretty good. The Participant run the car Ferrari. See the next slide for what is the problem here…………………………………………

The participant wants to use the another car: McLaren McLaren is best for grip so he chosed this car for the race. But hey… Ohhhhnooooooooooo.... It's not really pretty good because of the Problem here is:the object of new Ferrari is hard coded. So to use McLaren, it should be: NeedForSpeedCarmyracingcar = new Ferrari(); NeedForSpeedCarmyracingcar = new McLaren(); So at any instance the participant wants to choose another car, it needs the code change in Race.java. If the participant wants to change to Fordfrom McLaren, then it must be: NeedForSpeedCarmyracingcar = new McLaren(); NeedForSpeedCarmyracingcar = new Ford();

Solution: So, what do you think, what could be the solution???? Can you change the program as per the participant’s requirement? Think a while before going down for the solution… How is it if the object of your racing cars provide from outside but not in the class itself? That is NeedForSpeedCarmyracingcar= <get from outside> This will be known as the dependency Injection (IOC) Yes, it's a good approach. But who will create the object and who can provide the dependency injection to the class Race and how? The answer is the IOC container provided in Sprint framework. The dependency injection will be provided through ,[object Object]

asetter MethodSo let’s restructure the classes. You need to follow few steps to work with Spring IOC.

Step 1: Add property for the object you need to inject and write setter method. //Race.java package spring.test.santosh.game; public class Race{ NeedForSpeedCarmyracingcar; public void setMyracingcar(NeedForSpeedCarmyracingcar){ this.myracingcar= myracingcar; } public void startRace(){ //You don’t create the object of any car type//NeedForSpeedCarmyracingcar = new Ferrari(); System.out.println(myracingcar.startEngine()); System.out.println(myracingcar.accelerate()); } } Newly added. Through the setter method the object will be injected into Race class. Now we need Spring Framework to provide the Dependent Injection into the class Race. So to use Spring, download the Spring Framework from http://www.springsource.org/download After you download set the library files into the classpath.

Step 2: Create the Spring Configuration XML file. This will contain the entries for the dependency injection. The object will be referred as a bean. We can give any name for this XML. Here we will name as: SpringConfig.xml <!DOCTYPE beans PUBLIC "-//SPRING//DTD BEAN//EN" "http://www.springframework.org/dtd/spring-beans.dtd"> <beans> <bean id="race" class="spring.test.santosh.game.Race"> <property name="myracingcar"> <ref local="ferrari"/> </property> </bean> <bean id="ferrari" class="spring.test.santosh.game.Ferrari" /> <bean id="ford" class="spring.test.santosh.game.Ford" /> <bean id="mclaren" class="spring.test.santosh.game.McLaren" /> <bean id="jaguar" class="spring.test.santosh.game.Jaguar" /> </beans> myracingcar is the property in Race.java. Through the setter method the object is injected into Race.java You can change the ref as per the car chosen by the participant from the below bean id list. These are the objects injected dynamically. The objects are created by IOC container and injected into Race.java

Step 3: Write the client. It must use the config springconfig.xml. packagespring.test.santosh.race.game; importorg.springframework.context.ApplicationContext; import org.springframework.context.support.FileSystemXmlApplicationContext; publicclassParticipant{ publicstaticvoid main(String args[]){ ApplicationContextctx = newFileSystemXmlApplicationContext("springconfig.xml"); Race race = (Race) ctx.getBean("race"); race.startRace(); } } The instance of Ferrari will be created. Now run Driver and see the output…

Now we will change the springconfig.xml to choose McLaren car instead of Ferrari. We will not touch any of the java file… And we will see the output after that… <!DOCTYPE beans PUBLIC "-//SPRING//DTD BEAN//EN" "http://www.springframework.org/dtd/spring-beans.dtd"> <beans> <bean id="race" class="spring.test.santosh.game.Race"> <property name="myracingcar"> <ref local="mclaren"/> </property> </bean> <bean id="ferrari" class="spring.test.santosh.game.Ferrari" /> <bean id="ford" class="spring.test.santosh.game.Ford" /> <bean id="mclaren" class="spring.test.santosh.game.McLaren" /> <bean id="jaguar" class="spring.test.santosh.game.Jaguar" /> </beans> Now ref is changed to "mclaren" from "ferrari". Output after you runDriver.class

To download the source code project for this example, you can choose the link*: NeedForSpeed.zip (Standalone Application) *athttp://springs-download.blogspot.com

Understanding ApplicationContextandmethodgetBean("<BEAN NAME>") I believe you now understand what is IOC and how we can use the Dependency Injection in Springs to make java classes/components independent as possible of other java classes. Now let’s see more on the ApplicationContext and the method getBean("...") in ApplicationContext. ApplicationContextis the central interface to provide configuration for an application in springs. An ApplicationContext provides: ,[object Object]

Bean factory methods for accessing application components.And many more… Now we will see how ApplicationContext is used to load the file resources. Here we are loading the Spring Config file -springconfig.xml

new FileSystemXmlApplicationContext //Partifipant.java public class Participant{ public static void main(String args[]){ ApplicationContextctx = new FileSystemXmlApplicationContext("springconfig.xml"); Race race = (Race) ctx.getBean("race"); race.startRace(); } } ApplicationContextctx = new FileSystemXmlApplicationContext("springconfig.xml") The Application Context object: ,[object Object]

collects all the bean id’s as defined in springconfig.xml. Say: race, ferrari, ford, McLaren.

saves the instances of each bean class into Map with key as the bean id such as:,[object Object]

ApplicationContextinDifferent Applications/java Frameworks Till now we learned how we configure the Spring IOC (Independent Injection) by configuring the XML configuration file. So in the example you can notice the below line in Participant.java: ApplicationContextctx = newFileSystemXmlApplicationContext("springconfig.xml"); Here we are creating the object of FileSystemXMLApplicationContext by providing the XML name as argument. Our application is a stand-alone application and so simply we could use new FileSystemXMLApplicaitonContext(<XML file path>). Also this class constructor is helpful to create the Spring application context for test harness or unit testing. But there are different applications say Web application such as servlets/jsp's, Enterpriseapplications such as EJBs with Java Frameworks such as Struts, JSF etc. So in this section we will see how we can configure Springs IOC and how we will get the ApplicationContext in client.

Servlet andSprings I hope you are good in writing the Servlet and JSP application. So here I am not going to put how to build the servlet application and deploy it in the server. Just recall the directory structure in your servlet project: Now we will see where we can store our spring config XML file and how it could be accessible in the servlet classes. Note: It is very important that you don’t be confused this example with Springs MVC. We will see the Spring MVC latter. So now you concentrate how you will get the Spring ApplicationContext object in Servlet.

Achieving Springs Application Context in Servlet You can get the ApplicationContext of Spring in Servlet in 3 ways: Through new ClassPathXmlApplicationContext("<relative path of config XML>") Through new XmlWebApplicationContext() Through WebApplicationContextUtils.getWebApplicationContext(ServletContext);

Using ClassPathXmlApplicationContext The ClassPathXmlApplicationContextconstructor searches the given XML file from the classes folder in WEB-INF folder. Just you need to follow some basic steps. step 1: Create the spring config XML file. step 2: Name that file whatever you want. For example, in our example we named as: myspringconfig.xml step 3: Put this xml file in WEB-INF/classes folder while youare deploying. (If you use any editor like Eclipse, just put the XML in src folder, so when you build your project, it will automatically generate the same copy of XML along with the .class files in WEB-INF/classes folder.) Step 4: In servlet you can simply create the object of ClassPathXmlApplicationContextby passing the file relative path in constructor. E.g. ApplicatonContextctx = new ClassPathXmlApplicationContext("spring/test/santosh/config/myspringconfig.xml"); Herespring.test.santosh.configis a package created and stored the myspringconfig.xmlin this package. Let’s see the servlet example.

Let’s convert the same stand-alone application into servlet application by very minimum changes. ,[object Object]

Beginner's Guide to Spring Framework

Empfohlen

Empfohlen

Weitere ähnliche Inhalte

Andere mochten auch

Andere mochten auch (18)

Ähnlich wie Beginner's Guide to Spring Framework

Ähnlich wie Beginner's Guide to Spring Framework (20)

Mehr von Santosh Kumar Kar

Mehr von Santosh Kumar Kar (7)

Kürzlich hochgeladen

Kürzlich hochgeladen (20)

Beginner's Guide to Spring Framework