2025 年 09 月

NightCore-API开发指南

NightCore-API 是一个专为 Java 21+ 及 Spigot/Paper 1.20+ 服务器设计的轻量级插件开发框架，旨在通过提供现代化的架构和完整的工具集，大幅简化和加速插件开发流程。 该框架核心特性包括：现代化UI系统、强大的命令框架、灵活的配置管理、内置数据库支持、全面的国际化（i18n）功能、以及基于Manager的多模块架构。它还提供自动化的生命周期管理、事件处理系统、权限控制系统、多样化的消息发送（如ActionBar、Title、全息）和丰富的实用工具类。 开发者可通过简单的Maven依赖配置、继承`NightPlugin`主类和配置`plugin.yml`快速上手。NightCore-API 鼓励模块化设计和利用其提供的工具，确保插件高效、稳定且易于维护，致力于为开发者提供一个高效、功能全面的开发平台，助力构建高质量的Minecraft服务器插件。
作者：XiaoLin
标签： #Minecraft , #Spigot , #Bukkit

2024 年 08 月

kafka 的基本使用

Apache Kafka是一个开源的分布式流处理平台，最初由LinkedIn开发，主要用于构建实时数据管道和流处理应用程序，高效处理大量数据流。 其核心概念包括：**主题（Topic）**用于消息分类；**生产者（Producer）**发布消息；**消费者（Consumer）**订阅消息，可通过**消费者组（Consumer Group）**实现负载均衡；**代理（Broker）**是Kafka服务器，负责存储和处理数据；**分区（Partition）**将主题数据细分，提升并行度和吞吐量，并确保分区内消息有序；**偏移量（Offset）**标识消息在分区中的位置。 Kafka具备高吞吐量、可扩展性、持久性、容错性和实时性等特点。消息模型支持发布订阅和点对点模式。自Kafka 2.8起，引入**KRaft模式**替代ZooKeeper进行元数据管理，简化了部署和运维。用户可通过命令行工具快速部署Kafka集群，管理主题，并进行消息的生产和消费。
作者：XiaoLin
分类： 开发
标签： #java , #学习 , #SpringBoot

2024 年 06 月

使用 Triton 的 BLS 部署印章识别模型

Triton的Python Backend允许用户在Python中实现预处理、后处理及自定义逻辑，将Python模块嵌入Triton服务器执行。模型需在`model.py`中实现`TritonPythonModel`类，其核心是`execute`方法处理推理请求，`initialize`和`finalize`用于初始化和清理。用户可通过`conda-pack`打包自定义Python环境，并在`config.pbtxt`中通过`EXECUTION_ENV_PATH`参数指定。 BLS（业务逻辑脚本）是Python Backend的核心能力，扩展了Triton的集成模型（ensemble）功能，允许在推理流程中编排复杂的业务逻辑，如条件、循环，并调用其他模型。`pb_utils.InferenceRequest`和`pb_utils.InferenceResponse`是其核心API，用于进行模型间调用和处理响应。`triton_python_backend_utils`提供张量操作等辅助功能。 文章以TrOCR印章识别模型为例，演示了BLS如何整合`seal_encoder`和`seal_decoder`两个ONNX模型，实现端到端识别。BLS脚本负责预处理、模型调用及后处理，配置文件后端需设为`python`。需注意：GPU上的`pb_utils.Tensor`不能直接转NumPy，需通过DLPack先转为PyTorch Tensor再处理。
作者：XiaoLin
分类： 开发
标签： #python , #人工智能

Triton 部署 YOLOv8

NVIDIA Triton Inference Server是一款高性能、开源的深度学习推理服务器，旨在优化AI模型在云和边缘的部署。它支持TensorFlow、PyTorch、ONNX等主流框架，可在GPU、CPU等多种硬件上运行，提供高性能、低延迟的并发推理服务和监控工具，并支持单节点/集群部署、自动扩展及负载均衡。 Triton核心通过模型仓库集中管理模型，要求模型按`model_name/version/model_file`结构组织，并通过`config.pbtxt`定义模型名称、平台、输入输出张量及资源分配等配置。文章演示了使用Docker启动Triton，并以YOLOv8为例详细说明部署流程：首先将`.pt`模型导出为ONNX，按Triton规范配置模型仓库；为优化性能，还展示了ONNX转TensorRT并无缝切换部署后端。最后，提供了查看ONNX和PyTorch模型输入输出张量的Python工具，便于正确配置。
作者：XiaoLin
分类： 开发
标签： #python , #人工智能

2024 年 02 月

retrofit 添加对 SpringCloud LoadBalancer 的支特

本文详细介绍了Retrofit和Spring Cloud LoadBalancer，并阐述了如何将两者集成。Retrofit是一款由Square开发的类型安全的HTTP客户端，简化了Java/Android应用的网络请求，通过将REST API映射到Java接口方法，并提供自动数据解析、异步/同步支持及高可定制性（如OkHttp拦截器）等强大功能。 Spring Cloud LoadBalancer是一个客户端负载均衡解决方案，旨在微服务架构中高效分配请求，避免服务过载。它与Spring生态系统无缝集成，提供灵活的负载均衡策略，并替代了Netflix Ribbon。 文章详细阐述了如何将Spring Cloud LoadBalancer集成到Retrofit中。其核心思路是借鉴OpenFeign，通过自定义`RetrofitLoadBalancerInterceptor`（基于OkHttp拦截器）来实现。此拦截器在Retrofit发出请求前，利用`LoadBalancerClient`选择一个服务实例，重构请求URL。它还整合了`LoadBalancerLifecycle`接口，允许在负载均衡的不同阶段执行自定义逻辑（如日志记录、监控），从而实现Retrofit请求的动态负载均衡和精细化控制。
作者：XiaoLin
分类： 开发
标签： #java , #retrofit , #http , #springcloud

适配器设计模式学习笔记

适配器模式（Adapter Pattern）是一种结构型设计模式，旨在将一个类的接口转换为客户期望的另一个接口，使原本接口不兼容的类能够协同工作。 它包含目标接口 (Target)、需要被适配的类 (Adaptee)、执行转换的适配器 (Adapter) 和使用适配功能的客户端 (Client)。实现方式主要有**类适配器**（通过继承实现适配）和**对象适配器**（通过组合/委托实现适配），后者耦合度更低。 该模式适用于不修改现有代码结构下实现新功能，或当现有系统接口难以修改的场景，但需注意避免过度使用导致可读性下降。 实际应用广泛，例如**SLF4J**通过适配器（如`slf4j-log4j12`）统一不同日志框架（如Log4j）的API，为客户端提供一致的日志接口。**SpringMVC**也通过`HandlerAdapter`接口适配不同类型的处理器（Handler），实现请求的统一处理。
作者：XiaoLin
分类： 开发
标签： #设计模式 , #java , #结构型设计模式

组合设计模式学习笔记

组合设计模式是一种结构型模式，它将对象组合成树形结构以表示“部分-整体”的层次关系，使得客户端能统一处理单个对象和组合对象。该模式包含三个核心角色：抽象构件（Component），叶子节点（Leaf），以及组合节点（Composite）。其中，组合节点可以包含其他构件，并递归地执行操作。 其优点在于简化客户端代码，提高代码的可扩展性和复用性；但缺点是可能增加系统复杂性并导致过度设计，因此仅适用于业务场景能表示为树形结构的场合。文章通过文件系统（文件为叶子，文件夹为组合）的示例详细展示了其实现。该模式在JDK的Collection框架、Servlet API以及SSM框架（如Spring MVC Controller、MyBatis的SqlNode）中均有广泛应用，本质上是对树形数据结构和递归算法的抽象。
作者：XiaoLin
分类： 开发
标签： #java , #设计模式 , #结构型设计模式

装饰器设计模式学习笔记

装饰器设计模式是一种结构型模式，允许在不改变原有对象结构和功能的前提下，为其动态地增加新的职责和行为。其核心思想是“组合优于继承”，通过将新功能封装成独立的装饰者对象，并将其与原始对象组合起来，以扩展功能。 该模式包含抽象构件、具体构件、抽象装饰者和具体装饰者四个核心角色。具体构件是被装饰的原始对象，而具体装饰者则通过引用具体构件并实现相同接口的方式，为其添加额外功能。 Java I/O库是装饰器模式的典型应用，如`BufferedInputStream`包装`FileInputStream`来增强读取效率。装饰器模式的显著特点是：装饰者和被装饰者都实现同一接口，从而支持多层嵌套功能；并且它专注于**增强**原始对象**相关**的功能，而非像代理模式那样添加不相关的控制功能。
作者：XiaoLin
分类： 开发
标签： #java , #设计模式 , #结构型设计模式

享元设计模式学习笔记

享元模式（Flyweight Pattern）旨在通过共享来减少大量相似对象的内存消耗。它将对象状态划分为内蕴状态（共享且不随环境改变）和外蕴状态（由客户端维护且随环境改变），从而实现高效复用。 该模式主要由抽象享元、具体享元、享元工厂（负责创建管理共享对象）和客户端组成。它适用于大量细粒度对象造成内存开销大的场景。例如，在棋牌游戏中，通过共享棋子类型（内蕴状态）对象，仅独立存储其位置（外蕴状态），可大幅节省内存。 享元模式与单例、缓存、对象池等概念存在重要区别：享元可创建多个共享对象，旨在复用以节省内存，而非如单例般限制对象数量；其工厂的“存储”旨在共享，与传统为提高访问效率的缓存不同；而与对象池的“重复使用”（独占后归还，节约时间）不同，享元强调“共享使用”（同时被多处引用），主要目的是节约内存空间。
作者：XiaoLin
分类： 开发
标签： #设计模式 , #java , #结构型设计模式

桥接设计模式学习笔记

桥接设计模式（Bridge Pattern）是一种结构型设计模式，旨在将抽象部分与实现部分解耦，使它们可以独立地变化。其核心思想是，在不改变抽象部分的前提下，为抽象提供多种实现方式。该模式主要包含抽象类（Abstraction）、实现类接口（Implementor），以及具体的精化抽象类（RefinedAbstraction）和具体实现类（ConcreteImplementor）。 桥接模式适用于抽象与实现之间差异显著、需要多种实现方式，或两者都需要独立扩展的场景。它的主要优点是实现与抽象分离，大大提高了系统的灵活性和可扩展性，并促进了单一职责原则的遵循。例如，Java JDBC API（抽象）与各种数据库驱动（实现）即是典型的桥接模式应用。尽管它可能增加系统的复杂性，但能有效减少代码冗余和耦合，提升可维护性。
作者：XiaoLin
分类： 开发
标签： #java , #设计模式 , #结构型设计模式
共 30 篇文章
页