溫馨提示×

溫馨提示×

您好，登錄后才能下訂單哦！

密碼登錄×
登錄注冊×
獲取短信驗證碼
其他方式登錄
點擊 登錄注冊 即表示同意《億速云用戶服務條款》
登 錄 注冊有禮
云服務器 香港服務器 高防服務器
最新更新 網站標簽 地圖導航
產品

怎么搭建第一個Spring項目

發布時間：2021-11-20 16:39:48 來源：億速云 閱讀：173 作者：小新 欄目：大數據

怎么搭建第一個Spring項目

目錄

  1. 引言
  2. 環境準備
  3. 創建Spring項目
  4. 項目結構
  5. 編寫第一個控制器
  6. 配置數據庫連接
  7. 創建實體類和Repository
  8. 實現簡單的CRUD操作
  9. 測試API
  10. 部署項目
  11. 總結

引言

Spring框架是Java開發中最流行的框架之一，它提供了全面的基礎設施支持，使得開發者可以專注于業務邏輯的實現。Spring Boot進一步簡化了Spring應用的開發，通過自動配置和約定優于配置的原則，使得開發者可以快速搭建和運行Spring項目。

本文將詳細介紹如何從零開始搭建第一個Spring項目，涵蓋環境準備、項目創建、代碼編寫、測試和部署等各個環節。通過本文的學習，你將掌握Spring項目的基本開發流程，并能夠獨立完成一個簡單的Spring應用。

環境準備

在開始搭建Spring項目之前，首先需要準備好開發環境。以下是搭建Spring項目所需的基本環境配置。

Java開發環境

Spring項目是基于Java開發的，因此首先需要安裝Java開發工具包（JDK）。建議使用JDK 8或更高版本。

  1. 下載JDK：訪問Oracle官網或OpenJDK下載適合你操作系統的JDK版本。
  2. 安裝JDK：按照安裝向導完成JDK的安裝。
  3. 配置環境變量：
    • Windows：在系統環境變量中添加JAVA_HOME，指向JDK的安裝目錄，并在Path中添加%JAVA_HOME%\bin。
    • Linux/Mac：在~/.bashrc或~/.zshrc中添加以下內容： 
      
export JAVA_HOME=/path/to/jdk
export PATH=$JAVA_HOME/bin:$PATH
  4. 驗證安裝：打開終端或命令提示符，輸入java -version，如果顯示JDK版本信息，則說明安裝成功。

Maven安裝

Maven是Java項目的構建工具，Spring項目通常使用Maven來管理依賴和構建過程。

  1. 下載Maven：訪問Maven官網下載最新版本的Maven。
  2. 安裝Maven：
    • Windows：解壓下載的Maven壓縮包，并將解壓后的目錄添加到系統環境變量Path中。
    • Linux/Mac：解壓下載的Maven壓縮包，并在~/.bashrc或~/.zshrc中添加以下內容： 
      
export MAVEN_HOME=/path/to/maven
export PATH=$MAVEN_HOME/bin:$PATH
  3. 驗證安裝：打開終端或命令提示符，輸入mvn -v，如果顯示Maven版本信息，則說明安裝成功。

IDE選擇

集成開發環境（IDE）可以大大提高開發效率。常用的Java IDE有IntelliJ IDEA、Eclipse和VS Code等。本文推薦使用IntelliJ IDEA，因為它對Spring Boot的支持非常友好。

  1. 下載IntelliJ IDEA：訪問JetBrains官網下載適合你操作系統的IntelliJ IDEA版本。
  2. 安裝IntelliJ IDEA：按照安裝向導完成IntelliJ IDEA的安裝。
  3. 配置Maven：在IntelliJ IDEA中，打開File -> Settings -> Build, Execution, Deployment -> Build Tools -> Maven，確保Maven的路徑配置正確。

創建Spring項目

Spring項目的創建可以通過多種方式實現，本文將介紹兩種常見的方法：使用Spring Initializr和手動配置Maven項目。

使用Spring Initializr

Spring Initializr是一個在線工具，可以幫助你快速生成Spring Boot項目的基本結構。

  1. 訪問Spring Initializr：打開瀏覽器，訪問Spring Initializr。
  2. 配置項目：
    • Project：選擇Maven Project。
    • Language：選擇Java。
    • Spring Boot：選擇最新的穩定版本。
    • Project Metadata：填寫Group、Artifact、Name、Description等信息。
    • Dependencies：添加Spring Web、Spring Data JPA、H2 Database等依賴。
  3. 生成項目：點擊Generate按鈕，下載生成的項目壓縮包。
  4. 導入項目：解壓下載的壓縮包，并使用IntelliJ IDEA打開項目。

手動配置Maven項目

如果你更喜歡手動配置項目，可以按照以下步驟創建一個Maven項目。

  1. 創建Maven項目：
    • 打開IntelliJ IDEA，選擇File -> New -> Project。
    • 選擇Maven，點擊Next。
    • 填寫GroupId、ArtifactId、Version等信息，點擊Next。
    • 選擇項目存儲路徑，點擊Finish。
  2. 配置pom.xml：
    • 打開pom.xml文件，添加Spring Boot的父依賴： 
      
<parent>
 <groupId>org.springframework.boot</groupId>
 <artifactId>spring-boot-starter-parent</artifactId>
 <version>2.5.4</version>
 <relativePath/> <!-- lookup parent from repository -->
</parent>
    • 添加Spring Boot的起步依賴： 
      
<dependencies>
 <dependency>
     <groupId>org.springframework.boot</groupId>
     <artifactId>spring-boot-starter-web</artifactId>
 </dependency>
 <dependency>
     <groupId>org.springframework.boot</groupId>
     <artifactId>spring-boot-starter-data-jpa</artifactId>
 </dependency>
 <dependency>
     <groupId>com.h2database</groupId>
     <artifactId>h2</artifactId>
     <scope>runtime</scope>
 </dependency>
</dependencies>
    • 添加Maven插件： 
      
<build>
 <plugins>
     <plugin>
         <groupId>org.springframework.boot</groupId>
         <artifactId>spring-boot-maven-plugin</artifactId>
     </plugin>
 </plugins>
</build>

項目結構

Spring Boot項目的結構相對固定，以下是一個典型的Spring Boot項目結構。

主要目錄和文件

  • src/main/java：Java源代碼目錄。
  • src/main/resources：資源文件目錄，包括配置文件、靜態資源等。
  • src/test/java：測試代碼目錄。
  • pom.xml：Maven項目的配置文件。

Spring Boot主類

Spring Boot項目的入口是一個帶有@SpringBootApplication注解的主類。

package com.example.demo;

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

@SpringBootApplication
public class DemoApplication {

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

}

編寫第一個控制器

在Spring Boot中，控制器（Controller）負責處理HTTP請求并返回響應。下面我們將創建一個簡單的控制器。

創建Controller類

  1. 在src/main/java/com/example/demo目錄下創建一個新的包controller。
  2. 在controller包中創建一個新的類HelloController。
package com.example.demo.controller;

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
@RequestMapping("/api")
public class HelloController {

    @GetMapping("/hello")
    public String sayHello() {
        return "Hello, Spring Boot!";
    }

}

運行項目

  1. 在IntelliJ IDEA中，右鍵點擊DemoApplication類，選擇Run 'DemoApplication'。
  2. 打開瀏覽器，訪問http://localhost:8080/api/hello，你將看到頁面顯示Hello, Spring Boot!。

配置數據庫連接

在實際開發中，數據庫是必不可少的。Spring Boot支持多種數據庫，本文將使用H2內存數據庫作為示例。

添加數據庫依賴

在pom.xml中，我們已經添加了spring-boot-starter-data-jpa和h2依賴。

配置數據源

在src/main/resources/application.properties文件中，添加以下配置：

spring.datasource.url=jdbc:h2:mem:testdb
spring.datasource.driverClassName=org.h2.Driver
spring.datasource.username=sa
spring.datasource.password=password
spring.jpa.database-platform=org.hibernate.dialect.H2Dialect
spring.h2.console.enabled=true

創建實體類和Repository

在Spring Data JPA中，實體類（Entity）對應數據庫中的表，Repository接口用于操作數據庫。

定義實體類

  1. 在src/main/java/com/example/demo目錄下創建一個新的包entity。
  2. 在entity包中創建一個新的類User。
package com.example.demo.entity;

import javax.persistence.Entity;
import javax.persistence.GeneratedValue;
import javax.persistence.GenerationType;
import javax.persistence.Id;

@Entity
public class User {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    private String name;
    private String email;

    // Getters and Setters
}

創建Repository接口

  1. 在src/main/java/com/example/demo目錄下創建一個新的包repository。
  2. 在repository包中創建一個新的接口UserRepository。
package com.example.demo.repository;

import com.example.demo.entity.User;
import org.springframework.data.jpa.repository.JpaRepository;

public interface UserRepository extends JpaRepository<User, Long> {
}

實現簡單的CRUD操作

在Spring Boot中，通常將業務邏輯放在Service層，Controller層負責處理HTTP請求。

創建Service層

  1. 在src/main/java/com/example/demo目錄下創建一個新的包service。
  2. 在service包中創建一個新的類UserService。
package com.example.demo.service;

import com.example.demo.entity.User;
import com.example.demo.repository.UserRepository;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

import java.util.List;
import java.util.Optional;

@Service
public class UserService {

    @Autowired
    private UserRepository userRepository;

    public List<User> getAllUsers() {
        return userRepository.findAll();
    }

    public Optional<User> getUserById(Long id) {
        return userRepository.findById(id);
    }

    public User createUser(User user) {
        return userRepository.save(user);
    }

    public User updateUser(Long id, User userDetails) {
        User user = userRepository.findById(id).orElseThrow(() -> new RuntimeException("User not found"));
        user.setName(userDetails.getName());
        user.setEmail(userDetails.getEmail());
        return userRepository.save(user);
    }

    public void deleteUser(Long id) {
        userRepository.deleteById(id);
    }
}

編寫Controller方法

  1. 在controller包中創建一個新的類UserController。
package com.example.demo.controller;

import com.example.demo.entity.User;
import com.example.demo.service.UserService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;

import java.util.List;
import java.util.Optional;

@RestController
@RequestMapping("/api/users")
public class UserController {

    @Autowired
    private UserService userService;

    @GetMapping
    public List<User> getAllUsers() {
        return userService.getAllUsers();
    }

    @GetMapping("/{id}")
    public Optional<User> getUserById(@PathVariable Long id) {
        return userService.getUserById(id);
    }

    @PostMapping
    public User createUser(@RequestBody User user) {
        return userService.createUser(user);
    }

    @PutMapping("/{id}")
    public User updateUser(@PathVariable Long id, @RequestBody User userDetails) {
        return userService.updateUser(id, userDetails);
    }

    @DeleteMapping("/{id}")
    public void deleteUser(@PathVariable Long id) {
        userService.deleteUser(id);
    }
}

測試API

在開發過程中，測試是非常重要的環節。本文將介紹如何使用Postman進行API測試，并編寫簡單的單元測試。

使用Postman測試

  1. 啟動項目：在IntelliJ IDEA中運行DemoApplication。
  2. 打開Postman：下載并安裝Postman。
  3. 測試API：
    • GET /api/users：獲取所有用戶。
    • GET /api/users/{id}：根據ID獲取用戶。
    • POST /api/users：創建新用戶。
    • PUT /api/users/{id}：更新用戶信息。
    • DELETE /api/users/{id}：刪除用戶。

單元測試

  1. 在src/test/java/com/example/demo目錄下創建一個新的包controller。
  2. 在controller包中創建一個新的類UserControllerTest。
package com.example.demo.controller;

import com.example.demo.entity.User;
import com.example.demo.service.UserService;
import org.junit.jupiter.api.Test;
import org.mockito.Mockito;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.autoconfigure.web.servlet.WebMvcTest;
import org.springframework.boot.test.mock.mockito.MockBean;
import org.springframework.test.web.servlet.MockMvc;

import java.util.Arrays;
import java.util.Optional;

import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.*;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.*;

@WebMvcTest(UserController.class)
public class UserControllerTest {

    @Autowired
    private MockMvc mockMvc;

    @MockBean
    private UserService userService;

    @Test
    public void testGetAllUsers() throws Exception {
        User user = new User();
        user.setId(1L);
        user.setName("John Doe");
        user.setEmail("john.doe@example.com");

        Mockito.when(userService.getAllUsers()).thenReturn(Arrays.asList(user));

        mockMvc.perform(get("/api/users"))
                .andExpect(status().isOk())
                .andExpect(jsonPath("$[0].name").value("John Doe"));
    }

    @Test
    public void testGetUserById() throws Exception {
        User user = new User();
        user.setId(1L);
        user.setName("John Doe");
        user.setEmail("john.doe@example.com");

        Mockito.when(userService.getUserById(1L)).thenReturn(Optional.of(user));

        mockMvc.perform(get("/api/users/1"))
                .andExpect(status().isOk())
                .andExpect(jsonPath("$.name").value("John Doe"));
    }

    @Test
    public void testCreateUser() throws Exception {
        User user = new User();
        user.setId(1L);
        user.setName("John Doe");
        user.setEmail("john.doe@example.com");

        Mockito.when(userService.createUser(Mockito.any(User.class))).thenReturn(user);

        mockMvc.perform(post("/api/users")
                .contentType("application/json")
                .content("{\"name\":\"John Doe\",\"email\":\"john.doe@example.com\"}"))
                .andExpect(status().isOk())
                .andExpect(jsonPath("$.name").value("John Doe"));
    }

    @Test
    public void testUpdateUser() throws Exception {
        User user = new User();
        user.setId(1L);
        user.setName("John Doe");
        user.setEmail("john.doe@example.com");

        Mockito.when(userService.updateUser(Mockito.anyLong(), Mockito.any(User.class))).thenReturn(user);

        mockMvc.perform(put("/api/users/1")
                .contentType("application/json")
                .content("{\"name\":\"John Doe\",\"email\":\"john.doe@example.com\"}"))
                .andExpect(status().isOk())
                .andExpect(jsonPath("$.name").value("John Doe"));
    }

    @Test
    public void testDeleteUser() throws Exception {
        mockMvc.perform(delete("/api/users/1"))
                .andExpect(status().isOk());
    }
}

部署項目

在開發完成后，通常需要將項目部署到服務器上。Spring Boot項目可以打包為可執行的JAR文件，方便部署。

打包應用

  1. 使用Maven打包：在項目根目錄下運行以下命令： 
    
mvn clean package
  2. 查看打包結果：打包完成后，在target目錄下會生成一個demo-0.0.1-SNAPSHOT.jar文件。

部署到服務器

  1. 上傳JAR文件：將生成的JAR文件上傳到服務器。
  2. 運行應用：在服務器上運行以下命令啟動應用： 
    
java -jar demo-0.0.1-SNAPSHOT.jar
  3. 訪問應用：在瀏覽器中訪問http://服務器IP:8080/api/hello，驗證應用是否正常運行。

總結

通過本文的學習，你已經掌握了如何從零開始搭建一個Spring Boot項目。從環境準備、項目創建、代碼

向AI問一下細節
推薦閱讀：
  1. 構建微服務：快速搭建Spring Boot項目
  2. 基于IDEA，Eclipse搭建Spring Boot項目過程圖解

免責聲明：本站發布的內容（圖片、視頻和文字）以原創、轉載和分享為主，文章觀點不代表本網站立場，如果涉及侵權請聯系站長郵箱：is@yisu.com進行舉報，并提供相關證據，一經查實，將立刻刪除涉嫌侵權內容。

spring

猜你喜歡

最新資訊
相關推薦

相關標簽

springboot springmvc+mybatis springcloud gateway spring+springmvc+mybatis spring-boot-plus spring cloud alibaba spring boot 2.x 實戰教程 spring tool suit springfox spring cloud config spring cloud stream springdataredis spring-retry springcache spring batch spring-kafka springboot2.x Spring-IOC SpringBootAdmin spring-boot-devtools
AI
助
手
產品服務
地區劃分
專題活動
幫助支持
關于我們
售后咨詢
7*24小時在線電話：400-100-2938
7*24小時在線 QQ：800811969
關注億速云

億速云公眾號

手機網站二維碼

Copyright ? Yisu Cloud Ltd. All Rights Reserved. 2018 版權所有

廣州億速云計算有限公司粵ICP備17096448號-1 粵公網安備 44010402001142號增值電信業務經營許可證編號：B1-20181529

亚洲午夜精品一区二区_中文无码日韩欧免_久久香蕉精品视频_欧美主播一区二区三区美女