jeecg-boot新建module模块

使用IDEA创建module模块

点击create按钮后,即可创建新module模块。创建完成后需要做如下修改,保证接口文档、字典切面、新模块下的mapper扫描可以正常使用。

启动模块修改

pom.xml修改

jeecg-boot/jeecg-module-system/jeecg-system-start/pom.xml中新增app-boot的依赖

<dependencies>
        <!-- SYSTEM 系统管理模块 -->
        <dependency>
            <groupId>org.jeecgframework.boot</groupId>
            <artifactId>jeecg-system-biz</artifactId>
            <version>${jeecgboot.version}</version>
        </dependency>
        <!-- DEMO 示例模块 -->
        <dependency>
            <groupId>org.jeecgframework.boot</groupId>
            <artifactId>jeecg-module-demo</artifactId>
            <version>${jeecgboot.version}</version>
        </dependency>
        <!-- app-boot模块 -->
        <dependency>
            <groupId>com.app.boot</groupId>
            <artifactId>app-boot</artifactId>
            <version>${jeecgboot.version}</version>
        </dependency>

        <!-- flyway 数据库自动升级 -->
        <dependency>
            <groupId>org.flywaydb</groupId>
            <artifactId>flyway-core</artifactId>
        </dependency>
    </dependencies>

启动类修改

jeecg-boot/jeecg-module-system/jeecg-system-start/src/main/java/org/jeecg/JeecgSystemApplication.java新增com.app包扫描

/**
* 单体启动类
*/
@Slf4j
@SpringBootApplication
@ComponentScan(basePackages = {"org.jeecg.*","com.app.*"})
public class JeecgSystemApplication extends SpringBootServletInitializer {
  
  

接口文档相关修改

Swagger2Config

@Bean(value = "defaultApi2")
    public Docket defaultApi2() {
        return new Docket(DocumentationType.SWAGGER_2)
                .apiInfo(apiInfo())
                .select()
                //此包路径下的类,才生成接口文档
//                .apis(RequestHandlerSelectors.basePackage("org.jeecg"))
                .apis(basePackage("org.jeecg.modules"+SPLITOR+"com.app"))
                //加了ApiOperation注解的类,才生成接口文档
                .apis(RequestHandlerSelectors.withClassAnnotation(RestController.class))
                .apis(RequestHandlerSelectors.withMethodAnnotation(ApiOperation.class))
                .paths(PathSelectors.any())
                .build()
                .securitySchemes(Collections.singletonList(securityScheme()))
                .securityContexts(securityContexts())
                .globalOperationParameters(setHeaderToken());
    }
/**
     * @author jinhaoxun
     * @description 重写basePackage方法,使能够实现多包访问
     * @param basePackage 所有包路径
     * @return Predicate<RequestHandler>
     */
    public static Predicate<RequestHandler> basePackage(final String basePackage) {
        return input -> declaringClass(input).transform(handlerPackage(basePackage)::apply).or(true);
    }
    /**
     * @author jinhaoxun
     * @description 重写basePackage方法,使能够实现多包访问
     * @param basePackage 所有包路径
     * @return Function<Class<?>, Boolean>
     */
    private static Function<Class<?>, Boolean> handlerPackage(final String basePackage)     {
        return input -> {
            // 循环判断匹配
            for (String strPackage : basePackage.split(SPLITOR)) {
                assert input != null;
                boolean isMatch = input.getPackage().getName().startsWith(strPackage);
                if (isMatch) {
                    return true;
                }
            }
            return false;
        };
    }
    /**
     * @author jinhaoxun
     * @description 重写basePackage方法,使能够实现多包访问
     * @param input
     * @return Optional<? extends Class<?>>
     */
    private static Optional<Class<?>> declaringClass(RequestHandler input) {
        return Optional.fromNullable(input.declaringClass());
    }

mapper扫描

MybatisPlusSaasConfig

jeecg-boot/jeecg-boot-base-core/src/main/java/org/jeecg/config/mybatis/MybatisPlusSaasConfig.java增加com.app包扫描,避免新模块的mapper文件无法加载导致启动错误

/**
 * 单数据源配置(jeecg.datasource.open = false时生效)
 * @Author zhoujf
 *
 */
@Configuration
@MapperScan(value={"org.jeecg.modules.**.mapper*","com.app.**.mapper*"})
public class MybatisPlusSaasConfig {
  
  

application-dev.yml

jeecg-boot/jeecg-module-system/jeecg-system-start/src/main/resources/application-dev.yml新增com.app包扫描

#mybatis plus 设置
mybatis-plus:
  mapper-locations: classpath*:org/jeecg/**/xml/*Mapper.xml,classpath*:com/app/**/xml/*Mapper.xml
  global-config:
    # 关闭MP3.0自带的banner

本修改需要同步修改其他环境的配置文件例如prod、test等

字典切面修改

jeecg-boot/jeecg-boot-base-core/src/main/java/org/jeecg/common/aspect/DictAspect.java新增com.app包的切面配置

/**
     * 定义切点Pointcut
     */
    @Pointcut("(@within(org.springframework.web.bind.annotation.RestController) || " +
            "@within(org.springframework.stereotype.Controller) || @annotation(org.jeecg.common.aspect.annotation.AutoDict)) " +
            "&& execution(public org.jeecg.common.api.vo.Result org.jeecg..*.*(..)) || " +
            "execution(public org.jeecg.common.api.vo.Result com.app..*.*(..))")
    public void excudeService() {
    }

### JeecgBoot 单体服务架构概述 JeecgBoot 是一款基于 Spring Boot 2.x 和 Ant Design&Vue 的低代码开发平台,旨在通过自动化代码生成功能来简化 Java Web 应用程序的开发过程[^2]。该平台不仅提供了强大的代码生成工具,还引入了 Online Coding 模式,允许开发者在线配置表单、工作流和其他应用组件。 对于单体服务架构而言,JeecgBoot 提供了一站式的解决方案,涵盖了从前端到后端的所有方面。这种架构方式适合中小规模的应用场景,在单一进程中运行所有的功能模块,减少了分布式系统的复杂度和维护成本。 #### 使用指南 为了更好地理解和使用 JeecgBoot 构建单体应用程序,请遵循以下指导: ##### 安装与环境准备 确保本地已安装 JDK8 及以上版本,并设置好 Maven 或 Gradle 环境变量。下载并解压 JeecgBoot 最新稳定版源码包(当前为 v3.1.0),按照官方文档说明完成数据库初始化脚本执行以及必要的依赖库导入操作[^1]。 ##### 创建项目结构 启动 IDE (如 IntelliJ IDEA),创建一个新的 Maven 工程,将 `pom.xml` 文件中的 parent 继承指向 jeecg-boot-starter-parent 版本号;接着添加所需的 starter 模块作为子模块引用,比如 mybatis-plus-spring-boot-starter 来实现持久层访问等功能。 ```xml <parent> <groupId>org.jeecgframework.boot</groupId> <artifactId>jeecg-boot-starter-parent</artifactId> <version>3.1.0</version> </parent> <!-- 添加 Starter --> <dependencies> <!-- MyBatis Plus --> <dependency> <groupId>com.baomidou</groupId> <artifactId>mybatis-plus-boot-starter</artifactId> </dependency> ... </dependencies> ``` ##### 配置文件调整 编辑 application.yml 或 properties 格式的全局配置文件,指定数据源连接字符串、Redis 缓存服务器地址以及其他第三方服务接口信息等参数项。同时也可以在此处定义一些自定义属性用于控制特定行为或特性开关状态。 ```yaml spring: datasource: url: jdbc:mysql://localhost:3306/your_database?useUnicode=true&characterEncoding=utf-8&serverTimezone=UTC username: root password: your_password redis: host: localhost port: 6379 # 自定义配置 custom: featureToggle: true/false ``` ##### 启动类编写 最后一步是在项目的根目录下新建一个名为 Application.java 的入口类,继承于 SpringBootApplication 并标注 @EnableAutoConfiguration 注解以启用自动装配机制。这样当调用 main 方法时就能正常加载整个上下文环境并监听 HTTP 请求了。 ```java import org.springframework.boot.SpringApplication; import org.springframework.boot.autoconfigure.SpringBootApplication; @SpringBootApplication public class Application { public static void main(String[] args) { SpringApplication.run(Application.class, args); } } ``` --- #### 常见问题解答 针对初次接触 JeecgBoot 开发者可能会遇到的一些典型疑问如下所示: 1. **如何处理跨域请求?** 如果前端页面部署在不同域名上,则需要开启 CORS 支持。可以在 Controller 层面上加注解 `@CrossOrigin(origins = "*")` 实现简单的方式,或者更推荐的做法是统一在网关层面做集中管理。 2. **怎样优化性能表现?** 对于高并发场景下的响应速度提升,除了合理利用缓存技术外,还可以考虑分页查询代替全量拉取、异步任务调度减少主线程阻塞时间等方式来进行针对性改进措施。 3. **能否集成其他框架?** JeecgBoot 设计之初就充分考虑到兼容性和扩展性需求,因此完全可以与其他流行的开源软件组合起来共同发挥作用,例如 Elasticsearch 文档检索引擎、RabbitMQ 消息队列中间件等都可以无缝对接进来形成完整的生态系统。 4. **遇到了某些异常怎么办?** 日志记录是最直观有效的排查手段之一,建议先查看日志输出内容定位具体错误位置再采取相应修复策略。另外可以查阅社区论坛获取更多实战经验分享和技术交流机会。 5. **关于安全性方面的考量有哪些?** Shiro 身份认证授权框架已经被内置集成了进去,能够很好地满足大多数情况下安全防护的要求。当然如果追求更高的保护级别的话,不妨尝试接入 OAuth2/OIDC 授权协议或是 SSL/TLS 加密传输通道增强整体防御能力。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

燕山石头

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值