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

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

一、相关技术栈版本概览

技术栈

版本

说明

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能做什么?Java有什么特性?

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

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

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

[Java] 函数式编程相关概念 - 笔记2

匿名函数 ( Anonymous function )1. 匿名函数,是指没有被绑定到标识符的函数。根据字面意思,也可以理解为没有名字的函数。2. 匿名函数通常:1). 作为参数,被传递给高阶函数。2...

玩转Java注解-元注解、内置注解、自定义注解的原理和实现

前言Java 注解(Annotation)又称 Java 标注,是 JDK5.0 引入的一种注释机制。 重点:和 Javadoc 不同,Java 标注可以通过反射获取标注内容。 大话空话不用说太多,简...

学习java知道这五个网站就够了(学java好的网站)

“这个国家的每个人都应该学习编程计算机,因为它教你如何思考。” 当乔布斯几年前这么说时,他再次被证明是一个真正的有远见的人。好吧,这很难反驳!如今,编程比以往任何时候都更加蓬勃发展,而且这种趋势预计只...