/** * Adds a tag. Blank tag names or tags already part of the list will be * ignored. * * @param tag the tag to be added. */ public final void addTag(final String tag) { addElement(tags, tag); }
new PropertyProjectdoc(metaData.getParent()); projectdoc.setName(metaData.getName()); projectdoc.setShortDescription(metaData.getShortDescription()); projectdoc.setSortKey(metaData.getSortKey()); projectdoc.setSpace(metaData.getSpace()); projectdoc.setSummary(metaData.getSummary()); projectdoc.setTitle(metaData.getTitle()); for (final String item : metaData.getAudience()) for (final String item : metaData.getAudience()) for (final String item : metaData.getCategories()) for (final String item : metaData.getNotes()) for (final String item : metaData.getParents()) for (final String item : metaData.getTags())
final ProjectdocMetaData parent = metadata.getParent(); if (parent != null) if (StringUtils.isNotBlank(defaultName)) metadata.setName(defaultName); final String parentName = parent.getName(); if (parentName != null) metadata.setName(name); if (StringUtils.isNotBlank(defaultTitle)) metadata.setTitle(defaultTitle); final String parentTitle = parent.getTitle(); if (parentTitle != null) metadata.setTitle(title);
@SuppressWarnings(UNCHECKED) private void addDescription(final ProjectdocMetaData metaData, final Element rootNode) { final Element description = rootNode.getChild("description", getNs()); if (description != null) { final Element audienceElement = description.getChild("audience", getNs()); if (audienceElement != null) { final List<Element> members = audienceElement.getChildren("member", getNs()); for (final Element member : members) { final String memberName = member.getTextNormalize(); metaData.addAudience(memberName); } } final Element shortDescriptionElement = description.getChild("shortDescription", getNs()); final String shortDescription = toString(shortDescriptionElement); metaData.setShortDescription(shortDescription); final Element summaryElement = description.getChild("summary", getNs()); final String summary = toString(summaryElement); metaData.setSummary(summary); final Element notesElement = description.getChild("notes", getNs()); final String notes = toString(notesElement); metaData.addNote(notes); } }
private static ProjectdocMetaData createTypeMetadata(final Class<?> type, final Defaults defaults) { final ProjectdocMetaData metadata = new ProjectdocMetaData(); provideDefaults(defaults, metadata); for (final Annotation annotation : type.getAnnotations()) { addMetadata(metadata, annotation); } return metadata; }
private static void handleTag(final ProjectdocMetaData metadata, final DocTag annotation) { final String[] values = annotation.value(); for (final String value : values) { metadata.addTag(normalizeString(value)); } }
private static void handleCategory(final ProjectdocMetaData metadata, final DocCategory annotation) { final String[] values = annotation.value(); for (final String value : values) { metadata.addCategory(normalizeString(value)); } }
private static void handleParent(final ProjectdocMetaData metadata, final DocParent annotation) { final String[] values = annotation.value(); for (final String value : values) { metadata.addParent(normalizeString(value)); } }
private static void handleDocumentNotes(final ProjectdocMetaData metadata, final Document annotation) { final String[] values = annotation.notes(); for (final String value : values) { metadata.addNote(normalizeString(value)); } }
private static void handleDocumentAudience(final ProjectdocMetaData metadata, final Document annotation) { final String[] values = annotation.audience(); for (final String value : values) { metadata.addAudience(normalizeString(value)); } }
new PropertySetProjectdoc(metaData.getParent()); projectdoc.setName(metaData.getName()); projectdoc.setShortDescription(metaData.getShortDescription()); projectdoc.setSortKey(metaData.getSortKey()); projectdoc.setSpace(metaData.getSpace()); projectdoc.setSummary(metaData.getSummary()); projectdoc.setTitle(metaData.getTitle()); for (final String item : metaData.getAudience()) for (final String item : metaData.getAudience()) for (final String item : metaData.getCategories()) for (final String item : metaData.getNotes()) for (final String item : metaData.getParents()) for (final String item : metaData.getTags())
/** * Adds annotations of the given element. * * @param element the element whose annotations are to be fetched. * @return the document instance meta data for the given {@code element}. */ @Override public ProjectdocMetaData createMetaDataFromAnnotations(final Method element) { final ProjectdocMetaData metadata = new ProjectdocMetaData(parentMetadata); setDefaults(element, metadata); for (final Annotation annotation : element.getAnnotations()) { addMetadata(metadata, annotation); } return metadata; }
@SuppressWarnings(UNCHECKED) private void addTags(final ProjectdocMetaData metaData, final Element filing) { final Element tagsElement = filing.getChild("tags", getNs()); if (tagsElement != null) { final List<Element> tags = tagsElement.getChildren("tag", getNs()); for (final Element tag : tags) { final String tagName = tag.getTextNormalize(); metaData.addTag(tagName); } } }
@SuppressWarnings(UNCHECKED) private void addCategories(final ProjectdocMetaData metaData, final Element filing) { final Element categoriesElement = filing.getChild("categories", getNs()); if (categoriesElement != null) { final List<Element> categories = categoriesElement.getChildren("category", getNs()); for (final Element category : categories) { final String categoryName = category.getTextNormalize(); metaData.addCategory(categoryName); } } }
@SuppressWarnings(UNCHECKED) private void addParents(final ProjectdocMetaData metaData, final Element filing) { final Element parentsElement = filing.getChild("parents", getNs()); if (parentsElement != null) { final List<Element> parents = parentsElement.getChildren("parent", getNs()); for (final Element parent : parents) { final String parentName = parent.getTextNormalize(); metaData.addParent(parentName); } } }
/** * Adds a parent. Blank parent names or parents already part of the list will * be ignored. * * @param parent the parent to be added. */ public final void addParent(final String parent) { addElement(parents, parent); }
/** * Parses the comments for the given descriptor. * <p> * This method is overridden by subclasses to return their specific * implementation of the {@link DocumentMetaData}. * </p> * * @param descriptor the descriptor whose comments are requested to be parsed. * @param locale the locale to select the comments. * @return the comments for the given locale or the default comments, if the * locale is not supported. May be <code>null</code> if no information * is provided. */ @CheckForNull public ProjectdocMetaData parse(final PropertyDescriptor descriptor, final Locale locale) { try { final ProjectdocMetaData metaData = new ProjectdocMetaData(); parseBase(descriptor, locale, metaData); return metaData; } catch (final MetaDataException e) { LOG.warn("Cannot parse meta data for property descriptor '{}': {}", descriptor, e); return null; } }
/** * Adds a note. Blank notes or notes already part of the list will be ignored. * * @param note the note to be added. */ public final void addNote(final String note) { addElement(notes, note); }
/** * Adds a category. Blank category names or categories already part of the * list will be ignored. * * @param category the category to be added. */ public final void addCategory(final String category) { addElement(categories, category); }
/** * Adds the member to the intended audience of this document. * * @param member the audience member to add. */ public final void addAudience(final String member) { addElement(audience, member); }