在真实环境中完整评估产品能力
连接真实数据
对接您企业内部数据库
完整集成流程
体验从集成到运行的全程
技术方案验证
用真实报表验证性能
专属技术支持
部署过程一对一协助
本地部署运行环境
BaskServer 基于 Java 与 Web 技术打造,可轻松部署于 SpringBoot 项目中,配置信息存储于数据库,支持 9 种主流关系型数据库。
🖥 操作系统
- Windows Server 2016 / 10 及以上
- Linux(CentOS 7+、Ubuntu 18+ 等)
- macOS(开发测试环境)
☕ 运行环境
- JDK 1.8 及以上(SpringBoot2)
- JDK 17 及以上(SpringBoot3)
- Maven 3.6+(依赖管理)
- 推荐 JVM 内存:2GB 及以上
🗄 数据库(任选其一)
- MySQL 5.7+ / PostgreSQL 10+
- Oracle 11g+ / SQL Server 2016+
- DB2 / GBase / Informix
- HSQL / SQLite(仅测试用)
SpringBoot 项目集成 BaskServer
根据您的 SpringBoot 版本选择对应部署包,按以下三步完成集成:添加依赖、配置 BaskFilter、初始化数据库。官方提供 SpringBoot2 与 SpringBoot3 模板项目可直接参考。
第一步:添加 baskserver 相关的 jar
官方提供了 SpringBoot2 模板项目,可直接下载参考:gitee.com/xiaodaodao/baskserver-boot
以 Maven 项目为例,在 pom.xml 中添加 BaskReport、BaskReport 字体包与 BaskAdapt 依赖:
<dependency> <groupId>com.basksoft</groupId> <artifactId>baskreport</artifactId> <version>${baskreport.version}</version> </dependency> <dependency> <groupId>com.basksoft</groupId> <artifactId>baskreport-font</artifactId> <version>${baskreport-font.version}</version> </dependency> <dependency> <groupId>com.basksoft</groupId> <artifactId>baskadapt</artifactId> <version>${baskadapt.version}</version> </dependency>
https://central.sonatype.com/repository/maven-snapshots/);若通过 repository 仍无法下载,可在 Maven 的
settings.xml 中添加对应 mirror 配置。
第二步:添加 BaskFilter 配置
在 SpringBoot2 项目中新建配置类,注册 BaskFilter 并拦截所有请求路径:
import org.springframework.boot.web.servlet.FilterRegistrationBean; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; import org.springframework.core.env.Environment; import org.springframework.web.servlet.config.annotation.WebMvcConfigurer; import com.basksoft.core.BaskFilter; @Configuration public class BaskServerConfig implements WebMvcConfigurer { @Bean public FilterRegistrationBean registerReportFilter() { FilterRegistrationBean registration = new FilterRegistrationBean(new BaskFilter()); registration.addUrlPatterns("/*"); registration.setName("baskserver"); registration.setOrder(1); return registration; } }
第三步:完成数据库初始化
可选择向导自动初始化,或使用 SQL 脚本手动初始化。若使用 SQL 脚本方式,需完成以下两步:
① 完成 baskserver 的系统配置(任选其一):
- 在
baskserver.home目录下添加baskserver.properties文件配置系统参数 - 直接在 SpringBoot 项目的属性配置文件(application.properties / yml)中配置 baskserver 的系统参数
② 数据库脚本初始化:执行提供的数据库初始化脚本,创建 BaskServer 所需的表结构。
第一步:添加 baskserver 相关的 jar
官方提供了 SpringBoot3 模板项目,可直接下载参考:gitee.com/xiaodaodao/baskserver-boot3
在 pom.xml 中添加依赖配置(与 SpringBoot2 一致):
<dependency> <groupId>com.basksoft</groupId> <artifactId>baskreport</artifactId> <version>${baskreport.version}</version> </dependency> <dependency> <groupId>com.basksoft</groupId> <artifactId>baskreport-font</artifactId> <version>${baskreport-font.version}</version> </dependency> <dependency> <groupId>com.basksoft</groupId> <artifactId>baskadapt</artifactId> <version>${baskadapt.version}</version> </dependency>
https://central.sonatype.com/repository/maven-snapshots/,或在 settings.xml 中配置 mirror。
第二步:添加 BaskJakartaFilter 配置
SpringBoot3 基于 Jakarta EE,需使用 BaskJakartaFilter(注意与 SpringBoot2 的 BaskFilter 不同):
import org.springframework.boot.web.servlet.FilterRegistrationBean; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; import org.springframework.core.env.Environment; import org.springframework.web.servlet.config.annotation.WebMvcConfigurer; import com.basksoft.core.BaskJakartaFilter; @Configuration public class BaskServerConfig implements WebMvcConfigurer { @Bean public FilterRegistrationBean registerReportFilter() { FilterRegistrationBean registration = new FilterRegistrationBean(new BaskJakartaFilter()); registration.addUrlPatterns("/*"); registration.setName("baskserver"); registration.setOrder(1); return registration; } }
第三步:完成数据库初始化
同样支持向导初始化与 SQL 脚本初始化两种方式。使用 SQL 脚本方式时:
① 完成 baskserver 的系统配置(任选其一):
- 在
baskserver.home目录下添加baskserver.properties文件配置 - 在 SpringBoot3 项目的属性配置文件中配置 baskserver 系统参数
② 数据库脚本初始化:执行数据库初始化脚本完成建表。
http://服务器IP:端口 即可进入 BaskServer
管理界面。
试用相关问题
Q:试用版有功能限制吗?
A:试用版包含正式版的全部功能,仅在使用时间上有限制(通常为 30 天)。试用期内可充分评估产品是否满足业务需求。
Q:SpringBoot2 和 SpringBoot3 部署包有什么区别?
A:主要区别在于 Filter 配置类不同:SpringBoot2 使用 BaskFilter,SpringBoot3 基于 Jakarta EE 使用
BaskJakartaFilter;JDK 要求也不同,SpringBoot2 需 JDK 1.8+,SpringBoot3 需 JDK 17+。请根据您现有项目环境选择对应版本。
Q:BaskReport 和 BaskAdapt 需要分别集成吗?
A:不需要。BaskServer 是统一运行环境,在 pom.xml 中同时添加 baskreport 与 baskadapt 依赖、注册一次 BaskFilter 即可,两款产品在同一项目中运行。
Q:数据库初始化必须用 SQL 脚本吗?
A:不是。除了 SQL 脚本,也可以使用向导自动完成数据库初始化,向导方式更简单,启动项目后按提示填写数据库连接信息即可自动建表。
Q:集成过程中遇到问题怎么办?
A:可通过页面底部联系方式(电话 13761428282、邮箱 buy@basksoft.com、QQ 群 742169613)联系技术支持团队,我们将提供一对一协助。也可参考官方提供的模板项目:SpringBoot2 为 baskserver-boot,SpringBoot3 为 baskserver-boot3。