El SDK de Java de App Engine incluye un servidor web de desarrollo para probar la aplicación en tu equipo. El servidor web de desarrollo simula el entorno de ejecución Java de App Engine y todos sus servicios, incluido el almacén de datos. El complemento de Google para Eclipse puede ejecutar el servidor en el depurador de Eclipse. También puedes ejecutar el servidor de desarrollo desde la línea de comandos.
Si utilizas Eclipse y el complemento de Google, puedes ejecutar el servidor web de desarrollo en el depurador de Eclipse. Para ejecutar el servidor con la configuración predeterminada, selecciona el menú Run, Debug As > Web Application. Para un mayor control sobre cómo se inicia el servidor (por ejemplo, el puerto que utiliza), crea una nueva configuración de depuración a través del tipo de configuración "Web Application". Para obtener más información, consulta Complemento de Google para Eclipse.
También puedes ejecutar el servidor web de desarrollo desde una línea de comandos. El comando que debes ejecutar está en el directorio appengine-java-sdk/bin/ del SDK.
Si utilizas Windows, el comando es el siguiente:
appengine-java-sdk\bin\dev_appserver.cmd [options] war-location
Si utilizas Mac OS X o Linux, el comando es el siguiente:
appengine-java-sdk/bin/dev_appserver.sh [options] war-location
El comando adopta la ubicación del directorio WAR de tu aplicación como un argumento.
Para detener el servidor web, pulsa las teclas Control-C (en Windows, Mac o Linux).
Estos comandos son secuencias de comandos de envoltorio específicas del sistema operativo que ejecutan la clase Java com.google.appengine.tools.KickStart en appengine-java-sdk/lib/appengine-tools-api.jar.
El servidor web de desarrollo utiliza un archivo de tu equipo para simular el almacén de datos de App Engine. El archivo se denomina local_db.bin y se crea en el directorio WAR de tu aplicación, en el directorio WEB-INF/appengine-generated/. (No se sube con tu aplicación).
Este archivo se mantiene cada vez que se ejecuta el servidor web, por lo que los datos que almacenas siguen estando disponibles cuando vuelves a ejecutarlo. Para borrar el contenido del almacén de datos, cierra el servidor y, a continuación, elimina este archivo.
Como se describe en la sección Configuración de índices del almacén de datos, el servidor de desarrollo puede generar la configuración de índices del almacén de datos que necesita tu aplicación a partir de las consultas que este realiza al probarla. Esto genera un archivo denominado datastore-indexes-auto.xml en el directorio WEB-INF/appengine-generated/ del WAR. Para inhabilitar la configuración de índices automática, crea o edita el archivo datastore-indexes.xml en el directorio WEB-INF/ a través del atributo autoGenerate="false" del elemento <datastore-indexes>. Para obtener más información, consulta Configuración de índices del almacén de datos.
El servidor web de desarrollo simula las cuentas de Google con sus propias páginas de acceso y salida. Al ejecutarse en el servidor web de desarrollo, los métodos que generan URL de acceso y de salida devuelven URL a /_ah/login y /_ah/logout en el servidor local.
La página de acceso para el desarrollo incluye un formulario en el que puedes introducir una dirección de correo electrónico. En tu sesión se utilizará la dirección de correo electrónico que hayas introducido como usuario activo.
Para que la aplicación considere que el usuario conectado es un administrador, debes activar la casilla de verificación "Acceder como administrador" del formulario.
Cuando tu aplicación utiliza el API de extracción de URL para realizar una solicitud HTTP, el servidor web de desarrollo realiza la solicitud directamente desde tu equipo. El funcionamiento puede ser distinto del que muestra la aplicación al ejecutarse en App Engine utilizando un servidor proxy para el acceso a los sitios web.
El comando del servidor de desarrollo admite los siguientes argumentos de línea de comandos:
| 
--port=...El número de puerto que se debe utilizar para el servidor. El valor predeterminado es "8080".
--address=...La dirección de host que se debe utilizar para el servidor. Es posible que tengas que configurar este argumento para permitir el acceso al servidor de desarrollo desde otro equipo de tu red. Una dirección de 0.0.0.0 permite el acceso tanto de host local como de nombre de host. El valor predeterminado es "localhost".
--sdk_root=...Una ruta al SDK de Java de App Engine si es diferente de la ubicación de la herramienta.
--disable_update_checkSi se especifica, el servidor de desarrollo no contactará con App Engine para comprobar la disponibilidad de una nueva versión del SDK. De forma predeterminada, el servidor comprueba si existe una nueva versión al iniciarse e imprime un mensaje si hay disponible una nueva versión.
--helpImprime un mensaje de ayuda y finaliza.