CoreJava读书笔记--对象与类（六）

包

Java允许使用包（package）将类组织起来。借助于包可以方便地组织自己的代买，并将自己的代码与别人提供的代码库分开管理。

标准的Java类库分布在多个包中，例如:java.lang,java.util,java.net等。

使用包的主要原因就是确保类名的唯一性。如果两个类名相同的类，只要不放在一个包中，那么便不会产生冲突。

（一）类的导入

一个类可以使用所属包中的所有类，以及其他包中的公有类（public class）。

访问另一个包中的公有类有两种方式：

①在每个类之前添加完整的包名，如：

<span style="color:#ff0000">java.time.LoclaDate today = java.time.LocalDate.now();</span>

②使用import关键字，引用一个包或者一个特定的类。如：

<span style="color:#ff0000">import java.util.*</span>

（二）静态导入

①import语句不仅可以导入类，还可以导入静态方法和静态域。

如果在源文件顶部，添加一条指令：

import static java.lang.System.*;

就可以使用System类的静态方法和静态域了，而不必加类名前缀：

out.println("Goodbye World");

②也可以导入特定的方法或域：

import static java.lang.System.out;

（三）将类放入包中

要想将一个类放入包中，就必须将包的名字放在源文件的顶部即开头。

package com.horstman.corejava;

public class Employee{
   ...
}

如果没有在源文件中放置package语句，那么这个类会被放入一个默认包（default package）中。
 

类路径

类还可以存储在JAR（Java归档）文件中。在程序中使用到第三方库文件时，通常会给出一个或多个需要包含的jar文件。

为了使类能够被多个程序共享，需要做到以下几点：

①把类放到一个目录中

②将jar文件放在一个目录中

③设置类路径（class path）

类路径包括：①基目录，②当前目录（.），③jar文件

文档注释

JDK包含一个很有用的工具，就是javadoc，它可以由源文件生成一个HTML文档。

（一）注释的插入

javadoc实用程序（utility）从下面几个特性中抽取信息：

①包

②公有类与接口

③公有的和受保护的构造器及方法

④公有的和受保护的域

应该为上面的几个部分编写注释。注释应该放置在所描述的特性前面。注释以/**开始，以*/结束。

（二）类注释

类注释必须放在import语句之后，类定义之前。

（三）方法注释

每一个方法注释需要放在所描述的方法之前，除了通用的标记之外还可以使用以下几个标记：

@param  //变量描述：对当前方法的param进行描述
@return  //返回描述：对当前方法的返回部分进行描述
@throws //类描述：表示这个方法可能抛出异常

（四）通用注释

@author  //作者
@version //版本
@since //始于
@deprecated //这个标记将对类，方法或变量添加一个不再使用的注释
@see //引用，可以增加一个超链接

类设计技巧

①一定要保证数据私有：这是最重要的，绝对不要破坏封装性

②一定要对数据初始化：最好不要依赖于系统默认初始化，具体的初始化方式是提供默认值或者在所有构造器中设置默认值。

③不要在类中使用过多的基本类型：用其他的类代替多个相关的基本类型的使用

④不是所有的域都需要独立的域访问器和域更改器

⑤将职责过多的类进行分解

⑥类名和方法名要能够体现它们的职责

⑦优先使用不可变的类