避免 JavaDoc 注释中的重复

Question

我正在编写一个类，其中在某些方法之间使用相同的 xml。

例如

/**
 * Sample Response:
 * <xmp>
 *      <myXML>
 *          <stuff> data </stuff>
 *      </myXML>
 * </xmp>
 */
 CommonXML Method1();

/**
 * Sample Submission:
 * <xmp>
 *      <myXML>
 *          <stuff> data </stuff>
 *      </myXML>
 * </xmp>
 */
 void Method2(CommonXML xml);

我想编写我的文档，以便在 xml 更改时我可以修改一个资源，而不是更新受影响方法的所有 JavaDoc。

有谁知道如何做到这一点？

Answer 1

为什么不让你的文档阅读：

/**
 * Returns an XML file conforming to the CommonXML schema, available here 
 * (link-to-schema).
 **/

那么，如果您更新 XML，您只需更新您的架构吗？