swagger 配置类 存档

Knife4j 4.4.0 整合 Spring Boot 3.0:5分钟完成 Swagger UI 界面与功能全面升级 本文详细介绍了如何将Knife4j 4.4.0与Spring Boot 3.0快速整合,实现Swagger UI界面与功能的全面升级。通过5分钟快速配置指南,开发者可以轻松掌握API文档生成、安全认证、分组管理等核心功能,提升微服务架构下的开发效率与协作质量。 阅读详情

备份一下swagger配置类, 后面要用的时候直接用。

导入坐标:

        <!-- 集成swagger -->
        <dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-swagger2</artifactId>
            <version>2.9.2</version>
        </dependency>
        <dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-swagger-ui</artifactId>
            <version>2.9.2</version>
        </dependency>
        <dependency>
            <groupId>com.github.xiaoymin</groupId>
            <artifactId>swagger-bootstrap-ui</artifactId>
            <version>1.9.6</version>

在Config下新建一个swagger配置类。

package com.techen.ami.config;
import java.util.ArrayList;
import java.util.List;

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

import com.github.xiaoymin.swaggerbootstrapui.annotations.EnableSwaggerBootstrapUI;

import springfox.documentation.builders.ApiInfoBuilder;
import springfox.documentation.builders.ParameterBuilder;
import springfox.documentation.builders.PathSelectors;
import springfox.documentation.builders.RequestHandlerSelectors;
import springfox.documentation.schema.ModelRef;
import springfox.documentation.service.ApiInfo;
import springfox.documentation.service.Contact;
import springfox.documentation.service.Parameter;
import springfox.documentation.spi.DocumentationType;
import springfox.documentation.spring.web.plugins.Docket;
import springfox.documentation.swagger2.annotations.EnableSwagger2;

/**
 * Swagger2配置
 * 访问地址:http://ip:port/swagger-ui.html
 * 访问地址(增强):http://ip:port/doc.html
 * @author tom
 * @date 2019年11月12日
 * @Modify
 */
@Configuration
@EnableSwagger2
@EnableSwaggerBootstrapUI
public class SwaggerConfig {

    @Bean
    public Docket createRestApi(){
    	// 增加header
    	// 在所有rest统一添加一个参数
    	ParameterBuilder parameterBuilder = new ParameterBuilder();
    	List<Parameter> params = new ArrayList<Parameter>();
    	parameterBuilder.name("Authorization").description("token")
    			.modelRef(new ModelRef("string"))
    			.parameterType("header")
    			.defaultValue("Bearer ")
    			.required(true)
    			.build();
    	params.add(parameterBuilder.build());
    	// 配置规则
    	return new Docket(DocumentationType.SWAGGER_2)
    			.apiInfo(apiInfo())
    			.select()
    			.apis(RequestHandlerSelectors.basePackage("要管理的包路径"))
    			.paths(PathSelectors.any())
    			.build()
    			.globalOperationParameters(params);
    }
    
    private ApiInfo apiInfo(){
    	Contact contact = new Contact("用户姓名", "http://www.XXXXX.cn", "用户邮箱");
    	return new ApiInfoBuilder()
				.title("springboot integrate swagger2")
				.description("springboot integrate swagger2")
				.termsOfServiceUrl("")
				.contact(contact)
				.version("1.0")
				.build();
    }

}

swagger详细注解说明参考:https://blog.youkuaiyun.com/xiaojin21cen/article/details/78654652

 

swagger微服务下,多个服务统一管理接口参考:https://blog.youkuaiyun.com/qq_31748587/article/details/102563155

Spring Boot 3 + Swagger 3 + Knife4j 4.1.0:从配置到美化,打造团队专属API文档门户 本文详细介绍了如何在Spring Boot 3项目中集成Swagger 3和Knife4j 4.1.0,打造企业级API文档门户。从基础配置优化到高级功能实战,包括接口分组管理、离线文档导出、响应统一包装等,帮助团队提升API文档的可读性和美观度,适用于微服务架构下的文档整合与管理。 阅读详情

相关推荐

Spec4j:基于Java注解的REST API文档自动化生成方案

在REST API开发中,OpenAPI规范已成为定义接口契约的行业标准,其核心原理是通过结构化的描述文件(如YAML/JSON)来明确API的路径、参数、响应等元数据。这一技术价值在于实现了API设计、文档、测试和客户端代码生成等多个环节的标准化与自动化,从而提升开发效率并降低协作成本。在实际应用场景中,Spring Boot作为Java领域主流的Web框架,开发者常面临手动维护独立OpenAPI文件与业务代码不同步的痛点。为此,开源项目Spec4j提出了“YAMLless”的解决方案,通过引入Java注

weixin_30444105的博客 362

Swagger基本示例

类注解 @RestController @RequestMapping("/im/wsdm/user") @Api(tags = "融云用户") public class ImWsdmUserController extends BaseController { 方法注解 后端Swagger 接口文档注解编写示例: /** * 创建群组方法 * API 文档: http://www.rongcloud.cn/docs/server_sdk_api/group/group.htm

lxyoucan的博客 952

SpringBoot高校教师评价系统实战:从架构设计到部署运维全解析

在软件开发领域,SpringBoot作为Java生态中主流的微服务框架,以其自动配置和快速启动的特性,极大地简化了企业级应用的开发流程。其核心原理在于通过约定大于配置的方式,整合Spring生态的各种组件,为开发者提供了一套标准化的工程实践方案。这一技术价值体现在能够快速构建出具备高可维护性和可扩展性的后台管理系统,广泛应用于教务管理、OA办公等各类业务场景。本文以高校教师评价系统这一具体应用为切入点,深入剖析如何基于SpringBoot实现多角色权限控制、动态表单配置等核心功能,并结合JWT认证、MyBa

weixin_33767813的博客 480

springboot配置swagger示例

idea新建springboot项目 注意swagger 配置非常简单,但是因为版本问题新手经常出现项目启动不了的现象 sringboot 版本为2.1.3.RELEASE <parent> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-parent</artifactId> &.

xiatianit的博客 2043

架构师怎么做管理:接口文档管理

任何一个优秀的互联网系统,都离不开各类研发岗位上工程师们的通力协作,而且这种协作必须是以高效的、低成本的沟通方式进行。软件开发从过去的小作坊到现在几十几百人,到现在成千上万人的同时参与,这里面如果没有一个好的协作工具,是不可能进行下去的。对于工程师来说,开发文档就是这样一个低成本、高效率的沟通工具。但奇怪的是,很多工程师都不愿意写文档,尤其是开发文档(或者说接口文档),因为他们觉得只要有技术就可以了,文档啥的有没有都无所谓。

分享专业、有用、有趣的技术、产品、运营和管理知识。 475

SpringBoot整合Swagger2并且可以向数据库写入数据

SpringBoot整合Swagger2并且可以向数据库写入数据,使用工具IDEA

Swagger2原理详解与示例

在前后端分离开发的今天,接口文档显得尤为重要,其重要性有以下几点:1、约定接口信息,便于前后端分离开发;2、便于测试人员测试并检查数据;3、加快新员工上手工作的速度;4、后续工作交接。然而,接口文档的整理与编写又令繁重的开发工作雪上加霜。有没有好用的工具或者 ...

m_sophia的博客 6100

Golang实战:用Quic-Go v0.46.0搭建高性能文件传输服务(附完整代码)

本文详细介绍了如何使用Golang和Quic-Go v0.46.0构建高性能文件传输服务,涵盖服务端和客户端的完整实现。通过QUIC协议的多路复用、零RTT连接等特性,显著提升文件传输效率,特别适合高延迟或不稳定网络环境。文章提供完整代码示例和性能调优技巧,帮助开发者快速部署高效的文件传输解决方案。

weixin_33737134的博客 454

Swagger使用教程

访问地址 http://localhost:8088/context-path/swagger-ui/index.html 1.引入依赖 <dependency> <groupId>io.springfox</groupId> <artifactId>springfox-boot-starter</artifactId> <version>3.0.0</version> </dependency

天宇宇宇宇宇a的博客 470

亚马逊SP-API授权实战:从OAuth流程到Refresh Token获取

本文详细解析了亚马逊SP-API授权流程,从OAuth认证到Refresh Token获取的全过程。通过实战经验分享,帮助开发者快速掌握Marketplace Appstore、Website Workflow和自行授权三种方式,解决常见错误如MD5100和MD9999,并提供了安全存储Refresh Token的最佳实践。

weixin_30379531的博客 519

声纹识别实战:用Python从零搭建一个简易声纹验证系统(附完整代码)

本文是一份详细的声纹识别实战指南,教你使用Python从零搭建一个简易的声纹验证系统。文章涵盖了从音频采集、预处理、MFCC特征提取,到基于高斯混合模型(GMM)的建模与验证全流程,并提供了完整的代码实现,帮助开发者快速掌握这项生物特征识别核心技术。

ik6789012的博客 236

FastAPI学习-9. Swagger文档输出请求示例example

前言 可以在 Swagger文档上看到请求示例example,使用Pydantic schema_extra属性来实现。 schema_extra 使用 Config 和 schema_extra 为Pydantic模型声明一个示例,如Pydantic 文档:定制 Schema 中所述: from typing import Optional from fastapi import FastAPI from pydantic import BaseModel app = FastAPI() clas

qq_27371025的博客 2046

Unreal Engine鸿蒙移植实战:环境配置、构建流程与性能优化指南

游戏引擎移植是跨平台开发中的关键技术环节,其核心原理在于通过适配目标操作系统的底层接口和工具链,实现同一套代码在不同硬件和软件环境下的高效运行。这项技术的价值在于最大化代码复用率,降低多平台维护成本,并能让应用快速触达新兴生态系统的用户。在移动游戏和XR应用领域,随着鸿蒙HarmonyOS生态的快速发展,将成熟的商业引擎如Unreal Engine迁移至此平台,成为开发者探索新市场机会的重要路径。本文聚焦于Unreal Engine项目向鸿蒙系统的移植实践,详细解析了从环境搭建、源码适配到构建打包的全链路流

weixin_29011395的博客 411

Spring boot项目(二)——集成log日志和swagger文档

集成Log日志 集成swagger文档

weixin_45974176的博客 442

语音AI Agent落地实战:从ASR-NLP-TTS到多通道协同决策

语音AI Agent并非简单的自动语音识别(ASR)、自然语言处理(NLP)和文本转语音(TTS)三模块串联,而是在真实场景中需兼顾实时性、鲁棒性与隐私合规的端到端交互系统。其核心原理在于打破‘文本中间态’依赖,通过声学-文本-上下文多通道协同决策,融合原始音频特征、N-best置信度与设备环境信号,实现动态意图推演。技术价值体现在低延迟(如120ms离线唤醒)、高抗噪(-5dB SNR下WER≤25%)及强可控性(断网降级、本地热更新)。典型应用场景覆盖车载语音、智能家居与银行网点等边缘受限环境,尤其适用

weixin_29065959的博客 330

AgentScope实战训练营-Java开发HITL人机协作AI应用完整指南

本文手把手带你从零搭建一个基于 Spring Boot WebFlux + AgentScope + 通义千问的人机协作(HITL)AI 聊天应用。项目涵盖流式对话、工具调用、高危操作确认、对话中断、动态 MCP 工具接入、中英文双语界面等完整功能。文章从环境准备、pom.xml 配置、DTO 数据模型、Hook 机制、AgentService 核心服务、ChatController 接口到前端 HTML/CSS/JS 实现,逐一讲解每行代码的设计意图,并附带 REST API 接口说明、测试场景、常见问题

program哲学 713

南生论坛API接口设计艺术:Swagger文档自动生成与版本管理

南生论坛是基于SpringBoot + Vue构建的开源Java论坛项目,提供社区、问答、社交网络等全面功能。本文将深入探讨其API接口设计中的Swagger文档自动生成与版本管理实践,帮助开发者高效管理接口文档,提升前后端协作效率。 ## 一、Swagger文档自动生成配置解析 ### 1.1 核心配置类详解 南生论坛通过`SwaggerConfig.java`实现接口文档的自动化配置,位

gitblog_00717的博客 244

llama2-7b下载并转llama-2-7b-hf

④输入https://github.com/huggingface/transformers/blob/main/src/transformers/models/llama/convert_llama_weights_to_hf.py会下载 convert_llama_weights_to_hf.py 文件,我们需要用到这个文件将llama2-7b转成llama-2-7b-hf。③下载完之后是这四个文件,这里我是在windows操作系统中安装的WSL,没有linux操作系统,没办法。

wenling54321的博客 1033

Knife4j 4.4.0 集成实战:Spring Boot 3.x 项目 5 分钟完成 API 文档升级

本文详细介绍了如何在Spring Boot 3.x项目中快速集成Knife4j 4.4.0,优化API文档体验。通过5分钟完成配置,开发者可以充分利用Knife4j对Swagger的增强功能,包括美观界面、离线文档导出和高级安全控制,显著提升团队协作效率。

weixin_34354173的博客 412

推荐系统(一)概述

在互联网领域,推荐系统(Recommendation Systems)的应用非常广泛。在音视频方面,如抖音、快手、哔哩等;在电商平台方面,如京东、淘宝、拼多多等。推荐有助于帮助用户快速发现潜在感兴趣的内容(音视频、商品、新闻等信息流),从而提升用户体验,同时有助于提升商业效率。从本文开始,笔者将结合自身在信息流推荐领域的经验,通过系列文章对推荐系统展开介绍。

Jin_Kwok的博客 6085

visio安装包

Microsoft Office Visio 是一款专业的制图软件。利用经过更新的形状、协作工具和数据链接图表,创建专业级图表以简化复杂的信息。

Spring Boot 3 接口文档自动化:SpringDoc + Knife4j 终极指南

Swagger和Knife4j是用于自动化生成RESTful API接口文档的工具。Swagger通过代码注解自动生成交互式API文档,而Knife4j作为其增强版提供了更美观的UI界面。文章介绍了接口文档的必要性,详细说明了Swagger(SpringDoc OpenAPI)和Knife4j的使用方法,包括依赖引入、注解配置和页面美化技巧。针对SpringBoot3.5与Knife4j的兼容性问题,还提供了解决方案。

2402_83593125的博客 751

ssm框架搭建

这个是一个在idea上成功跑起来的ssm框架项目,保存在这里方便以后使用直接下载

Knife4j 使用详解

Knife4j:高效的API文档工具 Knife4j是基于Swagger的开源API文档工具,提供美观UI和强大功能,改善原生Swagger的不足。核心功能包括自动文档生成、接口分组、参数设置、在线调试、离线导出(HTML/PDF/Markdown)及多环境支持。集成简单,只需添加依赖、配置参数、使用注解即可生成文档,访问/doc.html查看。适用于微服务、前后端分离等场景,优势在于界面友好、功能丰富、扩展性强。离线导出功能尤为实用,支持多种格式,方便团队协作和文档交付。

技术人集结地 2284

win10 跳过U8环境检测的IE WebControls.rar

win10 安装u8的时候 提示IE WebControls 不通过,这个工具可以欺骗u8的检查。 跳过U8环境检测的IE WebControls。提示导入失败后,重新检测通过。

APIKit:基于上下文感知与智能流量的API安全测试平台实战指南

在软件工程与网络安全领域,API(应用程序编程接口)已成为现代应用架构的核心组件,其安全性直接关系到整个系统的稳定与数据资产的安全。API安全测试的原理在于通过模拟攻击者行为,对接口的认证、授权、输入验证、业务逻辑等层面进行系统性验证,以发现潜在漏洞。其技术价值在于将安全能力左移,实现漏洞的早期发现与修复,显著降低安全风险与修复成本。典型的应用场景包括对微服务架构、移动应用后端及云原生应用中的RESTful API和GraphQL接口进行持续安全评估。针对当前高频出现的Swagger API未授权访问等配置

weixin_34218890的博客 349

【优快云软件工程师能力认证学习精选】Spring Boot面试题(2020最新版)

优快云软件工程师能力认证(以下简称C系列认证)是由中国软件开发者网优快云制定并推出的一个能力认证标准。C系列认证历经近一年的实际线下调研、考察、迭代、测试,并梳理出软件工程师开发过程中所需的各项技术技能,结合企业招聘需求和人才应聘痛点,基于公开、透明、公正的原则,甑别人才时确保真实业务场景、全部上机实操、所有过程留痕、存档不可篡改。 我们每天将都会精选优快云站内技术文章供大家学习,帮助大家系统化学习IT技术。 概述 什么是 Spring Boot? Spring Boot 是 Spring.

优快云高校俱乐部官方博客 601

告别手写YAML:Spec4j自动生成Spring Boot REST API文档

在微服务架构和前后端分离的开发模式中,REST API作为系统间通信的核心契约,其规范文档的准确性和实时性至关重要。OpenAPI规范作为行业标准,通过YAML或JSON格式定义API的接口、参数和响应,为API设计、测试和文档化提供了统一框架。然而,手动维护YAML文件常导致文档与代码脱节,增加维护成本。基于“代码即文档”理念的自动化工具应运而生,通过分析源代码中的控制器、模型和注解,动态生成符合规范的API描述,从而确保文档与实现的一致性,提升开发效率和协作质量。Spec4j正是这样一款面向Spring

weixin_33924312的博客 286

OWASP OFFAT报告生成机制解析:从Rich表格到HTML安全报告的实现

OWASP OFFAT是一款开源API安全测试工具,能够自动扫描API接口中常见的OWASP漏洞。而它最被低估的能力之一,就是**报告生成机制**——同一份测试结果,可以自由切换为终端Rich表格、JSON、YAML和HTML安全报告四种形态。本文将以实用视角,一步步拆解OFFAT报告生成的完整链路,帮助你快速上手、看懂并定制属于自己的安全测试报告。 ## OFFAT报告有哪几种输出格式 OF

gitblog_00072的博客 1033
上一篇: 微服务 部分组件 思考知识点 记录
下一篇: docker 常用命令记录
libingbojava
博客等级 码龄9年 64粉丝 111原创
评论 1
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值