学习雷岩的Java系列，作为Java的基本入门系列。通过本系列，我们将学习Java的基础知识，包括变量、数据类型、运算符、选择结构、循环结构、数组等基础知识。本系列总结了格雷多年的经验，通过边说边练的方式带领零基础的朋友进入Java世界。

这个系列的每一章都会有很多练习。学习过程中请认真练习，并与我提供的参考代码进行对比，反复感受。要学好一门语言，只有听不懂才可能学好。用心去了解自己，多练习，多思考，是学好一门语言的基础。

这是本系列的第二章。

Java控制台输出语句

输出不换行

语法：System.out.print(“要输出的字符串”)；

函数：将括号中的字符串输出到控制台，不换行。

注意：Java中的字符串必须用英文双引号括起来。

例如，我们在记事本中编写以下代码

1.公共类MyFirstProgram {

2.公共静态void main(String[]args){ 0

3.//代码中有两行输出语句。

4.system . out . print(' hello Java ')；

5.system . out . print(' hello world ')；

6.}

7.}

结果如下。我们可以看到print方法的输出没有换行。

今天我们将集中讨论一些参数。

语法：

要生成的帮助文档目录-作者-版本-窗口标题文档以生成API

参数解释：

-d输出文档的目标路径，即要生成的帮助文档所在的目录。

-author包含@author段。

-version包含@version段。

-windowtitle文本浏览器窗口中显示的标题。

-要为其生成文档的文件生成API的文档。

每个参数的中间需要用空的隔间隔开。

示例：

* javadoc-d : javaprojectdoc-作者-版本-窗口标题我的第一个API。java上面的命令用于在D盘上的javaProject的doc目录中为所有带有。当前目录中的Java扩展。帮助文档的标题是“我的第一个API”，显示版本号和作者。

下图说明了执行上述命令的过程。

执行成功后，会在doc目录下生成API DOCuments。

我们可以双击index.html打开我们的帮助文档。

让我们将注释与最终效果逐一匹配，以便更好地理解文档注释。

点击“打包”，出现下图。我们相应类的文档注释的第一行显示了内容。

点击上图绿框框住的类名，进入类的详细描述页面，如下图，请仔细对照：

点击上图绿框框住的文字，我们来对照方法的文档注释

练习二

??本阶段我们学习Java中的注释，重点了解了文档注释及javadoc命令生成API。通过下面练习来验证一下，你是否掌握了吧。

1. 在练习一的基础上，为第一个输出语句添加多行注释，详细描述t n的作用及为什么添加多个t。

2. 在练习一的基础上，为第二个及第三个输出语句分别添加单选注释，描述语句的作用。

3. 在练习一的基础上，为MyFirstProgram类加文档注释，需要有概要描述、详细描述、版本号及作者

4. 在练习一的基础上，为main方法添加文档注释，需要有概要描述、详细描述和参数标注。

5. 5.添加完注释后，再次对类进行编译运行，不能出错。

练习三

??在练习二的基础上完成练习三：

1. 使用javadoc命令生成类的API。

2. 打开API文档，对各种描述及标注进行一一对应，加深对文档注释的理解 。

总结

??到此，今天的内容就已经结束了，下面的思维导图是今天的总结 ：

?练习参考代码

练习一参考代码

1. public class MyFirstProgram {
2.    public static void main(String[] args) {
3.       //行末的n是为了多输出一个换行符
4.       //由于My name is LeiGe比较长，因此在name后加了三个t，用于对齐制表位。
5.       System.out.println("nametttagen");
6.       System.out.println("LeiGettt18");
7.       System.out.println("My name is LeiGet18");
8.    }
9. }

练习二参考代码

1. /**
2. * <p>写在类第一行的文档注释应是类的作用.</p>
3. *
4. * <P>空一行后这里写类的详细作用，支持html语法比如写上：</P>
5. * <p>欢迎访问<a href="https://blog.csdn.net/weixin_42452652">彦磊的博客</a></P>
6. * <p>其后可以写明作者等信息</p>
7. *
8. *<p>空一行后写文档标注，如作者、版本等</p>
9. * @author 彦磊
10. * @version 1.0
11. */
12. public class MyFirstProgram {
13.    /**
14.    * <p>写在方法文档注释第一行的是方法的概要作用.</p>
15.    *
16.    * <p>空一行后写方法的详细作用</P>
17.    * <p>程序的入口.</p>
18.    *
19.    * <p>空一行后写文档的标注，如参数、返回值等.</p>
20.    * @param args 接收从控制台传入的参数.
21. 　　　　　*
22.    */
23.    public static void main(String[] args) {
24.       /*
25.       * 向控制台中输出name和age，并输出一个空行
26.       * t 的作用是输出一个制表位
27.       * n的作用是输出一个换行符
28.       */
29.       System.out.println("nametttagen");
30.       //换行输出LeiGe及18，并用制表位和上一行对齐
31.       System.out.println("LeiGettt18");
32.       //换行输出My name is LeiGe及18，并用制表位和上一行对齐
33.       System.out.println("My name is LeiGet18");
34.
35.
36.    }
37. }