Close

Spring - Quick Concepts and Example

[Updated: Jan 28, 2017, Created: Nov 25, 2015]

What is Spring Framework?



  1. DI (Dependency Injection) : Instance of Service implementations are injected into a target Object's variable/field (where variable/field is ideally of an interface type) via Constructors/Setters instead of target Object creating the concrete implementations themselves. Hence, this approach enabled application objects being POJO which can be used in different environment and with different implementations of services.

  2. IOC (Inversion of Control) container: Framework code invokes application code during an operation and ask for application specific information instead of application calling the Framework code directly, hence control is inverted. An example of IOC is Template pattern via sub-classing. Spring IOC provides annotations based IOC as well.

  3. AOP (Aspect-Oriented Programming) : This allows separation of cross-cutting concerns by adding behaviors (aspects) to the application code instead of application involving into those concerns itself. This enables application to be modular instead of mixing different concerns to a single place. The examples are Transaction management, logging etc.

  4. Lightweight Alternative to Java EE : Spring is lightweight solution for building enterprise application using POJO. It can be used in servlet container (e.g. Tomcat server) and doesn't require an Application server.


What is Spring bean?

A bean is an object that is instantiated, assembled, and otherwise managed by a Spring IoC container. These beans are created with the configuration metadata that you supply to the container, for example, in the form of XML definitions.


Example

We are going to give a quick step by step example with concise explanations to demonstrate how a particular implementation of an interface can be injected to a client application using Spring Framework.


Creating Beans

public interface HelloWorldService {
    void sayHi(String name);
}

public class HelloWorldServiceImpl implements HelloWorldService {

    public void sayHi(String message) {
        System.out.println(message);
    }
}

public class HelloWorldServiceClient {

    @Autowired
    private HelloWorldService helloWorld;

    public void showMessage() {
        helloWorld.sayHi("Hello world!");
    }
}


What is @Autowired?

In above code, we used annotation @Autowired in class HelloWorldServiceClient. This annotation tells the Spring container where to perform dependency injection. We have to register instance of HelloWorldServiceClient as bean to make it happen. We also have to register HelloWorldSericeImpl as bean. Next we will see how we can do that by using @Configuration on Java config class.



Spring Configuration and Starting the Container

In this example, class AppRunner, is responsible for defining and wiring dependencies. In other words it's a Spring specific configuration class. Our example demonstrates Java-based Configuration which is the alternative to XML based configuration. The same class is also responsible for starting the Spring container from the main method.

@Configuration
public class AppRunner {

    @Bean
    public HelloWorldService createHelloWorldService() {
        return new HelloWorldSericeImpl();
    }

    @Bean
    public HelloWorldServiceClient createClient() {
        return new HelloWorldServiceClient();
    }

    public static void main(String... strings) {
        AnnotationConfigApplicationContext context =
                                new AnnotationConfigApplicationContext(AppRunner.class);
        HelloWorldServiceClient bean = context.getBean(HelloWorldServiceClient.class);
        bean.showMessage();
    }

}


The annotations @Configuration and @Bean

We used annotation @Configuration to tell the container that beans are defined in AppRunner. The methods which returns bean instances are annotated with @Bean, which is another directive for the container so that it will know what objects should be registered as beans.



What is AnnotationConfigApplicationContext?

This class implements ApplicationContext. The container gets its instructions on what objects to instantiate, configure, and assemble by reading configuration metadata.

In our example we passed our config java class to the AnnotationConfigApplicationContext constructor. This class implements AnnotationConfigRegistry as well, so it accepts annotated classes as input.

Once instantiated, a spring application context object represents runtime reference of the spring container. Using the context object we can access registered beans. It's read-only but can be refreshed/reloaded whenever needed.



Example Project

Dependencies and Technologies Used:

  • Spring Context 4.2.3.RELEASE: Spring Context.
  • JDK 1.8
  • Maven 3.0.4

Spring Quick Example Select All Download
  • spring-quick-example
    • src
      • main
        • java
          • com
            • logicbig
              • example
                • app
                • client
                • service
                  • impl

See Also