这是通过javadoc来做到的。
注意下面的@deprecated的用法

/**
 * Sets the name.
 * @param name The name to set
 * @deprecated don't use this method.
 */
public void setName(String name) {
this.name = name;
}