「java需不需要写注释」java如何写注释
今天给各位分享java需不需要写注释的知识，其中也会对java如何写注释进行解释，如果能碰巧解决你现在面临的问题，别忘了关注本站，现在开始吧！
本文目录一览：
为什么要为程序添加注释，在java程序中如何为程序添加注释？
注释是用来给开发者或者是软件后续的维护者来看的。一般是用来描述这一段代码或者是程序做了些什么样的事情。实现了哪些功能，java里面注释代码，可以分为行注释和块注释，方法注释等。
行注释就是在需要注释的代码前加 //
块注释则是用 /* 和 */ 把文本段落框起来即可
Java用eclipse写项目，都什么需要写注释
不把你的设计思路写下来，过几天、几月、几年你自己都想不起来这些，修改时需要的(升级、查错等情况)
别人要读懂你的程序也要靠这些注释
归档也要求注释，而且要求一定的格式
注释的是否规范、详细决定了该软件是否有可移植性，是否是团队合作的产品。
对于java语言来说，大量注释会影响执行效率么
Java代码注释写的多，会影响到编译效率，但是不会影响到执行效率。
Java代码是先编译成字节码，然后被JVM解释执行的。
我做了个实验
TimeDemo 类
import java.util.ArrayList;
public class TimeDemo {
public static void main(String[] args) {
long start = System.currentTimeMillis();
ArrayListInteger list = new ArrayListInteger();
for (int i = 0; i 1000000; i++) {
list.add(i);
}
long end = System.currentTimeMillis();
System.out.println("本次执行耗费了"+(end-start)+"毫秒");
}
}
TimeDemo2
import java.util.ArrayList;
public class TimeDemo2 {
public static void main(String[] args) {
long start = System.currentTimeMillis();
ArrayListInteger list = new ArrayListInteger();
for (int i = 0; i 1000000; i++) {
list.add(i);
}
//用java.io生成了很多行的注释,
//注释
//注释
//注释
//注释
//注释
long end = System.currentTimeMillis();
System.out.println("本次执行耗费了"+(end-start)+"毫秒");
}
}
运行结果
当注释行数是1~1万行的时候. 能较快的编译
当注释行数达到1百万的时候,编译稍微慢一点
当注释行数达到1千万行的时候, CPU占用100%,卡了进1分钟也没有编译完成,只好强行关闭
结论:
简单明了的注释有助于程序猿对代码的读写
只有当注释行数极大的时候，才会严重的影响编译速度。 但不会影响执行速度
java 需要加注释。
注释的很详细了 还有什么不明白的可以给我留言
此外给楼主点建议，打好基础，这套代码乱七八糟，写的太烂了。不适合用来学习，要学习就找好代码，不然很容易被误导。
/**
*此类事dao层中的一个类 使用hibernate完成持久层的控制
*继承自抽象类AbstractDAO并实现了抽象类的相关方法
*主要包括获取图书列表，获取图书记录，添加图书信息，添加和更新图书信息，
*获取图书信息和判断判断是否可以删除图书信息这几个功能
*/
public class BookDAO extends AbstractDAO {
//无参数构造方法
public BookDAO() {
}
/**治理竟然加了个主方法，恕在下愚钝，除了添乱之外想不出别的解释
*也可能是测试阶段用来测试 然后忘记删除了
*/
public static void main(String[] args) {
// TODO Auto-generated method stub
}
/**
* 获取图书信息 根据关键字使用模糊查询 得到包含关键字的图书信息列表
*如果输入的book对象的bookName属性为控制或者空字符串 默认查询所有图书信息
*@pamar book 图书信息的持久化对象 应该对应数据库中的一张表bookinfo
*@pamar pager 应该是一个封装了分页逻辑的对象
*@return List 返回的数据库中包含book中关键字（图书名）的图书信息列表
*默认情况返回数据库中所有图书的信息，
*这里返回值设计成ListBookinfo会更好 当然由于集成的抽象类的限制改不了（抽象类设计的不好 ）
**/
public List getBookList(Bookinfo book,Pager pager) throws DataAccessException{
//hql语句 默认情况下 返回数据库中所有的图书信息
String hql = " from com.jframe.biz.book.Bookinfo book" +
" where 1=1 ";
/*如果book名存在且不是空串
*重新构造hql语句 添加限制条件 返回book名字的模糊查询结果集
*/
if(book.getBookName()!=null!"".equals(book.getBookName())){
hql += " and book.bookName like '%"+book.getBookName()+"%'";
}
//如果书的作者不为空且不是空串 添加限制条件 返回指定作者的模糊查询结果集
if(book.getAuthor()!=null!"".equals(book.getAuthor())){
hql += " and book.author like '%"+book.getAuthor()+"%'";
}
//创建查询对象 执行hql语句
Query query = this.getSession().createQuery(hql);
//以下两条记录设置了从数据库的第几条记录开始 查到第几条 用于分页
//设定结果集的大小 就是分页逻辑设定的每页显示的记录数
query.setMaxResults(pager.getPageSize());
//从分页中逻辑中传过来的起始记录开始查
query.setFirstResult((pager.getCurrentPage()-1)*pager.getPageSize());
//返回查询到的结果
return query.list();
}
/**
*查询指定条件的图书的记录数
*@pamar book 一个图书信息对象
*@return int 图书的记录数
*/
public int getBookCount(Bookinfo book) throws DataAccessException{
//设定默认的hql 查询所有的图书的记录
String hql = " select count(bookName) from com.jframe.biz.book.Bookinfo book" +
" where 1=1 ";
//如果图书名不为空且不是空串 添加限制条件--图书名的模糊查询
if(book.getBookName()!=null!"".equals(book.getBookName())){
hql += " and book.bookName like '%"+book.getBookName()+"%'";
}
// 如果图书作者不为空且不为空串 添加限制条件--图书作者的模糊查询
if(book.getAuthor()!=null!"".equals(book.getAuthor())){
hql += " and book.author like '%"+book.getAuthor()+"%'";
}
Query query = this.getSession().createQuery(hql);
//返回查询的结果集到list
List list = query.list();
//如果结果集对象不为空且存在结果
if(list!=nulllist.size()0)
//将结果集中第一个元素转换成整形然后返回
return ((Integer)query.list().iterator().next()).intValue();
else
//没有记录返回0
return 0;
}
/**
*添加图书信息
*@parma book 图书信息对象
*@return 很费解 为啥这个方法还有返回值，即使需要返回值也是布尔型的啊
*/
public Bookinfo addBookInfo(Bookinfo book) throws DataAccessException{
//创建hibernate模板对象
HibernateTemplate template = this.getHibernateTemplate();
//调用模板的保存方法保存图书信息
template.save(book);
//清理缓存或者说清理脏数据 检验内存中的持久态对象是否已经存入数据库
template.flush();
template.evict(book);
//以后返回值就不解释了 方法头上面有参数和返回值的解释
return getBookInfo(book);
}
/**
*保存或者更新方法 注意 这个方法在旧版的hibernate里有 貌似hibernate3.0以上版本就删掉了
*@parma book 图书信息对象
*@return 为啥这个和上个方法还有返回值，即使需要返回值也是布尔型的啊
*/
public Bookinfo saveBookInfo(Bookinfo book) throws DataAccessException{
//同上个方法 以后不解释
HibernateTemplate template = this.getHibernateTemplate();
//如果数据库中没有则插入 如果有则更新
template.saveOrUpdate(book);
return book;
}
/**
*删除指定图书
*@parma book图书信息
*@return void
*/
public void deleteBookInfo(Bookinfo book) throws DataAccessException{
HibernateTemplate template = this.getHibernateTemplate();
//调用模板的删除方法
template.delete(book);
}
/**
*根据书号查询图书信息
*@param book 图书对象
*@return 图书信息
*/
public Bookinfo getBookInfo(Bookinfo book) throws DataAccessException{
HibernateTemplate template = this.getHibernateTemplate();
//sql语句 查询指定书号的图书信息
String hql = " from com.jframe.biz.book.Bookinfo book" +
" where 1=1 and book.bookNo='"+book.getBookNo()+"'";
//调用查询的模板的查询类
List list = template.find(hql);
//将查询结果集的第一个值强制转换成对象返回
if(list!=nulllist.size()0)
return (Bookinfo) list.iterator().next();
else
return null;
}
/**
*r如果日志信息中记录的书号是可删除的 并且在数据库中存在则返回true
*/
public boolean isCanDelete(Bookinfo book) {
boolean flag = false;
HibernateTemplate template = this.getHibernateTemplate();
String hql = " from com.jframe.biz.log.Loginfo log" +
" where 1=1 and log.bookinfo.bookNo='"+book.getBookNo()+"'";
List list = template.find(hql);
if(list!=nulllist.size()0)
flag = false;
else
flag = true;
return flag;
}
}
关于java需不需要写注释和java如何写注释的介绍到此就结束了，不知道你从中找到你需要的信息了吗 ？如果你还想了解更多这方面的信息，记得收藏关注本站。
发布于：2022-12-03，除非注明，否则均为原创文章，转载请注明出处。