快速开始

本指南将帮助你在 5 分钟内开始使用 LCGYL Framework。

前置要求

• JDK 21 或更高版本
• Gradle 8.0+ 或 Maven 3.8+
• 你喜欢的 IDE（推荐 IntelliJ IDEA）

安装

使用 Gradle

在 build.gradle 中添加依赖：

dependencies {
    implementation 'com.lcgyl:lcgyl-framework-core:2.2.0'
}

使用 Maven

在 pom.xml 中添加依赖：

<dependency>
    <groupId>com.lcgyl</groupId>
    <artifactId>lcgyl-framework-core</artifactId>
    <version>2.2.0</version>
</dependency>

Hello World

创建你的第一个 LCGYL 应用：

import com.lcgyl.framework.core.annotation.Component;
import com.lcgyl.framework.core.annotation.Inject;
import com.lcgyl.framework.core.Application;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

@Component
public class HelloWorld {
    
    private static final Logger logger = LoggerFactory.getLogger(HelloWorld.class);
    
    public void sayHello() {
        logger.info("Hello, LCGYL Framework!");
    }
    
    public static void main(String[] args) {
        // 启动应用
        Application app = Application.run(HelloWorld.class, args);
        
        // 获取组件
        HelloWorld hello = app.getBean(HelloWorld.class);
        hello.sayHello();
    }
}

运行程序，你将看到：

Hello, LCGYL Framework!

依赖注入

LCGYL 提供了简单而强大的依赖注入：

@Component
public class UserService {
    
    private final UserRepository userRepository;
    
    @Inject
    public UserService(UserRepository userRepository) {
        this.userRepository = userRepository;
    }
    
    public User findById(Long id) {
        return userRepository.findById(id);
    }
}

@Component
public class UserRepository {
    
    public User findById(Long id) {
        // 查询用户
        return new User(id, "张三");
    }
}

事件驱动

使用事件总线进行组件间通信：

// 定义事件
public record UserCreatedEvent(User user) implements Event {
}

// 发布事件
@Component
public class UserService {
    
    @Inject
    private EventBus eventBus;
    
    public User createUser(String name) {
        User user = new User(name);
        // 发布事件
        eventBus.publish(new UserCreatedEvent(user));
        return user;
    }
}

// 监听事件
@Component
public class EmailService {
    
    @Subscribe
    public void onUserCreated(UserCreatedEvent event) {
        // 发送欢迎邮件
        sendWelcomeEmail(event.user());
    }
}

配置管理

使用配置文件管理应用配置：

# application.properties
app.name=MyApp
app.version=1.0.0
app.server.port=8080

@Component
public class AppConfig {
    
    @Value("app.name")
    private String name;
    
    @Value("app.version")
    private String version;
    
    @Value("app.server.port")
    private int port;
}

下一步

恭喜！你已经学会了 LCGYL Framework 的基础用法。

深入学习

• 项目结构 - 了解标准项目结构
• 依赖注入 - 深入理解 IoC 容器
• 配置管理 - 掌握配置管理

核心功能

• IoC 容器 - 完整的依赖注入功能
• 事件总线 - 事件驱动架构
• AOP 支持 - 面向切面编程
• 插件系统 - 可扩展的插件机制

进阶功能

• 数据访问 - 数据库操作
• Web 开发 - 构建 Web 应用
• 安全认证 - JWT 认证和授权
• 消息队列 - 异步消息处理

Spring 用户

如果你熟悉 Spring Framework：

• Spring 集成指南 - 与 Spring 无缝集成
• 配置说明 - Spring 配置方式
• 最佳实践 - Spring 集成最佳实践

实战示例

• Web 应用示例 - 完整的 Web 应用
• 微服务示例 - 微服务架构
• 博客系统 - 真实项目案例