XwFast,我开发了一个基于SpringBoot和MyBatisPlus的敏捷开发框架!

简介: XwFast,我开发了一个基于SpringBoot和MyBatisPlus的敏捷开发框架!


🚀 A Cutting-edge Tool For Rapid Java Web Development.

👉 http://xuewei.world 👈


🚀简介

XwFast 是专为 Java Web 开发的基于 Spring 系列框架封装的黑科技脚手架,通过诸多实用工具类/组件的使用,旨在帮助开发者快速、便捷地完成各类开发任务。这些封装的工具组件涵盖了基础增删查改接口、邮件客户端、短信客户端、等一系列操作,可以满足各种不同的开发需求。

❤️理念

XwFast 旨在解放程序员生产力,用最少的代码做最多的事,将您的宝贵时间放在复杂业务和提升自我上,简单的事就交给 XwFast 吧!

🛠️组件

XwFast

采用了组件式的架构设计,您可按需引入所需要的模块,当然如果您是成年人,“成年人不做选择,我全都要!”,您可直接引入 xw-fast-all

模块 介绍
xw-fast-all 关于 XwFast 的全部内容
xw-fast-core 核心,包括的各种工具类、异常定义等
xw-fast-crud 封装基础增删查改的基础接口、基础实体的封装
xw-fast-web 封装一些开箱即用的 Spring 组件

📦安装

🍊Maven

在项目的 pom.xmldependencies 中加入以下内容:

<!-- 引入 Xw-Fast -->
<dependency>
    <groupId>world.xuewei</groupId>
    <artifactId>xw-fast-all</artifactId>
    <version>1.0.6</version>
</dependency>

📥下载jar

点击链接,下载 xw-fast-all-X.X.X.jar

即可,Maven中央库

📝文档

前往查看官方示例 xw-fast-demo

快速开始

创建一个基础的 SpringBoot 项目,引入下面依赖:

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter</artifactId>
        <version>2.7.17</version>
    </dependency>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
        <version>2.7.17</version>
    </dependency>
    <!-- MyBatis Plus -->
    <dependency>
        <groupId>com.baomidou</groupId>
        <artifactId>mybatis-plus-boot-starter</artifactId>
        <version>3.2.0</version>
    </dependency>
    <!-- MySQL -->
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <scope>runtime</scope>
        <version>5.1.48</version>
    </dependency>
    <!-- Druid -->
    <dependency>
        <groupId>com.alibaba</groupId>
        <artifactId>druid</artifactId>
        <version>1.2.8</version>
    </dependency>
    <dependency>
        <groupId>com.alibaba</groupId>
        <artifactId>druid-spring-boot-starter</artifactId>
        <version>1.2.8</version>
    </dependency>
    <!-- 引入 Xw-Fast -->
    <dependency>
        <groupId>world.xuewei</groupId>
        <artifactId>xw-fast-all</artifactId>
        <version>1.0.6</version>
    </dependency>
</dependencies>

将 XwFast 的组件配置给 SpringBoot 扫描:

@ComponentScan(value = {"world.xuewei.fast", "你自己的项目包路径"})
@SpringBootApplication
public class XwFastDemoApplication {
    public static void main(String[] args) {
        SpringApplication.run(XwFastDemoApplication.class, args);
    }
}

在 SpringBoot 配置文件中正常配置数据源等信息,之后创建基础目录结构,如下(也可按照自己的想法自行设计):

controller

控制器包,编写控制器时继承 XwFast 封装的 BaseController,传入绑定的实体泛型。也可以在当前控制器类上声明注解

@FastController,XwFast 会自动注册这些增删查改接口。

点击链接查看接口示例

👉 基础增删查改接口示例 - XwFast

@RestController
@RequestMapping("/Example")
public class ExampleController extends BaseController<Example> {
    public ExampleController(ExampleService service) {
        super(service);
    }
    // Write Your Code Here ...
}
@RestController
@FastController
@RequestMapping("/Example")
public class ExampleController {
    @Autowired
    private ExampleService service;
    // Write Your Code Here ...
}
service

业务实现层,编写服务时继承 XwFast 封装的 BaseDBService,里面像 MyBatisPlus 一样封装了增删查改的接口,如果想问区别的话,那么我只能说

XwFast 更全面!

@Service
public class ExampleService extends BaseDBService<Example> {
    public ExampleService(ExampleMapper mapper) {
        super(mapper);
    }
    // Write Your Code Here ...
}
mapper

数据库访问层,和 Dao 是同一个意思,这里你可以直接继承自 MyBatisPlus 的 BaseMapper 类,传入实泛型。

@Mapper
public interface ExampleMapper extends BaseMapper<Example> {
    // Write Your Code Here ...
}
entity

数据库实体包,编写实体时继承 XwFast 封装的 BaseEntity,涉及到一些数据库的基础字段。

@Data
@Builder
@NoArgsConstructor
@AllArgsConstructor
@TableName("example")
@EqualsAndHashCode(callSuper = true)
public class Example extends BaseEntity implements Serializable {
    private static final long serialVersionUID = 541179640568881082L;
    /**
     * 编码
     */
    private String code;
    /**
     * 名称
     */
    private String name;
    /**
     * 备注
     */
    private String remark;
}

以上步骤做完之后那么恭喜你,运行服务就可以打开 Postman、Apifox 等接口测试工具测试了!

接口文档可查看示例:基础增删查改接口示例 - XwFast

如果你觉得创建、编写上面的几个类文件麻烦的话,XwFast 也帮你想了办法,你可以下载一个名为 EasyCode 的 IDEA

插件,这个插件可以帮你一键生成对应的实体、服务、DAO、Controller 等。但是你需要将 XwFast 提供的代码模板导入到你的 IDEA 配置。

可关注我的公众号:【薛伟同学】,后台回复【XwFast模板】获取代码模板。

【B站 - EasyCode使用教学视频 - 薛伟同学】

🏗️添砖加瓦

🌵分支说明

XwFast 的源码分为两个分支,功能如下:

分支 说明
main 🚩 主分支,release 版本使用的分支,与中央库提交的 jar 一致,不接收任何 pr 或修改
dev 🏴 开发分支,默认为下个版本的 SNAPSHOT 版本,接受修改或 pr

🐞提供bug反馈或建议

提交问题反馈请说明正在使用的 JDK 版本、XwFast 版本和相关依赖库版本。

Issues · XwFast

💡贡献代码的步骤

  1. 在 Github 上 fork 项目到自己的 repo
  2. 把 fork 过去的项目也就是你的项目 clone 到你的本地
  3. 修改代码(记得一定要修改 dev 分支)
  4. commit 后 push 到自己的库(dev分支)
  5. 登录 Github 在你首页可以看到一个 Pull Request 按钮,点击它,填写一些说明信息,然后提交即可
  6. 等待维护者合并

📐PR遵照的原则

XwFast 欢迎任何人为 XwFast 添砖加瓦,贡献代码,不过维护者是一个强迫症患者,为了照顾病人,需要提交的 pr(pull

request)符合一些规范,规范如下:

  1. 注释完备,尤其每个新增的方法应按照 Java 文档规范标明方法说明、参数说明、返回值说明等信息,必要时请添加单元测试,如果愿意,也可以加上你的大名。
  2. XwFast 代码的缩进按照默认(tab)缩进,所以请遵守(不要和我争执空格与 tab 的问题,这是一个病人的习惯)。
  3. 请 pull request 到 dev 分支。
  4. 我们如果关闭了你的 issue 或 pr,请不要诧异,这是我们保持问题处理整洁的一种方式,你依旧可以继续讨论,当有讨论结果时我们会重新打开。
相关文章
|
9天前
|
XML Java 数据格式
SpringBoot入门(8) - 开发中还有哪些常用注解
SpringBoot入门(8) - 开发中还有哪些常用注解
27 0
|
21天前
|
数据采集 监控 前端开发
二级公立医院绩效考核系统源码,B/S架构,前后端分别基于Spring Boot和Avue框架
医院绩效管理系统通过与HIS系统的无缝对接,实现数据网络化采集、评价结果透明化管理及奖金分配自动化生成。系统涵盖科室和个人绩效考核、医疗质量考核、数据采集、绩效工资核算、收支核算、工作量统计、单项奖惩等功能,提升绩效评估的全面性、准确性和公正性。技术栈采用B/S架构,前后端分别基于Spring Boot和Avue框架。
|
30天前
|
Java API 数据库
Spring Boot框架因其简洁的配置、快速的启动特性及丰富的功能集而备受开发者青睐
本文通过在线图书管理系统案例,详细介绍如何使用Spring Boot构建RESTful API。从项目基础环境搭建、实体类与数据访问层定义,到业务逻辑实现和控制器编写,逐步展示了Spring Boot的简洁配置和强大功能。最后,通过Postman测试API,并介绍了如何添加安全性和异常处理,确保API的稳定性和安全性。
36 0
|
13天前
|
SQL Java 数据库连接
持久层框架MyBatisPlus
持久层框架MyBatisPlus
31 1
持久层框架MyBatisPlus
|
25天前
|
前端开发 Java 数据库连接
Spring 框架:Java 开发者的春天
Spring 框架是一个功能强大的开源框架,主要用于简化 Java 企业级应用的开发,由被称为“Spring 之父”的 Rod Johnson 于 2002 年提出并创立,并由Pivotal团队维护。
43 1
Spring 框架:Java 开发者的春天
|
17天前
|
JavaScript 安全 Java
如何使用 Spring Boot 和 Ant Design Pro Vue 构建一个前后端分离的应用框架,实现动态路由和菜单功能
本文介绍了如何使用 Spring Boot 和 Ant Design Pro Vue 构建一个前后端分离的应用框架,实现动态路由和菜单功能。首先,确保开发环境已安装必要的工具,然后创建并配置 Spring Boot 项目,包括添加依赖和配置 Spring Security。接着,创建后端 API 和前端项目,配置动态路由和菜单。最后,运行项目并分享实践心得,帮助开发者提高开发效率和应用的可维护性。
35 2
|
16天前
|
消息中间件 NoSQL Java
springboot整合常用中间件框架案例
该项目是Spring Boot集成整合案例,涵盖多种中间件的使用示例,每个案例项目使用最小依赖,便于直接应用到自己的项目中。包括MyBatis、Redis、MongoDB、MQ、ES等的整合示例。
67 1
|
25天前
|
Java 数据库连接 开发者
Spring 框架:Java 开发者的春天
【10月更文挑战第27天】Spring 框架由 Rod Johnson 在 2002 年创建,旨在解决 Java 企业级开发中的复杂性问题。它通过控制反转(IOC)和面向切面的编程(AOP)等核心机制,提供了轻量级的容器和丰富的功能,支持 Web 开发、数据访问等领域,显著提高了开发效率和应用的可维护性。Spring 拥有强大的社区支持和丰富的生态系统,是 Java 开发不可或缺的工具。
|
1月前
|
人工智能 开发框架 Java
总计 30 万奖金,Spring AI Alibaba 应用框架挑战赛开赛
Spring AI Alibaba 应用框架挑战赛邀请广大开发者参与开源项目的共建,助力项目快速发展,掌握 AI 应用开发模式。大赛分为《支持 Spring AI Alibaba 应用可视化调试与追踪本地工具》和《基于 Flow 的 AI 编排机制设计与实现》两个赛道,总计 30 万奖金。
|
1月前
|
人工智能 Java API
阿里云开源 AI 应用开发框架:Spring AI Alibaba
近期,阿里云重磅发布了首款面向 Java 开发者的开源 AI 应用开发框架:Spring AI Alibaba(项目 Github 仓库地址:alibaba/spring-ai-alibaba),Spring AI Alibaba 项目基于 Spring AI 构建,是阿里云通义系列模型及服务在 Java AI 应用开发领域的最佳实践,提供高层次的 AI API 抽象与云原生基础设施集成方案,帮助开发者快速构建 AI 应用。本文将详细介绍 Spring AI Alibaba 的核心特性,并通过「智能机票助手」的示例直观的展示 Spring AI Alibaba 开发 AI 应用的便利性。示例源