参数中属性的 javadoc

Question

我有一个接受 Properties 对象的方法。是否有一种标准的方式来记录 javadoc 中的属性，例如：

/**
 * @param props containing the following optional configuration props
 *    "one" -> defaults "hello"
 *    "two" -> defaults "bye"
 */
public readProps(Properties props) {
    one = props.getProperty("one", "hello");
    two = props.getProperty("two", "bye");
}

Answer 1

我认为没有标准的方法来记录此类信息。但是，我会在描述中记录它，而不是在 @param 标签下。 @param 标签应该是参数的简短描述，较长的文本最好放在其他地方。例如：

/**
 * Reads props.
 * A {@link Properties} object is passed to this method containing the 
 * following properties:
 * <dl>
 * <dt>one</dt>
 * <dd>first property, defaults to <code>"hello"</code></dd>
 * <dt>two</dt>
 * <dd>second property, defaults to <code>"bye"</code></dd>
 * </dl>
 *
 * @param props the properties
 */
 public void readProps(Properties props) { ... }

参数中属性的 javadoc

javadoc of Properties in argument

javadoc