Package com.sun.tools.sjavac

Class CompileJavaPackages

java.lang.Object

com.sun.tools.sjavac.CompileJavaPackages

All Implemented Interfaces:

Transformer

public class CompileJavaPackages
extends Object
implements Transformer

This transform compiles a set of packages containing Java sources. The compile request is divided into separate sets of source files. For each set a separate request thread is dispatched to a javac server and the meta data is accumulated. The number of sets correspond more or less to the number of cores. Less so now, than it will in the future.

This is NOT part of any supported API. If you write code that depends on this, you do so at your own risk. This code and its internal interfaces are subject to change or deletion without notice.

Constructor Summary

Constructors

Constructor and Description
CompileJavaPackages()

Method Summary

Modifier and Type	Method and Description
void	setExtra(String e)
void	setExtra(String[] a)
boolean	transform(Map<String,Set<URI>> pkgSrcs, Set<URI> visibleSources, Map<URI,Set<String>> visibleClasses, Map<String,Set<String>> oldPackageDependents, URI destRoot, Map<String,Set<URI>> packageArtifacts, Map<String,Set<String>> packageDependencies, Map<String,String> packagePubapis, int debugLevel, boolean incremental, int numCores, PrintStream out, PrintStream err) The transform method takes a set of package names, mapped to their source files and to the pubapis of the packages.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

CompileJavaPackages

public CompileJavaPackages()

Method Detail

setExtra

public void setExtra(String e)

Specified by:

setExtra in interface Transformer

setExtra

public void setExtra(String[] a)

Specified by:

setExtra in interface Transformer

transform

public boolean transform(Map<String,Set<URI>> pkgSrcs,
                         Set<URI> visibleSources,
                         Map<URI,Set<String>> visibleClasses,
                         Map<String,Set<String>> oldPackageDependents,
                         URI destRoot,
                         Map<String,Set<URI>> packageArtifacts,
                         Map<String,Set<String>> packageDependencies,
                         Map<String,String> packagePubapis,
                         int debugLevel,
                         boolean incremental,
                         int numCores,
                         PrintStream out,
                         PrintStream err)

Description copied from interface: Transformer

The transform method takes a set of package names, mapped to their source files and to the pubapis of the packages. The transform implementation must: store the names of the generated artifacts for each package into package_artifacts store found dependencies to other packages into the supplied set package_dependencies store the public api for a package into the supplied set package_pubapis Any benign messages as a result of running the transform are written into stdout, and errors are written to stderr. The debug_level can be 0=silent (only warnings and errors) 1=normal 2=verbose 3 or greater=debug setExtra is used to set the extra information information that can be passed on the command line to the smart javac wrapper. If sjavac is building incrementally from an existing javac_state, the var incremental is true. The transformer will only be called if some source in the package (or dependency) has a modified timestamp. Thus the transformer might get called with many sources, of which only one has changed. The transformer is allowed to regenerate all artifacts but a better transformer will only write those artifacts that need updating. However the transformer must verify that the existing artifacts really are there! and it must always update package_artifacts, package_dependencies, and package_pubapis correctly. This means that at least for Java source, it will always have to recompile the sources. The transformer is allowed to put files anywhere in the dest_root. An example of this is, can be the META-INF transformer that copy files below META-INF directories to the single META-INF directory below dest_root. False is returned if there was an error that prevented the transform. I.e. something was printed on stderr. If num_cores is set to a non-zero value. The transform should attempt to use no more than these number of threads for heavy work.

Specified by:

transform in interface Transformer