com.google.gwt.dev.javac

Class CompilationUnitArchive

java.lang.Object

com.google.gwt.dev.javac.CompilationUnitArchive

All Implemented Interfaces:

Serializable

public class CompilationUnitArchive
extends Object
implements Serializable

This class represents a file that contains CachedCompilationUnits that make up a module. Intended to work with other CompilationUnitArchives on the class path to allow a project to be compiled incrementally. Therefore, one file may not contain all dependent compilation units. To get all dependent compilation units, the program will need to load all archives, plus any files not contained in any archive. No mater how the archive is created, when serialized, the output file should be deterministic.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
CompilationUnitArchive(String topModuleName) Create an archive object.

Method Summary

Modifier and Type	Method and Description
void	addUnit(CompilationUnit unit) Add a compilation unit to the archive.
static CompilationUnitArchive	createFromFile(File location)
static CompilationUnitArchive	createFromStream(InputStream stream)
static CompilationUnitArchive	createFromURL(URL location)
CachedCompilationUnit	findUnit(String resourcePath)
String	getTopModuleName() The name of the module used to compile this archive.
Map<String,CachedCompilationUnit>	getUnits() Retrieve all units stored in this archive.
void	writeToFile(File location) Persists the units currently stored in the archive to the specified file.

Methods inherited from class java.lang.Object

equals, finalize, getClass, hashCode, toString

Constructor Detail

CompilationUnitArchive

public CompilationUnitArchive(String topModuleName)

Create an archive object. Note that data is retained in memory only until the writeToFile(File) method is invoked.

Parameters:

topModuleName - The name of the module used to compile this archive. That is, the original parameter passed to CompileModule.

Method Detail

createFromFile

public static CompilationUnitArchive createFromFile(File location)
                                             throws IOException,
                                                    ClassNotFoundException

Throws:

IOException

ClassNotFoundException

createFromStream

public static CompilationUnitArchive createFromStream(InputStream stream)
                                               throws IOException,
                                                      ClassNotFoundException

Throws:

IOException

ClassNotFoundException

createFromURL

public static CompilationUnitArchive createFromURL(URL location)
                                            throws IOException,
                                                   ClassNotFoundException

Throws:

IOException

ClassNotFoundException

addUnit

public void addUnit(CompilationUnit unit)

Add a compilation unit to the archive.

findUnit

public CachedCompilationUnit findUnit(String resourcePath)

getTopModuleName

public String getTopModuleName()

The name of the module used to compile this archive.

getUnits

public Map<String,CachedCompilationUnit> getUnits()

Retrieve all units stored in this archive.

writeToFile

public void writeToFile(File location)
                 throws IOException

Persists the units currently stored in the archive to the specified file. The file is immediately closed.

Throws:

IOException