xsd2code

XSD2Code - 通用XSD到多语言代码转换工具 v3.1.3 (增强版)

[[图片] Go Version](https://golang.org/dl/) [[图片] Latest Release](https://github.com/suifei/xsd2code/releases/latest) [[图片] Build Status](https://github.com/suifei/xsd2code/actions) [[图片] License](https://github.com/suifei/xsd2code/blob/main/LICENSE) [[图片] Go Report Card](https://goreportcard.com/report/github.com/suifei/xsd2code) [[图片] GitHub Stars](https://github.com/suifei/xsd2code/stargazers) [[图片] GitHub Forks](https://github.com/suifei/xsd2code/network/members) [[图片] Contributors](https://github.com/suifei/xsd2code/graphs/contributors) [[图片] GitHub Issues](https://github.com/suifei/xsd2code/issues) [[图片] GitHub Pull Requests](https://github.com/suifei/xsd2code/pulls) [[图片] Downloads](https://github.com/suifei/xsd2code/releases) [[图片] Last Commit](https://github.com/suifei/xsd2code/commits/main)

🚀 一键将XSD转换为多语言代码，智能生成类型安全的数据结构

XSD2Code 是一个功能强大的命令行工具，专门用于将 XML Schema Definition (XSD) 文件转换为多种编程语言的类型定义和数据结构。该工具采用智能解析技术，自动处理复杂的XSD特性，生成可直接使用的、类型安全的代码。

📊 项目状态

🚀 快速特性一览

🎯 核心价值

• 🔄 自动化转换: 一键将复杂XSD转换为生产就绪的代码
• 🌍 多语言支持: 支持Go、Java、C#、TypeScript等主流语言
• 🎛️ 智能处理: 自动检测XSD特性，智能生成导入和辅助函数
• 📋 完整约束: 全面支持XSD约束验证，确保数据完整性
• ⚡ 零配置: 开箱即用，无需复杂配置

🎉 最新更新 (v3.1)

✨ 新增功能

• ✅ 智能导入管理: 动态检测所需导入，避免未使用的导入
• ✅ XSD限制增强: 完整支持whiteSpace、length、pattern、fixed value等限制
• ✅ 自动生成辅助函数: 自动生成applyWhiteSpaceProcessing等辅助函数
• ✅ 编译错误零容忍: 生成的代码保证无编译错误
• ✅ 增强验证支持: 完整的XSD约束验证代码生成

🔧 技术改进

• 🚀 动态导入检测: 基于实际使用情况智能添加导入语句
• 🚀 辅助函数生成: 按需生成所需的辅助验证函数
• 🚀 XSD约束全面支持: whiteSpace(preserve/replace/collapse)、exact length、fixed values
• 🚀 代码质量保证: 所有生成的代码通过编译测试

主要功能

核心特性

• ✅ 多语言支持: Go、Java、C#、Python代码生成
• ✅ 统一解析器: 自动处理所有XSD特性，无需选择解析模式
• ✅ 完整XSD支持: 复杂类型、简单类型、元素、属性、组引用、扩展、导入
• ✅ 智能导入管理: 动态检测并添加必要的导入语句
• ✅ XSD约束全面支持: pattern、length、whiteSpace、fixed value等所有约束
• ✅ 命名空间处理: 正确生成包含命名空间的XML注解
• ✅ JSON兼容: 可选生成JSON序列化标签
• ✅ 枚举支持: 自动转换XSD枚举为各语言的枚举类型
• ✅ 组引用: 完整支持XSD组定义和组引用
• ✅ 类型扩展: 支持complexContent和simpleContent扩展
• ✅ 递归导入: 自动处理导入的XSD文件
• ✅ 类型映射: 完整的XSD到目标语言类型映射

🆕 XSD约束支持详情

WhiteSpace 处理

• preserve: 保持所有空白字符
• replace: 替换制表符、换行符为空格
• collapse: 折叠多个空格为单个空格并去除首尾空格

长度约束

• length: 精确长度约束
• minLength/maxLength: 长度范围约束
• 自动生成长度验证代码

模式匹配

• pattern: 正则表达式模式匹配
• 自动生成regexp验证代码
• 智能导入regexp包

固定值约束

• fixed: 固定值约束
• 自动生成固定值验证

多语言代码生成

• Go: 标准结构体定义，XML/JSON标签，类型安全枚举，智能导入
• Java: POJO类，JAXB注解，枚举类型，getter/setter方法
• C#: 属性类，XML序列化注解，枚举类型，JSON支持
• Python: 数据类(dataclass)，类型注解，枚举类型，可选字段支持

安装

📦 多种安装方式

🚀 从源码构建 (推荐)

# 克隆仓库
git clone https://github.com/suifei/xsd2code.git
cd xsd2code

# 构建工具
go build -o xsd2code cmd/main.go

# 或使用Makefile
make build

📥 直接下载二进制文件

# 从GitHub Releases下载最新版本
# https://github.com/suifei/xsd2code/releases/latest

# Linux/macOS
curl -L https://github.com/suifei/xsd2code/releases/latest/download/xsd2code-linux-amd64 -o xsd2code
chmod +x xsd2code

# Windows (PowerShell)
Invoke-WebRequest -Uri "https://github.com/suifei/xsd2code/releases/latest/download/xsd2code-windows-amd64.exe" -OutFile "xsd2code.exe"

🔧 使用Go Install

# 如果您有Go环境
go install github.com/suifei/xsd2code@latest

📋 系统要求

使用方法

基本命令

# Go代码生成（默认）
./xsd2code -xsd=schema.xsd

# Java代码生成
./xsd2code -xsd=schema.xsd -lang=java -output=Types.java -package=com.example.models

# C#代码生成
./xsd2code -xsd=schema.xsd -lang=csharp -output=Types.cs -package=Example.Models -json

# Python代码生成
./xsd2code -xsd=schema.xsd -lang=python -output=types.py -package=models

# 显示类型映射
./xsd2code -xsd=schema.xsd -show-mappings

# 生成验证代码
./xsd2code -xsd=schema.xsd -validation -validation-output=validation.go

# 生成测试代码
./xsd2code -xsd=schema.xsd -tests -test-output=tests.go

# 生成示例XML
./xsd2code -xsd=schema.xsd -sample

命令行参数

• -xsd string: XSD文件路径 (必需)
• -lang string: 目标语言 (go, java, csharp, python) (默认: "go")
• -output string: 输出文件路径 (可选)
• -package string: 包名 (默认: "models")
• -json: 生成JSON兼容标签
• -comments: 包含注释 (默认: true)
• -validation: 生成验证代码
• -validation-output string: 验证代码输出路径
• -tests: 生成测试代码
• -test-output string: 测试代码输出路径
• -benchmarks: 生成基准测试
• -sample: 生成示例XML
• -show-mappings: 显示类型映射
• -validate string: 验证XML文件
• -debug: 启用调试模式
• -strict: 启用严格模式
• -plc: 启用PLC类型映射
• -help: 显示帮助
• -version: 显示版本

生成的代码示例

Go代码示例

package models

import (
    "regexp"
    "strings"
    "encoding/xml"
    "time"
)

// ExactLengthCodeType represents a string with pattern validation
type ExactLengthCodeType string

// Validate validates the ExactLengthCodeType format
func (v ExactLengthCodeType) Validate() bool {
    // Validate against pattern: [A-Z]{5}
    pattern := regexp.MustCompile(`[A-Z]{5}`)
    return pattern.MatchString(string(v))
}

// CollapsedStringType represents a string with whiteSpace processing
type CollapsedStringType string

// Validate validates the CollapsedStringType format
func (v CollapsedStringType) Validate() bool {
    strVal := string(v)
    strVal = applyWhiteSpaceProcessing(strVal, "collapse")
    length := len(strVal)
    return length >= 1 && length  `
- **minLength/maxLength**: 长度范围 `   `
- **pattern**: 正则表达式 ` `
- **whiteSpace**: 空白处理 ` `

#### 数值约束

- **minInclusive/maxInclusive**: 包含边界
- **minExclusive/maxExclusive**: 排除边界
- **totalDigits**: 总位数限制
- **fractionDigits**: 小数位数限制

#### 其他约束

- **enumeration**: 枚举值
- **fixed**: 固定值

### 验证代码生成

生成的类型包含内置验证方法：

func (v ExactLengthCodeType) Validate() bool { pattern := regexp.MustCompile([A-Z]{5}) return pattern.MatchString(string(v)) }

### 测试代码生成

自动生成单元测试和基准测试：

./xsd2code -xsd=schema.xsd -tests -benchmarks

## 支持的XSD特性

- ✅ **元素 (Elements)**: 基本元素、可选元素、数组元素
- ✅ **属性 (Attributes)**: 必需属性、可选属性、固定值属性
- ✅ **复杂类型 (ComplexType)**: sequence、choice、all、mixed content
- ✅ **简单类型 (SimpleType)**: restriction、enumeration、pattern、length约束
- ✅ **命名空间 (Namespaces)**: targetNamespace、xmlns处理
- ✅ **导入和包含 (Import/Include)**: 外部XSD文件引用
- ✅ **组 (Groups)**: 组定义和组引用
- ✅ **扩展 (Extension)**: complexContent和simpleContent扩展
- ✅ **约束 (Restrictions)**: 所有XSD约束类型
- ✅ **固定值 (Fixed)**: 元素和属性固定值
- ✅ **默认值 (Default)**: 元素和属性默认值

## 错误处理

工具提供详细的错误信息和调试支持：

启用调试模式

./xsd2code -xsd=schema.xsd -debug

启用严格模式（严格验证XSD）

./xsd2code -xsd=schema.xsd -strict

## 贡献

欢迎提交Issue和Pull Request来改进这个工具。

### 开发环境设置

克隆项目

git clone https://github.com/suifei/xsd2code.git cd xsd2code

安装依赖

go mod tidy

运行测试

go test ./...

构建

make build

## 许可证

MIT License - 详见 [LICENSE](LICENSE) 文件

## 更新日志

### v3.1 (2025-06-02)

- ✨ 新增智能导入管理功能
- ✨ 新增XSD约束全面支持（whiteSpace、length、pattern、fixed）
- ✨ 新增自动辅助函数生成
- 🔧 修复编译错误问题
- 🔧 优化代码生成质量
- 📝 完善文档和示例

### v3.0

- 🎉 重构为统一解析器架构
- ✨ 新增多语言支持（Java、C#、Python）
- ✨ 新增验证代码生成
- ✨ 新增测试代码生成
- 🔧 改进XSD特性支持

## 📈 项目统计

### 🏆 质量徽章

![Go Report Card](https://goreportcard.com/badge/github.com/suifei/xsd2code)
![Security](https://img.shields.io/badge/security-scan%20passed-brightgreen)
![Coverage](https://img.shields.io/badge/coverage-85%25-green)

### 📊 活跃度

![Commits](https://img.shields.io/github/commit-activity/m/suifei/xsd2code)
![Issues Closed](https://img.shields.io/github/issues-closed/suifei/xsd2code)
![PR Merged](https://img.shields.io/github/issues-pr-closed/suifei/xsd2code)
![Contributors](https://img.shields.io/github/contributors/suifei/xsd2code)

### 💻 兼容性

![Platform](https://img.shields.io/badge/platform-windows%20%7C%20linux%20%7C%20macos-lightgrey)
![Go Version](https://img.shields.io/badge/go-1.22.3%2B-blue)
![Architecture](https://img.shields.io/badge/arch-amd64%20%7C%20arm64-orange)

### 🎯 社区

![Stars](https://img.shields.io/github/stars/suifei/xsd2code?style=social)
![Forks](https://img.shields.io/github/forks/suifei/xsd2code?style=social)
![Watchers](https://img.shields.io/github/watchers/suifei/xsd2code?style=social)

## 📚 文档和Wiki

详细的文档和教程请访问我们的 [GitHub Wiki](https://github.com/suifei/xsd2code/wiki)：

- **[快速开始](https://github.com/suifei/xsd2code/wiki/Quick-Start)** - 5分钟上手指南
- **[安装指南](https://github.com/suifei/xsd2code/wiki/Installation)** - 详细安装步骤
- **[基本用法](https://github.com/suifei/xsd2code/wiki/Basic-Usage)** - 基本命令和参数
- **[XSD特性支持](https://github.com/suifei/xsd2code/wiki/XSD-Features)** - 支持的XSD特性详解
- **[命令行参考](https://github.com/suifei/xsd2code/wiki/Command-Line-Reference)** - 完整的命令行参数说明
- **[高级示例](https://github.com/suifei/xsd2code/wiki/Advanced-Examples)** - 复杂场景和高级用法
- **[常见问题](https://github.com/suifei/xsd2code/wiki/FAQ)** - 常见问题和解答

## 支持和反馈

如果您遇到问题或有功能建议，请：

1. 查看 [GitHub Issues](https://github.com/suifei/xsd2code/issues)
2. 提交新的Issue
3. 参与讨论和改进

## 🤝 贡献者

感谢所有为项目做出贡献的开发者！

[![Contributors](https://contrib.rocks/image?repo=suifei/xsd2code)](https://github.com/suifei/xsd2code/graphs/contributors)

## 💬 社区和联系

- 📧 **邮箱**: [xsd2code@example.com](mailto:xsd2code@example.com)
- 💬 **讨论**: [GitHub Discussions](https://github.com/suifei/xsd2code/discussions)
- 🐛 **问题反馈**: [GitHub Issues](https://github.com/suifei/xsd2code/issues)
- 📢 **功能请求**: [Feature Requests](https://github.com/suifei/xsd2code/issues/new?template=feature_request.md)

## ⭐ 支持项目

如果这个项目对您有帮助，请考虑：

- ⭐ 给项目加个星标
- 🍴 Fork 并参与开发
- 📢 分享给其他开发者
- 💰 [赞助项目](https://github.com/sponsors/suifei)

## 📊 项目里程碑

- ✅ **v1.0** - 基础XSD解析和Go代码生成
- ✅ **v2.0** - 多语言支持和验证功能
- ✅ **v3.0** - 统一解析器架构
- ✅ **v3.1** - 智能导入和约束支持
- 🚧 **v3.2** - 性能优化和并发处理
- 📋 **v4.0** - Web界面和REST API

---

**⚡ 由 [@suifei](https://github.com/suifei) 开发维护**  
🔥 让XSD转换变得简单高效！

感谢使用 XSD2Code！ 🚀