# loveqq-framework

**Repository Path**: hopper/loveqq-framework

## Basic Information

- **Project Name**: loveqq-framework
- **Description**: 轻量级 ioc/aop 框架，比 spring 更强大的条件推断；抽象出 mvc 模式，提供嵌入式 reactor-netty、tomcat 服务器；
提供 javafx mvvm 框架，可实现模型-数据的双向绑定；提供动态数据源配置支持；提供注解式缓存支持；
已集成 
    aspect、reactor-netty、tomcat、nacos、feign、mybatis、spring-tx、js
- **Primary Language**: Java
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: http://www.kfyty.com
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 10
- **Created**: 2024-09-12
- **Last Updated**: 2024-09-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# loveqq-framework
    轻量级 ioc/aop 框架，比 spring 更强大的条件推断；抽象出 mvc 模式，提供嵌入式 reactor-netty、tomcat 服务器；
    提供 javafx mvvm 框架，可实现模型-数据的双向绑定；提供动态数据源配置支持；提供注解式缓存支持；
    已集成 
        aspect、reactor-netty、tomcat、nacos、feign、mybatis、spring-tx、jsr303-valid、
        logback、jakarta-mail、quartz、xxl-job、pagehelper、redisson、shiro、thymeleaf、
        datasource-auto-config、baidu-uid-generator 等常用组件；
    默认提供 jar 包瘦身方式打包，支持 jarindex 启动，启动速度更快；
    已提供 Ruoyi-for-loveqq 版本，替换到 spring 及其全部 starter，开箱即用。

## loveqq-core
项目核心，包含一些通用工具类、jar index 启动引导、泛型推断工具、jdbc 访问工具、bean 封装工具、包读取工具、json 转换工具以及自动配置接口、自动配置注解等

## loveqq-boot
ioc 容器具体实现、自动装配、作用域代理(单例/原型/刷新)、懒加载代理、配置文件属性自动绑定(支持嵌套的复杂类型绑定)、条件注解、jsr 条件注解校验器、异步事件、动态代理、spi、自定义 jar index 类加载器等。

## loveqq-aop
aop 模块，支持 ant 路径匹配、注解类型匹配、集成 AspectJ 支持 pointcut 表达式匹配。

## loveqq-data-jdbc
数据库访问工具，基于代理实现了接口式 jdbc 访问，支持注解编写 SQL 或者基于模板引擎(如：enjoy/freemarker) 的动态 SQL；
内置代码生成器和默认生成模板，支持 java 编程模板、enjoy/freemarker 模板以及 jsp 模板（需要 k-jte 支持），或者自定义模板引擎。

## loveqq-mvc
基础 mvc 抽象，用于适配不同的 web 服务器，包含了路由注册、参数绑定、请求分发、请求拦截器等。

## loveqq-mvc-servlet
mvc 模式的 servlet 实现，主要实现了 DispatcherServlet，以及 Filter、Servlet 的自动配置等。
配套的启动器是 loveqq-boot-starter-tomcat

## loveqq-mvc-netty
mvc 模式的 netty 实现，主要实现了 DispatcherHandler，并添加自定义 Filter 的自动配置等。
配套的启动器是 loveqq-boot-starter-netty

## loveqq-boot-cloud-bootstrap
微服务架构必须的引导启动模块

## loveqq-boot-starter-validator
jsr303-valid 集成，并添加了自定义约束注解，可实现基于 Ognl 表达式的动态联动校验。

## loveqq-boot-starter-discovery-nacos/loveqq-boot-starter-config-nacos
集成了 nacos 服务发现、服务配置

## loveqq-sdk
用于快速封装 sdk，只需编写请求及响应模型，支持拦截器，易于拓展，支持命令式、响应式风格

## loveqq-javafx
javafx mvvm 框架，实现了视图和数据模型的双向绑定。代码中只需操作数据即可反应到视图上，视图上编辑数据即可反应到模型里。详见 javafx 模块 README.md.

## Ruoyi-for-loveqq
基于 loveqq 框架的单体版若依，去除了底层 spring 及其 spring boot starter。详情请查看仓库列表。

```xml
<dependency>
    <groupId>com.kfyty</groupId>
    <artifactId>loveqq-boot</artifactId>
    <version>1.0.0</version>
</dependency>
```
```java
package com.kfyty.demo;

import com.kfyty.loveqq.framework.boot.K;
import com.kfyty.loveqq.framework.boot.validator.annotation.Condition;
import com.kfyty.loveqq.framework.core.autoconfig.annotation.Async;
import com.kfyty.loveqq.framework.core.autoconfig.annotation.BootApplication;
import com.kfyty.loveqq.framework.core.autoconfig.annotation.EventListener;
import com.kfyty.loveqq.framework.core.event.ContextRefreshedEvent;
import com.kfyty.loveqq.framework.web.core.annotation.GetMapping;
import com.kfyty.loveqq.framework.web.core.autoconfig.annotation.EnableWebMvc;
import lombok.Data;
import lombok.extern.slf4j.Slf4j;

@Slf4j
@EnableWebMvc
@BootApplication
public class Main {

    public static void main(String[] args) {
        K.run(Main.class, args);
    }

    @GetMapping
    public User hello(@Valid User user) {
        return user;
    }

    @Async
    @EventListener
    public void onStarted(ContextRefreshedEvent event) {
        log.info("started succeed !");
    }

    @Data
    public static class User {
        @Condition(when = "type == 1", then = "photo != null", message = "type=1时，图片不能为空")
        private Integer type;

        private String photo;
    }
}
```

### 最佳实践
建议项目继承 loveqq-framework 父模块
```xml
    <parent>
        <groupId>com.kfyty</groupId>
        <artifactId>loveqq-framework</artifactId>
        <version>1.0.0</version>
    </parent>
```

打包时，需要在子模块添加以下配置，以生成 jar index
```xml
    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-antrun-plugin</artifactId>
            </plugin>
        </plugins>
    </build>
```
同时添加以下配置，以设置自己的启动类，打包后即可读取 jar index 启动
```xml
    <properties>
        <boot-start-class>com.kfyty.demo.Main</boot-start-class>
    </properties>
```