“ @SuppressWarnings ” คำอธิบายประกอบช่วยให้นักพัฒนามีโอกาสระงับคำเตือนโดยไม่จำเป็นต้องแก้ไขโค้ดและหลีกเลี่ยงการเปลี่ยนแปลงที่ไม่จำเป็น ช่วยให้การรวมราบรื่นขึ้นโดยไม่กระทบต่อการทำงานหรือโครงสร้างของรหัสเดิม โปรแกรมเมอร์สามารถมุ่งเน้นไปที่กระบวนการปรับโครงสร้างใหม่โดยไม่ถูกครอบงำด้วยคำเตือนที่สามารถแก้ไขได้ในภายหลัง
บทความนี้สาธิตการใช้งานคำอธิบายประกอบ @SuppressWarnings
วิธีการใช้คำอธิบายประกอบ @SuppressWarnings ใน Java
“ @SuppressWarnings ” คำอธิบายประกอบจะระงับคำเตือนที่เกี่ยวข้องกับการใช้ API ที่ระบุในขณะที่ยอมรับความเสี่ยง ส่วนใหญ่จะใช้เพื่อระงับคำเตือนที่เกี่ยวข้องกับ “ ไม่ถูกตรวจสอบ”, ”เลิกใช้”, “ไม่ได้ใช้”, “ชนิดดิบ” หรือ “อนุกรม '. นอกจากนี้ยังช่วยปรับปรุงโค้ดโดยระบุอย่างชัดเจนว่านักพัฒนาทราบคำเตือนบางอย่างและจงใจเลือกที่จะระงับ
ไวยากรณ์
ไวยากรณ์สำหรับ ' @SuppressWarnings ” คำอธิบายประกอบระบุเป็น:
@SuppressWarnings ( 'เสียงรบกวน' )
“ เสียงรบกวน ” ถูกแทนที่ด้วยชื่อคำเตือนที่จำเป็นซึ่งจำเป็นต้องระงับ
ให้เราไปดูตัวอย่างสำหรับคำอธิบายโดยละเอียด:
ตัวอย่างที่ 1: ระงับการเตือนที่ไม่ได้ตรวจสอบ
“ ไม่ได้ตรวจสอบ ” คำเตือนจะถูกระงับโดยใช้ “ @SuppressWarnings ” คำอธิบายประกอบในบล็อกรหัสด้านล่าง:
นำเข้า java.util.ArrayList ;
นำเข้า java.util.List ;
สาธารณะ ระดับ คำอธิบายประกอบ {
@SuppressWarnings ( 'ไม่ได้ตรวจสอบ' )
สาธารณะ คงที่ เป็นโมฆะ หลัก ( สตริง [ ] หาเรื่อง )
{
// ประกาศรายชื่ออาร์เรย์
รายการ ประเทศ = ใหม่ รายการอาร์เรย์ ( ) ;
// ยกคำเตือนที่ไม่ได้เลือก
ประเทศ. เพิ่ม ( 'ออสเตรีย' ) ;
ระบบ . ออก . พิมพ์ ( ประเทศ ) ;
}
}
ในข้อมูลโค้ดด้านบน:
- ขั้นแรก ให้นำเข้ายูทิลิตี้ที่จำเป็นในไฟล์ Java และสร้างคลาสชื่อ “ คำอธิบายประกอบ '.
- จากนั้นใช้ปุ่ม “ @SuppressWarnings ” คำอธิบายประกอบและส่งชื่อคำเตือน “ ไม่ได้ตรวจสอบ 'ถึงมัน
- ตอนนี้ ประกาศรายการ Array อย่างง่ายชื่อ “ ประเทศ ” และใส่องค์ประกอบจำลองเข้าไป
- สิ่งนี้ทำให้เกิด “ ไม่ได้ตรวจสอบ ” คำเตือนซึ่งจัดการหรือระงับโดย “ @SuppressWarnings ” คำอธิบายประกอบ
หลังจากรวบรวม:
เอาต์พุตแสดงการเกิดขึ้นของคำเตือนและคอมไพเลอร์ถูกระงับเพื่อแสดงเอาต์พุตที่ต้องการ
ตัวอย่างที่ 2: ระงับคำเตือนที่ไม่ได้ใช้และเลิกใช้งาน
หากต้องการระงับทั้งคำเตือนที่ไม่ได้ใช้และเลิกใช้ ให้เราทำตามโค้ดด้านล่าง:
นำเข้า java.util.ArrayList ;นำเข้า java.util.List ;
@SuppressWarnings ( { 'ไม่ได้ใช้' , 'เลิกใช้' } )
สาธารณะ ระดับ คำอธิบายประกอบ {
ส่วนตัว นานาชาติ unUseVar ;
@เลิกใช้แล้ว
สาธารณะ เป็นโมฆะ เสื่อม ( ) {
// เลิกใช้เมธอด
ระบบ . ออก . พิมพ์ ( 'เลิกใช้แล้ว' ) ;
}
สาธารณะ คงที่ เป็นโมฆะ หลัก ( สตริง [ ] หาเรื่อง ) {
// สร้างวัตถุสำหรับคลาส
การทดสอบคำอธิบายประกอบ = ใหม่ คำอธิบายประกอบ ( ) ;
ทดสอบการสาธิต เสื่อม ( ) ;
}
}
ในรหัสด้านบน:
- ประการแรก “ @SuppressWarnings ” ใช้คำอธิบายประกอบเพื่อระงับข้อผิดพลาดคำเตือนที่ไม่ได้ใช้และเลิกใช้งาน
- ถัดไป ประกาศคลาสชื่อ “ คำอธิบายประกอบ ” และประกาศตัวแปรชื่อ “ unUseVar “ข้างในนั้น.
- จากนั้นใช้ปุ่ม “ @เลิกใช้แล้ว ” คำอธิบายประกอบที่จะเลิกใช้ “ เสื่อม () ” วิธีการที่มีข้อความจำลอง
- หลังจากนั้นประกาศวัตถุ “ ทดสอบการสาธิต ” สำหรับคลาส “คำอธิบายประกอบ” และใช้วัตถุนี้เพื่อเรียก “ เสื่อม () ” วิธีการใน “ หลัก() ' วิธี.
หลังจากคอมไพล์แล้ว ผลลัพธ์จะแสดงด้านล่าง:
สแน็ปช็อตด้านบนเน้นย้ำถึงตัวแปรที่ไม่ได้ใช้งาน ยูทิลิตี้ และเมธอดที่เลิกใช้แล้วซึ่งควรเพิ่มคำเตือน แต่คำเตือนเหล่านี้ถูกระงับเนื่องจากการใช้ ' @SuppressWarnings ” คำอธิบายประกอบ
บทสรุป
ใน Java, the “ @SuppressWarnings ” คำอธิบายประกอบสั่งให้คอมไพเลอร์ระงับคำเตือนเฉพาะในระหว่างกระบวนการคอมไพล์ ซึ่งช่วยให้นักพัฒนามีโอกาสเลือกที่จะเพิกเฉยต่อคำเตือนบางอย่างในแต่ละองค์ประกอบ เช่น คลาส เมธอด หรือตัวแปร ควรใช้คำอธิบายประกอบ @SuppressWarnings อย่างรอบคอบและด้วยความระมัดระวัง เนื่องจากการใช้งานที่ไม่เหมาะสมอาจนำไปสู่การเกิดข้อผิดพลาดในโค้ดมากขึ้น