ModulesService (Google App Engine API for Java)

com.google.appengine.api.modules

Interface ModulesService



  • public interface ModulesService
    ModulesService allows the application to fetch information about its own module and version information. Additionally, the service has the ability to start, stop and change the number of instances associated with a module version.
    • Method Summary

      All Methods Instance Methods Abstract Methods 
      Modifier and Type Method and Description
      java.lang.String getCurrentInstanceId()
      Get the id of the current instance.
      java.lang.String getCurrentModule()
      Get the name of the current module.
      java.lang.String getCurrentVersion()
      Get the name of the current version.
      java.lang.String getDefaultVersion(java.lang.String module)
      Returns the name of the default version for the module.
      java.lang.String getInstanceHostname(java.lang.String module, java.lang.String version, java.lang.String instance)
      Returns a host name to use for the given module, version and instance.
      java.util.Set<java.lang.String> getModules()
      Get the set of modules that are available to the application.
      int getNumInstances(java.lang.String module, java.lang.String version)
      Returns the number of instances that are available to the given manual scaling module version.
      java.lang.String getVersionHostname(java.lang.String module, java.lang.String version)
      Returns a host name to use for the given module and version.
      java.util.Set<java.lang.String> getVersions(java.lang.String module)
      Returns the set of versions that are available to the given module.
      void setNumInstances(java.lang.String module, java.lang.String version, long instances)
      Set the number of instances that are available to the given manual scaling module version.
      java.util.concurrent.Future<java.lang.Void> setNumInstancesAsync(java.lang.String module, java.lang.String version, long instances)
      Starts an asynchronous call to setNumInstances(java.lang.String, java.lang.String, long) and returns a Future to obtain its eventual result.
      void startVersion(java.lang.String module, java.lang.String version)
      Starts the given manual scaling or basic scaling module version.
      java.util.concurrent.Future<java.lang.Void> startVersionAsync(java.lang.String module, java.lang.String version)
      Starts an asynchronous call to startVersion(java.lang.String, java.lang.String) and returns a Future to obtain its eventual result.
      void stopVersion(java.lang.String module, java.lang.String version)
      Stops the given manual scaling or basic scaling module version.
      java.util.concurrent.Future<java.lang.Void> stopVersionAsync(java.lang.String module, java.lang.String version)
      Starts an asynchronous call to stopVersion(java.lang.String, java.lang.String) and returns a Future to obtain its eventual result.
    • Method Detail

      • getCurrentModule

        java.lang.String getCurrentModule()
        Get the name of the current module. ("default" if modules are not enabled for this app)
        Returns:
        the name of the module
      • getCurrentVersion

        java.lang.String getCurrentVersion()
        Get the name of the current version.
        Returns:
        the name of the version
      • getCurrentInstanceId

        java.lang.String getCurrentInstanceId()
        Get the id of the current instance.
        Returns:
        current instance id
      • getModules

        java.util.Set<java.lang.String> getModules()
        Get the set of modules that are available to the application.
        Returns:
        Set of modules available to the application
        Throws:
        ModulesException - when ModulesService fails to perform the requested operation.
      • getVersions

        java.util.Set<java.lang.String> getVersions(java.lang.String module)
        Returns the set of versions that are available to the given module.
        Parameters:
        module - the name of the module or null for the current module
        Throws:
        ModulesException - when ModulesService fails to perform the requested operation.
      • getDefaultVersion

        java.lang.String getDefaultVersion(java.lang.String module)
        Returns the name of the default version for the module.
        Parameters:
        module - the name of the module or null for the current module
        Throws:
        ModulesException - when ModulesService fails to perform the requested operation.
      • getNumInstances

        int getNumInstances(java.lang.String module,
                            java.lang.String version)
        Returns the number of instances that are available to the given manual scaling module version.
        Parameters:
        module - the name of the module or null for the current module
        version - the name of the version or null for the current version
        Throws:
        ModulesException - when ModulesService fails to perform the requested operation.
      • setNumInstances

        void setNumInstances(java.lang.String module,
                             java.lang.String version,
                             long instances)
        Set the number of instances that are available to the given manual scaling module version. Changing the number of instances is an asynchronous process so this may return before added instances begin serving or removed instances stop serving.
        Parameters:
        module - the name of the module or null for the current module
        version - the name of the version or null for the current version
        instances - the number of instances to set
        Throws: