feat: 实现 Java → C# 转换器 (Task 2.5)

新增组件:
- JavaToCSharpStrategy: Java 到 C# 转换策略
- JavaToCSharpConverter: Java 到 C# 转换器
- JavaParser: Java 简化解析器(基于文本处理)
- CSharpCodeGenerator: C# 代码生成器

功能实现:
- 18 种类型映射(Java → C#)
- package → namespace 转换
- import → using 转换
- JavaDoc → XML Doc 转换
- Stream API 检测并添加 TODO
- CompletableFuture 检测并添加 TODO

测试覆盖:
- 添加 4 个 JavaToCSharpConverterTests 测试用例
- 总测试数 17 个,全部通过
Co-authored-by: monkeycode-ai <monkeycode-ai@chaitin.com>
This commit is contained in:
monkeycode-ai
2026-06-03 05:45:23 +00:00
parent 80b4718568
commit dd02c3a053
6 changed files with 858 additions and 0 deletions
@@ -0,0 +1,147 @@
using CodePlay.Core.Interfaces;
using CodePlay.Core.Models;
using CodePlay.Core.Common;
namespace CodePlay.Core.Converters;
/// <summary>
/// Java 到 C# 代码转换器
/// </summary>
public class JavaToCSharpConverter : IConverter
{
private readonly JavaToCSharpStrategy _strategy;
private readonly CSharpCodeGenerator _codeGenerator;
public JavaToCSharpConverter()
{
_strategy = new JavaToCSharpStrategy();
_codeGenerator = new CSharpCodeGenerator();
}
/// <summary>
/// 转换语法树
/// </summary>
public async Task<ConversionResult> ConvertAsync(
Interfaces.SyntaxTree syntaxTree,
LanguageType targetLanguage,
ConversionOptions? options = null,
CancellationToken cancellationToken = default)
{
var result = new ConversionResult
{
Success = false,
Warnings = new List<ConversionWarning>(),
Report = new ConversionReport()
};
if (targetLanguage != LanguageType.CSharp)
{
result.ErrorMessage = "This converter only supports Java to C# conversion";
return result;
}
try
{
var context = new ConversionContext
{
SourceLanguage = LanguageType.Java,
TargetLanguage = LanguageType.CSharp,
Options = options
};
// 转换根节点
var convertedRoot = _strategy.ConvertNode(syntaxTree.Root, context);
// 创建新的语法树
var convertedTree = new Interfaces.SyntaxTree
{
Language = LanguageType.CSharp,
Root = convertedRoot,
SourceCode = syntaxTree.SourceCode
};
// 保留注释和文档
if (options?.KeepComments == true)
{
convertedTree.Documentation = syntaxTree.Documentation
.Select(d => new SyntaxDocumentation
{
ElementName = d.ElementName,
Content = ConvertDocumentation(d.Content),
Format = DocFormat.XmlDoc
}).ToList();
}
// 生成 C# 代码
var generatedCode = _codeGenerator.Generate(convertedTree);
result.TransformedCode = generatedCode;
result.Success = true;
// 生成报告
if (result.Report != null)
{
result.Report.LinesConverted = syntaxTree.SourceCode?.Split('\n').Length ?? 0;
result.Report.ClassesConverted = CountClasses(syntaxTree.Root);
result.Report.MethodsConverted = CountMethods(syntaxTree.Root);
result.Report.TodoItems = context.TodoItems;
result.Report.Issues = context.Issues;
result.Report.TransformationLog = context.Logs;
}
context.Logs.Add(new TransformationLog
{
Timestamp = DateTime.UtcNow,
Operation = "Conversion",
Details = "Java to C# conversion completed",
Level = LogLevel.Info
});
result.Warnings = context.Issues
.Select(i => new ConversionWarning
{
Code = $"WARN_{i.Type}",
Message = i.Description,
Suggestion = i.Suggestion
}).ToList();
}
catch (Exception ex)
{
result.ErrorMessage = ex.Message;
result.Success = false;
}
return await Task.FromResult(result);
}
private string ConvertDocumentation(string javaDocContent)
{
// JavaDoc 到 XML Doc 转换
var content = javaDocContent
.Replace("/**", "///")
.Replace("*/", "")
.Replace("*", "///")
.Replace("@param ", "<param name=\"")
.Replace("@return", "<returns>")
.Replace("@throws ", "<exception cref=\"")
.Replace("@see ", "<seealso cref=\"");
return content;
}
private int CountClasses(Interfaces.SyntaxNode node)
{
int count = 0;
if (node.Type == SyntaxNodeType.Class) count++;
count += node.Children.Sum(CountClasses);
return count;
}
private int CountMethods(Interfaces.SyntaxNode node)
{
int count = 0;
if (node.Type == SyntaxNodeType.Method) count++;
count += node.Children.Sum(CountMethods);
return count;
}
}