很多人第一次写开发技术文档都不知道怎么写,该写些什么东西。个人认为技术文档格式是次要的,它的主要目的是给以后提供项目制作的思路。那么java开发文档怎么写?摆着一个着眼点页面的流转,业务的处理,逻辑都要很好的记录下来。

java开发文档怎么写?

Java文档注释是用于生成Java API文档的注释,通过在程序中的类、属性、方法部分加上注释,就可以用javadoc命令生成漂亮的API文档,是程序员进阶的必备技能。

注意,文档注释只说明紧跟其后的类、属性或者方法。

Javadoc文档生成命令为:

-author和-version可以省略。

文档注释的结构

根据在文档中显示的效果,文档注释分为三部分。举例如下:

简述部分写在一段文档注释的最前面,第一个点号 (.) 之前 (包括点号).

第二部分是详细说明部分。该部分对属性或者方法进行详细的说明,雅思周末班在格式上没有什么特殊的要求,可以包含若干个点号。它在文档中的位置如下图所示:

这部分文档对应的代码是:

第三部分是特殊说明部分。这部分包括版本说明、参数说明、返回值说明等。它在文档中的位置:

Java技术方案范例 java技术方案怎么写_程序人生

除上面所写之外,还有javadoc命令等详细参数没有介绍,请自行在命令行中使用help命令查看。

关于生成Java文档,通过命令行进行生成通常只做演示的作用,我们开发所使用的IDE如:IntelliJ IDEA、Eclipse等均集成了文档生成功能,只需要我们把文档注释写好,然后点击按钮即可。

福利时间:我整理了一些技术资料和面试题集,供大家提升进阶,不管你是有跳槽打算还是单纯精进自己,都可以免费领取一份。

先展示部分截图,文末附免费下载方式

一、JVM篇(2022)

(含:JVM类加载机制,JVM内存模型,垃圾收集机制,类字节码实现机制,JVM调优案例,GC日志详解等)

Java技术方案范例 java技术方案怎么写_Java技术方案范例_02

二、Java并发编程(2022)

(含:java内存模型,并发集合,线程池,阻塞队列,CAS与原子操作,无锁并发框架Disruptor等)

Java技术方案范例 java技术方案怎么写_java面试_03

三、Spring篇(2022)

(含:spring IOC,spring AOP原理,spring 5,springMVC,事务管理,循环依赖,spring设计模式等)

Java技术方案范例 java技术方案怎么写_java_04

四、Mysql篇(2022)

(含:SQL执行原理,索引底层机制,SQL执行计划分析,Mysql锁机制,Mysql事务隔离,SQL优化实践等)

Java技术方案范例 java技术方案怎么写_java_05

五、SpringCloud篇(2022)

(含:服务发现与注册Eureka与Nacos,服务限流熔断降级Hystrix与Sentinel,分布式事务Seata,网关Gateway等)

Java技术方案范例 java技术方案怎么写_java面试_06

六、Dubbo篇(2022)

(含:Dubbo基础,架构设计,集群,配置,通信协议,SPI等)

Java技术方案范例 java技术方案怎么写_Java技术方案范例_07

七、Redis篇(2022)

(含:Redis核心数据结构,Redis持久化机制与安全机制,哨兵与集群架构,Redis缓存穿透,缓存失效,缓存雪崩,Redis缓存设计与性能优化等)

Java技术方案范例 java技术方案怎么写_Java技术方案范例_08

八、分布式篇(2022)

(含:分布式架构原理,集群架构原理,分布式锁,分布式事务,分布式协议,分布式配置,海量数据分库分表,分布式调度,等)

Java技术方案范例 java技术方案怎么写_java_09

九、设计模式篇(2022)

(含:单例模式,工厂模式,抽象工厂模式,建造者模式,原型模式,适配器模式,装饰器模式,代理模式等23种设计模式)

Java技术方案范例 java技术方案怎么写_spring_10

十、数据结构与算法篇(2022)

(含:红黑树,B+树,贪心算法,哈希分治法,七大查找算法,动态规划,一致性算法等)

Java技术方案范例 java技术方案怎么写_程序人生_11

十一、MQ篇(2022)

(含:消息丢失,消息重复消费,消息乱序,消息积压,延时队列,消息回溯消费,消息刷盘机制,MQ中间件集群架构原理等)

Java技术方案范例 java技术方案怎么写_java面试_12

十二、Netty篇(2022)

(含:BIO、NIO及AIO线程模型,Netty线程模型,序列化协议protobuf,粘包拆包问题,Netty心跳机制,直接内存与Netty零拷贝,WebSocket协议等)

Java技术方案范例 java技术方案怎么写_程序人生_13

十三、Zookeeper篇(2022)

(含:ZooKeeper选举机制,ZooKeeper数据模型,ZooKeeper应用场景等)

Java技术方案范例 java技术方案怎么写_java_14

十四、ElasticSearch篇(2022)

(含:ElasticSearch数据模型、ElasticSearch分布式架构、ElasticSearch数据读写原理和段合并等)

Java技术方案范例 java技术方案怎么写_程序人生_15

十五、网络与操作系统篇(2022)

(含:网络协议,TCP/IP系统结构,TCP/IP协议族,常见面试题,等)

Java技术方案范例 java技术方案怎么写_java面试_16