从HelloWorld和文档注释开始入门Java编程_java

HelloWorld

public class HelloWorld
{
  public static void main(String args[])
  {
  System.out.println("Hello World!");  //向控制台输出一条语句,同时必须以;结尾
  }
}

运行上面程序如图所示

我们通过上面的程序开始分析并学习Java语言的基础知识;

1、注释:

      Java的注释分为三种:单行注释//  多行注释/*…*/  文档注释

      像上面的HelloWorld程序分别用到了多行注释和单行注释。

       Java还提供了另外一种注释叫文档注释,如果编写Java源代码时添加了合适的文档注释,然后通过JDK提供的javadoc工具可以直接将源代码里的文档注释提取成一份系统的API文档。API文档就是用以说明应用程序接口的文档。对于Java而言,API文档通常说细说明了每个类、每个方法的功能及用法。

       Java语言的API文档的下载地址:http://www.oracle.com/technetwork/java/javase/downloads/index.html

   关于文档注释,我会在后面专门有一篇文章

2、Java的组织形式

//Java程序必须是以类class形式存丰,类class是Java程序的最小程序单位
class 类名
{
 /*Java解释器规定:如需某个类能被解释器直接解释执行,则这个类必须包含main方法,而且main方法必须使用pulbic static void来修饰,且main方法的形参必须是字符串数组类型(String args[]是字符串数组的形式) 也就是说main方法基本上固定不变的
*/
  public static void main(String args[])
 {

  }
}

3、Java源文件的命名规则
    1)Java程序源文件的后缀必须是.java,不能是其他文件后缀名

    2)一个Java源文件可以包含多个类定义,但最多只能包含一个public类定义;如果Java源文件里包含public类定义,则该源文件的文件名必须与这个public类的类名相同

    3)Java语言是严格区分大小写的语言。因为源文件的文件名保存的时候也应注意大小写

    4)Java程序中的关键字全部是小写的

总结:通过上面的程序简单地说了一下Java程序的框架结构。

文档注释

Java语言提供了一种功能更强大的注释形式:文档注释。如果编写Java源代码时添加了合适的文档注释,然后通过JDK提供的javadoc工具可以直接将源代码里的文档注释提取成一份系统的API文档。API是应用程序接口的意思,API是Java提供的基本编程接口,当使用Java语言进行编程时,不可能把所有的Java类、所有方法全部记下来,那么如果我们遇到一个不确定的地方时,必须通过API文档来查看某个类、某个方法的功能和用法。

Java API文档的下载地址:http://www.oracle.com/technetwork/java/javase/downloads/index.html

下载完成之后,打开DOCS/api文件夹里面的index.html文件,

1、API文档首页如图

2、类说明区格局如下图

由于只有以public或protected修饰的内容才是希望暴露给别人使用的内容,而API文档主要是向使用者提供信息,因此javadoc工具默认只处理public或protected修饰的内容。如果开发者确实希望javadoc工具可以提取private修饰的内容,则可以在使用javadoc工具时增加-private选项来实现

下面我们通过一个演示程序来说明文档注释

package Gee;
/**
 网站:<a href="http://www.geeit.me/">作者博客站</a>
 <br/>这是一个javadoc工具演示的程序
 <br/>程序名:javadoc演示程序
 <br/>程序文件名:JavaDocDemo
 @author Gee
 @version 1.0
 */
 public class JavaDocDemo
 {
   /** 简单的测试Field
   */
   protected String name;
   /** 主方法,程序的入口 */
   public static void main(String[] args)
   {
       System.out.println("Hello World!");
   }
 }

除此之外,如果我们希望 javadoc工具生成更详细的文档信息,例如为方法参数、方法返回值等生成详细的说明信息,则可利用javadoc标记。常用的javadoc标记如下。

  •   @author:指定程序的作者 
  •   @version:源文件的版本
  •   @deprecated:不推荐使用的方法
  •   @param:方法的参数说明信息
  •   @return:方法的返回值说明信息
  •   @see: “参见”用于指定交叉参考的内容
  •   @exception:抛出异常的类型
  •   @throws:抛出的异常,和exception同义。

javadoc工具默认不会提取@author和@version两个标记信息,如果需要提取这两个标记应该使用javadoc工具指定的-author和-version两个版本

以上是小编为您精心准备的的内容,在的博客、问答、公众号、人物、课程等栏目也有的相关内容,欢迎继续使用右上角搜索按钮进行搜索java
, helloworld
文档注释
c语言入门helloworld、编程hello world、java编程helloworld、c语言编程helloworld、编程helloworld,以便于您获取更多的相关知识。

时间: 2024-09-10 20:33:33

从HelloWorld和文档注释开始入门Java编程_java的相关文章

仔细触摸Java编程中的“文档”和“包”

编程 什么是包 Java中的包(Package)其实指的就是目录,它是为了更好地管理Java类(Class)和接口(Interface).Java语言的包可以被另一个Java开发包所使用.如果我们要引用某个包中的类,用import关键字来标明即可.比如: import java.util. date=new Date  提示:import java.util.表示java.util中的所有公有类和接口被引入到当前包.这里的匹配符可以调入多个类名. 常用的Java标准包 JDK为我

Java编程那些事儿20—空白、语句结束和注释

3.8 空白 在前面的内容中,已经介绍了在编写代码中,单词和单词之间需要使用空格进行间隔,至于空格的数量则不限制. 而实际的编码中,为了使代码的结构清晰,一般需要在代码的前面加入一定数量的空格,例如如下格式: public class Blank{ public static void main(String[] args){ int n; { n = 10; } System.out.println(n); } } 在该代码中,除了第一行和最后一行外,每行都包含一定数量的空格,这种编码的格式称

如何使用JS的正则表达式检查 java中的文档注释? (用于代码高亮)

问题描述 例如:在java 中可以这样写文档注释/***这个是注释**/我想实现的效果是/***这个是注释**/现在我想用JS 的正则表达式 匹配他我写了如下的代码但是就是不起作用,只能匹配 /** 其他剩下的都不能匹配.MultiLineCComments : new RegExp('/\*[\s\S]*?\*/', 'gm'),希望哪为朋友帮帮忙,帮我修改一下这个正则表达式,使其能够正常工作.谢谢!问题补充:其实我这段代码是MultiLineCComments : new RegExp('/

Java核心技术卷I基础知识2.1.3 安装库源文件和文档

2.1.3 安装库源文件和文档 库源文件在JDK中以一个压缩文件src.zip的形式发布,必须将其解压缩后才能够访问源代码.建议按照下面所述的步骤进行操作.很简单: 1)确保JDK已经安装,并且jdk/bin目录在执行路径中. 2)在主目录中建立一个目录javasrc.如果愿意,可以在一个终端窗口完成这个步骤.   3)在jdk目录下找到文件src.zip. 4)将src.zip文件解压缩到javasrc目录.在一个终端窗口中,可以执行以下命令:         提示:src.zip文件中包含了

java怎样用正则表达式匹配文档注释,如“/**@date 2012-1-2*/”?

问题描述 现在想做个把文件的文档注释删除的东西?不知道java怎样用正则表达式来匹配,请各位帮忙 问题补充:牟盖东 写道 解决方案 写了个例子,你可以参照下package iteyeQuestions;/* * java怎样用正则表达式匹配文档注释,如"斜杠**@date 2012-1-2*斜杠"? * 现在想做个把文件的文档注释删除的东西?不知道java怎样用正则表达式来匹配,请各位帮忙 */import java.io.BufferedReader;import java.io.B

java开发-IE浏览器 浏览器模式和文档模式 开发中调试版本兼容问题

问题描述 IE浏览器 浏览器模式和文档模式 开发中调试版本兼容问题 我现在电脑安装的是ie10,当我在开发中想测试页面是否兼容10以下的版本时,是通过切换浏览器模式至低版本,还是切换文档模式至低版本,还是同时都切换,并保持一致. 希望用IE开发的老工程师回答,感激. 解决方案 装一个IETester,IETester是一个免费的WebBrowser控件,让您有渲染和IE8的JavaScript引擎,IE7和IE 6在Windows 7,Vista和XP的IE5.5中,以及在同一进程中安装的IE浏

Java中的包和文档

什么是包 Java中的包(Package)其实指的就是目录,它是为了更好地管理Java类(Class)和接口(Interface).Java语言的包可以被另一个Java开发包所使用.如果我们要引用某个包中的类,用import关键字来标明即可.比如: import java.util. date=new Date 提示:import java.util.表示java.util中的所有公有类和接口被引入到当前包.这里的匹配符可以调入多个类名. 常用的Java标准包 JDK为我们提供了很多标准的Jav

Word2003 怎么来设置纸张和文档网格

文章介绍一下Word2003 怎么来设置纸张和文档网格,有需要的同学可参考一下. 现在,还是不用急于录入文字,需要指定一下文字的样式.通常,很多人都是在录入文字后,用"字体"."字号"等命令设置文字的格式,用"两端对齐"."居中"等命令设置段落的对齐,但这样的操作要重复很多次,而且一旦设置的不合理,最后还要一一修改. 熟悉Word技巧的人对于这样的格式修改并不担心,因为他可以用"格式刷"将修改后的格式一一刷

eclipse中写文档注释修改作者名称

问题描述 eclipse中写文档注释修改作者名称 和方法创建的时间和它的格式,修改完后就是用快捷键它自己都能出来 解决方案 eclipse设置过程如下,按自己的喜好设置就好了. 解决方案二: 怎样修改Eclipse注释的作者修改eclipse 注释的作者Eclipse怎么修改文档注释样式 解决方案三: 我一般这样 /** @author :某某 **/ 此连接就是你找的方法 http://mobile.51cto.com/abased-387443.htm 解决方案四: 根据毕小宝图片说的,把下