Package com.google.gwt.core.ext

Class DelegatingGeneratorContext

  • All Implemented Interfaces:
    GeneratorContext
    Direct Known Subclasses:
    NonIncrementalGeneratorContext
    public abstract class DelegatingGeneratorContext
extends java.lang.Object
implements GeneratorContext
    An abstract generator context class which delegates all methods to a provided baseContext. Implementing classes can selectively override individual methods.

    • Constructor Detail

      • DelegatingGeneratorContext

        public DelegatingGeneratorContext​(GeneratorContext baseContext)
        Get a new instance wrapped from a base GeneratorContext implementation.

    • Method Detail

      • checkRebindRuleAvailable

        public boolean checkRebindRuleAvailable​(java.lang.String sourceTypeName)
        Description copied from interface: GeneratorContext
        Checks whether a rebind rule is available for a given sourceTypeName, such as can appear in a replace-with or generate-with rule.
        Specified by:
        checkRebindRuleAvailable in interface GeneratorContext
        Parameters:
        sourceTypeName - the name of a type to check for rebind rule availability.
        Returns:
        true if a rebind rule is available

      • getCachedGeneratorResult

        public CachedGeneratorResult getCachedGeneratorResult()
        Description copied from interface: GeneratorContext
        Get the cached rebind result that has been provided to the context, if available. The provided result will be the most recent previously generated result for the currently active rebind rule and requested type name.
        Specified by:
        getCachedGeneratorResult in interface GeneratorContext
        Returns:
        A CachedGeneratorResult object, if one has been provided to the context. Null is returned if there is no previous result available.

      • getPropertyOracle

        public PropertyOracle getPropertyOracle()
        Description copied from interface: GeneratorContext
        Gets the property oracle for the current generator context. Generators can use the property oracle to query deferred binding properties.
        Specified by:
        getPropertyOracle in interface GeneratorContext

      • getResourcesOracle

        public com.google.gwt.dev.resource.ResourceOracle getResourcesOracle()
        Description copied from interface: GeneratorContext
        Returns a resource oracle containing all resources that are mapped into the module's source (or super-source) paths. Conceptually, this resource oracle exposes resources which are "siblings" to GWT-compatible Java classes. For example, if the module includes com.google.gwt.core.client as a source package, then a resource at com/google/gwt/core/client/Foo.properties would be exposed by this resource oracle.
        Specified by:
        getResourcesOracle in interface GeneratorContext

      • getTypeOracle

        public TypeOracle getTypeOracle()
        Description copied from interface: GeneratorContext
        Gets the type oracle for the current generator context. Generators can use the type oracle to ask questions about the entire translatable code base.
        Specified by:
        getTypeOracle in interface GeneratorContext
        Returns:
        a TypeOracle over all the relevant translatable compilation units in the source path

      • isProdMode

        public boolean isProdMode()
        Description copied from interface: GeneratorContext
        Returns true if generators are being run to produce code for a production compile. Returns false for dev mode. Generators can use this information to produce code optimized for the target.
        Specified by:
        isProdMode in interface GeneratorContext

      • tryCreate

        public java.io.PrintWriter tryCreate​(TreeLogger logger,
                                     java.lang.String packageName,
                                     java.lang.String simpleName)
        Description copied from interface: GeneratorContext
        Attempts to get a PrintWriter so that the caller can generate the source code for the named type. If the named types already exists, null is returned to indicate that no work needs to be done. The file is not committed until GeneratorContext.commit(TreeLogger, PrintWriter) is called.
        Specified by:
        tryCreate in interface GeneratorContext
        Parameters:
        logger - a logger; normally the logger passed into the currently invoked generator, or a branch thereof
        packageName - the name of the package to which the create type belongs
        simpleName - the unqualified source name of the type being generated
        Returns:
        null if the package and class already exists, otherwise a PrintWriter is returned.

      • tryCreateResource

        public java.io.OutputStream tryCreateResource​(TreeLogger logger,
                                              java.lang.String partialPath)
                                       throws UnableToCompleteException
        Description copied from interface: GeneratorContext
        Attempts to get an OutputStream so that the caller can write file contents into the named file underneath the compilation output directory. The file is not committed until GeneratorContext.commitResource(TreeLogger, OutputStream) is called.
        Specified by:
        tryCreateResource in interface GeneratorContext
        Parameters:
        logger - a logger; normally the logger passed into the currently invoked generator, or a branch thereof
        partialPath - the name of the file whose contents are to be written; the name can include subdirectories separated by forward slashes ('/')
        Returns:
        an OutputStream into which file contents can be written, or null if a resource by that name is already pending or already exists
        Throws:
        UnableToCompleteException - if the resource could not be initialized for some reason, such as if the specified partial path is invalid