# xmltohtml

**Repository Path**: gitmy/xmltohtml

## Basic Information

- **Project Name**: xmltohtml
- **Description**: xml转html
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-01-26
- **Last Updated**: 2026-01-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 文档转换工具

一个基于Spring Boot的文档转换工具，支持XML和PDF文档转换为HTML格式。

## 功能特性

### XML转HTML
- 支持自定义XSLT模板
- 适用于基金报告、数据展示等多种场景
- 美观的HTML输出格式

### PDF转HTML
- 使用Apache PDFBox进行PDF处理
- 支持文件上传和在线预览
- 保留文本内容和格式
- 响应式设计，支持移动设备

## 技术栈

- **后端**: Spring Boot 2.7.18
- **PDF处理**: Apache PDFBox 2.0.29
- **模板引擎**: Thymeleaf
- **前端**: HTML5, CSS3, JavaScript
- **构建工具**: Maven

## 快速开始

### 1. 克隆项目
```bash
git clone <repository-url>
cd xmltohtml
```

### 2. 安装依赖
```bash
mvn clean install
```

### 3. 运行应用
```bash
mvn spring-boot:run
```

### 4. 访问应用
打开浏览器访问: http://localhost:8080

## 使用说明

### 主页
访问 http://localhost:8080 查看应用主页，选择需要的转换功能。

### XML转HTML
1. 访问 http://localhost:8080/xml
2. 上传XML文件或使用示例文件
3. 选择XSLT模板（可选）
4. 点击转换按钮
5. 下载或预览生成的HTML

### PDF转HTML
1. 访问 http://localhost:8080/pdf
2. 上传PDF文件或使用示例文件
3. 点击转换按钮
4. 下载或预览生成的HTML

## API接口

### XML转换API
```
POST /api/transform/xml-to-html
Content-Type: application/json

{
  "xmlContent": "<xml>...</xml>",
  "xsltPath": "xslt/fund_profile.xslt"
}
```

### PDF转换API
```
POST /pdf/upload
Content-Type: multipart/form-data

file: [PDF文件]
```

```
GET /pdf/convert-sample
```
转换项目中的示例PDF文件

## 项目结构

```
src/
├── main/
│   ├── java/
│   │   └── com/example/xmltohtml/
│   │       ├── controller/
│   │       │   ├── HomeController.java          # 主页控制器
│   │       │   ├── XmlTransformController.java # XML转换控制器
│   │       │   └── PdfToHtmlController.java    # PDF转换控制器
│   │       ├── service/
│   │       │   ├── XmlTransformService.java    # XML转换服务
│   │       │   ├── ThymeleafXmlTransformService.java
│   │       │   └── PdfToHtmlService.java       # PDF转换服务
│   │       └── XmlToHtmlApplication.java
│   └── resources/
│       ├── templates/
│       │   ├── index.html                      # 主页
│       │   ├── pdf-convert.html               # PDF转换页面
│       │   └── fund_profile.html              # XML转换页面
│       ├── xslt/                              # XSLT模板
│       ├── xml/                               # XML示例文件
│       └── pdf/                               # PDF示例文件
```

## 配置说明

### application.yml
```yaml
server:
  port: 8080

spring:
  servlet:
    multipart:
      max-file-size: 10MB
      max-request-size: 10MB
```

## 依赖说明

### 核心依赖
- `spring-boot-starter-web`: Web应用支持
- `spring-boot-starter-thymeleaf`: 模板引擎
- `pdfbox`: PDF处理库
- `commons-io`: 文件操作工具

## 开发说明

### 添加新的转换功能
1. 在`service`包中创建新的服务类
2. 在`controller`包中创建对应的控制器
3. 在`templates`目录中创建页面模板
4. 更新主页导航

### 自定义样式
所有页面都使用内联CSS，可以根据需要修改样式。

## 注意事项

1. PDF转换功能需要Apache PDFBox依赖
2. 大文件处理可能需要调整内存配置
3. 建议在生产环境中配置适当的文件大小限制

## 许可证

MIT License

## 贡献

欢迎提交Issue和Pull Request来改进这个项目。