Java学习回忆录-基础语法-泛型

Java学习回忆录-基础语法-泛型

泛型

Java泛型（generics）是JDK 5中引入的一个新特性,泛型提供了编译时类型安全检测机制，该机制允许程序员在编译时检测到非法的类型。

泛型方法

​ 泛型方法在调用时可以接收不同类型的参数。根据传递给泛型方法的参数类型，编译器适当地处理每一个方法调用。

定义泛型方法的规则：

- 所有泛型方法声明都有一个类型参数声明部分（由尖括号分隔），该类型参数声明部分在方法返回类型之前（在下面例子中的<E>）。
- 每一个类型参数声明部分包含一个或多个类型参数，参数间用逗号隔开。一个泛型参数，也被称为一个类型变量，是用于指定一个泛型类型名称的标识符。
- 类型参数能被用来声明返回值类型，并且能作为泛型方法得到的实际参数类型的占位符。
- 泛型方法方法体的声明和其他方法一样。注意类型参数只能代表引用型类型，不能是原始类型（像int,double,char的等）

举例：使用泛型来定义数组，并打印不同类型的数组中的数据。

package Practices.Basic;
// 泛型练习
public class GenericDemo {
	// 定义一个方法，用来输出数组的数据，E表示泛型
    public static <E> void printArray(E[] inputArray) {
        for(E element:inputArray){		// 增强for遍历输出数组里面的元素
            System.out.print(element + "  ");
        }
        System.out.println();
    }

    public static void main(String[] args) {
        // 定义几个对象类的数组来测试
        Integer[] intArray = {1,2,3,4,5};
        Double[] doubleArray = {1.1,2.2,3.3,4.4,5.5};
        Character[] charArray = {'a','b','c','d','e'};

        // 调用方法来进行测试
        printArray(intArray);
        printArray(doubleArray);
        printArray(charArray);
    }
}

**踩坑之一： 原本以为可以使用java自动拆装箱的特性来实现定义int类型的数组，但是没想到不行。 **

定义有界泛型：

要声明一个有界的类型参数，首先列出类型参数的名称，后跟extends关键字，最后紧跟它的上界。

语法： <T extends Comparable<T> > T maximum(T x, T y, T z)

泛型类

泛型类的声明和非泛型类的声明类似，除了在类名后面添加了类型参数声明部分。

和泛型方法一样，泛型类的类型参数声明部分也包含一个或多个类型参数，参数间用逗号隔开。一个泛型参数，也被称为一个类型变量，是用于指定一个泛型类型名称的标识符。因为他们接受一个或多个参数，这些类被称为参数化的类或参数化的类型。

package Practices.Basic;

// 定义一个泛型类
public class GenericClassDemo<T> {
    private T date;    // 这里的T是泛型类定义时指定的类型
	// 简单测试，所以这里定义了一个get和set方法来测试
    public T getDate() {
        return date;
    }

    public void setDate(T date) {
        this.date = date;
    }

    // 为了测试方便，没有定义另外一个类来实现调用，所以直接在这里定义了
    public static void main(String[] args) {
        // 创建不同类型的泛型类
        GenericClassDemo<Integer> class1 = new GenericClassDemo<Integer>();
        GenericClassDemo<String> class2 = new GenericClassDemo<String>();

        // 调用方法
        class1.setDate(new Integer(88));
        class2.setDate(new String("test"));
		// 测试数据的正确性
        System.out.println(class1.getDate());
        System.out.println(class2.getDate());
    }
}

文档注释

​ 说明注释允许你在程序中嵌入关于程序的信息。你可以使用javadoc工具软件来生成信息，并输出到HTML文件中。

标签	描述	示例
@author	标识一个类的作者	@author description
@deprecated	指名一个过期的类或成员	@deprecated description
{@docRoot}	指明当前文档根目录的路径	Directory Path
@exception	标志一个类抛出的异常	@exception exception-name explanation
{@inheritDoc}	从直接父类继承的注释	Inherits a comment from the immediate surperclass.
{@link}	插入一个到另一个主题的链接	{@link name text}
{@linkplain}	插入一个到另一个主题的链接，但是该链接显示纯文本字体	Inserts an in-line link to another topic.
@param	说明一个方法的参数	@param parameter-name explanation
@return	说明返回值类型	@return explanation
@see	指定一个到另一个主题的链接	@see anchor
@serial	说明一个序列化属性	@serial description
@serialData	说明通过writeObject( ) 和 writeExternal( )方法写的数据	@serialData description
@serialField	说明一个ObjectStreamField组件	@serialField name type description
@since	标记当引入一个特定的变化时	@since release
@throws	和 @exception标签一样.	The @throws tag has the same meaning as the @exception tag.
{@value}	显示常量的值，该常量必须是static属性。	Displays the value of a constant, which must be a static field.
@version	指定类的版本	@version info