Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(85)

Side by Side Diff: doc/ja/manual/annotations.html

Issue 594833004: Roll FindBugs from 2.0.3 to 3.0.0 (Closed) Base URL: https://chromium.googlesource.com/chromium/deps/findbugs.git@master
Patch Set: Created 6 years, 3 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View unified diff | Download patch
« no previous file with comments | « doc/ja/manual/acknowledgments.html ('k') | doc/ja/manual/anttask.html » ('j') | no next file with comments »
Toggle Intra-line Diffs ('i') | Expand Comments ('e') | Collapse Comments ('c') | Show Comments Hide Comments ('s')
OLDNEW
1 <html><head> 1 <html><head>
2 <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> 2 <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
3 <title>&#31532;10&#31456; &#12450;&#12494;&#12486;&#12540;&#12471;&#12519;&#1 2531;</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><l ink rel="home" href="index.html" title="FindBugs&#8482; &#12510;&#12491;&#12517; &#12450;&#12523;"><link rel="up" href="index.html" title="FindBugs&#8482; &#1251 0;&#12491;&#12517;&#12450;&#12523;"><link rel="prev" href="analysisprops.html" t itle="&#31532;9&#31456; &#20998;&#26512;&#12503;&#12525;&#12497;&#12486;&#12451; &#12540;"><link rel="next" href="rejarForAnalysis.html" title="&#31532;11&#31456 ; rejarForAnalysis &#12398;&#20351;&#29992;&#26041;&#27861;"></head><body bgcolo r="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class ="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">&#31532;10&#31456; &#12450;&#12494;&#12486;&#12540;&#12471;&#125 19;&#12531;</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ana lysisprops.html">&#25147;&#12427;</a>&nbsp;</td><th width="60%" align="center">& nbsp;</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="rejarForAna lysis.html">&#27425;&#12408;</a></td></tr></table><hr></div><div class="chapter" title="&#31532;10&#31456; &#12450;&#12494;&#12486;&#12540;&#12471;&#12519;&#125 31;"><div class="titlepage"><div><div><h2 class="title"><a name="annotations"></ a>&#31532;10&#31456; &#12450;&#12494;&#12486;&#12540;&#12471;&#12519;&#12531;</h 2></div></div></div><p><span class="application">FindBugs</span> &#12399;&#12356 ;&#12367;&#12388;&#12363;&#12398;&#12450;&#12494;&#12486;&#12540;&#12471;&#12519 ;&#12531;&#12434;&#12469;&#12509;&#12540;&#12488;&#12375;&#12390;&#12356;&#12414 ;&#12377;&#12290;&#38283;&#30330;&#32773;&#12398;&#24847;&#22259;&#12434;&#26126 ;&#30906;&#12395;&#12377;&#12427;&#12371;&#12392;&#12391;&#12289; FindBugs &#123 99;&#12424;&#12426;&#30340;&#30906;&#12395;&#35686;&#21578;&#12434;&#30330;&#348 92;&#12377;&#12427;&#12371;&#12392;&#12364;&#12391;&#12365;&#12414;&#12377;&#122 90;&#12450;&#12494;&#12486;&#12540;&#12471;&#12519;&#12531;&#12434;&#20351;&#299 92;&#12377;&#12427;&#12383;&#12417;&#12395;&#12399; Java 5 &#12364;&#24517;&#352 01;&#12391;&#12354;&#12426;&#12289; annotations.jar &#12362;&#12424;&#12403; jsr 305.jar &#12501;&#12449;&#12452;&#12523;&#12434;&#12467;&#12531;&#12497;&#12452; &#12523;&#26178;&#12398;&#12463;&#12521;&#12473;&#12497;&#12473;&#12395;&#21547; &#12417;&#12427;&#24517;&#35201;&#12364;&#12354;&#12426;&#12414;&#12377;&#12290; </p><div class="variablelist"><dl><dt><span class="term"><span class="command">< strong>edu.umd.cs.findbugs.annotations.CheckForNull</strong></span></span></dt>< dd><span class="command"><strong>[Target]</strong></span> Field, Method, Paramet er 3 <title>&#31532;10&#31456; &#12450;&#12494;&#12486;&#12540;&#12471;&#12519;&#1 2531;</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><l ink rel="home" href="index.html" title="FindBugs&#8482; &#12510;&#12491;&#12517; &#12450;&#12523;"><link rel="up" href="index.html" title="FindBugs&#8482; &#1251 0;&#12491;&#12517;&#12450;&#12523;"><link rel="prev" href="analysisprops.html" t itle="&#31532;9&#31456; &#20998;&#26512;&#12503;&#12525;&#12497;&#12486;&#12451; &#12540;"><link rel="next" href="rejarForAnalysis.html" title="&#31532;11&#31456 ; rejarForAnalysis &#12398;&#20351;&#29992;&#26041;&#27861;"></head><body bgcolo r="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class ="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">&#31532;10&#31456; &#12450;&#12494;&#12486;&#12540;&#12471;&#125 19;&#12531;</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ana lysisprops.html">&#25147;&#12427;</a>&nbsp;</td><th width="60%" align="center">& nbsp;</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="rejarForAna lysis.html">&#27425;&#12408;</a></td></tr></table><hr></div><div class="chapter" title="&#31532;10&#31456; &#12450;&#12494;&#12486;&#12540;&#12471;&#12519;&#125 31;"><div class="titlepage"><div><div><h2 class="title"><a name="annotations"></ a>&#31532;10&#31456; &#12450;&#12494;&#12486;&#12540;&#12471;&#12519;&#12531;</h 2></div></div></div><p><span class="application">FindBugs</span> &#12399;&#12356 ;&#12367;&#12388;&#12363;&#12398;&#12450;&#12494;&#12486;&#12540;&#12471;&#12519 ;&#12531;&#12434;&#12469;&#12509;&#12540;&#12488;&#12375;&#12390;&#12356;&#12414 ;&#12377;&#12290;&#38283;&#30330;&#32773;&#12398;&#24847;&#22259;&#12434;&#26126 ;&#30906;&#12395;&#12377;&#12427;&#12371;&#12392;&#12391;&#12289; FindBugs &#123 99;&#12424;&#12426;&#30340;&#30906;&#12395;&#35686;&#21578;&#12434;&#30330;&#348 92;&#12377;&#12427;&#12371;&#12392;&#12364;&#12391;&#12365;&#12414;&#12377;&#122 90;&#12450;&#12494;&#12486;&#12540;&#12471;&#12519;&#12531;&#12434;&#20351;&#299 92;&#12377;&#12427;&#12383;&#12417;&#12395;&#12399; Java 5 &#12364;&#24517;&#352 01;&#12391;&#12354;&#12426;&#12289; annotations.jar &#12362;&#12424;&#12403; jsr 305.jar &#12501;&#12449;&#12452;&#12523;&#12434;&#12467;&#12531;&#12497;&#12452; &#12523;&#26178;&#12398;&#12463;&#12521;&#12473;&#12497;&#12473;&#12395;&#21547; &#12417;&#12427;&#24517;&#35201;&#12364;&#12354;&#12426;&#12414;&#12377;&#12290; </p><div class="variablelist"><dl><dt><span class="term"><span class="command">< strong>edu.umd.cs.findbugs.annotations.CheckForNull</strong></span></span></dt>< dd><p>
4 <p>&#12450;&#12494;&#12486;&#12540;&#12471;&#12519;&#12531;&#12434;&#12388;& #12369;&#12383;&#35201;&#32032;&#12399;&#12289; null &#12391;&#12354;&#12427;&#2 1487;&#33021;&#24615;&#12364;&#12354;&#12426;&#12414;&#12377;&#12290;&#12375;&#1 2383;&#12364;&#12387;&#12390;&#12289;&#24403;&#35442;&#35201;&#32032;&#12434;&#2 0351;&#29992;&#12377;&#12427;&#38555;&#12399; null &#12481;&#12455;&#12483;&#124 63;&#12434;&#12377;&#12427;&#12409;&#12365;&#12391;&#12377;&#12290;&#12371;&#123 98;&#12450;&#12494;&#12486;&#12540;&#12471;&#12519;&#12531;&#12434;&#12513;&#124 77;&#12483;&#12489;&#12395;&#36969;&#29992;&#12377;&#12427;&#12392;&#12289;&#125 13;&#12477;&#12483;&#12489;&#12398;&#25147;&#12426;&#20516;&#12395;&#36969;&#299 92;&#12373;&#12428;&#12414;&#12377;&#12290;</p></dd><dt><span class="term"><span class="command"><strong>edu.umd.cs.findbugs.annotations.CheckReturnValue</stron g></span></span></dt><dd><span class="command"><strong>[Target]</strong></span> Method, Constructor 4 <span class="command"><strong>[Target]</strong></span> Field, Method, Pa rameter
5 <div class="variablelist"><dl><dt><span class="term"><span class="command">< strong>[Parameter]</strong></span></span></dt><dd><p> 5 </p><p>&#12450;&#12494;&#12486;&#12540;&#12471;&#12519;&#12531;&#12434;&#123 88;&#12369;&#12383;&#35201;&#32032;&#12399;&#12289; null &#12391;&#12354;&#12427 ;&#21487;&#33021;&#24615;&#12364;&#12354;&#12426;&#12414;&#12377;&#12290;&#12375 ;&#12383;&#12364;&#12387;&#12390;&#12289;&#24403;&#35442;&#35201;&#32032;&#12434 ;&#20351;&#29992;&#12377;&#12427;&#38555;&#12399; null &#12481;&#12455;&#12483;& #12463;&#12434;&#12377;&#12427;&#12409;&#12365;&#12391;&#12377;&#12290;&#12371;& #12398;&#12450;&#12494;&#12486;&#12540;&#12471;&#12519;&#12531;&#12434;&#12513;& #12477;&#12483;&#12489;&#12395;&#36969;&#29992;&#12377;&#12427;&#12392;&#12289;& #12513;&#12477;&#12483;&#12489;&#12398;&#25147;&#12426;&#20516;&#12395;&#36969;& #29992;&#12373;&#12428;&#12414;&#12377;&#12290;</p></dd><dt><span class="term">< span class="command"><strong>edu.umd.cs.findbugs.annotations.CheckReturnValue</s trong></span></span></dt><dd><p>
6 <span class="command"><strong>[Target]</strong></span> Method, Constructor
7 </p><div class="variablelist"><dl><dt><span class="term"><span class="comman d"><strong>[Parameter]</strong></span></span></dt><dd><p>
6 <span class="command"><strong>priority:</strong></span> &#35686;&# 21578;&#12398;&#20778;&#20808;&#24230;&#12434;&#25351;&#23450;&#12375;&#12414;&# 12377; (HIGH, MEDIUM, LOW, IGNORE) &#12290;&#12487;&#12501;&#12457;&#12523;&#124 88;&#20516; :MEDIUM&#12290;</p><p> 8 <span class="command"><strong>priority:</strong></span> &#35686;&# 21578;&#12398;&#20778;&#20808;&#24230;&#12434;&#25351;&#23450;&#12375;&#12414;&# 12377; (HIGH, MEDIUM, LOW, IGNORE) &#12290;&#12487;&#12501;&#12457;&#12523;&#124 88;&#20516; :MEDIUM&#12290;</p><p>
7 <span class="command"><strong>explanation:</strong></span>&#25147; &#12426;&#20516;&#12434;&#12481;&#12455;&#12483;&#12463;&#12375;&#12394;&#12369; &#12400;&#12394;&#12425;&#12394;&#12356;&#29702;&#30001;&#12434;&#12486;&#12461; &#12473;&#12488;&#12391;&#35500;&#26126;&#12375;&#12414;&#12377;&#12290;&#12487; &#12501;&#12457;&#12523;&#12488;&#20516; :""&#12290;</p></dd></dl></div><p>&#123 71;&#12398;&#12450;&#12494;&#12486;&#12540;&#12471;&#12519;&#12531;&#12434;&#203 51;&#29992;&#12375;&#12390;&#12289;&#21628;&#20986;&#12375;&#24460;&#12395;&#251 47;&#12426;&#20516;&#12434;&#12481;&#12455;&#12483;&#12463;&#12377;&#12409;&#123 65;&#12513;&#12477;&#12483;&#12489;&#12434;&#34920;&#12377;&#12371;&#12392;&#123 64;&#12391;&#12365;&#12414;&#12377;&#12290;</p></dd><dt><span class="term"><span class="command"><strong>edu.umd.cs.findbugs.annotations.DefaultAnnotation</stro ng></span></span></dt><dd><span class="command"><strong>[Target]</strong></span> Type, Package 9 <span class="command"><strong>explanation:</strong></span>&#25147; &#12426;&#20516;&#12434;&#12481;&#12455;&#12483;&#12463;&#12375;&#12394;&#12369; &#12400;&#12394;&#12425;&#12394;&#12356;&#29702;&#30001;&#12434;&#12486;&#12461; &#12473;&#12488;&#12391;&#35500;&#26126;&#12375;&#12414;&#12377;&#12290;&#12487; &#12501;&#12457;&#12523;&#12488;&#20516; :""&#12290;</p></dd></dl></div><p>&#123 71;&#12398;&#12450;&#12494;&#12486;&#12540;&#12471;&#12519;&#12531;&#12434;&#203 51;&#29992;&#12375;&#12390;&#12289;&#21628;&#20986;&#12375;&#24460;&#12395;&#251 47;&#12426;&#20516;&#12434;&#12481;&#12455;&#12483;&#12463;&#12377;&#12409;&#123 65;&#12513;&#12477;&#12483;&#12489;&#12434;&#34920;&#12377;&#12371;&#12392;&#123 64;&#12391;&#12365;&#12414;&#12377;&#12290;</p></dd><dt><span class="term"><span class="command"><strong>edu.umd.cs.findbugs.annotations.DefaultAnnotation</stro ng></span></span></dt><dd><p>
8 <div class="variablelist"><dl><dt><span class="term"><span class="command">< strong>[Parameter]</strong></span></span></dt><dd><p> 10 <span class="command"><strong>[Target]</strong></span> Type, Package
11 </p><div class="variablelist"><dl><dt><span class="term"><span class="comman d"><strong>[Parameter]</strong></span></span></dt><dd><p>
9 <span class="command"><strong>value:</strong></span>&#12450;&#1249 4;&#12486;&#12540;&#12471;&#12519;&#12531;&#12463;&#12521;&#12473;&#12398;class& #12458;&#12502;&#12472;&#12455;&#12463;&#12488;&#12290;&#35079;&#25968;&#12398;& #12463;&#12521;&#12473;&#12434;&#25351;&#23450;&#12377;&#12427;&#12371;&#12392;& #12364;&#12391;&#12365;&#12414;&#12377;&#12290;</p><p> 12 <span class="command"><strong>value:</strong></span>&#12450;&#1249 4;&#12486;&#12540;&#12471;&#12519;&#12531;&#12463;&#12521;&#12473;&#12398;class& #12458;&#12502;&#12472;&#12455;&#12463;&#12488;&#12290;&#35079;&#25968;&#12398;& #12463;&#12521;&#12473;&#12434;&#25351;&#23450;&#12377;&#12427;&#12371;&#12392;& #12364;&#12391;&#12365;&#12414;&#12377;&#12290;</p><p>
10 <span class="command"><strong>priority:</strong></span>&#30465;&#3 0053;&#26178;&#12398;&#20778;&#20808;&#24230;&#12434;&#25351;&#23450;&#12375;&#1 2414;&#12377; (HIGH, MEDIUM, LOW, IGNORE) &#12290;&#12487;&#12501;&#12457;&#1252 3;&#12488;&#20516; :MEDIUM&#12290;</p></dd></dl></div><p> 13 <span class="command"><strong>priority:</strong></span>&#30465;&#3 0053;&#26178;&#12398;&#20778;&#20808;&#24230;&#12434;&#25351;&#23450;&#12375;&#1 2414;&#12377; (HIGH, MEDIUM, LOW, IGNORE) &#12290;&#12487;&#12501;&#12457;&#1252 3;&#12488;&#20516; :MEDIUM&#12290;</p></dd></dl></div><p>
11 Indicates that all members of the class or package should be annotated with the default 14 &#12463;&#12521;&#12473;&#12414;&#12383;&#12399;&#12497;&#12483;&#12465;&#12540; &#12472;&#12398;&#12377;&#12409;&#12390;&#12398;&#12513;&#12531;&#12496;&#12540; &#12364;&#25351;&#23450;&#12373;&#12428;&#12383;&#12450;&#12494;&#12486;&#12540; &#12471;&#12519;&#12531;&#12463;&#12521;&#12473;&#12398;&#12487;&#12501;&#12457; &#12523;&#12488;&#20516;&#12391;&#12450;&#12494;&#12486;&#12540;&#12488;&#12373; &#12428;&#12427;&#12371;&#12392;&#12434;&#25351;&#23450;&#12377;&#12427;&#12371; &#12392;&#12364;&#12391;&#12365;&#12414;&#12377;&#12290;
12 value of the supplied annotation classes. This would be used for behavior annota tions 15 &#12371;&#12398;&#25351;&#23450;&#12399; @NonNull &#12289; @CheckForNull &#12289 ;&#12414;&#12383;&#12399; @CheckReturnValue&#12394;&#12393;&#12395;&#20351;&#299 92;&#12377;&#12427;&#24819;&#23450;&#12391;&#12377;&#12290;
13 such as @NonNull, @CheckForNull, or @CheckReturnValue. In particular, you can us e 16 &#20855;&#20307;&#30340;&#12395;&#12399;&#12289; &#12463;&#12521;&#12473;&#12414 ;&#12383;&#12399;&#12497;&#12483;&#12465;&#12540;&#12472;&#12395; @DefaultAnnota tion(NonNull.class) &#12434;&#25351;&#23450;&#12375;&#12383;&#19978;&#12391;&#12 289;
14 @DefaultAnnotation(NonNull.class) on a class or package, and then use @Nullable only 17 null &#12434;&#35377;&#23481;&#12375;&#12383;&#12356;&#12497;&#12521;&#12513;&#1 2540;&#12479;&#12540;&#12289;&#12513;&#12477;&#12483;&#12489;&#12414;&#12383;&#1 2399;&#12501;&#12451;&#12540;&#12523;&#12489;&#12395;&#12398;&#12415; @Nullable &#12434;&#25351;&#23450;&#12377;&#12427;&#12392;&#12356;&#12358;&#20351;&#29992; &#26041;&#27861;&#12364;&#12354;&#12426;&#12414;&#12377;&#12290;
15 on those parameters, methods or fields that you want to allow to be null. 18 </p></dd><dt><span class="term"><span class="command"><strong>edu.umd.cs.f indbugs.annotations.DefaultAnnotationForFields</strong></span></span></dt><dd><p >
16 </p></dd><dt><span class="term"><span class="command"><strong>edu.umd.cs.f indbugs.annotations.DefaultAnnotationForFields</strong></span></span></dt><dd><s pan class="command"><strong>[Target]</strong></span> Type, Package 19 <span class="command"><strong>[Target]</strong></span> Type, Package
17 <div class="variablelist"><dl><dt><span class="term"><span class="command">< strong>[Parameter]</strong></span></span></dt><dd><p> 20 </p><div class="variablelist"><dl><dt><span class="term"><span class="comman d"><strong>[Parameter]</strong></span></span></dt><dd><p>
18 <span class="command"><strong>value:</strong></span>&#12450;&#1249 4;&#12486;&#12540;&#12471;&#12519;&#12531;&#12463;&#12521;&#12473;&#12398;class& #12458;&#12502;&#12472;&#12455;&#12463;&#12488;&#12290;&#35079;&#25968;&#12398;& #12463;&#12521;&#12473;&#12434;&#25351;&#23450;&#12377;&#12427;&#12371;&#12392;& #12364;&#12391;&#12365;&#12414;&#12377;&#12290;</p><p> 21 <span class="command"><strong>value:</strong></span>&#12450;&#1249 4;&#12486;&#12540;&#12471;&#12519;&#12531;&#12463;&#12521;&#12473;&#12398;class& #12458;&#12502;&#12472;&#12455;&#12463;&#12488;&#12290;&#35079;&#25968;&#12398;& #12463;&#12521;&#12473;&#12434;&#25351;&#23450;&#12377;&#12427;&#12371;&#12392;& #12364;&#12391;&#12365;&#12414;&#12377;&#12290;</p><p>
19 <span class="command"><strong>priority:</strong></span>&#30465;&#3 0053;&#26178;&#12398;&#20778;&#20808;&#24230;&#12434;&#25351;&#23450;&#12375;&#1 2414;&#12377; (HIGH, MEDIUM, LOW, IGNORE) &#12290;&#12487;&#12501;&#12457;&#1252 3;&#12488;&#20516; :MEDIUM&#12290;</p></dd></dl></div><p> 22 <span class="command"><strong>priority:</strong></span>&#30465;&#3 0053;&#26178;&#12398;&#20778;&#20808;&#24230;&#12434;&#25351;&#23450;&#12375;&#1 2414;&#12377; (HIGH, MEDIUM, LOW, IGNORE) &#12290;&#12487;&#12501;&#12457;&#1252 3;&#12488;&#20516; :MEDIUM&#12290;</p></dd></dl></div><p>
20 This is same as the DefaultAnnotation except it only applys to fields. 23 &#12501;&#12451;&#12540;&#12523;&#12489;&#12398;&#12415;&#12395;&#36969;&#29992; &#12373;&#12428;&#12427;&#12371;&#12392;&#20197;&#22806;&#12399; DefaultAnnotati on &#12392;&#21516;&#27096;&#12391;&#12377;&#12290;
21 </p></dd><dt><span class="term"><span class="command"><strong>edu.umd.cs.f indbugs.annotations.DefaultAnnotationForMethods</strong></span></span></dt><dd>< span class="command"><strong>[Target]</strong></span> Type, Package 24 </p></dd><dt><span class="term"><span class="command"><strong>edu.umd.cs.f indbugs.annotations.DefaultAnnotationForMethods</strong></span></span></dt><dd>< p>
22 <div class="variablelist"><dl><dt><span class="term"><span class="command">< strong>[Parameter]</strong></span></span></dt><dd><p> 25 <span class="command"><strong>[Target]</strong></span> Type, Package
26 </p><div class="variablelist"><dl><dt><span class="term"><span class="comman d"><strong>[Parameter]</strong></span></span></dt><dd><p>
23 <span class="command"><strong>value:</strong></span>&#12450;&#1249 4;&#12486;&#12540;&#12471;&#12519;&#12531;&#12463;&#12521;&#12473;&#12398;class& #12458;&#12502;&#12472;&#12455;&#12463;&#12488;&#12290;&#35079;&#25968;&#12398;& #12463;&#12521;&#12473;&#12434;&#25351;&#23450;&#12377;&#12427;&#12371;&#12392;& #12364;&#12391;&#12365;&#12414;&#12377;&#12290;</p><p> 27 <span class="command"><strong>value:</strong></span>&#12450;&#1249 4;&#12486;&#12540;&#12471;&#12519;&#12531;&#12463;&#12521;&#12473;&#12398;class& #12458;&#12502;&#12472;&#12455;&#12463;&#12488;&#12290;&#35079;&#25968;&#12398;& #12463;&#12521;&#12473;&#12434;&#25351;&#23450;&#12377;&#12427;&#12371;&#12392;& #12364;&#12391;&#12365;&#12414;&#12377;&#12290;</p><p>
24 <span class="command"><strong>priority:</strong></span>&#30465;&#3 0053;&#26178;&#12398;&#20778;&#20808;&#24230;&#12434;&#25351;&#23450;&#12375;&#1 2414;&#12377; (HIGH, MEDIUM, LOW, IGNORE) &#12290;&#12487;&#12501;&#12457;&#1252 3;&#12488;&#20516; :MEDIUM&#12290;</p></dd></dl></div><p> 28 <span class="command"><strong>priority:</strong></span>&#30465;&#3 0053;&#26178;&#12398;&#20778;&#20808;&#24230;&#12434;&#25351;&#23450;&#12375;&#1 2414;&#12377; (HIGH, MEDIUM, LOW, IGNORE) &#12290;&#12487;&#12501;&#12457;&#1252 3;&#12488;&#20516; :MEDIUM&#12290;</p></dd></dl></div><p>
25 This is same as the DefaultAnnotation except it only applys to methods. 29 &#12513;&#12477;&#12483;&#12489;&#12398;&#12415;&#12395;&#36969;&#29992;&#12373; &#12428;&#12427;&#12371;&#12392;&#20197;&#22806;&#12399; DefaultAnnotation &#123 92;&#21516;&#27096;&#12391;&#12377;&#12290;
26 </p></dd><dt><span class="term"><span class="command"><strong>edu.umd.cs.f indbugs.annotations.DefaultAnnotationForParameters</strong></span></span></dt><d d><span class="command"><strong>[Target]</strong></span> Type, Package 30 </p></dd><dt><span class="term"><span class="command"><strong>edu.umd.cs.f indbugs.annotations.DefaultAnnotationForParameters</strong></span></span></dt><d d><p>
27 <div class="variablelist"><dl><dt><span class="term"><span class="command">< strong>[Parameter]</strong></span></span></dt><dd><p> 31 <span class="command"><strong>[Target]</strong></span> Type, Package
32 </p><div class="variablelist"><dl><dt><span class="term"><span class="comman d"><strong>[Parameter]</strong></span></span></dt><dd><p>
28 <span class="command"><strong>value:</strong></span>&#12450;&#1249 4;&#12486;&#12540;&#12471;&#12519;&#12531;&#12463;&#12521;&#12473;&#12398;class& #12458;&#12502;&#12472;&#12455;&#12463;&#12488;&#12290;&#35079;&#25968;&#12398;& #12463;&#12521;&#12473;&#12434;&#25351;&#23450;&#12377;&#12427;&#12371;&#12392;& #12364;&#12391;&#12365;&#12414;&#12377;&#12290;</p><p> 33 <span class="command"><strong>value:</strong></span>&#12450;&#1249 4;&#12486;&#12540;&#12471;&#12519;&#12531;&#12463;&#12521;&#12473;&#12398;class& #12458;&#12502;&#12472;&#12455;&#12463;&#12488;&#12290;&#35079;&#25968;&#12398;& #12463;&#12521;&#12473;&#12434;&#25351;&#23450;&#12377;&#12427;&#12371;&#12392;& #12364;&#12391;&#12365;&#12414;&#12377;&#12290;</p><p>
29 <span class="command"><strong>priority:</strong></span>&#30465;&#3 0053;&#26178;&#12398;&#20778;&#20808;&#24230;&#12434;&#25351;&#23450;&#12375;&#1 2414;&#12377; (HIGH, MEDIUM, LOW, IGNORE) &#12290;&#12487;&#12501;&#12457;&#1252 3;&#12488;&#20516; :MEDIUM&#12290;</p></dd></dl></div><p> 34 <span class="command"><strong>priority:</strong></span>&#30465;&#3 0053;&#26178;&#12398;&#20778;&#20808;&#24230;&#12434;&#25351;&#23450;&#12375;&#1 2414;&#12377; (HIGH, MEDIUM, LOW, IGNORE) &#12290;&#12487;&#12501;&#12457;&#1252 3;&#12488;&#20516; :MEDIUM&#12290;</p></dd></dl></div><p>
30 This is same as the DefaultAnnotation except it only applys to method parameters . 35 &#12497;&#12521;&#12513;&#12540;&#12479;&#12540;&#12398;&#12415;&#12395;&#36969; &#29992;&#12373;&#12428;&#12427;&#12371;&#12392;&#20197;&#22806;&#12399; Default Annotation &#12392;&#21516;&#27096;&#12391;&#12377;&#12290;
31 </p></dd><dt><span class="term"><span class="command"><strong>edu.umd.cs.f indbugs.annotations.NonNull</strong></span></span></dt><dd><span class="command" ><strong>[Target]</strong></span> Field, Method, Parameter 36 </p></dd><dt><span class="term"><span class="command"><strong>edu.umd.cs.f indbugs.annotations.NonNull</strong></span></span></dt><dd><p>
32 <p>&#12450;&#12494;&#12486;&#12540;&#12471;&#12519;&#12531;&#12434;&#12388;& #12369;&#12383;&#35201;&#32032;&#12399;&#12289; null &#12391;&#12354;&#12387;&#1 2390;&#12399;&#12356;&#12369;&#12414;&#12379;&#12435;&#12290;&#12450;&#12494;&#1 2486;&#12540;&#12471;&#12519;&#12531;&#12434;&#12388;&#12369;&#12383;&#12501;&#1 2451;&#12540;&#12523;&#12489;&#12399;&#12289;&#27083;&#31689;&#23436;&#20102;&#2 4460; null &#12391;&#12354;&#12387;&#12390;&#12399;&#12356;&#12369;&#12414;&#123 79;&#12435;&#12290;&#12450;&#12494;&#12486;&#12540;&#12471;&#12519;&#12531;&#124 34;&#12388;&#12369;&#12383;&#12513;&#12477;&#12483;&#12489;&#12399;&#12289; null &#12391;&#12399;&#12394;&#12356;&#20516;&#12434;&#25147;&#12426;&#20516;&#12392 ;&#12375;&#12394;&#12369;&#12428;&#12400;&#12394;&#12426;&#12414;&#12379;&#12435 ;&#12290;</p></dd><dt><span class="term"><span class="command"><strong>edu.umd.c s.findbugs.annotations.Nullable</strong></span></span></dt><dd><span class="comm and"><strong>[Target]</strong></span> Field, Method, Parameter 37 <span class="command"><strong>[Target]</strong></span> Field, Method, Para meter
33 <p>&#12450;&#12494;&#12486;&#12540;&#12471;&#12519;&#12531;&#12434;&#12388;& #12369;&#12383;&#35201;&#32032;&#12399;&#12289; null &#12391;&#12354;&#12387;&#1 2390;&#12399;&#12356;&#12369;&#12414;&#12379;&#12435;&#12290;In general, this me ans developers will have to read the documentation to determine when a null valu e is acceptable and whether it is neccessary to check for a null value. FindBugs will treat the annotated items as though they had no annotation.</p><p> 38 </p><p>&#12450;&#12494;&#12486;&#12540;&#12471;&#12519;&#12531;&#12434;&#123 88;&#12369;&#12383;&#35201;&#32032;&#12399;&#12289; null &#12391;&#12354;&#12387 ;&#12390;&#12399;&#12356;&#12369;&#12414;&#12379;&#12435;&#12290;&#12450;&#12494 ;&#12486;&#12540;&#12471;&#12519;&#12531;&#12434;&#12388;&#12369;&#12383;&#12501 ;&#12451;&#12540;&#12523;&#12489;&#12399;&#12289;&#27083;&#31689;&#23436;&#20102 ;&#24460; null &#12391;&#12354;&#12387;&#12390;&#12399;&#12356;&#12369;&#12414;& #12379;&#12435;&#12290;&#12450;&#12494;&#12486;&#12540;&#12471;&#12519;&#12531;& #12434;&#12388;&#12369;&#12383;&#12513;&#12477;&#12483;&#12489;&#12399;&#12289; null &#12391;&#12399;&#12394;&#12356;&#20516;&#12434;&#25147;&#12426;&#20516;&#1 2392;&#12375;&#12394;&#12369;&#12428;&#12400;&#12394;&#12426;&#12414;&#12379;&#1 2435;&#12290;</p></dd><dt><span class="term"><span class="command"><strong>edu.u md.cs.findbugs.annotations.Nullable</strong></span></span></dt><dd><p>
34 In pratice this annotation is useful only for overriding an overarching NonNull 39 <span class="command"><strong>[Target]</strong></span> Field, Method, Para meter
35 annotation. 40 </p><p>
36 </p></dd><dt><span class="term"><span class="command"><strong>edu.umd.cs.f indbugs.annotations.OverrideMustInvoke</strong></span></span></dt><dd><span clas s="command"><strong>[Target]</strong></span> Method 41 &#12450;&#12494;&#12486;&#12540;&#12471;&#12519;&#12531;&#12434;&#12388;&#12369; &#12383;&#35201;&#32032;&#12399;&#12289; &#26465;&#20214;&#12395;&#12424;&#12426 ; null &#12391;&#12354;&#12427;&#21487;&#33021;&#24615;&#12364;&#12354;&#12426;& #12414;&#12377;&#12290;
37 <div class="variablelist"><dl><dt><span class="term"><span class="command">< strong>[Parameter]</strong></span></span></dt><dd><p> 42 &#19968;&#33324;&#12395;&#12289;&#38283;&#30330;&#32773;&#12399;&#12489;&#12461; &#12517;&#12513;&#12531;&#12488;&#12434;&#35501;&#12435;&#12391; null &#20516;&# 12434;&#35377;&#23481;&#12377;&#12427;&#12363;&#12393;&#12358;&#12363;&#12414;&# 12383;&#12399; null &#20516;&#12434;&#12481;&#12455;&#12483;&#12463;&#12377;&#12 427;&#12363;&#12393;&#12358;&#12363;&#12434;&#27770;&#23450;&#12377;&#12427;&#24 517;&#35201;&#12364;&#12354;&#12426;&#12414;&#12377;&#12290;
38 <span class="command"><strong>value:</strong></span>Specify when t he super invocation should be 43 FindBugs &#12399;&#12371;&#12398;&#12450;&#12494;&#12486;&#12540;&#12471;&#12519 ;&#12531;&#12434;&#12388;&#12369;&#12383;&#35201;&#32032;&#12434;&#12289;&#12450 ;&#12494;&#12486;&#12540;&#12471;&#12519;&#12531;&#12364;&#12388;&#12356;&#12390 ;&#12356;&#12394;&#12356;&#12418;&#12398;&#12392;&#21516;&#27096;&#12395;&#25201 ;&#12356;&#12414;&#12377;&#12290;
39 performed (FIRST, ANYTIME, LAST). Default value:ANYTIME. 44 </p><p>
45 &#23455;&#38555;&#12395;&#12399;&#12289;&#12371;&#12398;&#12450;&#12494;&#12486; &#12540;&#12471;&#12519;&#12531;&#12399; NonNull &#12434;&#12388;&#12369;&#12383 ;&#35201;&#32032;&#12434;&#12458;&#12540;&#12496;&#12540;&#12521;&#12452;&#12489 ;&#12377;&#12427;&#22580;&#21512;&#12395;&#26377;&#29992;&#12391;&#12377;&#12290 ;
46 </p></dd><dt><span class="term"><span class="command"><strong>edu.umd.cs.f indbugs.annotations.OverrideMustInvoke</strong></span></span></dt><dd><p>
47 <span class="command"><strong>[Target]</strong></span> Method
48 </p><div class="variablelist"><dl><dt><span class="term"><span class="comman d"><strong>[Parameter]</strong></span></span></dt><dd><p>
49 <span class="command"><strong>value:</strong></span>super &#12398; &#21628;&#12403;&#20986;&#12375;&#31623;&#25152;&#12434;&#25351;&#23450;&#12375; &#12414;&#12377; (FIRST, ANYTIME, LAST)&#12290; &#12487;&#12501;&#12457;&#12523; &#12488;&#20516; :ANYTIME&#12290;
40 </p></dd></dl></div><p> 50 </p></dd></dl></div><p>
41 Used to annotate a method that, if overridden, must (or should) be invoke super 51 &#12458;&#12540;&#12496;&#12540;&#12521;&#12452;&#12489;&#12373;&#12428;&#12383; &#22580;&#21512;&#12395;&#12458;&#12540;&#12496;&#12540;&#12521;&#12452;&#12489; &#12513;&#12477;&#12483;&#12489;&#20869;&#12391; super &#12434;&#21628;&#12403;& #20986;&#12377;&#12409;&#12365;&#12513;&#12477;&#12483;&#12489;&#12395;&#12450;& #12494;&#12486;&#12540;&#12488;&#12375;&#12414;&#12377;&#12290;
42 in the overriding method. Examples of such methods include finalize() and clone( ). 52 &#20363;&#12360;&#12400;&#12289; finalize() &#12420; clone() &#12364;&#12381;&#1 2398;&#12424;&#12358;&#12394;&#12513;&#12477;&#12483;&#12489;&#12395;&#35442;&#2 4403;&#12375;&#12414;&#12377;&#12290;
43 The argument to the method indicates when the super invocation should occur: 53 &#24341;&#25968;&#12399;&#12289; super &#12398;&#21628;&#12403;&#20986;&#12375;& #31623;&#25152;&#12434;&#25351;&#23450;&#12375;&#12414;&#12377;&#12290;&#12377;& #12394;&#12431;&#12385;&#12289;&#38543;&#26178;&#12289;&#12513;&#12477;&#12483;& #12489;&#12398;&#26368;&#21021;&#12414;&#12383;&#12399;&#12513;&#12477;&#12483;& #12489;&#12398;&#26368;&#24460;&#12391;&#12377;&#12290;
44 at any time, at the beginning of the overriding method, or at the end of the ove rriding method.
45 (This anotation is not implmemented in FindBugs as of September 8, 2006).
46 </p></dd><dt><span class="term"><span class="command"><strong>edu.umd.cs.f indbugs.annotations.PossiblyNull</strong></span></span></dt><dd><p> 54 </p></dd><dt><span class="term"><span class="command"><strong>edu.umd.cs.f indbugs.annotations.PossiblyNull</strong></span></span></dt><dd><p>
47 This annotation is deprecated. Use CheckForNull instead. 55 &#38750;&#25512;&#22888;&#12391;&#12377;&#12290; CheckForNull &#12434;&#20351;&# 29992;&#12375;&#12390;&#12367;&#12384;&#12373;&#12356;&#12290;
48 </p></dd><dt><span class="term"><span class="command"><strong>edu.umd.cs.f indbugs.annotations.SuppressWarnings</strong></span></span></dt><dd><span class= "command"><strong>[Target]</strong></span> Type, Field, Method, Parameter, Const ructor, Package 56 </p></dd><dt><span class="term"><span class="command"><strong>edu.umd.cs.f indbugs.annotations.SuppressWarnings</strong></span></span></dt><dd><p>
49 <div class="variablelist"><dl><dt><span class="term"><span class="command">< strong>[Parameter]</strong></span></span></dt><dd><p> 57 <span class="command"><strong>[Target]</strong></span> Type, Field, Method , Parameter, Constructor, Package
50 <span class="command"><strong>value:</strong></span>The name of th e warning. More than one name can be specified. 58 </p><div class="variablelist"><dl><dt><span class="term"><span class="comman d"><strong>[Parameter]</strong></span></span></dt><dd><p>
59 <span class="command"><strong>value:</strong></span>&#35686;&#2157 8;&#12398;&#21517;&#31216;&#12290;&#35079;&#25968;&#12398;&#21517;&#31216;&#1243 4;&#25351;&#23450;&#12377;&#12427;&#12371;&#12392;&#12364;&#12391;&#12365;&#1241 4;&#12377;&#12290;
51 </p><p> 60 </p><p>
52 <span class="command"><strong>justification:</strong></span>Reason why the warning should be ignored. &#12487;&#12501;&#12457;&#12523;&#12488;&#20 516; :""&#12290;</p></dd></dl></div><p> 61 <span class="command"><strong>justification:</strong></span>&#3568 6;&#21578;&#12434;&#28961;&#35222;&#12377;&#12427;&#29702;&#30001;&#12290; &#124 87;&#12501;&#12457;&#12523;&#12488;&#20516; :""&#12290;</p></dd></dl></div><p>
53 The set of warnings that are to be suppressed by the compiler in the annotated e lement. 62 The set of warnings that are to be suppressed by the compiler in the annotated e lement.
54 Duplicate names are permitted. The second and successive occurrences of a name are ignored. 63 Duplicate names are permitted. The second and successive occurrences of a name are ignored.
55 The presence of unrecognized warning names is <span class="emphasis"><em>not</em ></span> an error: Compilers 64 The presence of unrecognized warning names is <span class="emphasis"><em>not</em ></span> an error: Compilers
56 must ignore any warning names they do not recognize. They are, however, free to emit a 65 must ignore any warning names they do not recognize. They are, however, free to emit a
57 warning if an annotation contains an unrecognized warning name. Compiler vendors should 66 warning if an annotation contains an unrecognized warning name. Compiler vendors should
58 document the warning names they support in conjunction with this annotation type . They 67 document the warning names they support in conjunction with this annotation type . They
59 are encouraged to cooperate to ensure that the same names work across multiple c ompilers. 68 are encouraged to cooperate to ensure that the same names work across multiple c ompilers.
60 </p></dd><dt><span class="term"><span class="command"><strong>edu.umd.cs.f indbugs.annotations.UnknownNullness</strong></span></span></dt><dd><span class=" command"><strong>[Target]</strong></span> Field, Method, Parameter 69 </p></dd><dt><span class="term"><span class="command"><strong>edu.umd.cs.f indbugs.annotations.UnknownNullness</strong></span></span></dt><dd><p>
61 <p> 70 <span class="command"><strong>[Target]</strong></span> Field, Method, Para meter
71 </p><p>
62 Used to indicate that the nullness of the target is unknown, or my vary in unkno wn ways in subclasses. 72 Used to indicate that the nullness of the target is unknown, or my vary in unkno wn ways in subclasses.
63 </p></dd><dt><span class="term"><span class="command"><strong>edu.umd.cs.f indbugs.annotations.UnknownNullness</strong></span></span></dt><dd><span class=" command"><strong>[Target]</strong></span> Field, Method, Parameter 73 </p></dd><dt><span class="term"><span class="command"><strong>edu.umd.cs.f indbugs.annotations.UnknownNullness</strong></span></span></dt><dd><p>
64 <p> 74 <span class="command"><strong>[Target]</strong></span> Field, Method, Para meter
75 </p><p>
65 Used to indicate that the nullness of the target is unknown, or my vary in unkno wn ways in subclasses. 76 Used to indicate that the nullness of the target is unknown, or my vary in unkno wn ways in subclasses.
66 </p></dd></dl></div><p>&#12414;&#12383;&#12289; <span class="application"> FindBugs</span> &#27425;&#12395;&#31034;&#12377;&#12450;&#12494;&#12486;&#12540; &#12471;&#12519;&#12531;&#12418;&#12469;&#12509;&#12540;&#12488;&#12375;&#12390; &#12356;&#12414;&#12377;&#12290; :</p><div class="itemizedlist"><ul class="itemi zedlist" type="disc"><li class="listitem">net.jcip.annotations.GuardedBy</li><li class="listitem">net.jcip.annotations.Immutable</li><li class="listitem">net.jc ip.annotations.NotThreadSafe</li><li class="listitem">net.jcip.annotations.Threa dSafe</li></ul></div><p> 77 </p></dd></dl></div><p>&#12414;&#12383;&#12289; <span class="application"> FindBugs</span> &#27425;&#12395;&#31034;&#12377;&#12450;&#12494;&#12486;&#12540; &#12471;&#12519;&#12531;&#12418;&#12469;&#12509;&#12540;&#12488;&#12375;&#12390; &#12356;&#12414;&#12377;&#12290; :</p><div class="itemizedlist"><ul class="itemi zedlist" type="disc"><li class="listitem"><p>net.jcip.annotations.GuardedBy</p>< /li><li class="listitem"><p>net.jcip.annotations.Immutable</p></li><li class="li stitem"><p>net.jcip.annotations.NotThreadSafe</p></li><li class="listitem"><p>ne t.jcip.annotations.ThreadSafe</p></li></ul></div><p>
67 </p><p><a class="ulink" href="http://jcip.net/" target="_top">Java Concurrency i n Practice</a> &#12398; <a class="ulink" href="http://jcip.net/annotations/doc/i ndex.html" target="_top"> API &#12489;&#12461;&#12517;&#12513;&#12531;&#12488;</ a> &#12434;&#21442;&#29031;&#12375;&#12390;&#12367;&#12384;&#12373;&#12356;&#122 90;</p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="analysisprops.ht ml">&#25147;&#12427;</a>&nbsp;</td><td width="20%" align="center">&nbsp;</td><td width="40%" align="right">&nbsp;<a accesskey="n" href="rejarForAnalysis.html">& #27425;&#12408;</a></td></tr><tr><td width="40%" align="left" valign="top">&#315 32;9&#31456; &#20998;&#26512;&#12503;&#12525;&#12497;&#12486;&#12451;&#12540;&nb sp;</td><td width="20%" align="center"><a accesskey="h" href="index.html">&#1250 7;&#12540;&#12512;</a></td><td width="40%" align="right" valign="top">&nbsp;&#31 532;11&#31456; rejarForAnalysis &#12398;&#20351;&#29992;&#26041;&#27861;</td></t r></table></div></body></html> 78 </p><p><a class="ulink" href="http://jcip.net/" target="_top">Java Concurrency i n Practice</a> &#12398; <a class="ulink" href="http://jcip.net/annotations/doc/i ndex.html" target="_top"> API &#12489;&#12461;&#12517;&#12513;&#12531;&#12488;</ a> &#12434;&#21442;&#29031;&#12375;&#12390;&#12367;&#12384;&#12373;&#12356;&#122 90;</p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="analysisprops.ht ml">&#25147;&#12427;</a>&nbsp;</td><td width="20%" align="center">&nbsp;</td><td width="40%" align="right">&nbsp;<a accesskey="n" href="rejarForAnalysis.html">& #27425;&#12408;</a></td></tr><tr><td width="40%" align="left" valign="top">&#315 32;9&#31456; &#20998;&#26512;&#12503;&#12525;&#12497;&#12486;&#12451;&#12540;&nb sp;</td><td width="20%" align="center"><a accesskey="h" href="index.html">&#1250 7;&#12540;&#12512;</a></td><td width="40%" align="right" valign="top">&nbsp;&#31 532;11&#31456; rejarForAnalysis &#12398;&#20351;&#29992;&#26041;&#27861;</td></t r></table></div></body></html>
OLDNEW
« no previous file with comments | « doc/ja/manual/acknowledgments.html ('k') | doc/ja/manual/anttask.html » ('j') | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698