添加搜索高亮功能支持与测试优化：1. 在Response结构体中添加Highlighting字段支持搜索高亮 2. 创建新的搜索高亮功能API 3. 添加功能测试与单元测试 4. 优化现有测试用例，减少测试数据量并添加超时控制

Author: CC11001100

pkg/api/class_search.go

@@ -0,0 +1,95 @@
+package api
+
+import (
+	"context"
+	"errors"
+
+	"github.com/scagogogo/sonatype-central-sdk/pkg/request"
+	"github.com/scagogogo/sonatype-central-sdk/pkg/response"
+)
+
+// SearchClassesWithHighlighting 根据完全限定类名搜索制品，并返回高亮信息
+// 参数:
+//   - ctx: 上下文，可用于取消或设置超时
+//   - fullyQualifiedClassName: 完全限定类名，如"org.specs.runner.JUnit"
+//   - limit: 最大返回结果数量，如果小于等于0则不限制
+//
+// 返回:
+//   - 搜索结果: 包含匹配的版本信息以及高亮片段
+//   - 错误: 如果搜索过程中发生错误
+func (c *Client) SearchClassesWithHighlighting(ctx context.Context, fullyQualifiedClassName string, limit int) (*response.Response[*response.Version], error) {
+	// 创建搜索请求
+	query := request.NewQuery().SetFullyQualifiedClassName(fullyQualifiedClassName)
+	searchReq := request.NewSearchRequest().SetQuery(query)
+
+	// 设置限制条数
+	if limit > 0 {
+		searchReq.SetLimit(limit)
+	}
+
+	// 添加高亮相关参数
+	searchReq.AddCustomParam("hl", "true")
+	searchReq.AddCustomParam("hl.fl", "fch")     // 高亮完全限定类名字段
+	searchReq.AddCustomParam("hl.snippets", "3") // 最多返回3个高亮片段
+
+	// 执行搜索请求
+	result, err := SearchRequestJsonDoc[*response.Version](c, ctx, searchReq)
+	if err != nil {
+		return nil, err
+	}
+
+	// 验证响应
+	if result == nil || result.ResponseBody == nil {
+		return nil, errors.New("empty response body")
+	}
+
+	return result, nil
+}
+
+// ExtractHighlightedClasses 从搜索结果中提取出每个制品中的高亮类名
+// 参数:
+//   - result: 带有高亮信息的搜索结果
+//
+// 返回:
+//   - 映射关系: 文档ID到该文档中包含的高亮类名列表
+func ExtractHighlightedClasses(result *response.Response[*response.Version]) map[string][]string {
+	if result == nil || result.Highlighting == nil {
+		return nil
+	}
+
+	// 创建结果映射
+	highlightedClasses := make(map[string][]string)
+
+	// 遍历每个文档的高亮信息
+	for docId, fields := range result.Highlighting {
+		// 提取类字段(fch)的高亮片段
+		if classHighlights, exists := fields["fch"]; exists && len(classHighlights) > 0 {
+			highlightedClasses[docId] = classHighlights
+		}
+	}
+
+	return highlightedClasses
+}
+
+// SearchFullyQualifiedClassNames 搜索完全限定类名并返回包含这些类的所有制品版本
+// 参数:
+//   - ctx: 上下文，可用于取消或设置超时
+//   - className: 要搜索的完全限定类名或部分类名（支持模式匹配）
+//   - limit: 最大返回结果数量
+//
+// 返回:
+//   - 版本列表: 包含匹配类的所有制品版本
+//   - 高亮信息: 每个制品中匹配的具体类名
+//   - 错误: 如果搜索过程中发生错误
+func (c *Client) SearchFullyQualifiedClassNames(ctx context.Context, className string, limit int) ([]*response.Version, map[string][]string, error) {
+	// 执行带高亮的搜索
+	result, err := c.SearchClassesWithHighlighting(ctx, className, limit)
+	if err != nil {
+		return nil, nil, err
+	}
+
+	// 提取高亮的类名
+	highlights := ExtractHighlightedClasses(result)
+
+	return result.ResponseBody.Docs, highlights, nil
+}

pkg/api/class_search_test.go

@@ -0,0 +1,145 @@
+package api
+
+import (
+	"context"
+	"testing"
+	"time"
+
+	"github.com/stretchr/testify/assert"
+)
+
+// TestSearchClassesWithHighlighting 测试带高亮的类搜索功能
+func TestSearchClassesWithHighlighting(t *testing.T) {
+	// 使用真实客户端
+	client := createRealClient(t)
+
+	// 设置更长的超时时间
+	ctx, cancel := context.WithTimeout(context.Background(), 60*time.Second)
+	defer cancel()
+
+	// 测试全限定类名
+	className := "org.apache.commons.io.FileUtils"
+
+	// 设置子测试的超时时间
+	subCtx, subCancel := context.WithTimeout(ctx, 20*time.Second)
+	defer subCancel()
+
+	// 执行带高亮的搜索
+	result, err := client.SearchClassesWithHighlighting(subCtx, className, 3)
+
+	// 如果API连接失败，跳过测试
+	if err != nil {
+		t.Logf("搜索 %s 时出错: %v", className, err)
+		t.Skip("无法连接到Maven Central API")
+		return
+	}
+
+	// 验证返回结果
+	assert.NotNil(t, result, "搜索结果不应为空")
+	assert.NotNil(t, result.ResponseBody, "响应体不应为空")
+	assert.NotEmpty(t, result.ResponseBody.Docs, "搜索结果不应为空")
+
+	// 验证高亮信息
+	assert.NotNil(t, result.Highlighting, "高亮信息不应为空")
+
+	// 输出结果信息
+	t.Logf("找到 %d 个包含 %s 的结果", result.ResponseBody.NumFound, className)
+	for i, doc := range result.ResponseBody.Docs {
+		t.Logf("结果 %d: %s:%s:%s", i+1, doc.GroupId, doc.ArtifactId, doc.Version)
+
+		// 显示高亮信息
+		if highlightInfo, exists := result.Highlighting[doc.ID]; exists {
+			if fchHighlights, hasFch := highlightInfo["fch"]; hasFch && len(fchHighlights) > 0 {
+				t.Logf("  高亮: %s", fchHighlights[0])
+			}
+		}
+	}
+}
+
+// TestExtractHighlightedClasses 测试高亮提取函数
+func TestExtractHighlightedClasses(t *testing.T) {
+	// 使用真实客户端
+	client := createRealClient(t)
+
+	// 设置超时
+	ctx, cancel := context.WithTimeout(context.Background(), 60*time.Second)
+	defer cancel()
+
+	// 测试全限定类名
+	className := "org.junit.Assert"
+
+	// 设置子测试的超时时间
+	subCtx, subCancel := context.WithTimeout(ctx, 20*time.Second)
+	defer subCancel()
+
+	// 执行带高亮的搜索
+	result, err := client.SearchClassesWithHighlighting(subCtx, className, 3)
+
+	// 如果API连接失败，跳过测试
+	if err != nil {
+		t.Logf("搜索 %s 时出错: %v", className, err)
+		t.Skip("无法连接到Maven Central API")
+		return
+	}
+
+	// 提取高亮信息
+	highlights := ExtractHighlightedClasses(result)
+
+	// 验证提取的高亮信息
+	assert.NotNil(t, highlights, "提取的高亮信息不应为空")
+	assert.NotEmpty(t, highlights, "提取的高亮信息应该包含数据")
+
+	// 输出结果信息
+	t.Logf("从 %d 个结果中提取了 %d 个高亮类名", len(result.ResponseBody.Docs), len(highlights))
+	for docId, highlightedClasses := range highlights {
+		t.Logf("文档 ID: %s", docId)
+		for i, cls := range highlightedClasses {
+			t.Logf("  高亮类 %d: %s", i+1, cls)
+		}
+	}
+}
+
+// TestSearchFullyQualifiedClassNames 测试完全限定类名搜索
+func TestSearchFullyQualifiedClassNames(t *testing.T) {
+	// 使用真实客户端
+	client := createRealClient(t)
+
+	// 设置超时
+	ctx, cancel := context.WithTimeout(context.Background(), 60*time.Second)
+	defer cancel()
+
+	// 测试全限定类名
+	className := "org.apache.commons.lang3.StringUtils"
+
+	// 设置子测试的超时时间
+	subCtx, subCancel := context.WithTimeout(ctx, 20*time.Second)
+	defer subCancel()
+
+	// 执行搜索
+	versions, highlights, err := client.SearchFullyQualifiedClassNames(subCtx, className, 3)
+
+	// 如果API连接失败，跳过测试
+	if err != nil {
+		t.Logf("搜索 %s 时出错: %v", className, err)
+		t.Skip("无法连接到Maven Central API")
+		return
+	}
+
+	// 验证搜索结果
+	assert.NotNil(t, versions, "搜索结果不应为空")
+	assert.NotEmpty(t, versions, "搜索结果应该包含数据")
+	assert.NotNil(t, highlights, "高亮信息不应为空")
+
+	// 输出结果信息
+	t.Logf("找到 %d 个包含 %s 的结果", len(versions), className)
+	for i, v := range versions {
+		t.Logf("结果 %d: %s:%s:%s", i+1, v.GroupId, v.ArtifactId, v.Version)
+
+		// 显示对应的高亮信息
+		if hlClasses, exists := highlights[v.ID]; exists {
+			for j, cls := range hlClasses {
+				t.Logf("  高亮类 %d: %s", j+1, cls)
+			}
+		}
+	}
+}