if (property.getDoc() != null) { writer.print(" /**\n"); writer.printf(" *%s\n", property.getDoc().toString().replace("\n", "\n * ")); writer.print(" */\n"); if (property.getDoc() != null) { writer.print(" /**\n"); writer.printf(" *%s\n", property.getDoc().toString().replace("\n", "\n * ")); writer.print(" */\n"); if (property.getDoc() != null) { writer.print(" /**\n"); writer.printf(" *%s\n", property.getDoc().toString().replace("\n", "\n * ")); writer.print(" */\n");
private void generateDoc(DataObjectModel model, CodeWriter writer) { Doc doc = model.getDoc(); if (doc != null) { writer.println("/**"); writer.println(" * A function providing a DSL for building [" + model.getType().getName() + "] objects."); writer.println(" *"); Token.toHtml(doc.getTokens(), " *", KotlinCodeGenHelper::renderLinkToHtml, "\n", writer); writer.println(" *"); model.getPropertyMap().values().stream().filter(filterProperties()).forEach(p -> { writer.print(" * @param " + p.getName() + " "); if (p.getDoc() != null) { String docInfo = Token.toHtml(p.getDoc().getTokens(), "", KotlinCodeGenHelper::renderLinkToHtml, "").replace("/*", "/<star>"); writer.print(docInfo); } writer.println(); }); writer.println(" *"); writer.println(" * <p/>"); writer.println(" * NOTE: This function has been automatically generated from the [" + model.getType().getName() + " original] using Vert.x codegen."); writer.println(" */"); } }
@Test public void testUncommentedProperty() throws Exception { DataObjectModel model = new GeneratorHelper().generateDataObject(UncommentedProperty.class); PropertyInfo propertyInfo = model.getPropertyMap().get("theProperty"); assertNull(propertyInfo.getDoc()); }
@Test public void testCommentedProperty() throws Exception { DataObjectModel model = new GeneratorHelper().generateDataObject(CommentedProperty.class); PropertyInfo setterProperty = model.getPropertyMap().get("setterProperty"); assertEquals(" Setter setter property description.\n", setterProperty.getDoc().getFirstSentence().getValue()); PropertyInfo getterProperty = model.getPropertyMap().get("getterProperty"); assertEquals(" Getter getter property description.\n", getterProperty.getDoc().getFirstSentence().getValue()); PropertyInfo getterAndSetterProperty = model.getPropertyMap().get("getterAndSetterProperty"); assertEquals(" GetterAndSetter setter property description.\n", getterAndSetterProperty.getDoc().getFirstSentence().getValue()); }
@Test public void testUncommentedPropertyOverridesAncestorCommentedProperty() throws Exception { DataObjectModel model = new GeneratorHelper().generateDataObject(UncommentedPropertyOverridesAncestorSuperCommentedProperty.class, AbstractCommentedProperty.class); PropertyInfo propertyInfo = model.getPropertyMap().get("theProperty"); Doc propertyDoc = propertyInfo.getDoc(); assertEquals(" The property description.\n", propertyDoc.getFirstSentence().getValue()); }
@Test public void testUncommentedPropertyOverridesCommentedProperty() throws Exception { DataObjectModel model = new GeneratorHelper().generateDataObject(UncommentedPropertyOverridesSuperCommentedProperty.class, AbstractCommentedProperty.class); PropertyInfo propertyInfo = model.getPropertyMap().get("theProperty"); Doc propertyDoc = propertyInfo.getDoc(); assertEquals(" The property description.\n", propertyDoc.getFirstSentence().getValue()); }
@Test public void testCommentedPropertyOverridesUncommentedProperty() throws Exception { DataObjectModel model = new GeneratorHelper().generateDataObject(CommentedPropertyOverridesUncommentedProperty.class, AbstractUncommentedProperty.class); PropertyInfo propertyInfo = model.getPropertyMap().get("theProperty"); Doc propertyDoc = propertyInfo.getDoc(); assertEquals(" The overriden property description.\n", propertyDoc.getFirstSentence().getValue()); }
@Test public void testCommentedPropertyInheritedFromCommentedProperty() throws Exception { DataObjectModel model = new GeneratorHelper().generateDataObject(CommentedPropertyInheritedFromCommentedProperty.class, AbstractCommentedProperty.class); PropertyInfo propertyInfo = model.getPropertyMap().get("theProperty"); Doc propertyDoc = propertyInfo.getDoc(); assertEquals(" The property description.\n", propertyDoc.getFirstSentence().getValue()); }
@Test public void testCommentedPropertyOverridesCommentedProperty() throws Exception { DataObjectModel model = new GeneratorHelper().generateDataObject(CommentedPropertyOverridesCommentedProperty.class, AbstractCommentedProperty.class); PropertyInfo propertyInfo = model.getPropertyMap().get("theProperty"); Doc propertyDoc = propertyInfo.getDoc(); assertEquals(" The overriden property description.\n", propertyDoc.getFirstSentence().getValue()); }