writer.print(param.getName()); writer.print(" "); if (param.getDescription() != null) { Token.toHtml(param.getDescription().getTokens(), "", this::renderLinkToHtml, "", writer);
private void generateDoc(ClassModel model, MethodInfo method, PrintWriter writer) { Doc doc = method.getDoc(); if (doc != null) { writer.print("/**\n"); Token.toHtml(doc.getTokens(), " *", KotlinCodeGenHelper::renderLinkToHtml, "\n", writer); writer.print(" *\n"); method.getParams() .stream() .limit(method.getParams().size() - 1) .forEach(p -> { writer.print(" * @param " + p.getName() + " "); if (p.getDescription() != null) { String docInfo = Token.toHtml(p.getDescription().getTokens(), "", KotlinCodeGenHelper::renderLinkToHtml, ""); writer.print(docInfo); } writer.print("\n"); }); if (!method.getReturnType().isVoid()) { writer.print(" * @return "); if (method.getReturnDescription() != null) { String docInfo = Token.toHtml(method.getReturnDescription().getTokens(), "", KotlinCodeGenHelper::renderLinkToHtml, ""); writer.print(docInfo); } } writer.print(" *\n"); writer.print(" * <p/>\n"); writer.print(" * NOTE: This function has been automatically generated from the [" + model.getType().getName() + " original] using Vert.x codegen.\n"); writer.print(" */\n"); } }
writer.print(param.getName()); writer.print(" "); if (param.getDescription() != null) { Token.toHtml(param.getDescription().getTokens(), "", this::renderLinkToHtml, "", writer);
doc += renderDoc(type, commentedIndentation, method.getDoc()); for (ParamInfo param : method.getParams()) { if (param.getDescription() != null) { doc += commentedIndentation; doc += " @param " + param.getName()+ " "; doc += convertLink(param.getDescription()); if (param.getType().getKind() == ClassKind.DATA_OBJECT) { doc += " see " + renderDataObjectHtmlLink(type, param.getType());
private MethodInfo genOverloadedMethod(MethodInfo method, Class streamType) { List<ParamInfo> params = null; int count = 0; for (ParamInfo param : method.getParams()) { if (param.getType().isParameterized() && param.getType().getRaw().getName().equals("io.vertx.core.streams.ReadStream")) { if (params == null) { params = new ArrayList<>(method.getParams()); } ParameterizedTypeInfo paramType = new io.vertx.codegen.type.ParameterizedTypeInfo( io.vertx.codegen.type.TypeReflectionFactory.create(streamType).getRaw(), false, java.util.Collections.singletonList(((ParameterizedTypeInfo) param.getType()).getArg(0)) ); params.set(count, new io.vertx.codegen.ParamInfo( param.getIndex(), param.getName(), param.getDescription(), paramType )); } count = count + 1; } if (params != null) { return method.copy().setParams(params); } return null; } }
@Test public void testMethodComments() throws Exception { ClassModel model = new GeneratorHelper().generateClass(InterfaceWithComments.class); assertEquals(InterfaceWithComments.class.getName(), model.getIfaceFQCN()); assertEquals(InterfaceWithComments.class.getSimpleName(), model.getIfaceSimpleName()); assertTrue(model.getReferencedTypes().isEmpty()); assertTrue(model.getSuperTypes().isEmpty()); List<MethodInfo> methods = model.getMethods(); assertEquals(2, methods.size()); Doc comment1 = new Doc(" Comment 1 line 1\n Comment 1 line 2", null, Arrays.asList(new Tag("param", "str the_string"), new Tag("return", "the_return_value\n"))); Doc comment2 = new Doc(" Comment 2 line 1\n Comment 2 line 2\n"); checkMethod(methods.get(0), "foo", 1, String.class, MethodKind.OTHER, comment1); assertEquals("str", methods.get(0).getParams().get(0).getName()); assertEquals("the_string", methods.get(0).getParams().get(0).getDescription().toString()); checkMethod(methods.get(1), "bar", 1, "void", MethodKind.OTHER, comment2); }
if (param.getDescription() != null) { Token.toHtml(param.getDescription().getTokens(), "", this::renderLinkToHtml, "", writer); writer.print(" ");