如何将@SuppressWarning("unchecked")作用于特定代码行而非方法级？

前置说明 #

首先纠正一个容易踩的拼写坑：正确的告警抑制注解是@SuppressWarnings（注意是复数形式的Warnings，少写s的写法注解完全不会生效）。
Java语法本身支持该注解在局部代码级别的作用，但绝大多数人都会踩同一个坑：如果直接把注解加在普通赋值语句前方，注解的作用域会自动扩散到整个所属代码块，和直接在方法上加注解的效果没有区别，根本达不到仅抑制单行告警的目的。

正确实现方式 #

将触发告警的两处强制类型转换单独抽取为局部变量声明，把@SuppressWarnings("unchecked")注解加在对应局部变量的声明前方。此时注解的作用范围会严格绑定到这行强转代码，不会影响方法内其他代码的告警检测，后续如果新增的代码出现未检查类型转换问题，编译器仍然会正常触发提示。

调整后的可运行代码如下：

public static <T> T marshal(Class<T> cls, String xml) throws JAXBException {
    T res;
    if (cls == xml.getClass()) {
        // 注解仅作用于下一行的强制类型转换
        @SuppressWarnings("unchecked")
        T tempRes = (T) xml;
        res = tempRes;
    } else {
        JAXBContext ctx = JAXBContext.newInstance(cls);
        Unmarshaller unmarshaller = ctx.createUnmarshaller();
        // 注解仅作用于下一行的强制类型转换
        @SuppressWarnings("unchecked")
        T tempRes = (T) unmarshaller.unmarshal(new StringReader(xml));
        res = tempRes;
    }
    return res;
}

补充修正原代码的几处编译错误：

• 原代码中JAXBContext对象定义的变量名是ct，后续调用时误用ctx，存在变量名不匹配问题
• 原代码中Unmarshaller类名、createUnmarshaller方法名存在拼写错误
• 已补充方法上声明抛出JAXBException，匹配JAXB API的受检异常要求

避坑提醒 #

以下写法无法实现单行精准抑制，会导致注解作用域覆盖整个代码块，不要使用：

if (cls == xml.getClass()) {
    @SuppressWarnings("unchecked")
    res = (T) xml; // 该注解实际作用于整个if块，和方法级注解效果一致
}

内容的提问来源于stack exchange，提问作者Rahul Negi