Java集合框架中的“未检查”警告及泛型化实践指南-java教程-PHP中文网

Java集合框架中的“未检查”警告及泛型化实践指南

本文旨在解决java开发中常见的“recompile with -xlint:unchecked”警告，深入探讨其产生原因——主要源于使用原始类型（raw types）的集合，如`vector`。我们将通过重构代码，采用现代java泛型（generics）和`arraylist`等类型安全的集合，演示如何消除这些警告，提升代码的可读性、健壮性及类型安全性，并纠正常见的逻辑错误。

理解“未检查”警告及其根源

在Java编程中，当编译器提示“recompile with -Xlint:unchecked for details.”时，这通常意味着你的代码使用了未经类型检查的操作，特别是与Java集合框架相关的操作。这种警告的出现，是因为你在使用泛型集合时没有指定类型参数，或者使用了像java.util.Vector这样的老旧且默认不带泛型的集合类，导致编译器无法在编译时进行严格的类型检查，从而可能在运行时引发ClassCastException。

原始类型（Raw Types）是指在泛型类或接口中使用时，不带类型参数的名称。例如，Vector而不是Vector<Sroom>。当使用原始类型时，集合可以存储任何类型的对象，但在取出元素时，你需要手动进行强制类型转换，这正是“未检查”警告的根源。

现代化集合实践：拥抱泛型与ArrayList

为了解决上述问题并提升代码质量，我们应遵循以下最佳实践：

使用泛型（Generics）：泛型是Java 5引入的重要特性，它允许你在定义类、接口和方法时使用类型参数，从而在编译时强制执行类型检查。这不仅消除了运行时类型转换的风险，也提高了代码的可读性。
优先使用ArrayList而非Vector：Vector是Java早期提供的动态数组实现，其所有方法都是同步的（synchronized）。在单线程或大多数多线程场景下，这种同步机制会带来不必要的性能开销。ArrayList是非同步的，通常在性能上优于Vector，并且是更推荐的列表实现。如果需要线程安全，应考虑使用Collections.synchronizedList(new ArrayList<T>())或java.util.concurrent包下的并发集合。
声明时使用接口类型：在声明集合变量时，推荐使用接口类型（如List、Set、Map），而不是具体的实现类（如ArrayList、HashSet、HashMap）。这提供了更大的灵活性，允许在不修改客户端代码的情况下更换底层实现。

代码重构与优化

接下来，我们将针对提供的代码进行重构，以消除警告并优化逻辑。

立即学习“Java免费学习笔记（深入）”；

1. Dental 类重构

原代码中Dental类使用了原始类型Vector，并且在Details方法中存在逻辑缺陷。

原代码片段：

集简云

软件集成平台，快速建立企业自动化与智能化

查看详情

import java.util.Vector;

public class Dental{
    public Vector Sroomlist; // 原始类型 Vector
    // ...
    public Dental(String name, String address, int contact){
        // ...
        Sroomlist = new Vector(); // 初始化原始类型 Vector
    }
    public void addsrooms(Sroom room){
        Sroomlist.addElement(room); // 使用 addElement
    }
    public void Details(){
        // ...
        int n = 0;
        while (n<Sroomlist.size()){
            Sroom room = (Sroom) // 需要强制类型转换，且循环体未调用 SRoomDetails
            Sroomlist.elementAt(n);
            n +=1;
        }
    }
}

登录后复制

重构后的 Dental 类：

import java.util.ArrayList;
import java.util.List; // 导入 List 接口

public class Dental {
    public List<Sroom> sRoomList; // 使用 List 接口和泛型 <Sroom>
    public String name;
    public String address;
    public int contact;

    public Dental(String name, String address, int contact) {
        this.name = name;
        this.address = address;
        this.contact = contact;
        this.sRoomList = new ArrayList<>(); // 初始化为 ArrayList，并使用钻石操作符 (<>)
    }

    public void addsrooms(Sroom room) {
        sRoomList.add(room); // 使用 List 接口的 add 方法
    }

    public void Details() {
        System.out.println("DENTAL SURGERY DETAILS");
        System.out.println("____________________");
        System.out.println("Name: " + name);
        System.out.println("Address: " + address);
        System.out.println("______________");
        System.out.println("Contact: " + contact);
        System.out.println("SURGERY ROOM DETAILS");

        // 遍历并显示每个手术室的详细信息
        if (sRoomList.isEmpty()) {
            System.out.println("No surgery rooms added yet.");
        } else {
            for (Sroom room : sRoomList) { // 使用增强for循环遍历，无需手动类型转换
                room.SRoomDetails(); // 调用 Sroom 的详细信息方法
            }
        }
    }
}

登录后复制

重构要点：

将Vector Sroomlist;改为List<Sroom> sRoomList;，使用List接口和泛型，并统一变量命名风格（小驼峰）。
构造器中，将Sroomlist = new Vector();改为this.sRoomList = new ArrayList<>();。
addsrooms方法中，将Sroomlist.addElement(room);改为sRoomList.add(room);。
Details方法中，修复了原代码中循环体为空的逻辑错误，并使用增强for循环（foreach loop）来遍历sRoomList，这不仅更简洁，也避免了手动索引和类型转换。同时，添加了当列表为空时的提示。

2. Sroom 类重构

原代码中SRoomDetails方法只打印了标签，未打印实际值。

原代码片段：

public class Sroom {
    public int r_id;
    public String type;

    public Sroom(int r_id, String type){
        this.r_id = r_id;
        this.type = type;
    }
    public void SRoomDetails(){
        System.out.println("Room ID: "); // 未打印 r_id
        System.out.println("Room Type: "); // 未打印 type
    }
}

登录后复制

重构后的 Sroom 类：

public class Sroom {
    public int r_id;
    public String type;

    public Sroom(int r_id, String type) {
        this.r_id = r_id;
        this.type = type;
    }

    public void SRoomDetails() {
        System.out.println("  Room ID: " + r_id); // 打印实际值
        System.out.println("  Room Type: " + type); // 打印实际值
    }
}

登录后复制

重构要点：

在SRoomDetails方法中，确保打印出r_id和type的实际值。

3. Composition 类重构

原代码中main方法存在调用Details()的错误，因为Details()是Dental类的一个实例方法，必须通过Dental类的实例来调用。

原代码片段：

public class Composition {
    public void main(String[]args){ // main 方法应为 static
        Dental d = new Dental ("Dental Surgery ", "abc road",11889796);
        Sroom sr1 = new Sroom (1," Surgery Room 01");
        Sroom sr2 = new Sroom (2," Surgery Room 02");
        Sroom sr3 = new Sroom (3," Surgery Room 03");
        Details(); // 错误：直接调用实例方法

        d.addsrooms(sr1);
        d.addsrooms(sr2);
        d.addsrooms(sr3);
        d.Details();
    }
}

登录后复制

重构后的 Composition 类：

public class Composition {
    public static void main(String[] args) { // main 方法必须是 static
        Dental d = new Dental("Dental Surgery ", "abc road", 11889796);
        Sroom sr1 = new Sroom(1, " Surgery Room 01");
        Sroom sr2 = new Sroom(2, " Surgery Room 02");
        Sroom sr3 = new Sroom(3, " Surgery Room 03");

        // 在添加房间之前调用 Details，用于展示初始状态
        System.out.println("--- Before adding rooms ---");
        d.Details(); // 正确：通过 Dental 实例 d 调用 Details 方法

        d.addsrooms(sr1);
        d.addsrooms(sr2);
        d.addsrooms(sr3);

        // 在添加房间之后再次调用 Details，用于展示更新后的状态
        System.out.println("\n--- After adding rooms ---");
        d.Details();
    }
}

登录后复制

重构要点：

main方法必须是static的，才能作为程序的入口点。
将Details();改为d.Details();，通过Dental类的实例来调用其方法。
为了更好地演示效果，在添加房间前后都调用d.Details()。

完整重构后的代码示例

import java.util.ArrayList;
import java.util.List;

// Dental 类：管理牙科诊所及其手术室
public class Dental {
    public List<Sroom> sRoomList; // 使用 List 接口和泛型 <Sroom>
    public String name;
    public String address;
    public int contact;

    public Dental(String name, String address, int contact) {
        this.name = name;
        this.address = address;
        this.contact = contact;
        this.sRoomList = new ArrayList<>(); // 初始化为 ArrayList
    }

    public void addsrooms(Sroom room) {
        sRoomList.add(room); // 使用 List 接口的 add 方法
    }

    public void Details() {
        System.out.println("DENTAL SURGERY DETAILS");
        System.out.println("____________________");
        System.out.println("Name: " + name);
        System.out.println("Address: " + address);
        System.out.println("______________");
        System.out.println("Contact: " + contact);
        System.out.println("SURGERY ROOM DETAILS");

        if (sRoomList.isEmpty()) {
            System.out.println("  No surgery rooms added yet.");
        } else {
            for (Sroom room : sRoomList) { // 使用增强for循环遍历
                room.SRoomDetails(); // 调用 Sroom 的详细信息方法
            }
        }
    }
}

// Sroom 类：表示手术室
class Sroom { // 移除 public 关键字，使其成为包私有，或者将所有类放在单独文件中
    public int r_id;
    public String type;

    public Sroom(int r_id, String type) {
        this.r_id = r_id;
        this.type = type;
    }

    public void SRoomDetails() {
        System.out.println("  Room ID: " + r_id);
        System.out.println("  Room Type: " + type);
    }
}

// Composition 类：主程序入口
class Composition { // 移除 public 关键字，使其成为包私有，或者将所有类放在单独文件中
    public static void main(String[] args) {
        Dental d = new Dental("Dental Surgery ", "abc road", 11889796);
        Sroom sr1 = new Sroom(1, " Surgery Room 01");
        Sroom sr2 = new Sroom(2, " Surgery Room 02");
        Sroom sr3 = new Sroom(3, " Surgery Room 03");

        System.out.println("--- Initial State ---");
        d.Details(); // 在添加房间之前显示诊所详情

        d.addsrooms(sr1);
        d.addsrooms(sr2);
        d.addsrooms(sr3);

        System.out.println("\n--- State After Adding Rooms ---");
        d.Details(); // 在添加房间之后显示诊所详情
    }
}

登录后复制

重要提示： 在一个.java文件中通常只能有一个public类，且该类的名称必须与文件名相同。如果希望所有类都为public，则需要将它们分别放在各自的文件中（例如Dental.java, Sroom.java, Composition.java）。在上述示例中，为了方便展示，Sroom和Composition类被修改为包私有（移除了public关键字），这样它们可以与public class Dental一起放在Dental.java文件中。如果需要从其他包访问它们，则必须将它们声明为public并放置在单独的文件中。