Skip to main content

RADUS#2 - Important classes and Annotations


Once we extract the project into our IDE you'll notice couple of classes already created. Let's focus on one of the important class called Application class, which does all the magic to run your spring boot application

package com.artifactsbyrake.restdemo;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class RestdemoApplication {

	public static void main(String[] args) {
		SpringApplication.run(RestdemoApplication.class, args);
	}

}

  • Notice the main method in the above class which is used to launch the spring application
  • Also pay attention to the annotation "@SpringBootApplication", this is used to identify the Application class in spring boot

What does spring boot do when it runs the app?

To run an application, spring does the following things on application start-up:

  • Create's instance of Spring's ApplicationContext
  • Spring loads multiple beans that are needed as per configuration
  • Enables functionality to accept command-line args and expose them as spring properties

@SpringBootApplication

Here's a small snippet of code you can see when you expand @SpringBootApplication annotation:

@SpringBootConfiguration
@EnableAutoConfiguration
@ComponentScan(excludeFilters = { @Filter(type = FilterType.CUSTOM, classes = TypeExcludeFilter.class),
		@Filter(type = FilterType.CUSTOM, classes = AutoConfigurationExcludeFilter.class) })
public @interface SpringBootApplication {

Understanding the functionality provided by these annotations will help us understand inner workings of spring boot much better:
  • @SpringBootConfiguration
    • There should be only one annotation like this in entire application and most applications we develop inherit from @SpringBootApplication
    • This annotation indicates that a class provides context configuration
  • @EnableAutoConfiguration
    • Auto-configuration is one of the powerful features of spring boot framework
    • At a high level, whenever you add a dependency you'll get certain jar's added to your classpath. Using these jars present in the classpath, spring boot will try to guess and configure beans that you'll likely need.
    • For example here are few dependencies and beans that'll be configured
      1. Dependency: spring-boot-starter-web
        • Beans configured:
          • DispatcherServlet
          • CharacterEncodingFilter
          • BeanNameHandlerMapping
          • BasicErrorController
          • HandlerExceptionResolver
      2. Dependency: spring-boot-starter-data-jpa
        • Beans configured:
          • LocalContainerEntityManagerFactoryBean
          • JpaTransactionManager
    • "spring-boot-autoconfigure-{version}.jar" is the jar that provides support for spring boot auto-configuration
  • @ComponentScan
    • Enables scanning of spring beans in the package of current class and all it's sub-packages

There are many annotations provided by spring that we'll leverage while building REST API's i'll try to talk about them here once we get to use them.

Happy Coding  👨‍💻









 

Comments

Popular posts from this blog

Spring Boot - RestTemplate PATCH request fix

  In Spring Boot, you make a simple http request as below: 1. Define RestTemplate bean @Bean public RestTemplate restTemplate () { return new RestTemplate (); } 2. Autowire RestTemplate wherever you need to make Http calls @Autowire private RestTemplate restTemplate ; 3. Use auto-wired RestTemplate to make the Http call restTemplate . exchange ( "http://localhost:8080/users" , HttpMethod . POST , httpEntity , String . class ); Above setup works fine for all Http calls except PATCH. The following exception occurs if you try to make a PATCH request as above Exception: I / O error on PATCH request for \ "http://localhost:8080/users\" : Invalid HTTP method: PATCH ; nested exception is java . net . ProtocolException : Invalid HTTP method: PATCH Cause: Above exception happens because of the HttpURLConnection used by default in Spring Boot RestTemplate which is provided by the standard JDK HTTP library. More on this at this  bug Fix: This can b...

Settings.xml for Maven, JFrog

For development and deployment of applications we always use an artifactory in real-time world to host artifacts needed for your build and also as a target to deploy artifacts generated in the build process. For Maven, to communicate with artifactory we need a settings.xml file which is usually located at "/User/rake/.m2/settings.xml" this file consists of how to authenticate to the artifactory servers and authorizations to read/ write to different locations like release, snapshots e.t.c... Settings.xml can be generated using the artifactory you're using which in my case is JFrog , but here's a sample settings file for your reference incase you're feeling lazy☺ <?xml version="1.0" encoding="UTF-8"?> <settings xsi:schemaLocation= "http://maven.apache.org/SETTINGS/1.1.0 http://maven.apache.org/xsd/settings-1.1.0.xsd" xmlns= "http://maven.apache.org/SETTINGS/1.1.0" xmlns:xsi= "http://www.w3.org/2001/XM...

Stored Procedures in ADF

One of the common requirements for ADF programmers is to invoke Stored Procedures and Functions. Implementing this is so simple with few lines of code in Java classes used under business components. Following code snippets from fusion guide  will help execute different procedures with and without arguments. Execute stored procedure with No Arguments: public void callProcWithNoArgs() { getDBTransaction().executeCommand( "begin devguidepkg.proc_with_no_args; end;"); } Execute stored procedure with only IN arguments: Procedures often take arguments in order to process some business logic. Arguments are limited from none to many. In order to use stored procedures with argument mode we need to use JDBC PreparedStatement object. How To: Create connection Create a JDBC PreparedStatement with procedure details wrapped in a PL/SQL begin..end block. Assign the values to arguments if any. Execute the statement. Close the statement. protected void callStoredPr...