当前位置：首页 > news >正文

MONI后台管理系统-swagger3(springdoc-openapi)集成

news 来源：原创 2025/5/26 10:01:44

springdoc-openapi Java 库有助于使用 Spring Boot 项目自动生成 API 文档。springdoc-openapi 通过在运行时检查应用程序来根据 Spring 配置、类结构和各种注释推断 API 语义。
该库会自动生成 JSON/YAML 和 HTML 格式的页面文档。生成的文档可以使用swagger-api注释进行补充。
github地址官网

1. 项目依赖版本

Spring-Boot: 3.1.0

2. 引入依赖

        <dependency><groupId>org.springdoc</groupId><artifactId>springdoc-openapi-starter-webmvc-ui</artifactId><version>2.3.0</version></dependency>

3. 配置

package com.omni.admin.swagger;import io.swagger.v3.oas.models.Components;
import io.swagger.v3.oas.models.OpenAPI;
import io.swagger.v3.oas.models.info.Info;
import io.swagger.v3.oas.models.security.SecurityRequirement;
import io.swagger.v3.oas.models.security.SecurityScheme;
import jakarta.annotation.Resource;
import org.springframework.boot.autoconfigure.condition.ConditionalOnExpression;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;/*** SpringDoc配置**/
@Configuration
@ConditionalOnExpression("${springdoc.api-docs.enabled:true}")
public class SwaggerDocConfig {@Resourceprivate SwaggerDocProperties springDocProperties;@Beanpublic OpenAPI openAPI() {return new OpenAPI().info(new Info().title(springDocProperties.getTitle()).version(springDocProperties.getApplicationVersion())).addSecurityItem(new SecurityRequirement().addList(springDocProperties.getTokenName())).components(new Components().addSecuritySchemes(springDocProperties.getTokenName(),getSecurityScheme()));}private SecurityScheme getSecurityScheme(){return new SecurityScheme().name(springDocProperties.getTokenName()).in(SecurityScheme.In.HEADER).type(SecurityScheme.Type.APIKEY).scheme("basic");}
}

package com.omni.admin.swagger;import lombok.Data;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.boot.autoconfigure.condition.ConditionalOnExpression;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.context.annotation.Configuration;import java.util.List;/*** swagger配置类**/
@Data
@Configuration
@ConfigurationProperties(prefix = "springdoc")
@ConditionalOnExpression("${springdoc.api-docs.enabled:true}")
public class SwaggerDocProperties {/*** 项目应用名*/@Value("${spring.application.name:接口文档}")private String applicationName;/*** 项目名称*/private String title = "Omni-Admin后台管理系统接口文档";/*** 项目版本信息*/private String applicationVersion = "1.0.0";/*** 项目描述信息*/private String applicationDescription;/*** 认证token的名称*/private String tokenName = "X-Access-Token";/*** 文档组配置*/private List<Group> groups;@Datapublic static class Group{private String modelName;/*** 组名称*/private String name;/*** 组所属的包*/private String packageName;}
}

4. properties配置

这里需要做一些说明：其中配置了排序相关和分模块。还有默认访问是全部文档是展开的，可以配置默认合并。

# springdoc接口文档配置 配置参考 springdoc.md
springdoc.api-docs.enabled=true
springdoc.swagger-ui.tags-sorter=alpha
springdoc.swagger-ui.operations-sorter=method
springdoc.group-configs[0].group=A-平台管理
springdoc.group-configs[0].packages-to-scan[0]=auth.platform.service.platform
springdoc.group-configs[1].group=B-标签管理
springdoc.group-configs[1].packages-to-scan[0]=auth.platform.service.tag
springdoc.group-configs[2].group=C-配置中心
springdoc.group-configs[2].packages-to-scan[0]=auth.platform.service.configcenter
springdoc.group-configs[3].group=D-日志管理
springdoc.group-configs[3].packages-to-scan[0]=auth.platform.service.log
springdoc.group-configs[4].group=F-监控管理
springdoc.group-configs[4].packages-to-scan[0]=auth.platform.service.monitor
springdoc.group-configs[5].group=G-文件管理
springdoc.group-configs[5].packages-to-scan[0]=auth.platform.service.file
springdoc.group-configs[6].group=H-WS消息管理
springdoc.group-configs[6].packages-to-scan[0]=auth.platform.service.websocket
# 该配置控制是否需要在界面显示过滤框
springdoc.swagger-ui.filter=true
# 该配置主要控制swagger显示是直接展开还是关闭 none 不默认展开  list 列出所有api  full直接展开所有api
springdoc.swagger-ui.doc-expansion=none

5. 访问

http://localhost:8080/swagger-ui/index.html

在这里插入图片描述

6. Controller示例

package com.omni.admin.controller;import com.omni.admin.common.result.ApiResult;
import io.swagger.v3.oas.annotations.Operation;
import io.swagger.v3.oas.annotations.tags.Tag;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;/*** 接口信息表*/
@Tag(name = "接口管理")
@RestController
@RequestMapping("/api-info")
public class ApiInfoController {@Operation(summary = "测试接口文档")@GetMapping("/demo")public ApiResult<Void> demo(){return ApiResult.success();}}

7. Springdoc-openapi 属性

springdoc-openapi依赖于使用标准文件位置的标准 Spring 配置属性（YML 或属性）。

7.1. Springdoc-OpenAPI 核心属性

参数名称	默认值	描述
springdoc.api-docs.path	`/v3/api-docs`	`String`，用于 Json 格式的 OpenAPI 文档的自定义路径。
springdoc.api-docs.enabled	`true`	`Boolean`.禁用 springdoc-openapi 端点（默认为 /v3/api-docs）。
springdoc.packages-to-scan	`*`	`List of Strings`.要扫描的包列表（逗号分隔）
springdoc.paths-to-match	`/*`	`List of Strings`.要匹配的路径列表（逗号分隔）
springdoc.produces-to-match-to	`/*`	`List of Strings`.生成要匹配的媒体类型列表（逗号分隔）
springdoc.headers-to-match	`/*`	`List of Strings`.要匹配的标头列表（逗号分隔）
springdoc.consumptions-to-matchs.	`/*`	`List of Strings`.要匹配的消耗媒体类型列表（逗号分隔）
springdoc.paths-to-exclude		`List of Strings`.要排除的路径列表（逗号分隔）
springdoc.packages-to-exclude		`List of Strings`.要排除的包列表（逗号分隔）
springdoc.default-consumptions-media-type	`application/json`	`String`.默认使用媒体类型。
springdoc.default-produces-media-type	`/`	`String`.默认生成媒体类型。
springdoc.cache.disabled	`false`	`Boolean`.禁用计算的 OpenAPI 的 springdoc-openapi 缓存。
弹簧文档显示执行器	`false`	`Boolean`.显示执行器端点。
springdoc.auto-tag-classes	`true`	`Boolean`.禁用 springdoc-openapi 自动标记。
springdoc.model-and-view-allow	`false`	`Boolean`.允许带有 ModelAndView 的 RestControllers 返回出现在 OpenAPI 描述中。
springdoc.override-with-generic-response	`true`	`Boolean`.如果为 true，则自动将@ControllerAdvice响应添加到所有生成的响应中。
springdoc.api-docs.groups.enabled	`true`	`Boolean`.禁用 springdoc-openapi 组。
springdoc.group-configs[0].group		`String`.组名称
springdoc.group-configs[0].displayName		`String`.组的显示名称。
springdoc.group-configs[0].packages-to-scan	`*`	`List of Strings`.要扫描组的包列表（逗号分隔）
springdoc.group-configs[0].paths-to-match	`/*`	`List of Strings`.要为组匹配的路径列表（逗号分隔）
springdoc.group-configs[0].paths-to-exclude	``	`List of Strings`.要为组排除的路径列表（逗号分隔）
springdoc.group-configs[0].packages-to-exclude		`List of Strings`.要为组排除的包列表（逗号分隔）
springdoc.group-configs[0].produces-to-match	`/*`	`List of Strings`.生成要匹配的媒体类型列表（逗号分隔）
springdoc.group-configs[0].consumes-to-match	`/*`	`List of Strings`.要匹配的消耗媒体类型列表（逗号分隔）
springdoc.group-configs[0].headers-to-match	`/*`	`List of Strings`.要匹配的标头列表（逗号分隔）
springdoc.webjars.prefix	`/webjars`	`String`，要更改 webjars 前缀，该前缀可见 swagger-ui 的 URL 为 spring-webflux。
springdoc.api-docs.resolve-schema-properties	`false`	`Boolean`.在@Schema（名称、标题和说明）上启用属性解析程序。
springdoc.remove-broken-reference-definition	`true`	`Boolean`.禁用删除损坏的引用定义。
springdoc.writer-with-default-pretty-printer	`false`	`Boolean`.启用OpenApi规范的漂亮打印。
springdoc.model-converters.deprecating-converter.enabled	`true`	`Boolean`.禁用弃用模型转换器。
springdoc.model-converters.polymorphic-converter.enabled	`true`	`Boolean`.禁用多态模型转换器。
springdoc.model-converters.pageable-converter.enabled	`true`	`Boolean`.禁用可分页模型转换器。
springdoc.model-converters.sort-converter.enabled	`true`	`Boolean`.禁用排序转换器。
springdoc.use-fqn	`false`	`Boolean`.启用完全限定名称。
springdoc.show-login-endpoint	`false`	`Boolean`.使 Spring 安全登录端点可见。
springdoc.pre-load-enabled	`false`	`Boolean`.预加载设置，用于在应用程序启动时加载 OpenAPI。
springdoc.writer-with-order-by-keys	`false`	`Boolean`.启用确定性/字母顺序排序。
springdoc.use-management-port	`false`	`Boolean`.在执行器管理端口上公开招摇 UI。
springdoc.disable-i18n	`false`	`Boolean`.使用 i18n 禁用自动翻译。
springdoc.show-spring-cloud-functions	`true`	`Boolean`.显示弹簧云函数 Web 终结点。
springdoc.api-docs.version	`openapi_3_0`	`String`.选择或（使用值）。OpenAPI 3.0``OpenAPI 3.1``OPENAPI_3_1
springdoc.default-flat-paramObject	`false`	`Boolean`.默认平展参数。
springdoc.default-support-form-data	`false`	`Boolean`.在指定 api 以接受表单数据时默认设置表单数据的参数。

7.2. swagger-ui 属性

上提供了对 swagger-ui 属性的支持。请参阅官方文档。springdoc-openapi
您可以在文档中使用与 Spring 引导属性相同的 swagger-ui 属性。

参数名称	默认值	描述
springdoc.swagger-ui.path	`/swagger-ui.html`	`String`，用于 swagger-ui HTML 文档的自定义路径。
springdoc.swagger-ui.enabled	`true`	`Boolean`.禁用 swagger-ui 端点（默认情况下为 /swagger-ui.html）。
springdoc.swagger-ui.configUrl	`/v3/api-docs/swagger-config`	`String`.要从中获取外部配置文档的 URL。
springdoc.swagger-ui.layout	`BaseLayout`	`String`.通过插件系统提供的组件的名称，用作 Swagger UI 的顶级布局。
springdoc.swagger-ui.validatorUrl	`validator.swagger.io/validator`	默认情况下，Swagger UI 会尝试根据 swagger.io 的在线验证器验证规范。您可以使用此参数设置不同的验证程序 URL，例如，对于本地部署的验证程序验证程序徽章。将其设置为，或者将禁用验证。none``127.0.0.1``localhost
springdoc.swagger-ui.tryItOutEnabled	`false`	`Boolean`.控制默认情况下是否应启用“试用”部分。
springdoc.swagger-ui.filter	`false`	`Boolean OR String`.如果设置，则启用筛选。顶部栏将显示一个编辑框，可用于筛选显示的标记操作。可以是用于启用或禁用的布尔值，也可以是字符串，在这种情况下，将使用该字符串作为筛选器表达式启用筛选。筛选区分大小写，与标记内任意位置的筛选器表达式匹配。
springdoc.swagger-ui.operationsSorter		`Function=(a ⇒ a)`.对每个 API 的操作列表应用排序。它可以是“alpha”（按路径字母数字排序），“method”（按HTTP方法排序）或函数（参见Array.prototype.sort（）以了解排序函数的工作原理）。默认值为服务器返回的顺序不变。
springdoc.swagger-ui.tagsSorter		`Function=(a ⇒ a)`.对每个 API 的标记列表应用排序。它可以是“alpha”（按路径字母数字排序）或函数，请参阅 Array.prototype.sort（）以学习如何编写排序函数）。每次传递时，将两个标记名称字符串传递给分拣机。默认值是由 Swagger UI 确定的顺序。
springdoc.swagger-ui.oauth2RedirectUrl	`/swagger-ui/oauth2-redirect.html`	`String`.OAuth 重定向网址。
springdoc.swagger-ui.displayOperationId	`false`	`Boolean`.控制操作 ID 在操作列表中的显示。缺省值为。`false`
springdoc.swagger-ui.displayRequestDuration	`false`	`Boolean`.控制“试用”请求的请求持续时间（以毫秒为单位）的显示。
springdoc.swagger-ui.deepLink	`false`	`Boolean`.如果设置为，则启用标签和操作的深层链接。有关更多信息，请参阅 [深层链接文档]（/docs/usage/deep-linking.md）。`true`
springdoc.swagger-ui.defaultModelsExpandDepth	`1`	`Number`.模型的默认扩展深度（设置为 -1 将完全隐藏模型）。
springdoc.swagger-ui.defaultModelExpandDepth	`1`	`Number`.模型示例部分上模型的默认扩展深度。
springdoc.swagger-ui.defaultModelRendering		`String=["example"*, "model"]`.控制首次呈现 API 时模型的显示方式。（用户始终可以通过单击“模型”和“示例值”链接来切换给定模型的渲染。
springdoc.swagger-ui.docExpansion		`String=["list"*, "full", "none"]`.控制操作和标记的默认展开设置。它可以是“列表”（仅展开标签）、“完整”（展开标签和操作）或“无”（不展开任何内容）。
springdoc.swagger-ui.maxDisplayTags		`Number`.如果设置，将显示的标记操作数限制为最多此数量。默认值为显示所有操作。
springdoc.swagger-ui.showExtensions	`false`	`Boolean`.控制供应商扩展（）字段和操作、参数和架构的值的显示。`x-`
springdoc.swagger-ui.url		`String`.要配置，自定义 OpenAPI 文件的路径。如果使用，将被忽略。`urls`
springdoc.swagger-ui.showCommonExtensions	`false`	`Boolean`.控制参数的扩展（、、、、）字段和值的显示。pattern``maxLength``minLength``maximum``minimum
springdoc.swagger-ui.supportedSubmitMethods		`Array=["get", "put", "post", "delete", "options", "head", "patch", "trace"]`.启用了“试用”功能的 HTTP 方法列表。空数组禁用所有操作的“试用”。这不会从显示中过滤操作。
springdoc.swagger-ui.queryConfigEnabled	`false`	`Boolean`.自以来禁用。此参数启用（旧版）通过 URL 搜索参数覆盖配置参数。在启用此功能之前，请参阅安全公告。`v1.6.0`
springdoc.swagger-ui.oauth. additionalQueryStringParams		`String`.添加到授权 URL 和令牌 URL 的其他查询参数。
springdoc.swagger-ui.disable-swagger-default-url	`false`	`Boolean`.禁用 swagger-ui 默认宠物商店网址。（从 v1.4.1 开始可用）。
springdoc.swagger-ui.urls[0].url		`URL`.Topbar 插件使用的 swagger 组的 url。URL 在此数组中的所有项中必须是唯一的，因为它们用作标识符。
springdoc.swagger-ui.urls[0].name		`String`.Topbar 插件使用的 swagger 组的名称。名称在此数组中的所有项中必须是唯一的，因为它们用作标识符。
springdoc.swagger-ui.urlsPrimaryName		`String`.加载 Swagger UI 时将显示的招摇组的名称。
springdoc.swagger-ui.oauth.clientId		`String`.默认客户端 ID。必须是字符串。
springdoc.swagger-ui.oauth.clientSecret		`String`.默认客户端机密。切勿在生产环境中使用此参数。它公开了重要的安全信息。此功能仅适用于开发/测试环境。
springdoc.swagger-ui.oauth.realm		`String`.领域查询参数（适用于 OAuth 1）已添加到授权 URL 和令牌 URL。
springdoc.swagger-ui.oauth.appName		`String`.OAuth 应用程序名称，显示在授权弹出窗口中。
springdoc.swagger-ui.oauth.scopeSeparator		`String`.用于传递范围的 OAuth 范围分隔符，在调用之前进行编码，默认值为空格（编码值 %20）。
springdoc.swagger-ui.csrf.enabled	`false`	`Boolean`.启用 CSRF 支持
springdoc.swagger-ui.csrf.use-local-storage	`false`	`Boolean`.从本地存储获取 CSRF 令牌。
springdoc.swagger-ui.csrf.use-session-storage	`false`	`Boolean`.从会话存储中获取 CSRF 令牌。
springdoc.swagger-ui.csrf.cookie-name	`XSRF-TOKEN`	`String`.可选的 CSRF，用于设置 CSRF cookie 名称。
springdoc.swagger-ui.csrf.header-name	`X-XSRF-TOKEN`	`String`.可选的 CSRF，用于设置 CSRF 标头名称。
springdoc.swagger-ui.syntaxHighlight.activated	`true`	`Boolean`.是否应激活语法突出显示。
springdoc.swagger-ui.syntaxHighlight.theme	`agate`	`String`…突出显示.js要使用的语法着色主题。（只有这 6 种样式可用。`String=["agate"*, "arta", "monokai", "nord", "obsidian", "tomorrow-night"]`
springdoc.swagger-ui.oauth. useBasicAuthentication WithAccessCodeGrant	`false`	`Boolean`.仅针对访问代码流激活。在对 tokenURL 的authorization_code请求期间，使用 HTTP 基本身份验证方案（具有基本 base64encode（client_id + client_secret）的授权标头）传递客户端密码。
springdoc.swagger-ui.oauth. usePkceWithAuthorization CodeGrant	`false`	`Boolean`.仅适用于授权代码流。代码交换的证明密钥为 OAuth 公共客户端带来了增强的安全性。
springdoc.swagger-ui.persistAuthorization	`false`	`Boolean`.如果设置为 true，它将保留授权数据，并且在浏览器关闭/刷新时不会丢失
springdoc.swagger-ui.use-root-path	`false`	`Boolean`.如果设置为 true，则可以直接从应用程序根路径访问 swagger-u。

8. Springdoc-openapi 实例

8.1. springdoc 应用实例

在这里插入图片描述

8.2 演示应用程序的源代码

https://github.com/springdoc/springdoc-openapi-demos.git

9. 从SpringFox迁移

删除 springfox 和 swagger 2 依赖项。改为添加依赖项。springdoc-openapi-ui

 <dependency> <groupId>org.springdoc</groupId> <artifactId>springdoc-openapi-ui</artifactId> <version>1.6.14</version> </dependency>

将 swagger 2 注释替换为 swagger 3 注释（它已包含在依赖项中）。招摇 3 注释的包是 .springdoc-openapi-ui``io.swagger.v3.oas.annotations
- @Api→@Tag
- @ApiIgnore→或或@Parameter(hidden = true)``@Operation(hidden = true)``@Hidden
- @ApiImplicitParam→@Parameter
- @ApiImplicitParams→@Parameters
- @ApiModel→@Schema
- @ApiModelProperty(hidden = true)→@Schema(accessMode = READ_ONLY)
- @ApiModelProperty→@Schema
- @ApiOperation(value = "foo", notes = "bar")→@Operation(summary = "foo", description = "bar")
- @ApiParam→@Parameter
- @ApiResponse(code = 404, message = "foo")→@ApiResponse(responseCode = "404", description = "foo")
如果使用对象捕获多个请求查询参数，请使用@ParameterObject
此步骤是可选的：仅当您有多个 bean 时，才将它们替换为 bean。Docket``GroupedOpenApi

以前：

 @Bean public Docket publicApi() { return new Docket(DocumentationType.SWAGGER_2) .select() .apis(RequestHandlerSelectors.basePackage("org.github.springshop.web.public")) .paths(PathSelectors.regex("/public.*")) .build() .groupName("springshop-public") .apiInfo(apiInfo()); } @Bean public Docket adminApi() { return new Docket(DocumentationType.SWAGGER_2) .select() .apis(RequestHandlerSelectors.basePackage("org.github.springshop.web.admin")) .paths(PathSelectors.regex("/admin.*")) .apis(RequestHandlerSelectors.withMethodAnnotation(Admin.class)) .build() .groupName("springshop-admin") .apiInfo(apiInfo()); }

现在：

 @Bean public GroupedOpenApi publicApi() { return GroupedOpenApi.builder() .group("springshop-public") .pathsToMatch("/public/**") .build(); } @Bean public GroupedOpenApi adminApi() { return GroupedOpenApi.builder() .group("springshop-admin") .pathsToMatch("/admin/**") .addMethodFilter(method -> method.isAnnotationPresent(Admin.class)) .build(); }

如果你只有一个 - 删除它，而是将属性添加到你的：Docket``application.properties

springdoc.packagesToScan=package1, package2
springdoc.pathsToMatch=/v1, /api/balance/**

 @Bean public OpenAPI springShopOpenAPI() { return new OpenAPI() .info(new Info().title("SpringShop API") .description("Spring shop sample application") .version("v0.0.1") .license(new License().name("Apache 2.0").url("http://springdoc.org"))) .externalDocs(new ExternalDocumentation() .description("SpringShop Wiki Documentation") .url("https://springshop.wiki.github.org/docs")); }

MONI后台管理系统-swagger3(springdoc-openapi)集成

springdoc-openapi Java 库有助于使用 Spring Boot 项目自动生成 API 文档。springdoc-openapi 通过在运行时检查应用程序来根据 Spring 配置、类结构和各种注释推断 API 语义。该库会自动生成 JSON/YAML 和 HTML 格式的页面文档。生成的文档可以使用swagger-api注释进行补充。…...

编程日记 2025/5/26 10:01:44

常见八股文04

63.索引的优缺点优点 1.提高了查询性能 2.支持唯一性约束，避免插入重复数据 3.支持唯一性约束：在多表连接时，索引能够减少连接所需的时间和资源缺点 1.占用额外存储空间:特别是在大型数据表中，索引可能会占用大量的空间 …...

编程日记 2025/5/21 8:05:05

php各个版本的特性以及绕过方式

一.php各个版本的特性二.绕过正则匹配的常见方式 1.绕过空格 a.空变量$ l$s b.环境变量IFS（默认情况下IFS为空格、制表符和换行符） l${IFS}s c.重定向符（<,>） cat < file.txt //把file.txt的内容给cat命令&…...

编程日记 2025/5/26 6:04:07

允许某段网络访问Linux服务器上的MariaDB

在Linux服务器上安装了MariaDB，默认情况下，只允许本机访问。在某些特殊的情况下，要允许外部访问。具体操作流程如下： 1 修改服务器配置 vi /etc/my.cnf.d/server.cnf取消下面的注释，以便允许外来的主机访问。 bind-…...

编程日记 2025/5/25 1:46:50

【C语言】信号

【C语言】信号信号1. 信号状态2. 信号处理方式3. 信号注册相关函数4. 信号集相关函数信号 1. 信号状态信号有三种状态：产生、未决和递达信号产生方式： 按键产生，ctrlc 产生中断信号SIGINT，ctrl \ 产生退出信号 SIGQUIT并…...

编程日记 2025/5/26 8:36:47

2023年下半年软考信息安全工程师案例分析及答案解析

试题一（16分）回答问题1至问题6，将解答填入答题纸对应的解答栏内。问题1（4分）已知DES算法S盒如下，请补全S盒空缺的数据（1）、（2）、（3）、（4）。【参考答案】3、13、15、0 问题2（2分）已知S盒的输入为110011，请计算经过S盒变换之后的二进制输出。【参考…...

编程日记 2025/5/22 16:23:02

<?php highlight_file(__FILE__); $key1 0; $key2 0;$a $_GET[a]; $b $_GET[b];if(isset($a) && intval($a) > 6000000 && strlen($a) < 3){if(isset($b) && 8b184b substr(md5($b),-6,6)){$key1 1;}else{die("Emmm...再想想&quo…...

编程日记 2025/5/26 9:39:06

【WRF教程第3.6期】预处理系统 WPS 详解：以4.5版本为例

预处理系统 WPS 详解：以4.5版本为例 Geogrid/Metgrid 插值选项详解1. 插值方法的工作机制2. 插值方法的详细说明2.1 四点双线性插值（four_pt）2.2 十六点重叠抛物线插值（sixteen_pt）2.3 简单四点平均插值（av…...

编程日记 2025/5/26 4:30:30

图解HTTP-HTTP协议

HTTP HTTP是一种不保存状态，即无状态的协议。HTTP协议自身不对请求和响应之间的通信进行保存。为了保存状态因此后面也有一些技术产生比如Cookies技术。 HTTP是通过URI定位网上的资源，理论上将URI可以访问互联网上的任意资源。如果不是访问特定的资源…...

编程日记 2025/5/22 13:34:59

Linux基本命令

Linux基本命令一条Linux命令由：命令本身 [可选项] [参数] ls 展示 ls命令的选项: -a 选项，可以展示出隐藏的内容以 . 开头的文件或文件夹默认被隐藏，需要-a才能显示出来 **-l **选项,以列表的形式展示内容,并展示更多细节-h 选项&…...

编程日记 2025/5/26 9:21:15

【win10+RAGFlow+Ollama】搭建本地大模型助手（教程+源码）

一、RAGFlow简介 RAGFlow是一个基于对文档深入理解的开源RAG（Retrieval-augmented Generation，检索增强生成）引擎。主要作用： 让用户创建自有知识库，根据设定的参数对知识库中的文件进行切块处理，用户向大…...

编程日记 2025/5/26 9:46:42

.ejs 后缀文件 - 嵌入式JavaScript模板

嵌入式JavaScript模板（Embedded JavaScript templates）文件是以.ejs 后缀。它是一种模板引擎，它允许你在你的HTML文件中直接嵌入JavaScript代码。EJS模板可以包含HTML代码、JavaScript表达式、控制结构（如if语句和循环&#xff09…...

编程日记 2025/5/26 9:56:00

springboot461学生成绩分析和弱项辅助系统设计(论文+源码)_kaic

摘要传统办法管理信息首先需要花费的时间比较多，其次数据出错率比较高，而且对错误的数据进行更改也比较困难，最后，检索数据费事费力。因此，在计算机上安装学生成绩分析和弱项辅助系统软件来发挥其高效地信息处理的作…...

编程日记 2025/5/26 8:45:28

【从零开始入门unity游戏开发之——C#篇23】C#面向对象继承——`as`类型转化和`is`类型检查、向上转型和向下转型、里氏替换原则（LSP）

文章目录一、as类型转化和is类型检查1、as 关键字使用场景：语法：示例：特点： 2、is 关键字使用场景：语法：示例：特点： 3、总结二、向上转型和向下转型1、向上转型示例： 2…...

编程日记 2025/5/26 9:58:11

“魔法糖果盒的秘密：用朴素贝叶斯算法猜糖果颜色”

想象一下，你有一个神奇的糖果盒，这个糖果盒里有两种糖果：红色的和蓝色的。你闭上眼睛，从盒子里拿出一个糖果，然后尝一尝，你想知道这个糖果是红色的还是蓝色的。朴素贝叶斯算法就像是一个魔法规则&#xff0…...

编程日记 2025/5/26 8:24:03

使用“NodeMCU”、“红外模块”实现空调控制

项目思路空调遥控器之所以能够实现对空调的控制，是因为它能够向空调发射出特定的红外信号。从理论上来说，任何能够发射出这种相同红外信号的红外发射器，都可以充当空调遥控器（这也正是手机能够控制多种不同品牌空调的原因所在&a…...

编程日记 2025/5/26 6:25:58

了解cuda的统一内存

1. CUDA 6中的统一内存在CUDA 6中，从Kepler GPU架构（计算能力3.0或更高）开始，在64位Windows 7、8和Linux操作系统（内核2.6.18）上开始支持统一内存. 从CUDA 6开始，NVIDIA推出了CUDA平台历史上…...

编程日记 2025/5/24 9:11:30

MySQL索引

2.1 索引概述 2.1.1 介绍索引（index）是帮助MySQL高效获取数据的数据结构(有序)。在数据之外，数据库系统还维护着满足特定查找算法的数据结构，这些数据结构以某种方式引用（指向）数据， 这样就…...

编程日记 2025/5/26 9:37:32

会话控制（cookie、session 和 token）

1. 介绍所谓会话控制就是对会话进行控制HTTP 是一种无状态的协议，它没有办法区分多次的请求是否来自于同一个客户端， 无法区分用户，而产品中又大量存在的这样的需求，所以我们需要通过会话控制来解决该问题。常见的会话控制…...

编程日记 2025/5/26 8:31:12

stm32 rtc 详解

目录 L151 RTC 唤醒代码方式一通过 RTC Alarm Interrupt：(基本和F1系列一样)： L151 RTC 唤醒代码方式二通过 RTC WakeUp Interrupt F103VE RTC 闹钟唤醒代码 （103RC 没有闹钟中断）： RTC（real time…...

编程日记 2025/5/26 9:33:51

D 咖智能饮品机器人：开启商业新篇

在科技迅猛发展的当下，智能机器人正逐步渗透到各个商业领域，D 咖智能饮品机器人便是其中的佼佼者，它的出现为饮品行业带来全新的发展契机，有望开启商业新篇。从大环境来看，消费者对于饮品的需求日益多元化和个性化。他…...

编程日记 2025/5/22 22:57:06

使用FakeSMTP创建本地SMTP服务器接收邮件具体实现。

以下代码来自Let’s Go further节选。具体说明均为作者本人理解。编辑邮件模版主要包含三个template: subject：主题plainBody： 纯文本正文htmlBody：超文本语言正文 {{define "subject"}}Welcome to Greenlight!{{end}} {{def…...

编程日记 2025/5/23 10:49:55

重拾设计模式--模板方法模式

文章目录一、模板方法模式概述二、模板方法模式UML图三、优点1代码复用性高2可维护性好3扩展性强四、缺点五、使用场景六、C 代码示例1七、 C 代码示例2 一、模板方法模式概述定义：定义一个操作中的算法骨架，而降一些步骤延迟到子类中。模板方法使得…...

编程日记 2025/5/24 2:43:29

二、windows环境下vscode使用wsl教程

本篇文件介绍了在windows系统使用vscode如何连接使用wsl，方便wsl在vscode进行开发。 1、插件安装双击桌面vscode，按快捷键CtrlShiftX打开插件市场，搜索【WSL】点击安装即可。 2、开启WSL的linux子系统点击左下方图标【Open a Remote Win…...

编程日记 2025/5/24 5:06:37

我们的电视Our tv 3.6.0安卓+TV 一款全新电视直播软件-内置稳定直播源

应用简介我们的电视（ourtv）是一款完全无广告的电视直播软件，清晰度可选择高清，超清，蓝光等播放。安装即可使用，再也不用费劲去找各种不稳定的直播源了。 “我们的电视”播放线路（直播源&…...

编程日记 2025/5/24 8:45:11

批处理理解

初识批处理如何批处理： 命名：.bat 方法：创建一个记事本文件，然后将其扩展改为.bat 批处理作用：自上而下成批处理每一条DOS命令，直到执行到最后一条。运行环境：当然是我们cmd了回归我学过的…...

编程日记 2025/5/23 2:42:27

高效准确的PDF解析工具，赋能企业非结构化数据治理

目录准确性高：还原复杂版面元素使用便捷：灵活适配场景贴心服务：快速响应机制在数据为王的时代浪潮中，企业数据治理已成为组织优化运营、提高竞争力的关键。随着数字化进程的加速，企业所积累的数据量呈爆炸式增长…...

编程日记 2025/5/25 19:48:28

Go框架比较：goframe、beego、iris和gin

由于工作需要，这些年来也接触了不少的开发框架，Golang的开发框架比较多，不过基本都是Web"框架"为主。这里稍微打了个引号，因为大部分"框架"从设计和功能定位上来讲，充其量都只能算是一个组件&…...

编程日记 2025/5/25 13:20:04

【ETCD】【实操篇（三）】【ETCDCTL】如何向集群中写入数据

在分布式系统中，etcd 是一个高可用的键值存储，用于存储和共享配置信息、服务发现、协调等。向 etcd 写入数据可以通过多种方式进行，常见的方式是使用 etcd 提供的 HTTP API 或者通过客户端库来进行操作。目录一、使用EtcdCtl工具来写入数据…...

编程日记 2025/5/24 15:24:50

2025年春节档的《哪吒2》，光线传媒动画梦的关键一战

没想到《哪吒之魔童闹海》会以这种形式重回大众视野。距离2025年春节还有不到两个月，春节档电影大战已经打响，原本市场还在猜测2024年频频“胎动”的《哪吒之魔童闹海》（以下简称《哪吒2》）会不会参与这场“神仙打架”&#xff…...

编程日记 2025/5/22 23:30:14

windows C#-实例构造函数

声明一个实例构造函数，以指定在使用 new 表达式创建某个类型的新实例时所执行的代码。要初始化静态类或非静态类中的静态变量，可以定义静态构造函数。如以下示例所示，可以在一种类型中声明多个实例构造函数： class Coords {pu…...

编程日记 2025/5/26 0:31:43

FPGA-PS端编程1：

目标在小梅哥的zynq 7015上，完成以下目标： 读取 S1 按键的电平， 当 S1 按键为按下状态时，驱动 PS LED 以 1S 的频率闪烁(注意理解 1S 的频率闪烁和 1S的时间翻转两种描述之间的差别)， 当 S1 释放后，停止…...

编程日记 2025/5/21 16:13:32

【JavaEE进阶】第一个Spring Boot程序

目录 🌴安装插件 🎄Spring Boot介绍 🌳Spring Boot项目创建 🚩创建Spring Boot项目 🏀jar 包下载不下来问题 🚩启动项目 🌲目录介绍 🚩src文件 🚩target文件 &…...

编程日记 2025/5/21 19:25:19

RunCam WiFiLink连接手机图传测试

RunCam WiFiLink中文手册从这里下载一、摄像头端 1.连接天线（易忘） 2.打开摄像头前面的盖子（易忘） 3.接上直流电源，红线为正，黑线为负 4.直流电源设置电压为14v，电流为3.15A， 通…...

编程日记 2025/5/26 7:45:36

使用Chat-LangChain模块创建一个与用户交流的机器人

当然！要使用Chat-LangChain模块创建一个与用户交流的机器人，你需要安装并配置一些Python库。以下是一个基本的步骤指南和示例代码，帮助你快速上手。安装依赖库首先，你需要安装langchain库，它是一个高级框架&#x…...

编程日记 2025/5/25 20:15:58

地级市2011-2020数字经济博士研究生自用数据

赵涛评价指标数据，具体指标见图片参考文献: [1]赵涛,张智,梁上坤.数字经济、创业活跃度与高质量发展——来自中国城市的经验证据[J].管理世界,2020,36(10):65-76. 每百人移动电话数，是模仿赵涛的，指人均再➗100 数据来源，中国城…...

编程日记 2025/5/24 14:17:14

呼叫中心部门如何使用开源大模型智能呼叫中心，对接已有系统实现降本增效

呼叫中心部门如何使用开源大模型智能呼叫中心，对接已有系统实现降本增效作者：开源大模型智能呼叫中心FreeIPCC 随着人工智能技术的快速发展，特别是大规模语言模型（LLM）的应用，企业可以通过将开源大模型与…...

编程日记 2025/5/22 9:49:35

Latex 转换为 Word（使用GrindEQ ）（英文转中文，毕业论文）

效果预览第一步： 告诉chatgpt： 将latex格式中的英文翻译为中文（符号和公式不要动）,给出latex格式第二步： Latex 转换为 Word（使用GrindEQ ） 视频 https://www.bilibili.com/video/BV1f242…...

编程日记 2025/5/25 11:04:37

多态中虚函数调用问题

在多态中，一般通过虚函数表会调用子类重写的虚函数，然而，有一种情况调用的还是父类的虚函数，就是在父类的构造函数中调用的是父类的虚函数，无论子类是否重写。 #include <iostream> #include <list> #inc…...

编程日记 2025/5/21 1:37:57

【NLP 18、新词发现和TF·IDF】

目录一、新词发现 1.新词发现的衡量标准 ① 内部稳固 ② 外部多变 2.示例 ① 初始化类 NewWordDetect ② 加载语料信息，并进行统计 ③ 统计指定长度的词频及其左右邻居字符词频 ④ 计算熵 ⑤ 计算左右熵编辑 ⑥ 统计词长总数 ⑦ 计算互信息 ⑧ 计算每个词…...

编程日记 2025/5/26 1:47:14

windows服务器Oracle TNS 远程监听器中毒

修复Oracle TNS 监听器远程中毒漏洞 1.1 修改监听文件如何快速找到listener.ora ？ cmd输入 tnsping localhost 修改配置文件，路径以自己的实际路径为准，我都在D盘 listener.ora内容如下： #listener.ora Network Configuration F…...

编程日记 2025/5/20 1:53:04

GitLab的安装和使用

1.GitLab 环境说明系统版本 CentOS 7.2 x86_64 软件版本 gitlab-ce-10.8.4 GitLab 是一个用于仓库管理系统的开源项目，使用Git作为代码管理工具，并在此基础上搭建起来的web服务。可通过Web界面进行访问公开的或者私人项目。它拥有与Github类似的功能…...

编程日记 2025/5/25 20:16:11

常用的JVM启动参数有哪些?

大家好，我是锋哥。今天分享关于【常用的JVM启动参数有哪些?】面试题。希望对大家有帮助； 常用的JVM启动参数有哪些? 1000道互联网大厂Java工程师精选面试题-Java资源分享网 JVM启动参数用于配置Java虚拟机（JVM）的运行时行为…...

编程日记 2025/5/20 23:31:17

MobaXterm 连接不上VMware 的Ubuntu 虚拟机

想在window11的笔记本上通过VMWare安装Ubuntu操作系统，但是在两个桌面见来回切换，十分的麻烦，于是通过远程服务访问客户端软件MateXterm来访问虚拟机的Linux系统，但是从CSDN上搜到的教程都没有成功，于是，尝…...

编程日记 2025/5/20 17:27:53

异步BUCK二极管损耗计算

异步BUCK工作原理 Q闭合时（Ton），输入电压Vin为电感L和输出电容Cout充电，同时为负载供电；Q断开时（Toff），电感L为负载供电，电流通过续流二极管D回流到电感L； 之…...

编程日记 2025/5/25 11:12:52

【WPF】把DockPanel的内容生成图像

要在WPF中将一个 DockPanel 的内容生成为图像并保存，可以按照与之前类似的步骤进行，但这次我们将专注于 DockPanel 控件而不是整个窗口。 DockPanel的使用 WPF（Windows Presentation Foundation）中的 DockPanel 是一种布局控件&…...

编程日记 2025/5/22 17:17:10