Raw Types
- raw type *是没有任何类型参数的泛型类或interface的名称。例如,给定通用的
Box
类:
public class Box<T> {
public void set(T t) { /* ... */ }
// ...
}
要创建参数化类型Box\<T\>
,请为形式类型参数T
提供一个实际类型参数:
Box<Integer> intBox = new Box<>();
如果省略实际类型参数,则创建原始类型Box\<T\>
:
Box rawBox = new Box();
因此,Box
是泛型Box\<T\>
的原始类型。但是,非泛型类或interface类型不是原始类型。
原始类型显示在旧版代码中,因为在 JDK 5.0 之前,许多 API 类(例如Collections
类)不是通用的。使用原始类型时,您实际上会获得泛型行为-Box
给您Object
。为了向后兼容,允许将参数化类型分配给其原始类型:
Box<String> stringBox = new Box<>();
Box rawBox = stringBox; // OK
但是,如果将原始类型分配给参数化类型,则会收到警告:
Box rawBox = new Box(); // rawBox is a raw type of Box<T>
Box<Integer> intBox = rawBox; // warning: unchecked conversion
如果您使用原始类型来调用在相应的泛型类型中定义的泛型方法,也会收到警告:
Box<String> stringBox = new Box<>();
Box rawBox = stringBox;
rawBox.set(8); // warning: unchecked invocation to set(T)
该警告表明原始类型会绕过泛型检查,从而将不安全代码的catch推迟到运行时。因此,应避免使用原始类型。
Type Erasure部分提供了有关 Java 编译器如何使用原始类型的更多信息。
未检查的错误消息
如前所述,将旧代码与通用代码混合时,您可能会遇到类似于以下内容的警告消息:
Note: Example.java uses unchecked or unsafe operations.
Note: Recompile with -Xlint:unchecked for details.
当使用对原始类型进行操作的较旧的 API 时,可能会发生这种情况,如以下示例所示:
public class WarningDemo {
public static void main(String[] args){
Box<Integer> bi;
bi = createBox();
}
static Box createBox(){
return new Box();
}
}
术语“未检查”是指编译器没有足够的类型信息来执行确保类型安全所需的所有类型检查。尽管编译器会给出提示,但默认情况下“ unchecked”警告是禁用的。要查看所有“未经检查”的警告,请使用\-Xlint:unchecked
重新编译。
使用\-Xlint:unchecked
重新编译前面的示例将揭示以下附加信息:
WarningDemo.java:4: warning: [unchecked] unchecked conversion
found : Box
required: Box<java.lang.Integer>
bi = createBox();
^
1 warning
要完全禁用未经检查的警告,请使用\-Xlint:\-unchecked
标志。 @SuppressWarnings\("unchecked"\)
注解 禁止未检查的警告。如果您不熟悉@SuppressWarnings
语法,请参见Annotations。