跟着振锁撸全栈之JAVA入门 | 创建自己的第一个网站项目

createh51个月前 (02-01)技术教程15

一、相关技术栈版本概览

技术栈

版本

说明

java

≥17.0.2

JDK版本

springframework

6.1.11

JavaEE开发框架

springboot

3.3.2

容器+MVC框架

gradle

8.9

自动化构建工具

lombok

1.18.32

Java工具类库

knife4j

4.5.0

Swagger增强组件

前提还是需要具备JAVA开发的基础概念,比如安装JDK环境。

二、整合相关技术栈

1. 创建空项目

使用 Spring Initializr 「https://start.spring.io/」快速创建Spring项目

Dependencies 对话框中搜索并添加 web 依赖关系,如屏幕截图所示。点击“生成”按钮,下载压缩包,并将其解压缩到计算机本地。


2. 编写基础的 Gradle 相关脚本

以下按相对项目的根目录进行说明,如文件不存在 可以手动创建:

  • gradle.properties
# 当前项目版本
projectVersion=0.1.0-SNAPSHOT

# SpringBoot版本
springbootVersion=3.3.2

# JDK最低版本
jdkVersion=17
  • build.gradle
buildscript {
    repositories {
        mavenLocal()
        maven { url "https://maven.aliyun.com/repository/public/" }
    }

    dependencies {
        /* 添加插件依赖路径(通过jar方式) */
        classpath "org.springframework.boot:spring-boot-gradle-plugin:${springbootVersion}"
    }
}

allprojects {
    apply plugin: "idea"
    apply plugin: "java"
    apply plugin: "org.springframework.boot"
    apply plugin: "io.spring.dependency-management"

    group = 'com.app4j.stack'
    version = projectVersion

    java {
        toolchain {
            languageVersion = JavaLanguageVersion.of(jdkVersion)
        }
    }

    configurations {
        // 排除tomcat
        all*.exclude module: 'spring-boot-starter-tomcat'
        compileOnly {
            extendsFrom annotationProcessor
        }
    }

    repositories {
        mavenLocal()
        maven { url "https://maven.aliyun.com/repository/public/" }
    }

    dependencies {
        // Lombok
        compileOnly 'org.projectlombok:lombok'
        annotationProcessor 'org.projectlombok:lombok'
        // Spring Web
        implementation 'org.springframework.boot:spring-boot-starter-web'
        // 使用undertow 替换tomcat
        implementation 'org.springframework.boot:spring-boot-starter-undertow'
    }
}


3. 创建 Springboot 启动类

com.app4j.web.WebApplication

package com.app4j.web;

import lombok.extern.slf4j.Slf4j;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.builder.SpringApplicationBuilder;

/**
 * @author eric.hao
 * @since 2024/07/18
 */
@Slf4j
@SpringBootApplication
public class WebApplication {

    public static void main(String[] args) {
        new SpringApplicationBuilder(WebApplication.class).run(args);
        log.info("[App4j] Application Started.");
    }
}

ok 项目这就可以正式启动啦!

4. 整合 Swagger

只需一步即可!引入 Knife4j Swagger 增加工具包:

dependencies {
    // Swagger
    implementation 'com.github.xiaoymin:knife4j-openapi3-jakarta-spring-boot-starter:4.5.0'
}

让我们添加一个接口,测试下 swagger 的效果:

package com.app4j.web.knife4j;

import io.swagger.v3.oas.annotations.Operation;
import io.swagger.v3.oas.annotations.tags.Tag;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;

/**
 * @author eric.hao
 * @since 2024/07/27
 */
@RestController
@RequestMapping("/demo")
@Tag(name = "示例接口")
public class Knife4jController {

    @Operation(summary = "向客人问好")
    @PostMapping("/sayHi")
    public ResponseEntity sayHi(@RequestParam(value = "name") String name) {
        return ResponseEntity.ok("Hi:" + name);
    }
}

访问接口文档的本地地址:
http://127.0.0.1:8080/doc.html

重要提示:为什么这次不用配置Docket Bean,就可以看到接口清单?

Knife4j 自4.0版本,下面的配置在
knife4j-openapi2-spring-boot-starter
中仍然需要如此配置,而在
knife4j-openapi3-spring-boot-starter

knife4j-openapi3-jakarta-spring-boot-starter
则不需要!!!

以上,我们完成了一个新的网站项目的初始化,并查看网站项目的OpenAPI!

关注点赞收藏不迷路!!振锁会持续给大家分享大厂一线的开发经验,手把手从0到架构设计!成为独当一面的多面手!!

相关文章

Java简介(“java”)

/* *作者:呆萌老师 *?csdn认证讲师 *?51cto高级讲师 *?腾讯课堂认证讲师 *?网易云课堂认证讲师 *?华为开发者学堂认证讲师 *?爱奇艺千人名师计划成员 *在这里给大家分享技术、知识...

不清楚Java是什么?只需5分钟,了解java必须要懂的知识点

Java是什么?Java吸取了C++面向对象的概念,将数据封装于类中,利用类的优点,实现了程序的简洁性和便于维护性。下面是我收集的Java必备基础知识点,希望对你有用。1、 简述Java的基本历史Ja...

Java是什么?Java自学还是培训好?(java有基础自学好还是培训班好)

每年学习Java开发的人都在一直不断上涨,有些人学有所成顺利的迈入了开发的行列,当然也有相当大一部分人由于种种原因没有坚持到最后,那么Java是什么?Java自学还是培训好?下面跟随优就业小编一起来看...

「软帝学院」什么是java?学Java能做什么?Java有什么特性?

什么是java?学Java能做什么?Java有什么特性?Java 技术既是一种高级的面向对象的编程语言,也是一个平台。Java 技术基于 Java 虚拟机(Java virtual machine,J...

Java怎么学?看完这篇文章就知道了

当今,Java编程在日常生活中的运用越来越广泛,相关岗位很有发展前景,因此不少人都想要学习Java。那今天咱们就来聊聊,Java怎么学?这个问题小编非常拿手,下面,我就给大家提供一份详细的Java学...

六种常用事务解决方案,你方唱罢,我登场(没有最好只有更好)

1 事务概念在分布式系统中,为了保证数据的高可用,通常,我们会将数据保留多个副本(replica),这些副本会放置在不同的物理的机器上。为了对用户提供正确的 CRUD 等语义,我们需要保证这些放置在不...