Getting Started with Spring Boot: Setting Up Your First Project in Eclipse IDE
2 min readMay 21, 2024
Prerequisites
- Eclipse IDE: Ensure you have Eclipse IDE installed. The “Eclipse IDE for Java Developers” package is recommended.
- JDK: Ensure you have JDK 8 or higher installed.
- Spring Tool Suite (STS) Plugin: Install the Spring Tools (STS) plugin in Eclipse for easier Spring development.
Steps to Create and Set Up a Spring Boot Project
1. Install Eclipse IDE and JDK
- Download and install the latest version of Eclipse IDE from the Eclipse website.
- Download and install JDK from the Oracle website.
2. Install the Spring Tools (STS) Plugin in Eclipse
- Open Eclipse IDE.
- Go to Help -> Eclipse Marketplace.
- In the search box, type “Spring Tools” and press Enter.
- Find “Spring Tools (aka Spring IDE and Spring Tool Suite)” in the list and click Install.
- Follow the installation steps and restart Eclipse.
3. Create a New Spring Boot Project
- Open Eclipse IDE.
- Go to File -> New -> Other.
- In the wizard, expand Spring Boot and select Spring Starter Project. Click Next.
- Fill in the project details:
- Name: Enter a name for your project.
- Type: Choose Maven Project (default).
- Packaging: Select Jar.
- Java Version: Select the JDK version you installed.
- Click Next.
4. Configure Project Dependencies
In the dependencies selection screen, choose the dependencies you need. Common choices include:
- Spring Web: For building web applications.
- Spring Data JPA: For working with JPA-based repositories.
- H2 Database: For using an in-memory database.
- Spring Boot DevTools: For easier development with auto-restart.
- After selecting the dependencies, click Next and then Finish.
5. Explore the Generated Project
- Once the project is created, you’ll see a typical Maven project structure in the Project Explorer:
- src/main/java: Contains your Java source files.
- src/main/resources: Contains application properties and other resources.
- pom.xml: Maven configuration file where dependencies are managed.
6. Modify application.properties
- Navigate to src/main/resources and open
application.properties
. - Add any necessary configurations. For example, to configure an H2 database:
spring.datasource.url=jdbc:h2:mem:testdb spring.datasource.driverClassName=org.h2.Driver spring.datasource.username=sa spring.datasource.password= spring.jpa.database-platform=org.hibernate.dialect.H2Dialect
7. Create a Simple REST Controller
- In the src/main/java folder, create a package and a new Java class:
package com.example.demo; import org.springframework.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.RestController; @RestController public class HelloController { @GetMapping("/hello") public String sayHello() { return "Hello, World!"; } }
8. Run the Spring Boot Application
- Open the DemoApplication.java file (located in the root package) and run it as a Java application.
- Right-click on the file -> Run As -> Java Application.
The application will start, and you should see logs indicating the embedded Tomcat server is running.
9. Test Your Application
- Open a web browser or a tool like Postman.
- Navigate to
http://localhost:8080/hello
. - You should see the message “Hello, World!”.
Conclusion
You’ve successfully created and set up a Spring Boot project in Eclipse IDE. From here, you can expand your project by adding more controllers, services, repositories, and other components as needed.