static {
    final ImmutableMap.Builder<String, JavadocTagInfo> textToTagBuilder =
        new ImmutableMap.Builder<>();

    final ImmutableMap.Builder<String, JavadocTagInfo> nameToTagBuilder =
        new ImmutableMap.Builder<>();

    for (final JavadocTagInfo tag : JavadocTagInfo.values()) {
      textToTagBuilder.put(tag.getText(), tag);
      nameToTagBuilder.put(tag.getName(), tag);
    }

    TEXT_TO_TAG = textToTagBuilder.build();
    NAME_TO_TAG = nameToTagBuilder.build();
  }
示例#2
0
 /**
  * Gets validTags from a given piece of Javadoc.
  *
  * @param cmt the Javadoc comment to process.
  * @param tagType the type of validTags we're interested in
  * @return all standalone validTags from the given javadoc.
  */
 public static JavadocTags getJavadocTags(TextBlock cmt, JavadocTagType tagType) {
   final String[] text = cmt.getText();
   final List<JavadocTag> tags = Lists.newArrayList();
   final List<InvalidJavadocTag> invalidTags = Lists.newArrayList();
   Pattern blockTagPattern = Pattern.compile("/\\*{2,}\\s*@(\\p{Alpha}+)\\s");
   for (int i = 0; i < text.length; i++) {
     final String s = text[i];
     final Matcher blockTagMatcher = blockTagPattern.matcher(s);
     if ((tagType == JavadocTagType.ALL || tagType == JavadocTagType.BLOCK)
         && blockTagMatcher.find()) {
       final String tagName = blockTagMatcher.group(1);
       String content = s.substring(blockTagMatcher.end(1));
       if (content.endsWith("*/")) {
         content = content.substring(0, content.length() - 2);
       }
       final int line = cmt.getStartLineNo() + i;
       int col = blockTagMatcher.start(1) - 1;
       if (i == 0) {
         col += cmt.getStartColNo();
       }
       if (JavadocTagInfo.isValidName(tagName)) {
         tags.add(new JavadocTag(line, col, tagName, content.trim()));
       } else {
         invalidTags.add(new InvalidJavadocTag(line, col, tagName));
       }
     }
     // No block tag, so look for inline validTags
     else if (tagType == JavadocTagType.ALL || tagType == JavadocTagType.INLINE) {
       // Match Javadoc text after comment characters
       final Pattern commentPattern = Pattern.compile("^\\s*(?:/\\*{2,}|\\*+)\\s*(.*)");
       final Matcher commentMatcher = commentPattern.matcher(s);
       final String commentContents;
       final int commentOffset; // offset including comment characters
       if (!commentMatcher.find()) {
         commentContents = s; // No leading asterisks, still valid
         commentOffset = 0;
       } else {
         commentContents = commentMatcher.group(1);
         commentOffset = commentMatcher.start(1) - 1;
       }
       final Pattern tagPattern = Pattern.compile(".*?\\{@(\\p{Alpha}+)\\s+(.*?)\\}");
       final Matcher tagMatcher = tagPattern.matcher(commentContents);
       while (tagMatcher.find()) {
         final String tagName = tagMatcher.group(1);
         final String tagValue = tagMatcher.group(2).trim();
         final int line = cmt.getStartLineNo() + i;
         int col = commentOffset + tagMatcher.start(1) - 1;
         if (i == 0) {
           col += cmt.getStartColNo();
         }
         if (JavadocTagInfo.isValidName(tagName)) {
           tags.add(new JavadocTag(line, col, tagName, tagValue));
         } else {
           invalidTags.add(new InvalidJavadocTag(line, col, tagName));
         }
         // else Error: Unexpected match count for inline Javadoc
         // tag!
       }
     }
     blockTagPattern = Pattern.compile("^\\s*\\**\\s*@(\\p{Alpha}+)\\s");
   }
   return new JavadocTags(tags, invalidTags);
 }