BudWk: Java微服务开源框架的演进与应用指南

需积分: 9 0 下载量 105 浏览量 更新于2024-11-08 收藏 378KB ZIP 举报
资源摘要信息:"BudWk企业级开源开发框架介绍" BudWk(原名NutzWk)是一个资深的Java Web开源开发框架,从V6版本开始更名为BudWk。BudWk框架的历史悠久,经过多年的沉淀和优化,现已形成成熟的6.x版本,具备Java微服务分布式架构和前后端完全分离的特点。 BudWk框架的技术栈包括多种流行的开源技术: - nutzboot(nutz核心):为框架提供了基础运行和管理能力。 - dubbo:用于服务的远程调用。 - redis:作为高性能的键值存储数据库,用于处理缓存和会话。 - zookeeper:用于服务注册和发现,以及分布式协调。 - shiro:为系统提供安全认证和授权功能。 - quartz:用于任务调度。 - beetl:作为模板引擎。 - logback:用于日志记录。 - sentinel(可选):作为流量控制框架,用于系统限流。 - seata(可选):提供了分布式事务管理。 BudWk框架自带多个模块,包括系统管理、简易CMS、微信模块、定时任务和丰富的服务API,能够广泛地应用于商业项目中。 运行环境要求: - JDK 8 181+ 或 OpenJDK 11+ - Redis 4.0.8+ - 支持MySQL 5.7+、MariaDB、Oracle、SqlServer、达梦等多种数据库。 - Zookeeper 3.4.13+ 安装和使用说明: 1. 确保数据库和Redis服务已启动,并且监听默认端口。 2. 在MySQL数据库中创建名为nutzwk_nb的空数据库,NB模块启动时会自动进行表的创建和数据初始化。 3. 在项目根目录运行`mvn clean install -Dmaven.test.skip=true`进行项目构建。 4. 在NB模块目录下运行`mvn compile nutzboot:run`或`mvn package nutzboot:shade`来运行项目或打包生成可执行的jar文件。 5. 在项目根目录运行`mvn -Dmaven.javadoc.skip=true -Dmaven.test.skip=true -Dnutzboot.dst=E:/dst clean package nutzboot:shade`将所有可运行jar包生成到指定位置。 6. 根据模块启动顺序依次启动,包括系统模块(sys)、日志模块(slog)、可选的CMS模块、微信模块(wx)、定时任务模块(task)、后台管理模块(web-admin)和前端管理模块(wk-vue-admin)。 7. 启动完成后,通过访问***,并使用用户名superadmin和密码1来进行登录。 代码生成器使用: - 安装nodejs后,通过执行命令`npm install apidoc -g`来全局安装apidoc工具。 - 在wk-nb-web-admin目录下,执行`apidoc -i ./ -o E:/dst/apidoc_admin/`生成后台接口文档。 - 在wk-nb-web-api-open目录下,执行`apidoc -i ./ -o E:/dst/apidoc_api/`生成对外接口文档。 项目部署: - 内置配置文件启动方式:`nohup java -jar wk-nb-service-sys.jar &`,通过添加参数`-Dnutz.profiles.active=prod`来加载`application-prod.properties`文件。 - 外置配置文件启动方式:`nohup java -Dnutz.boot.configure.properties.dir=/data/nutzwk/sys/ -jar wk-nb-service-sys.jar &`,这种方式会加载指定文件夹下的所有`.properties`配置文件。 - 生产环境中,推荐使用budwk-daemon-python脚本进行部署,能够在线更新jar包和配置文件。 BudWk框架的文件压缩包中包含了`说明.htm`和`budwk-nutzboot`两个重要文件。`说明.htm`文件可能包含了更多关于框架的详细说明和使用帮助,而`budwk-nutzboot`文件则很可能是框架的核心文件或相关文档,具体功能需要根据实际内容进一步分析。