ה ' @SuppressWarnings ' הערה מציעה למפתחים את ההזדמנות לדכא את האזהרות ללא צורך בשינוי הקוד ומונעת שינויים מיותרים. זה מאפשר אינטגרציה חלקה יותר מבלי להשפיע על הפונקציונליות או המבנה של הקוד הישן. על ידי השימוש בו, המתכנתים יכולים להתמקד בתהליך ה-refactoring מבלי להיות מוצפים באזהרות שניתן לטפל בהן מאוחר יותר.
מאמר זה מדגים את השימוש בביאור @SuppressWarnings.
כיצד להשתמש בהערת @SuppressWarnings ב-Java?
ה ' @SuppressWarnings ' ההערה מדכאת אזהרות הקשורות לשימוש בממשקי API שצוינו תוך הכרה בסיכונים שלהם. הוא משמש בעיקר כדי לדכא אזהרות הקשורות ל' לא מסומן', 'מבוטל', 'לא בשימוש', 'סוגי גלם' או 'סדרתי '. בנוסף, זה עוזר לשפר את הקוד על ידי ציון מפורש שהמפתח מודע לאזהרות מסוימות ובוחר בכוונה לדכא אותן.
תחביר
התחביר עבור ' @SuppressWarnings ' ההערה מצוינת כך:
@SuppressWarnings ( 'רַעַשׁ' )
ה ' רַעַשׁ ” מוחלף בשם האזהרה הנדרש שיש לדכא.
הבה נבקר בכמה דוגמאות להסבר מפורט:
דוגמה 1: דחק אזהרה לא מסומנת
ה ' לא בדוק האזהרה תודחק על ידי שימוש ב- @SuppressWarnings ' ביאור בגוש הקוד שלהלן:
יְבוּא java.util.ArrayList ;
יְבוּא java.util.List ;
פּוּמְבֵּי מעמד ביאור {
@SuppressWarnings ( 'לא בדוק' )
פּוּמְבֵּי סטָטִי בָּטֵל רָאשִׁי ( חוּט [ ] arg )
{
//הצהרת רשימת מערך
רשימה מדינות = חָדָשׁ רשימת מערך ( ) ;
// אזהרה לא מסומנת הועלתה
מדינות. לְהוֹסִיף ( 'אוֹסְטְרֵיָה' ) ;
מערכת . הַחוּצָה . println ( מדינות ) ;
}
}
בקטע הקוד שלמעלה:
- ראשית, ייבא את כלי השירות הדרושים לקובץ Java וצור מחלקה בשם ' ביאור '.
- לאחר מכן, השתמש ב' @SuppressWarnings ' הערה והעבירו את שם האזהרה ' לא בדוק ' אליו.
- כעת, הכריז על רשימת מערכים פשוטה בשם ' מדינות ” והכנס בו אלמנט דמה.
- זה גורם ל' לא בדוק אזהרת ' המטופלת או מדוכאת על ידי ' @SuppressWarnings ' ביאור.
לאחר הקומפילציה:
הפלט מראה את התרחשות של אזהרה והיא מדוכאת על ידי המהדר כדי להציג את הפלט הנדרש.
דוגמה 2: דיכוי של אזהרות שאינן בשימוש או ביטול משימוש
כדי לדכא אזהרות שאינן בשימוש והן אזהרות שהוצאו משימוש, הבה נפעל לפי הקוד הבא:
יְבוּא java.util.ArrayList ;יְבוּא java.util.List ;
@SuppressWarnings ( { 'לא בשימוש' , 'בִּזוּי' } )
פּוּמְבֵּי מעמד ביאור {
פְּרָטִי int unUseVar ;
@ הוצא משימוש
פּוּמְבֵּי בָּטֵל פג ( ) {
// יישום שיטה שהוצא משימוש
מערכת . הַחוּצָה . println ( 'זה הוצא משימוש.' ) ;
}
פּוּמְבֵּי סטָטִי בָּטֵל רָאשִׁי ( חוּט [ ] args ) {
//יצירת אובייקט עבור מחלקה
DemoTest של הערות = חָדָשׁ ביאור ( ) ;
demoTest. פג ( ) ;
}
}
בקוד למעלה:
- קודם ה ' @SuppressWarnings ' ההערה משמשת כדי לדכא שגיאות אזהרה שאינן בשימוש וקשורות לביטול.
- לאחר מכן, הכריז על מחלקה בשם ' ביאור ' ולהכריז על משתנה בשם ' unUseVar ' בתוך זה.
- לאחר מכן, השתמש ב' @ הוצא משימוש ' ביאור כדי לבטל את ' deprec() שיטה המכילה הודעת דמה.
- לאחר מכן, הכריז על חפץ ' demoTest ' עבור המחלקה 'ביאור' והשתמש באובייקט זה כדי לקרוא את ' deprec() שיטת 'ב' רָאשִׁי() ' שיטה.
לאחר ההידור, הפלט מופיע להלן:
תמונת המצב שלמעלה מדגישה את המשתנים שאינם בשימוש, כלי השירות והשיטות שהוצאו משימוש שצריכים להעלות אזהרות. אבל אזהרות אלה נדחקות עקב ניצול ' @SuppressWarnings ' ביאור.
סיכום
בג'אווה, ה' @SuppressWarnings ' ההערה מורה למהדר לדכא אזהרות ספציפיות במהלך תהליך ההידור. הוא מציע למפתחים את ההזדמנות להתעלם באופן סלקטיבי מאזהרות מסוימות על בסיס של רכיב, כגון מחלקות, שיטות או משתנים. יש להשתמש בביאור @SuppressWarnings בתבונה ובזהירות מכיוון ששימוש לא נכון בו עלול להוביל להתרחשות רבה יותר של שגיאות בקוד.