Usar a API Modules

A API Modules fornece funções que devolvem informações sobre o ambiente de funcionamento atual (módulo, versão e instância).

A API Modules também tem funções que obtêm o endereço de um módulo, uma versão ou uma instância. Isto permite que uma aplicação envie pedidos de uma instância para outra, tanto nos ambientes de desenvolvimento como de produção.

O seguinte exemplo de código mostra como obter o nome do módulo e o ID da instância para um pedido:

import com.google.appengine.api.modules.ModulesService;
import com.google.appengine.api.modules.ModulesServiceFactory;

ModulesService modulesApi = ModulesServiceFactory.getModulesService();

// Get the service name handling the current request.
String currentModuleName = modulesApi.getCurrentModule();
// Get the instance handling the current request.
int currentInstance = modulesApi.getCurrentInstance();

O ID da instância de um módulo dimensionado automaticamente é devolvido como um valor único codificado em base64, por exemplo, e4b565394caa.

Pode comunicar entre módulos na mesma app obtendo o nome do anfitrião do módulo de destino:

O seguinte exemplo de código mostra como obter o nome do módulo e o ID da instância para um pedido:

import com.google.appengine.api.modules.ModulesService;
import com.google.appengine.api.modules.ModulesServiceFactory;

import java.net.MalformedURLException;
import java.net.URL;
import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.io.IOException;

// ...

ModulesService modulesApi = ModulesServiceFactory.getModulesService();

// ...
    try {
        URL url = new URL("http://" +
            modulesApi.getVersionHostname("my-backend-service","v1") +
            "/fetch-stats");
        BufferedReader reader = new BufferedReader(
            new InputStreamReader(url.openStream()));
        String line;

        while ((line = reader.readLine()) != null) {
            // Do something...
        }
        reader.close();

    } catch (MalformedURLException e) {
        // ...
    } catch (IOException e) {
        // ...
    }

Também pode usar o serviço URL Fetch.