public static void main(String[] args) throws Exception {
System.out.println("Scan http api");
ApiDocs apiDocs = scan(args);
Output output = createOutput(args);
String outputDir = getOutputDir(args);
System.out.println("Output class: " + output.getClass().getName());
System.out.println("Output dir: " + outputDir);
output.output(apiDocs, outputDir, getOutputArgs(args));
}
/**
* Search for the requested comments in the given method. If it does not have comments, return
* documentation from the overriden method if possible. If the overriden method does not exist or
* does not have documentation to inherit, search for documentation to inherit from implemented
* methods.
*
* @param input the input object used to perform the search.
* @return an Output object representing the documentation that was found.
*/
public static Output search(Input input) {
Output output = new Output();
if (input.isInheritDocTag) {
// Do nothing because "method" does not have any documentation.
// All it has it {@inheritDoc}.
} else if (input.taglet == null) {
// We want overall documentation.
output.inlineTags =
input.isFirstSentence ? input.method.firstSentenceTags() : input.method.inlineTags();
output.holder = input.method;
} else {
input.taglet.inherit(input, output);
}
if (output.inlineTags != null && output.inlineTags.length > 0) {
return output;
}
output.isValidInheritDocTag = false;
Input inheritedSearchInput = input.copy();
inheritedSearchInput.isInheritDocTag = false;
if (input.method.overriddenMethod() != null) {
inheritedSearchInput.method = input.method.overriddenMethod();
output = search(inheritedSearchInput);
output.isValidInheritDocTag = true;
if (output != null && output.inlineTags.length > 0) {
return output;
}
}
// NOTE: When we fix the bug where ClassDoc.interfaceTypes() does
// not pass all implemented interfaces, we will use the
// appropriate method here.
MethodDoc[] implementedMethods = (new ImplementedMethods(input.method, null)).build(false);
for (int i = 0; i < implementedMethods.length; i++) {
inheritedSearchInput.method = implementedMethods[i];
output = search(inheritedSearchInput);
output.isValidInheritDocTag = true;
if (output != null && output.inlineTags.length > 0) {
return output;
}
}
return output;
}
