Java 如何记录声明了多个变量的单行?

Java 如何记录声明了多个变量的单行?,java,javadoc,Java,Javadoc,我在编写代码文档时遇到了这个小问题。我试图记录许多行,这些行看起来像下面的第一个示例,但它总是给该行上的每个变量提供完全相同的描述 是否有一种方法可以记录每个变量,只使用一个文档(注释?),而不将变量声明行拆分为多行 例1: private boolean isDamage = true, isOverTime = false, interruptable = false, canBeDispelled = false; 示例2:(我是如何尝试记录的。) 下一个示例是我的变量声明区域当

我在编写代码文档时遇到了这个小问题。我试图记录许多行,这些行看起来像下面的第一个示例,但它总是给该行上的每个变量提供完全相同的描述

是否有一种方法可以记录每个变量,只使用一个文档(注释?),而不将变量声明行拆分为多行

例1:

private boolean isDamage = true, isOverTime = false, interruptable = false, canBeDispelled     = false;
示例2:(我是如何尝试记录的。)

下一个示例是我的变量声明区域当前的样子。如果我必须将我的多声明行分割成多行,那么这将是一个长期的混乱

/** The ID of the spell. */
private int id = -1;
/** The name of the spell. */
private String name = null;
private double damageMin = -1.0, damageMax = -1.0;
private double healMin = -1.0, healMax = -1.0;
private int effectTime = 1;
private double costMana = -1.0, costEnergy = -1.0, castTime = -1.0;
private boolean isDamage = true, isOverTime = false, interruptable = false, canBeDispelled = false;
/** Whether the spell is a buff or not. This only applies to buff and debuff spells. */
private boolean isBuff = false;
private int bonusStrength = 0, bonusDexterity = 0, bonusConstitution = 0, bonusIntelligence = 0, bonusWisdom = 0, bonusCharisma = 0;
private double bonusDamage = 0, bonusHealth = 0, bonusResource = 0; // bonusResource allows you to ass bonus energy or mana depending on the player's type.
谢谢你的回复

编辑:
我找到了,并且看了看。这正是我想问的,但那篇文章上的答案不是我想要的。

变量的名称非常简单,所以除非你是javadoc文档,否则没有必要这样做。你没有这样做,所以你可以用一个一般的措辞,比如

/*定义拼写行为*/

当另一个开发人员读取您的代码时,他将从这一行中获得所需的所有信息以及变量及其名称。事实上,该评论可能根本不需要,因为它几乎没有增加任何价值


如果您确实想使用javadoc文档,您必须将其拆分为多行。

将它们放在不同的行上?如果没有其他方法,我将不得不这样做,但我宁愿不这样做。当然,在这个例子中,注释没有添加任何有用的信息,所以应该删除。这种情况并不少见。
/** The ID of the spell. */
private int id = -1;
/** The name of the spell. */
private String name = null;
private double damageMin = -1.0, damageMax = -1.0;
private double healMin = -1.0, healMax = -1.0;
private int effectTime = 1;
private double costMana = -1.0, costEnergy = -1.0, castTime = -1.0;
private boolean isDamage = true, isOverTime = false, interruptable = false, canBeDispelled = false;
/** Whether the spell is a buff or not. This only applies to buff and debuff spells. */
private boolean isBuff = false;
private int bonusStrength = 0, bonusDexterity = 0, bonusConstitution = 0, bonusIntelligence = 0, bonusWisdom = 0, bonusCharisma = 0;
private double bonusDamage = 0, bonusHealth = 0, bonusResource = 0; // bonusResource allows you to ass bonus energy or mana depending on the player's type.