Swagger 常用注解使用 Swagger 注解不仅能生成自动化的 API 文档,还能显著提升后端接口的可维护性与前后端对接效率。
1. 核心注解概览
注解
作用范围
核心功能
@Api
类 (Controller)
标识 API 资源分组,通常用于定义模块名称。
@ApiOperation
方法 (Controller Method)
描述具体接口的操作意图及作用。
@ApiParam
参数 (Method Parameter)
描述请求参数的含义、是否必填等。
@ApiModel
类 (POJO/DTO/VO)
描述数据模型(实体类)的用途。
@ApiModelProperty
属性 (Field)
描述模型属性的含义、示例值及约束。
2. 详细用法示例📂 模块层级:@Api用于类上,通过 tags 属性对接口进行逻辑分组。
@RestController
@RequestMapping("/admin/employee")
@Api(tags = "员工管理相关接口 ...
实现 SSH 免密登录(Public Key Authentication)主要分为两个步骤:在本地生成密钥对 和 将公钥上传至远程服务器。
以下是通用的配置步骤(适用于 Linux/macOS/Windows PowerShell):
第一步:在本地生成密钥对如果你的本地电脑(客户端)还没有 SSH 密钥,需要先生成一个。
打开终端(Terminal 或 PowerShell)。
输入以下命令:
ssh-keygen -t rsa -b 4096
或者使用更现代的算法(推荐): ssh-keygen -t ed255193. 一路按回车键。
当提示 Enter file in which to save the key 时,按回车(默认保存在 ~/.ssh/id_rsa)。
当提示 Enter passphrase 时,一定要按回车留空(如果设置了密码,登录时就需要输入这个密码,就无法实现“免密”了)。
第二步:将公钥上传到服务器最简单的方法是使用 ssh-copy-id 命令。
假设你的远程服务器用户名是 root,IP 是 192.168.1. ...
本节主要介绍 torchvision 工具箱中 transforms 模块的基本使用。在深度学习中,transforms 主要用于对图片进行预处理(Pre-processing)和数据增强(Data Augmentation)。
1. Transforms 的结构理解可以将 transforms 理解为一个工具箱。
transforms: 整个工具箱。
transforms.ToTensor(): 工具箱里的一个具体工具(例如:一把锤子)。
tool = transforms.ToTensor(): 我们从工具箱里拿出来的具体工具对象。
result = tool(input): 使用这个工具对输入(图片)进行处理,得到结果。
2. 核心方法:ToTensorToTensor 是最基础也是最常用的 transform,它的主要作用是将 PIL Image 或 numpy.ndarray 转换为 torch.Tensor。实战代码from torchvision import transforms
from PIL import Image
img_pa ...
本节主要记录 TensorBoard 中 add_image 方法的使用,用于在训练过程中可视化图像数据(如输入图片、特征图等)。
1. add_image()add_image()用于将图像数据写入到TensorBoard的日志文件中
参数说明
tag (string): 数据标识符,类似图片的标题。
img_tensor (torch.Tensor, numpy.array, or string/blobname): 图像数据。
global_step (int): 全局步数(x轴),通常对应 Epoch 或 Iteration。
dataformats (string): 图像数据的维度格式(非常重要)。
默认格式为 CHW (Channel, Height, Width)。
常见 OpenCv 或 PIL 读取转 Numpy 后的格式为 HWC (Height, Width, Channel)。
注意: 如果数据格式不匹配,需要显式指定该参数,否则会报错或显示花屏。
2. 实战代码通常使用PIL或者OpenCV读取照片,然后转换为numpy.arrary传给Te ...
1. 安装TensorBoard进入已经安装Pytorch的conda环境
pip3 install tensorboard
2. SummaryWriter类
导入模块
from torch.utils.tensorboard import SummaryWriter
按住Ctrl点击SummaryWriter即可插件具体用法
log_dir (str)指定日志存储路径,默认为./runs/**CURRENT_DATETIME_HOSTNAME**
其他不常用的参数:comment (str),purge_step (int),max_queue (int),flush_secs (int),filename_suffix (str). 具体用法可见参数描述
创建实体类writer
writer = SummaryWriter("logs")
这会在当前目录下生成一个名为logs的文件夹,用于存放事件文件
3. add_scalar() 添加标量到Summary中
绘制标量数据:writer.add_scalar(tag, s ...
Redis 是一个开源的、基于内存的键值对(Key-Value)数据库。它的特点是速度极快,常被用作缓存、消息队列和会话存储。
Redis 快速入门1. Redis安装
Windows
推荐使用 WSL2 (Ubuntu) 安装sudo apt install redis 或者下载 Redis for Windows (不推荐官方已不再维护 Windows 版本)
Docker
docker run --name my-redis -d -p 6379:6379 redis
进入 Redis 命令行工具:
docker exec -it my-redis redis-cli
2. 核心概念:键值对 (Key-Value)Redis 类似于巨大的JSON对象或者Pyhon的字典。通过一个KEY来访问
3. 基础数据类型在redis-cli中执行命令
1. String最基本类型,可以存储文字,数字等等
SET/GET:设置和获取值
SET name tinsiag
GET name
#output: "tinsiag"
INCR ...
Spring Boot 入门1. 基础boot 工程的父工程, 用于管理起步依赖的管理
pom.xml
<parent>
xxx
</parent>
创建Maven工程
导入spring-boot-starter-web起步依赖
编写Controller
提供启动类
2. 配置
application.properties
[官方文档](Common Application Properties :: Spring Boot)
spring.application.name=spring-boot-quick-start
server.port=8081 //端口
debug=true //debug
server.servlet.context-path=/fuck //虚拟目录
application.yml 实际开发中使用
server:
port: 9191
servlet:
con ...
1. Java NIO 最推荐使用Java NIO (java.nio.file.Files)
读取文件最简单,代码最少的方法是使用Files类
import java.io.BufferedReader;
import java.io.FileNotFoundException;
import java.io.FileReader;
import java.io.IOException;
public class Main {
public static void main(String[] args) throws IOException {
BufferedReader br = new BufferedReader(new FileReader("src/1.txt"));
String line;
try {
while ((line = br.readLine())!= null){
...
0 运行环境本地Windows11
服务器Debian 12
1 整体流程
本地运行hexo deploy,通过git推送到服务器
在git仓库配置钩子脚本,在接收到推送后自动将最新的静态文件同步覆盖到指定的工作目录
配置nginx服务器,将请求指向该工作目录
2 本地安装2.1 安装 Node.js 和 GitNode.js安装链接
Git安装包链接
使用git -v,node -v验证安装C:\Users\Admin>git -v
git version 2.51.0.windows.1
C:\Users\Admin>node -v
v25.2.0
2.2 安装hexonpm install -g hexo-cli
2.3 初始化hexo新建一个文件夹 ,并在该文件夹路径下的终端运行hexo init,并安装hexo-deployer-git 插件npm install hexo-deployer-git --save
3 服务器安装3.1 安装Node.js和Git更新系统sudo apt update
sudo apt upgrade -y
安装sudo ...













