# dbtool

**Repository Path**: ithanjunjun/dbtool

## Basic Information

- **Project Name**: dbtool
- **Description**: web版数据库连接工具
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-20
- **Last Updated**: 2026-06-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 数据库连接工具 (DB Tool)

基于 Spring Boot 2.x + Freemarker 开发的数据库连接工具Web应用。

## 功能特性

- 🔐 **简单登录** - 固定账户登录 (admin/admin123)
- 🗄️ **多数据库支持** - Oracle、PostgreSQL、MySQL
- 📝 **SQL编辑器** - 基于 CodeMirror，提供语法高亮
- ✨ **SQL联想** - 关键字自动补全
- ✓ **语法检查** - SQL语法实时验证
- 🚀 **一键格式化** - SQL语句自动格式化
- 📊 **结果展示** - 支持表格展示查询结果

## 技术栈

- **后端**: Spring Boot 2.7.18 + Druid连接池
- **模板引擎**: Freemarker
- **前端**: CodeMirror 5 + 原生JavaScript
- **数据库驱动**: 
  - Oracle JDBC (ojdbc8)
  - PostgreSQL JDBC (postgresql)
  - MySQL JDBC (mysql-connector-java)

## 快速启动

### 1. 修改配置 (可选)

编辑 `src/main/resources/application.yml` 修改端口等配置。

### 2. 添加Oracle驱动 (如果需要)

Oracle驱动需要从Oracle官方仓库下载，如遇到下载问题，可注释掉Oracle依赖。

### 3. 编译运行

```bash
# 编译
mvn clean package -DskipTests

# 运行
java -jar target/db-tool-1.0.0.jar
```

### 4. 访问

打开浏览器访问: http://localhost:8080/dbtool

默认账户: `admin` / `admin123`

## 项目结构

```
db-tool/
├── src/main/java/com/dbtool/
│   ├── DbToolApplication.java      # 启动类
│   ├── config/                     # 配置类
│   │   ├── FreemarkerConfig.java
│   │   └── WebConfig.java
│   ├── controller/                 # 控制器
│   │   ├── LoginController.java
│   │   └── MainController.java
│   ├── model/                       # 模型类
│   │   ├── DataSourceConfig.java
│   │   ├── Result.java
│   │   └── SqlExecuteResult.java
│   └── service/                     # 服务类
│       ├── DataSourceService.java
│       ├── LoginService.java
│       └── SqlValidationService.java
├── src/main/resources/
│   ├── application.yml              # 配置文件
│   └── templates/                   # Freemarker模板
│       ├── login.ftl                # 登录页
│       └── index.ftl                # 主页面
└── pom.xml                          # Maven配置
```

## 使用说明

### 1. 登录

使用默认账户登录系统。

### 2. 添加数据源

点击左侧边栏的"添加"按钮，填写数据库连接信息：
- 连接名称（自定义）
- 数据库类型（Oracle/PostgreSQL/MySQL）
- 主机地址
- 端口号
- 数据库名/服务名
- 用户名/密码

可以使用"测试连接"按钮验证连接是否正常。

### 3. 执行SQL

选择数据源后，在SQL编辑器中输入SQL语句：
- `Ctrl+Enter` 或点击"执行"按钮执行SQL
- 点击"语法检查"验证SQL语法
- 点击"格式化"美化SQL格式
- 点击"清空"清空编辑器内容

### 4. 查看结果

- SELECT查询显示为表格形式
- UPDATE/DELETE/INSERT显示影响行数

## 注意事项

1. **安全提示**: 本工具仅供开发测试使用，请勿在生产环境暴露
2. **连接池**: 使用Druid连接池，支持连接复用
3. **结果限制**: SELECT查询最多返回1000行
4. **事务**: 默认自动提交，建议谨慎执行更新操作

## License

MIT License