xml - 我如何引用 <xs :element> into my <xs:documentation>?

Question

我有一个XSD，用于在Java接口(interface)中创建相应的类。 我的 xsd 的每个元素都有自己的 <xs:documentation> ，我想知道是否可以引用另一个 <xs:element>到文档标签中。

更清楚地说，如果我在 Java 文档中编写此内容:

/**
This method does something nice.
If you want to do something nicer, use {@link AnotherClass#NicerMethod()}
*/
public void niceMethod()

...然后，当创建 Java 文档时，用户可以单击链接 AnotherClass#NicerMethod()并直接转到该方法的文档。

我想在 <xs:documentation> 中做类似的事情。例如，给定这个 XSD:

<xs:complexType name="personinfo">
  <xs:sequence>
    <xs:element name="firstname" type="xs:string">
      <xs:annotation>
        <xs:documentation>This element is linked to @lastname</xs:documentation>
      </xs:annotation>            
    </xs:element>
    <xs:element name="lastname" type="xs:string"/>
  </xs:sequence>
</xs:complexType>

...我想知道(如果存在)在 @lastname 上使用的正确语法这样，当生成 XSD 文档时/当从此 XSD 生成 Java 类时，属性 firstname将记录另一个属性 lastname 的真实链接。

<xs:documentation>的唯一示例我在网上找到的是this XSD其中一些元素在文档中以纯字符串(前面有命名空间)引用，但是当我使用这样的示例生成 XSD 文档时，我没有得到任何链接，只有纯文本。 环顾四周，我似乎找不到任何其他例子或提及这一点。

这可能吗？如果是这样，我该怎么办？

Answer 1

XSD 中没有规定指定对 xsd:documentation(用户元数据)或 xsd:appinfo(应用程序元数据)中的组件(元素或属性)的引用 –你只能靠自己了。