数据导出:将数据库的数据导出成Excel工作表或Word文档 方法:将一个泛型集合导出出去 主要使用: SaveFileDialog StreamWriter 导出代码: private void button1_Click(object sender, EventArgs e)  //点击导出按钮导出数据 { saveFileDialog1.Filter = "Excel工作表|*.xlsx|Word文档|*.doc";  //选怎导出的是excle表格,还是Word文档 saveF…

1.什么是API文档 在Java语言中有3种注释 //单行注释 /* 多行注释 */ /** * 文档注释 */ API(应用程序接口)文档就是用javadoc命令提取文档注释生成的,html格式,用浏览器查看. API文档既然是由文档注释生成的,那么文档注释怎么写呢? 首先,文档注释必须放在类和方法的前面,格式也要准确. 其中,要写清楚类和方法的功能,以及方法传入的形参和返回值具体是什么. 一般来说,只默认提取public和protected修饰的类.接口.方法.成员变量.构造器.内部类的说明…

第一步: 源码注释规范,一定要用/** 两个*这一特殊的注释.注释上可以添加@author等特殊说明,下图是部分 javadoc 标记 信息,可以根据需要选用.   第二步: 确保整个工程的项目都添加了特殊注释后,右键工程,选择export导出. 第三步: 选择java—>javadoc,然后点击next(下一步). 第四步: 这个选项可以选择javadoc命令,要生成api的工程以及API存放的路径.javadoc command会自动选择安装的jdk的bin目录下的javadoc应用程序,如…

我们可以通过 javadoc 命令从文档注释中提取内容,生成程序的 API 帮助文档. javadoc -d doc demo.java 文档注释:/******/ @author 标明开发该类模块的作者 @version 标明该类模块的版本 @see 参考转向,也就是相关主题 @param 对方法中某参数的说明 @return 对方法返回值的说明 @exception 对方法可能抛出的异常进行说明…

转载自:http://blog.163.com/hui_san/blog/static/5710286720104191100389/ 前言 Java 的语法与 C++ 及为相似,那么,你知道 Java 的注释有几种吗? 1)// 注释一行   2)/* ...... */ 注释若干行 3)/** ...... */ 注释若干行,并写入 javadoc 文档 通常这种注释的多行写法如下: /**   * .........   * .........   */ 这第三种注释有什么用?javado…

Tips 书中的源代码地址:https://github.com/jbloch/effective-java-3e-source-code 注意,书中的有些代码里方法是基于Java 9 API中的,所以JDK 最好下载 JDK 9以上的版本. 56. 为所有已公开的API元素编写文档注释 如果API要可用,就必须对其进行文档化.传统上,API文档是手工生成的,保持文档与代码的同步是一件苦差事.Java编程环境使用Javadoc实用程序简化了这一任务.Javadoc使用特殊格式的文档注释(通常称为…

文档注释的结构 文档注释主体的开头是一句话,概述类型或成员的作用,应自成一体.后面可跟其他句子或段落,用以详细说明类.接口.方法或字段. 除了这些描述性的段落以外,后也可跟其他段落,数量不限,并且每段以一个特殊的文档注释标签开头,如@author.@param.@returns.这些包含标签的段落提供类.接口.方法或字段的特殊信息,javadoc会以标准形式显示这些信息. 文档注释的描述性内容可以包含简单的HTML标记标签,在这里列举几个常用的: <i>name</i> 表示强调…

本文翻译自How to Write Doc Comments for the Javadoc Tool,但是精简了一些私以为不重要的东西 本文不讨论如何使用javadoc工具自动生成文档的方法,而是主要探讨应该如何去写文档注释 业余时间整理,难免有遗漏或错误,如有发现欢迎指正 转载请注明 文档注释概览 “文档注释”(Java Doc Comments)是专门为了用javadoc工具自动生成文档而写的注释,它是一种带有特殊功能的注释. 文档注释与一般注释的最大区别在于起始符号是/**而不是/*或/…

1.前言 Java中有三种注释方式.前两种分别是 // 和 /* */,主要用于代码的注释,以此来方便代码的可读性.第三种被称作说明注释或文档注释,它以 /** 开始,以 */结束,文档注释允许你在程序中嵌入关于程序的信息,有了这个注释就可以使用 javadoc 工具软件来生成信息,并输出到HTML文件中. 2.文档注释的格式 /*** .........* .........*/ 在开始的 /** 之后,第一行或几行是关于类.变量和方法的主要描述. 之后,你可以包含一个或多个各种各样的 @ 标…

Eclipse和IntelliJ IDEA系的IDE都有自动生成文档注释的功能,Xcode虽然安装了VVDocument,但是仍然感觉注释的功能不是很完善,于是今天整理了一下书写文档注释的一些用法. 首先要说的就是文档注释提取的工具:主要是介绍HeaderDoc和appleDoc 1.我们平常长按option键同时鼠标点击,弹出的文档就是Xcode会自动使用HeaderDoc生成的.如图: 2.appleDoc只为Objective-C服务,可以在文档书写完成之后使用appledoc生成docS…