[英]Java Writing Method Definition
我想学习在课堂上编写方法定义。 即:
public int myMethod()
{
//This method is used for ....bla bla bla....
}
我想告诉用户有什么方法。 在.Net中,您可以编写此定义,并在编写方法时看到解释。 如何在JAVA中完成?
这样做:
/**
* This method is used for..
*/
public int myMethod()
{
}
对于params使用这样:
/**
* This method is used for..
* @param v pass this to do something
*/
public int myMethod(Object v)
{
}
完整的详细信息: oracle.com
充实其他一些答案。
第一句话应该是第三人称的句子,它回答了“方法做什么”这个问题,“eq,”创造一个foobar。 此外,第一句用作摘要注释,因此它应尽可能清晰,简洁。
例如,如果您的方法读入文件并返回整数状态:
/**
* Reads in config file and initializes application.
*
* @return Application status; 0 if everything is okay.
*/
public int myMethod() {
// ...
}
IMO添加不必要的细节只是 - 不必要。 有些方法是自我记录的,规范的例子是getter / setter:
/**
* Sets first name.
*
* @param firstName Name to set.
*/
public void setFirstName(String firstName) {
this.firstName = firstName;
}
冗余评论。 同样,命名良好的方法可以避免需要大量或任何文档:
public List<User> getAllUsers() { ... }
public User findUserById(Long id) { ... }
国际海事组织,除非有一些非常了不起的东西,没有必要说。
HTML用于标记Javadocs,但IMO最好将其格式化为可以多种格式(编辑器,IDE,Javadoc等)读取,因此我倾向于缩进并使用空格来确保我可以用纯文本和渲染来查看所有内容。
标准doclet假定HTML:除非通过<p>
或<br>
标签明确指出,否则忽略空格。
/**
* Builds and returns the current list of ingredients.
*
* <p>
* <b>Note:</b> Initializes ingredient information if necessary.
* </p>
*/
有用的链接:
如果必须记录它,在函数之前使用Javadoc是有利的。
/**
* Does [fill in the blank here]
* @return An integer stating [what it does]
*/
public int myMethod() {
// Fill in the rest here
}
将其添加为方法上方的/ ** ... * /注释:
/**
* This method is used for ....bla bla bla....
*/
public int myMethod()
{
}
一旦键入/ **,Eclipse将自动生成Javadoc方法签名注释,然后按Enter键转到下一行。
请参阅如何为Javadoc工具编写Doc注释 。 (基本上,你正在寻找所谓的Javadocs。)
有关示例,请参阅此处发布的其他答案。
您需要使用javadoc注释来实现此目的。 像下面的东西
/** * This method is used for.. */ public int myMethod() { }
以下是有关Javadoc方法Javadoc方法的更多信息的链接
声明:本站的技术帖子网页,遵循CC BY-SA 4.0协议,如果您需要转载,请注明本站网址或者原文地址。任何问题请咨询:yoyou2525@163.com.