精简了openapi相关

src/openapi/models/open_api_reference.cj

@@ -0,0 +1,60 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+/*
+ * Copyright (c) 杭州颉创科技有限公司 2025. All rights reserved.
+ * This source file is licensed under the MIT License found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+ 
+package simcu::simapi.openapi.models
+
+/**
+ * @brief 表示 OpenAPI 引用对象。
+ */
+public class OpenApiReference <: IOpenApiSerializable {
+    /**
+     * @brief 表示引用标识。
+     */
+    public var id: String
+    /**
+     * @brief 表示引用类型。
+     */
+    public var referenceType: ReferenceType
+
+    /**
+     * @brief 创建 OpenAPI 引用对象。
+     * @param referenceType 引用类型。
+     * @param id 引用标识。
+     */
+    public init(referenceType: ReferenceType, id: String) {
+        this.id = id
+        this.referenceType = referenceType
+    }
+
+    /**
+     * @brief 返回当前引用在 OpenAPI 文档中的字符串值。
+     * @return 引用字符串。
+     */
+    public func toReferenceString(): String {
+        if (ReferenceType.Tag == referenceType) {
+            return id
+        }
+        return "#/components/${referenceType.toString()}/${id}"
+    }
+
+    /**
+     * @brief 按 OpenAPI V3 格式写出当前引用对象。
+     * @param writer OpenAPI 写入器。
+     */
+    public func serializeAsV3(writer: IOpenApiWriter): Unit {
+        if (ReferenceType.Tag == referenceType) {
+            writer.writeValue(id)
+            return
+        }
+        writer.startObject()
+        writer.writeName("$ref")
+        writer.writeValue(toReferenceString())
+        writer.endObject()
+    }
+}