类的阐述，Package,编码规范

类的阐述

• 同一个源文件中可以定义多个类。
• 编译后，每一个类都会生成独立的, .class文件
• 一个类中，只能有一个主函数，每个类都可以有自己的主函数。
• 一个类中，只能有一个主函数，每个类都可以有自己的主函数。
• public修饰的类成为公开类，要求类名与文件名称完全相同（这样就导致一个源文件只能有一个公开类），包括大小写。

Package

作用：类似于文件夹，用于管理字节码(.class)文件。

    *  为类再添加一个分类，不同的Package文件下可以有同名的.class文件
*  当一个项目中有两个**相同类名**的class文件，为了区分它们就可以为它们添加不同的Package包名

语法： Package 包名;

编译与运行：带包编译：

​ javac -d . MyPack.java 自动生成当前文件夹创建对应的包文件

​ javac -d C:\xxx\xxx MyPack.java 指定文件夹

​ 带包运行：

​ java 文件名.MyPack.class

• Package的命名规则：
  • 采用域名倒置的规则：www.daidu.com.cn -> cn.com.baidu.xxx
  • 例如：cn.com.company(公司)department(部门).group(组).project(项目).module(模块).XxxClass

编码规范

• 编码规范（1）：

  • 层级之间必须缩进(Tab : 一个制表位)。
  • 一行只写一句代码。

• 代码注释（2）：

  • //单行注释

  • /* 多行注释*/

  • 文档注释：(生成外部文档：javadoc -d . HelloWorld.java)

    这样的注释适用于修饰类和函数。

    注意： 要想生成外部文档，这个类就要是一个

    /** 文档注释 */

    标签	描述	示例
    @author	标识一个类的作者	@author description
    @version	指定类的版本	@version info
    @param	说明一个方法的参数	@param parameter-name explanation
    @return	说明返回值类型	@return explanation

    命令： javadoc -d 文档存放目录 -author -version 源文件名.java

    这条命令编译一个名为"源文件名.java"的 java 源文件，并将生成的文档存放在"文档存放目录"指定的目录下，生成的文档中 index.html 就是文档的首页。-author 和 -version 两个选项可以省略

• 语法规定：

  • 可以由：字母，数字，_,$，但是不能以数字开头。
  • 不能与关键字，保留字重名。

• 约定俗成：

  • 类名有一个或多个单子组成，每个单词首字母大写。
  • 函数名，变量名由一个或者多个单词组成，手单词字母小写，拼接词首字母大写。
  • 包名全小写，只可以使用特殊字符".",并且不以"." 开头或者结尾。
  • 常量全大写，多个单词用_连接。

标签：编码,阐述,java,Package,注释,version,文档,class
来源： https://www.cnblogs.com/alien-x/p/12452356.html