# database-metadata-browser

**Repository Path**: life-is-like-tea/database-metadata-browser

## Basic Information

- **Project Name**: database-metadata-browser
- **Description**: 数据库元数据浏览器，工具定位 仅提供元数据检索能力，不支持 SQL 执行、字段定义修改，纯查询类工具。
- **Primary Language**: Java
- **License**: MPL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2019-12-04
- **Last Updated**: 2026-05-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 数据库工具

## README

# Database Metadata Browser

轻量级数据库元数据浏览器，提供表与字段的快速检索能力，不支持 SQL 执行或字段定义修改，纯查询类工具。

## 功能特性

### 字段检索
- 查询目标字段是否存在
- 展示字段所属全部数据表
- 检测字段重复定义情况

### 表检索
- 查询目标数据表是否存在
- 查看指定表内所有字段信息

### 数据库连接管理
- 支持多数据库配置，可新增、编辑、删除连接
- 自动记忆上次使用的连接配置
- 连接测试功能

### 本地缓存
- 查询数据自动缓存为本地 Excel 文件
- 下次打开优先加载缓存，无需重复连接数据库

## 支持的数据库

| 数据库 | 状态 |
|--------|------|
| MySQL  | ✅ 已支持 |
| Oracle | ✅ 已支持 |
| SQL Server | 🔧 预留支持 |
| DB2 | 🔧 预留支持 |

## 技术栈

- **语言**: Java 8
- **UI 框架**: Swing + BeautyEye LNF
- **构建工具**: Maven
- **依赖库**:
  - `mysql-connector-java` 5.1.44 — MySQL JDBC 驱动
  - `ojdbc8` 12.2.0.1 — Oracle JDBC 驱动
  - `sqljdbc4` 4.0 — SQL Server JDBC 驱动
  - `poi` 3.14 / `poi-ooxml` 3.14 — Excel 读写
  - `fastjson` 1.2.49 — JSON 处理
  - `commons-lang3` 3.8.1 — 工具类库
  - `log4j` 1.2.14 — 日志框架

## 项目结构

```
src/
├── Main.java                          # 程序入口
├── log4j.properties                   # 日志配置
└── vip/rssc/app/
    ├── constant/
    │   └── EDBType.java               # 数据库类型枚举
    ├── db/
    │   └── Db.java                    # 数据管理核心类
    ├── serivce/
    │   ├── DbService.java             # 数据库服务接口
    │   └── impl/
    │       ├── MysqlDbServiceImpl.java  # MySQL 元数据查询
    │       └── OracleDbServiceImpl.java # Oracle 元数据查询
    ├── ui/
    │   ├── MainForm.java              # 主界面
    │   └── DbConnectionDialog.java    # 数据库连接配置对话框
    └── utils/
        ├── ConfigsUtils.java          # 配置管理工具
        ├── DaoUtils.java              # 数据访问工具
        ├── EncryptUtils.java          # 加密工具
        ├── ExcelUtils.java            # Excel 读写工具
        ├── FileRWUtils.java           # 文件读写工具
        ├── JDBCUtils.java             # JDBC 连接工具
        ├── TableUtils.java            # 表格渲染工具
        ├── ExceptionHandleUtils.java  # 异常处理工具
        ├── logo.ico                   # 应用图标
        └── logo.png                   # 应用图标
```

## 构建与运行

### 前置要求
- JDK 8+
- Maven 3.x

### 构建
```bash
mvn clean package
```

构建产物位于 `target/` 目录，生成可执行 JAR 文件。

### 运行
```bash
java -jar target/database-metadata-browser-1.0-SNAPSHOT.jar
```

## 使用说明

1. 启动应用后，点击「新增」按钮配置数据库连接
2. 填写配置名称、数据库类型、服务器地址、端口、数据库名、用户名和密码
3. 点击「测试连接」验证配置，成功后点击「保存」
4. 在主界面顶部的下拉框中选择已配置的数据库连接
5. 在「表名」输入框中输入关键词按回车搜索表
6. 在「列名」输入框中输入关键词按回车搜索字段
7. 也可同时输入表名和列名进行组合筛选
8. 使用「筛选表」下拉框可快速定位到某张表
9. 点击「重置」清空所有筛选条件

## 配置文件存储

数据库连接配置保存在用户主目录下：

```
~/.database-metadata-browser/
├── conf/
│   ├── <配置名>/
│   │   ├── my.properties       # 连接配置（密码已加密）
│   │   └── DatabaseMetadataBrowserCache.xls  # 数据缓存
│   └── lastUsedConfig.txt      # 上次使用的配置名
└── logs/
    └── DatabaseMetadataBrowser.log  # 运行日志
```

## 许可证

[Mozilla Public License Version 2.0](LICENSE)