如何将 <xs:element> 引用到我的 <xs:documentation> 中？

Question

我有一个XSD，用于在Java接口中创建相应的类。我的 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 文档时，用户可以单击 link 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 文档时 / 当 Java 类是从这个 XSD 生成的，属性 firstname 将用真实的 link 记录到另一个属性 lastname。

我在网上能找到的 <xs:documentation> 的唯一示例是 this XSD，其中一些元素在文档中以纯字符串（前面带有命名空间）引用，但是当我生成 XSD doc 使用这样的示例我没有得到 link，只是纯文本。四处阅读，我似乎找不到任何其他例子或提到这一点。

可能吗？如果可以，我应该怎么做？

Answer 1

XSD 中没有规定在 xsd:documentation（用户元数据）或 xsd:appinfo（应用程序元数据）中指定对组件（元素或属性）的引用 – 你在你自己的。

如何将 <xs:element> 引用到我的 <xs:documentation> 中？

How can I reference an <xs:element> into my <xs:documentation>?

xml

xsd

javadoc

xml-documentation