org.aspectj.tools.ajdoc.JavadocRunner Maven / Gradle / Ivy

Show more of this group Show more artifacts with this name
Show all versions of aspectjtools Show documentation

AspectJ tools most notably contains the AspectJ compiler (AJC). AJC applies aspects to Java classes during compilation, fully replacing Javac for plain Java classes and also compiling native AspectJ or annotation-based @AspectJ syntax. Furthermore, AJC can weave aspects into existing class files in a post-compile binary weaving step. This library is a superset of AspectJ weaver and hence also of AspectJ runtime.

There is a newer version: 1.9.22.1

Show newest version

/* *******************************************************************
 * Copyright (c) 1999-2001 Xerox Corporation,
 *               2002 Palo Alto Research Center, Incorporated (PARC).
 * All rights reserved.
 * This program and the accompanying materials are made available
 * under the terms of the Eclipse Public License v 2.0
 * which accompanies this distribution and is available at
 * https://www.eclipse.org/org/documents/epl-2.0/EPL-2.0.txt
 *
 * Contributors:
 *     Xerox/PARC     initial implementation
 *     Mik Kersten	  port to AspectJ 1.1+ code base
 * ******************************************************************/

package org.aspectj.tools.ajdoc;

import javax.tools.DocumentationTool;
import javax.tools.DocumentationTool.DocumentationTask;
import javax.tools.JavaFileObject;
import javax.tools.StandardJavaFileManager;
import javax.tools.ToolProvider;
import java.lang.reflect.InvocationTargetException;
import java.util.List;

/**
 * @author Mik Kersten
 */
class JavadocRunner {

	static void callJavadoc(String[] javadocArgs) {
		try {
			Class.forName("com.sun.tools.javadoc.Main")
				.getMethod("execute", String[].class)
				.invoke(null, new Object[] { javadocArgs });
		}
		catch (ClassNotFoundException | NoSuchMethodException | IllegalAccessException | InvocationTargetException e) {
			throw new RuntimeException("Failed to invoke javadoc", e);
		}
	}

	public static void callJavadocViaToolProvider(Iterable options, List files) {
		DocumentationTool docTool = ToolProvider.getSystemDocumentationTool();
		StandardJavaFileManager fileManager = docTool.getStandardFileManager(null, null, null);
		Iterable fileObjects = fileManager.getJavaFileObjects(files.toArray(new String[0]));
		DocumentationTask task = docTool.getTask(
			null, // default output writer (System.err)
			null, // default file manager
			null, // default diagnostic listener
			null, // default doclet class
			options,
			fileObjects
		);
		task.call();
	}
}