Java注释

Java注释

单行注释：

//这里是单行注释

多行注释：

/*这里是多行注释，可以多行 */
在Java中还有一类注释，称为JavaDoc注释，它能够从程序源代码中抽取类、方法、成员等的注释，形成一个和源代码配套的API帮助文档（简单地说，就是介绍该类的方法和成员变量的文档）

语法规则：

1、JavaDoc注释以/**开头，以 */结束
2、每个注释包含一些描述性的文本及若干个JavaDoc标签
3、JavaDoc标签一般以“@”为前缀

常用的JavaDoc标签

标签	含义
@author	作者名
@version	版本标本
@param	版本标识
@since	最早使用该方法/类/接口的JDK版本
@return	返回值
@throws	异常类及抛出条件

包

Java提供包来管理类，类似于文件存在文件夹中，Java的类文件可以存储在不同的包中
作用：
1、允许类组成较小的单元，易于找到和使用相应的文件
2、防止命名冲突
3、更好的保护类，属性和方法

如何声明包

语法：package 包名;

package cn.kgc.classanddobject;//声明包
public class KgcSchool{
	//.....
	public String toString(){
	//.....
	}	
}

注意：
包的声明必须是Java源文件中的第一条非注释性语句，而且一个源文件只能有一个包声明

包的命名规范

1、包名由小写字母组成，不能以圆点开头或结尾

package mypackage;

2、包名之前最好加上唯一的前缀，通常使用组织倒置的网络域名

package cn.kgc.mypackage;

3、包名后续部分以不同机构内部的命名规范不同而不同

package cn.kgc.javagroup.powerproject;
				部门名		项目名

包与目录的关系

创建包package cn.kgc.mypackage，即创建了目录结构：cn/kgc/mypackage

如何导入包

语法：

import  包名.类名;

为了使用不在同一包中的类，需要在Java程序中使用import关键字导入这个类

import java.util.*;		//导入Java.util包中所有的类
import cn.kgc.classanddobject.Menu;		//导入指定包中指定类