很多人第一次写开发技术文档都不知道怎么写,该写些什么东西。个人认为技术文档格式是次要的,它的主要目的是给以后提供项目制作的思路。那么java开发文档怎么写?摆着一个着眼点页面的流转,业务的处理,逻辑都要很好的记录下来。
java开发文档怎么写?
Java文档注释是用于生成Java API文档的注释,通过在程序中的类、属性、方法部分加上注释,就可以用javadoc命令生成漂亮的API文档,是程序员进阶的必备技能。
注意,文档注释只说明紧跟其后的类、属性或者方法。
Javadoc文档生成命令为:
-author和-version可以省略。
文档注释的结构
根据在文档中显示的效果,文档注释分为三部分。举例如下:
简述部分写在一段文档注释的最前面,第一个点号 (.) 之前 (包括点号).
第二部分是详细说明部分。该部分对属性或者方法进行详细的说明,雅思周末班在格式上没有什么特殊的要求,可以包含若干个点号。它在文档中的位置如下图所示:
这部分文档对应的代码是:
第三部分是特殊说明部分。这部分包括版本说明、参数说明、返回值说明等。它在文档中的位置:
除上面所写之外,还有javadoc命令等详细参数没有介绍,请自行在命令行中使用help命令查看。
关于生成Java文档,通过命令行进行生成通常只做演示的作用,我们开发所使用的IDE如:IntelliJ IDEA、Eclipse等均集成了文档生成功能,只需要我们把文档注释写好,然后点击按钮即可。
福利时间:我整理了一些技术资料和面试题集,供大家提升进阶,不管你是有跳槽打算还是单纯精进自己,都可以免费领取一份。 先展示部分截图,文末附免费下载方式 一、JVM篇(2022)
(含:JVM类加载机制,JVM内存模型,垃圾收集机制,类字节码实现机制,JVM调优案例,GC日志详解等)
二、Java并发编程(2022)
(含:java内存模型,并发集合,线程池,阻塞队列,CAS与原子操作,无锁并发框架Disruptor等)
三、Spring篇(2022)
(含:spring IOC,spring AOP原理,spring 5,springMVC,事务管理,循环依赖,spring设计模式等)
四、Mysql篇(2022)
(含:SQL执行原理,索引底层机制,SQL执行计划分析,Mysql锁机制,Mysql事务隔离,SQL优化实践等)
五、SpringCloud篇(2022)
(含:服务发现与注册Eureka与Nacos,服务限流熔断降级Hystrix与Sentinel,分布式事务Seata,网关Gateway等)