001/* 002 * Copyright (c) 2009 The openGion Project. 003 * 004 * Licensed under the Apache License, Version 2.0 (the "License"); 005 * you may not use this file except in compliance with the License. 006 * You may obtain a copy of the License at 007 * 008 * http://www.apache.org/licenses/LICENSE-2.0 009 * 010 * Unless required by applicable law or agreed to in writing, software 011 * distributed under the License is distributed on an "AS IS" BASIS, 012 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, 013 * either express or implied. See the License for the specific language 014 * governing permissions and limitations under the License. 015 */ 016// 7.4.4.0 (2021/06/30) openGionV8事前準備(taglet2→taglet) 017//package org.opengion.fukurou.taglet2; 018package org.opengion.fukurou.taglet; 019 020import static org.opengion.fukurou.system.HybsConst.BUFFER_MIDDLE; // 6.1.0.0 (2014/12/26) refactoring 021 022import jdk.javadoc.doclet.DocletEnvironment ; 023// import jdk.javadoc.doclet.Doclet ; 024// import jdk.javadoc.doclet.Reporter ; 025import javax.lang.model.element.Element ; 026import javax.lang.model.element.Modifier ; 027import javax.lang.model.element.TypeElement; 028import javax.lang.model.element.ElementKind ; 029import javax.lang.model.element.VariableElement; 030import javax.lang.model.element.ExecutableElement; 031// import javax.lang.model.SourceVersion ; 032import javax.lang.model.type.TypeMirror; 033import javax.lang.model.type.TypeKind; 034import javax.lang.model.util.ElementFilter ; 035import javax.lang.model.util.Elements ; 036import javax.lang.model.util.Types ; 037import javax.tools.Diagnostic.Kind ; 038import com.sun.source.doctree.DocCommentTree ; 039import com.sun.source.util.DocTrees ; 040// import com.sun.source.util.DocSourcePositions ; 041import com.sun.source.doctree.DocTree ; 042 043// import java.util.Locale ; 044import java.util.Set; 045import java.util.List; 046import java.util.HashSet; 047import java.util.Arrays; 048// import java.util.stream.Stream; // 6.4.3.4 (2016/03/11) 049// import java.util.stream.Collectors; // 6.4.3.4 (2016/03/11) 050// import java.util.regex.Pattern; // 6.3.9.1 (2015/11/27) final化に伴う整理 051 052// import java.io.IOException; 053// import java.io.File; 054// import java.io.PrintWriter; 055import java.util.stream.Stream; // 6.4.3.4 (2016/03/11) 056import java.util.stream.Collectors; // 6.4.3.4 (2016/03/11) 057import java.util.Map; 058 059// import org.opengion.fukurou.util.FileUtil; 060// import org.opengion.fukurou.util.StringUtil; 061 062/** 063 * ソースコメントから、パラメータ情報を取り出す Doclet クラスです。 064 * og.paramLevel タグと og.cryptography タグを切り出します。 065 * これらは、システムパラメータとしてGE12テーブルに設定される値をクラスより抽出する 066 * のに使用します。 067 * 068 * @version 7.3 069 * @author Kazuhiko Hasegawa 070 * @since JDK11.0, 071 */ 072public class DocTreeSpecific extends AbstractDocTree { 073 private static final String SELECT_PACKAGE = "org.opengion" ; 074 private static final boolean USE_PRIVATE = false ; 075 076 private static final String OG_FOR_SMPL = "og.formSample"; 077 private static final String OG_REV = "og.rev"; 078 private static final String OG_GROUP = "og.group"; 079 private static final String DOC_VERSION = "version"; 080 private static final String DOC_AUTHOR = "author"; 081 private static final String DOC_SINCE = "since"; 082 083// private static final String OG_TAG_NAME = "og.tag"; // 6.1.2.0 (2015/01/24) チェック用 084// private static final String DOC_PARAM = "param"; // 5.1.9.0 (2010/08/01) チェック用 085// private static final String DOC_RETURN = "return"; // 5.1.9.0 (2010/08/01) チェック用 086 087 private static final String CONSTRUCTOR = "コンストラクタ" ; 088 private static final String METHOD = "メソッド" ; 089 090 private String version ; 091 private String outfile ; 092 private int debugLevel ; // 0:なし 1:最小チェック 2:日本語化 3:体裁 4:Verチェック 5:taglibラベル 093 094 private final Set<String> mtdClsSet = new HashSet<>(); 095 096 // 5.1.9.0 (2010/08/01) ソースチェック用(半角文字+空白文字のみ) 097// private static final Pattern PTN = Pattern.compile("[\\w\\s]+"); // 6.3.9.1 (2015/11/27) 098 099// private DocTrees docUtil; 100// private Elements eleUtil ; 101 private Types typUtil ; 102 103 /** 104 * デフォルトコンストラクター 105 * 106 * @og.rev 7.3.0.0 (2021/01/06) PMD refactoring. Each class should declare at least one constructor. 107 */ 108 public DocTreeSpecific() { super(); } // これも、自動的に呼ばれるが、空のメソッドを作成すると警告されるので、明示的にしておきます。 109 110 /** 111 * Doclet のエントリポイントメソッドです(昔の startメソッド)。 112 * 113 * @og.rev 7.3.0.0 (2021/01/06) 新しいJavaDoc対応 114 * 115 * @param docEnv ドックレットを1回呼び出す操作環境 116 * 117 * @return 正常実行時 true 118 */ 119 @Override 120 public boolean run( final DocletEnvironment docEnv ) { 121 try( DocTreeWriter writer = new DocTreeWriter( outfile,ENCODE ) ) { 122 writer.printTag( "<?xml version=\"1.0\" encoding=\"", ENCODE , "\" ?>" ); 123 writer.printTag( "<javadoc>" ); 124 writer.printTag( " <version>",version,"</version>" ); 125 writer.printTag( " <description></description>" ); 126 writeContents( docEnv,writer ); 127 writer.printTag( "</javadoc>" ); 128 } 129 catch( final Throwable th ) { 130 reporter.print(Kind.ERROR, th.getMessage()); 131 } 132 133 return true; 134 } 135 136 /** 137 * DocletEnvironmentよりコンテンツを作成します。 138 * 139 * @og.rev 7.3.0.0 (2021/01/06) 新しいJavaDoc対応 140 * @og.rev 8.0.0.0 (2021/07/31) Avoid instantiating new objects inside loops 141 * 142 * @param docEnv ドックレットの最上位 143 * @param writer DocTreeWriterオブジェクト 144 */ 145 private void writeContents( final DocletEnvironment docEnv, final DocTreeWriter writer ) { 146// docUtil = docEnv.getDocTrees(); 147 final DocTrees docUtil = docEnv.getDocTrees(); 148 final Elements eleUtil = docEnv.getElementUtils(); 149 typUtil = docEnv.getTypeUtils(); 150 151 final StringBuilder modiBuf = new StringBuilder(); // 8.0.0.0 (2021/07/31) Avoid instantiating new objects inside loops 152 final StringBuilder buf = new StringBuilder(); // 8.0.0.0 (2021/07/31) Avoid instantiating new objects inside loops 153 154 // クラス単位にループする。 155 for( final TypeElement typEle : ElementFilter.typesIn(docEnv.getIncludedElements())) { 156 final String fullName = String.valueOf( typEle.getQualifiedName() ) ; 157 writer.setClassName( fullName ); 158 159 final String className = String.valueOf( typEle.getSimpleName() ); 160 161// final StringBuilder modiBuf = new StringBuilder(); 162 modiBuf.setLength( 0 ) ; // 8.0.0.0 (2021/07/31) 163 typEle.getModifiers().forEach( modi -> modiBuf.append( modi ).append( ' ' ) ); 164 final ElementKind eleKind = typEle.getKind(); 165 if( ElementKind.CLASS.equals( eleKind ) ) { modiBuf.append( "class" ); } 166 final String modifiers = modiBuf.toString().trim(); 167 168 final TypeMirror superType = typEle.getSuperclass(); 169 final String superClass = TypeKind.NONE.equals( superType.getKind() ) ? "" : superType.toString(); 170 171 final String intFase = Stream.of( typEle.getInterfaces() ) 172 .map( typ -> String.valueOf(typ) ) 173 .collect( Collectors.joining( "," ) ); 174 175 final DocCommentTree docTree = docUtil.getDocCommentTree(typEle); // ドキュメンテーション・コメントが見つからない場合、null が返る。 176 177 final List<? extends DocTree> desc = docTree == null ? EMPTY_LIST : docTree.getFirstSentence(); 178 final List<? extends DocTree> cmnt = docTree == null ? EMPTY_LIST : docTree.getFullBody(); 179 180 final Map<String,List<String>> blkTagMap = blockTagsMap(docTree); 181 final String smplTags = getBlockTag( OG_FOR_SMPL, blkTagMap, "" ); 182 final String revTags = getBlockTag( OG_REV , blkTagMap, "\n" ); 183 final String createVer = getBlockTag( DOC_VERSION, blkTagMap, "" ); 184 final String author = getBlockTag( DOC_AUTHOR , blkTagMap, "" ); 185 final String since = getBlockTag( DOC_SINCE , blkTagMap, "" ); 186 final String grpTags = getBlockTag( OG_GROUP , blkTagMap, "," ); 187 188 // 5.7.1.1 (2013/12/13) タグのインデントを止める。 189 writer.printTag( "<classDoc>" ); 190 writer.printTag( " <fullName>" ,fullName ,"</fullName>" ); 191 writer.printTag( " <modifiers>" ,modifiers ,"</modifiers>" ); 192 writer.printTag( " <className>" ,className ,"</className>" ); 193 writer.printTag( " <superClass>" ,superClass ,"</superClass>" ); 194 writer.printTag( " <interface>" ,intFase ,"</interface>" ); 195 writer.printTag( " <createVer>" ,createVer ,"</createVer>" ); 196 writer.printTag( " <author>" ,author ,"</author>" ); 197 writer.printTag( " <since>" ,since ,"</since>" ); 198 writer.printTag( " <description>" ,desc ,"</description>" ); 199 writer.printTag( " <contents>" ,cmnt ,"</contents>" ); 200 writer.printTag( " <classGroup>" ,grpTags ,"</classGroup>" ); 201 writer.printTag( " <formSample>" ,smplTags ,"</formSample>" ); 202 writer.printTag( " <history>" ,revTags ,"</history>" ); 203 204 205 // 5.1.9.0 (2010/08/01) ソースチェック用(コメントや概要が無い場合。スーパークラスは省く) 206 if( debugLevel >= 2 && ( cmnt.isEmpty() || desc.isEmpty() ) && superClass.isEmpty() ) { 207 // final DocSourcePositions srcPos = docUtil.getSourcePositions(); 208 // System.err.println( "警告2:コメントC=\t" + srcPos ); 209 System.err.println( "②警告2:コメントC=\t" + typEle ); 210 } 211 212 int extendFlag = 0; // 0:オリジナル 1:org.opengion関連Extend 2:Java関連Extend 213 214 // 6.4.3.0 (2016/02/05) PMDチェックのDocletでのフォロー。 215 // checkPMD( typEle ); 216 217 // 5.6.6.0 (2013/07/05) VERSION staticフィールドと、@og.rev コメントの比較チェック 218 // while 以下で、fullName と classDoc を順番に上にさかのぼっているので、先にチェックします。 219 // checkTag2( typEle ); 220 221 mtdClsSet.clear(); 222 TypeElement loopEle = typEle; 223 String superName = fullName; 224 while( loopEle != null ) { 225 writer.setClassName( superName ); 226 227 // 対象クラスの スーパークラスを取得しておく(メソッド内で使うのと、上位に上がってく時に使う) 228 final TypeMirror spType = loopEle.getSuperclass(); 229 230 // AbstractObjectPool<java.sql.Connection> の様な型を削除します。 231// final StringBuilder buf = new StringBuilder().append(spType); 232 buf.setLength( 0 ) ; // 8.0.0.0 (2021/07/31) 233 buf.append(spType) ; // 8.0.0.0 (2021/07/31) 234 235 int st = buf.indexOf("<"); 236 int ed = buf.indexOf(">",st); 237 while( st > 0 ) { 238 buf.delete(st,ed+1); 239 st = buf.indexOf("<"); 240 ed = buf.indexOf(">",st); 241 } 242 superName = buf.toString(); 243 // superName = String.valueOf( spType ); 244 245 final String extClass = ( extendFlag == 0 ) ? "" : superName ; 246 247 // コンストラクタのみフィルタリングして取得する 248 for( final ExecutableElement exEle : ElementFilter.constructorsIn(loopEle.getEnclosedElements()) ) { 249 final DocCommentTree dct = docUtil.getDocCommentTree(exEle); // ドキュメンテーション・コメントが見つからない場合、null が返る。 250 if( dct != null && isAction( exEle,extendFlag ) ) { 251 // checkTag( exEle,dct ); // 5.5.4.1 (2012/07/06) チェックを分離 252 menberTag( exEle,dct,CONSTRUCTOR,writer,extendFlag,extClass ); 253 } 254 } 255 256 // メソッドのみフィルタリングして取得する 257 for( final ExecutableElement exEle : ElementFilter.methodsIn(loopEle.getEnclosedElements())) { 258 final DocCommentTree dct = docUtil.getDocCommentTree(exEle); // ドキュメンテーション・コメントが見つからない場合、null が返る。 259 if( dct != null && isAction( exEle,extendFlag ) ) { 260 // checkTag( exEle,dct ); 261 menberTag( exEle,dct,METHOD,writer,extendFlag,extClass ); 262 } 263 } 264 265 // 対象クラス(オリジナル)から、上に上がっていく。 266 if( superName.startsWith( SELECT_PACKAGE ) ) { 267 extendFlag = 1; 268 } 269 else { 270 break; 271 } 272 273 loopEle = eleUtil.getTypeElement(superName); 274 } 275 writer.printTag( "</classDoc>" ); 276 } 277 } 278 279 /** 280 * メンバークラスのXML化を行うかどうか[true/false]を判定します。 281 * 282 * 以下の条件に合致する場合は、処理を行いません。(false を返します。) 283 * 284 * 1.同一クラスを処理中にEXTENDで継承元をさかのぼる場合、すでに同じシグネチャのメソッドが 285 * 存在している。 286 * 2.USE_PRIVATE が true の時の private メソッド 287 * 3.extendFlag が 0以上(1,2)の時の private メソッド 288 * 4.メソッド名におかしな記号(<など)が含まれている場合 289 * 290 * @og.rev 7.3.0.0 (2021/01/06) 新しいJavaDoc対応 291 * 292 * @param menber ExecutableMemberDocオブジェクト 293 * @param extendFlag 継承状態 [0:オリジナル/1:org.opengion関連Extend/2:Java関連Extend] 294 * 295 * @return XML化を行うかどうか[true/false] 296 */ 297 private boolean isAction( final ExecutableElement menber,final int extendFlag ) { 298// final String menberName = String.valueOf( menber.getSimpleName() ) ; 299 final boolean isPrivate = menber.getModifiers().contains( Modifier.PRIVATE ); 300 final boolean isTypeParam = ! menber.getTypeParameters().isEmpty(); 301 final boolean rtn = ! mtdClsSet.add( String.valueOf( menber ) ) // 5.5.4.1 (2012/07/06) メソッドの重複処理判定は、クラス名も含めて行う 302 || USE_PRIVATE && isPrivate 303 || extendFlag > 0 && isPrivate 304 || isTypeParam; // PMD Useless parentheses. 305 306 return ! rtn ; 307 } 308 309// /** 310// * param,return 等の整合性をチェックします。 311// * 312// * @og.rev 7.3.0.0 (2021/01/06) 新しいJavaDoc対応 313// * 314// * @param exEle ExecutableElementオブジェクト 315// * @param menber DocCommentTreeオブジェクト 316// */ 317// private void checkTag( final ExecutableElement exEle , final DocCommentTree menber ) { 318// // 未実装 319// } 320 321// /** 322// * PMDで、チェックしている処理のうち、Docletでフォローできる分をチェックします。 323// * 324// * ※ このチェックは、警告レベル5 のみ集約していますので、呼出元で、制限します。 325// * 326// * @og.rev 7.3.0.0 (2021/01/06) 新しいJavaDoc対応 327// * 328// * @param typEle TypeElementオブジェクト 329// */ 330// private void checkTag2( final TypeElement typEle ) { 331// String cnstVar = null ; // 初期値 332// String seriUID = null ; 333// final String src = "\tsrc/" + String.valueOf(typEle).replace('.','/') + ".java:100" ; // 行が判らないので、100行目 決め打ち 334// 335// // フィールドのみフィルタリングして取得する 336// for( final VariableElement varEle : ElementFilter.fieldsIn(typEle.getEnclosedElements())) { // フィールドだけに絞る 337// final String key = String.valueOf(varEle); 338// if( "VERSION".equals( key ) ) { 339// cnstVar = String.valueOf( varEle.getConstantValue() ); 340// } 341// else if( "serialVersionUID".equals( key ) ) { 342// seriUID = String.valueOf( varEle.getConstantValue() ) + "L"; // 旧JavaDocと違い、"L" まで取ってこれないみたい 343// } 344// } 345// 346// if( cnstVar == null ) { return; } // VERSION が未定義のクラスは処理しない 347// 348// String maxRev = cnstVar ; // 5.7.1.1 (2013/12/13) 初期値 349// boolean isChange = false; // max が入れ替わったら、true 350// 351// // メソッドのみフィルタリングして取得する 352// for( final ExecutableElement exEle : ElementFilter.methodsIn(typEle.getEnclosedElements())) { 353// final DocCommentTree dct = docUtil.getDocCommentTree(exEle); // ドキュメンテーション・コメントが見つからない場合、null が返る。 354// final Map<String,List<String>> blkTagMap = blockTagsMap(dct); 355// final List<String> revTags = blkTagMap.get("og.rev"); 356// 357// if( revTags != null ) { 358// for( final String tag :revTags ) { // 複数存在しているはず 359// final int idx = tag.indexOf( ' ' ); // 最初のスペース 360// if( idx > 0 ) { 361// final String rev = tag.substring( 0,idx ).trim(); 362// if( maxRev.compareTo( rev ) < 0 ) { // revTags の og.rev が大きい場合 363// maxRev = rev ; 364// isChange = true; 365// } 366// } 367// } 368// } 369// } 370// 371// // VERSION 文字列 の定義があり、かつ、max の入れ替えが発生した場合のみ、警告4:VERSIONが古い 372// if( isChange ) { // 5.7.1.1 (2013/12/13) 入れ替えが発生した場合 373// System.err.println( "警告4:VERSIONが古い=\t" + cnstVar + " ⇒ " + maxRev + src ); 374// } 375// 376// // serialVersionUID の定義がある。 377// if( seriUID != null ) { 378// final StringBuilder buf = new StringBuilder(); 379// // maxRev は、最大の Revか、初期のVERSION文字列 例:5.6.6.0 (2013/07/05) 380// for( int i=0; i<maxRev.length(); i++ ) { // 381// final char ch = maxRev.charAt( i ); 382// if( ch >= '0' && ch <= '9' ) { buf.append( ch ); } // 数字だけ取り出す。 例:566020130705 383// } 384// buf.append( 'L' ); // 強制的に、L を追加する。 385// final String maxSeriUID = buf.toString() ; 386// 387// // 5.7.1.1 (2013/12/13) 値の取出し。Long型を表す "L" も含まれている。 388// if( !maxSeriUID.equals( seriUID ) ) { // 一致しない 389// System.err.println( "警告4:serialVersionUIDが古い=\t" + seriUID + " ⇒ " + maxSeriUID + src ); 390// } 391// } 392// } 393 394// /** 395// * PMDで、チェックしている処理のうち、Docletでフォローできる分をチェックします。 396// * 397// * ※ このチェックは、警告レベル5 のみ集約していますので、呼出元で、制限します。 398// * 399// * @og.rev 7.3.0.0 (2021/01/06) 新しいJavaDoc対応 400// * 401// * @param typEle TypeElementオブジェクト 402// */ 403// private void checkPMD( final TypeElement typEle ) { 404// // 未実装 405// } 406 407 /** 408 * メンバークラス(コンストラクタ、メソッド)をXML化します。 409 * 410 * @og.rev 7.3.0.0 (2021/01/06) 新しいJavaDoc対応 411 * 412 * @param menber ExecutableElementオブジェクト 413 * @param docTree DocCommentTreeオブジェクト 414 * @param menberType メンバータイプ(コンストラクタ、メソッド) 415 * @param writer Tagを書き出すWriterオブジェクト 416 * @param extendFlag 継承状態 [0:オリジナル/1::org.opengion関連Extend/2:Java関連Extend] 417 * @param extClass 継承クラス(オリジナルの場合は、空文字列) 418 */ 419 private void menberTag( final ExecutableElement menber, 420 final DocCommentTree docTree , 421 final String menberType, 422 final DocTreeWriter writer, 423 final int extendFlag , 424 final String extClass ) { 425 426 final String modifiers ; 427 428 final StringBuilder buf = new StringBuilder( BUFFER_MIDDLE ); 429 menber.getModifiers().forEach( modi -> buf.append( modi ).append( ' ' ) ); 430 if( ElementKind.METHOD.equals( menber.getKind() ) ) { // メソッドの処理。コンストラクタの場合は、返り値がないので処理しない。 431 buf.append( menber.getReturnType() ); 432 } 433 modifiers = buf.toString(); 434 435 final String menberName = String.valueOf( menber.getSimpleName() ); // コンストラクタの場合は、<init> が返る。 436 437 final StringBuilder sigBuf = new StringBuilder().append( menberName ).append( '(' ) ; 438 boolean flag = false; 439 for( final VariableElement valEle : menber.getParameters() ) { 440 flag = true; 441 final Element ele = typUtil.asElement( valEle.asType() ); // 型が対応する要素を持たない場合はnullを返します。 442 final String key = ele == null // 配列や、プリミティブ型の場合は、null になっている。 443 ? String.valueOf( valEle.asType() ) 444 : String.valueOf( ele.getSimpleName() ); 445 446 sigBuf.append( key ).append( ' ' ) 447 .append( valEle.getSimpleName() ).append( ',' ); 448 } 449 450 if( flag ) { sigBuf.deleteCharAt( sigBuf.length()-1 ); } 451 sigBuf.append( ')' ); 452 final String signature = sigBuf.toString(); 453// final String signature = String.valueOf( menber ); 454 455 final List<? extends DocTree> desc = docTree == null ? EMPTY_LIST : docTree.getFirstSentence(); 456 final List<? extends DocTree> cmnt = docTree == null ? EMPTY_LIST : docTree.getFullBody(); 457 458 final Map<String,List<String>> blkTagMap = blockTagsMap(docTree); 459 final String revTags = getBlockTag( OG_REV, blkTagMap, "\n" ); 460 461 // tags は、OG_REV 以外のすべてで、かつ、キーワードも含む。 462 final StringBuilder tagBuf = new StringBuilder(); 463 if( docTree != null ) { 464 for( final DocTree dt : docTree.getBlockTags() ) { 465 final String tag = String.valueOf(dt).trim(); 466 if( !tag.contains( OG_REV ) ) { tagBuf.append( tag ).append( '\n' ); } 467 } 468 } 469 final String tags = tagBuf.toString().trim(); 470 471// final StringBuilder tagBuf = new StringBuilder(); 472// final StringBuilder revBuf = new StringBuilder(); 473// if( docTree != null ) { 474// for( final DocTree dt : docTree.getBlockTags() ) { 475// final String tag = String.valueOf(dt).trim(); 476// if( tag.contains( OG_REV ) ) { revBuf.append( cutTag( tag,OG_REV ) ).append( '\n' ); } 477// else { tagBuf.append( tag ).append( '\n' ); } 478// } 479// } 480// final String revTags = revBuf.toString().trim(); 481// final String tags = tagBuf.toString().trim(); 482 483 final String extend = String.valueOf( extendFlag ); 484 485 // final DocSourcePositions srcPos = docUtil.getSourcePositions(); 486 // final String position = String.valueOf( srcPos.getStartPosition( null,docTree,null ) ); 487 final String position = ""; 488 489 writer.printTag( " <menber>" ); 490 writer.printTag( " <type>" ,menberType ,"</type>" ); 491 writer.printTag( " <name>" ,menberName ,"</name>" ); 492 writer.printTag( " <modifiers>" ,modifiers ,"</modifiers>" ); 493 writer.printTag( " <signature>" ,signature ,"</signature>" ); 494 writer.printTag( " <position>" ,position ,"</position>" ); 495 writer.printTag( " <extendClass>",extClass ,"</extendClass>" ); 496 writer.printTag( " <extendFlag>" ,extend ,"</extendFlag>" ); 497 writer.printTag( " <description>",desc ,"</description>" ); 498 writer.printTag( " <contents>" ,cmnt ,"</contents>" ); 499 writer.printTag( " <tagText>" ,tags ,"</tagText>" ); 500 writer.printTag( " <history>" ,revTags ,"</history>" ); 501 writer.printTag( " </menber>"); 502 } 503 504 /** 505 * サポートされているすべてのオプションを返します。 506 * 507 * @return サポートされているすべてのオプションを含むセット、存在しない場合は空のセット 508 */ 509 @Override 510 public Set<? extends Option> getSupportedOptions() { 511 final Option[] options = { 512 new AbstractOption( "-outfile", "-version", "-debugLevel" ) { 513 514 /** 515 * 必要に応じてオプションと引数を処理します。 516 * 517 * @param opt オプション名 518 * @param arguments 引数をカプセル化したリスト 519 * @return 操作が成功した場合はtrue、そうでない場合はfalse 520 */ 521 @Override 522 public boolean process(final String opt, final List<String> arguments) { 523 if( "-outfile".equalsIgnoreCase(opt) ) { 524 outfile = arguments.get(0); 525 } 526 else if( "-version".equalsIgnoreCase(opt) ) { 527 version = arguments.get(0); 528 } 529 else if( "-debugLevel".equalsIgnoreCase(opt) ) { 530 debugLevel = Integer.parseInt( arguments.get(0) ); 531 } 532 return true; 533 } 534 } 535 }; 536 return new HashSet<>(Arrays.asList(options)); 537 } 538}