在javadoc中定义所需的哈希值

Question

假设我有一个像这样的Java方法：

void configure(Map<String, String> values) {
    assert values.containsKey("x"), "Missing parameter x"
}

是否可以在JavaDoc注释中指定“{”是values中的必需值？

Answer 1

如果您可以更改方法的签名，并假设x是必需参数，但Map可能包含其他（可选）参数，您可以在签名本身通过

void configure(String xValue, Map<String, String> optionalValues = [:]) {

}