Volver al blog
Desarrollo / NOTAS DE DESARROLLO

HTTP Server: un pequeño servidor web para Java

Cómo integrar el servidor HTTP del proyecto en una aplicación Java y adaptar la carga de recursos a otro entorno.

Librería HTTP Server añadida al proyecto Java

HTTP Server es una pequeña librería que desarrollé en Java para servir recursos web desde una aplicación. El proyecto explora una forma de añadir comunicación HTTP a programas que se ejecutan sobre la JVM.

Preparar el proyecto de escritorio

En el ejemplo original utilicé Eclipse. El primer paso es añadir el JAR de la librería al directorio lib y registrarlo en el build path del proyecto.

Librería HTTP Server añadida al proyecto Java

Después, crea un directorio WebContent para los archivos que se van a publicar. La relación entre esa carpeta y los contextos determina qué recurso recibe cada petición.

Directorio WebContent del ejemplo

Registrar el manejador y arrancar el servidor

Este fragmento muestra la API del proyecto: define la dirección de escucha, crea el manejador, configura los recursos y registra index.html como documento inicial.

String host = "127.0.0.1";
int port = 8080;

HttpServer httpServer = new HttpServerImpl(host, port);
WebHandler webHandler = new WebHandler() {
    @Override
    public HttpResponse handleQuery(HttpRequest httpRequest) {
        // Método donde recibiremos las peticiones GET y POST
        // que contengan parámetros, por ejemplo de un formulario
        return HttpResponse.build(Status.NOT_FOUND);
    }

    @Override
    public InputStream toStream(File file) throws Exception {
        return new FileInputStream(file); // Fichero a Stream
    }
};
// Establece el directorio donde están los recursos web
webHandler.setContentFolder("WebContent");
// Registro de contexto de inicio
webHandler.getIndexMap().put("/", "/index.html");
// Establece el HTTP listener, en este caso webHandler
httpServer.setHttpListener(webHandler);
// Conectamos el servidor
httpServer.connect();

try (Scanner scanner = new Scanner(System.in)) {
    System.out.println("Press Enter to exit...");
    scanner.nextLine();
}

Con el servidor del ejemplo en ejecución, puedes abrir http://127.0.0.1:8080. El manejador de peticiones con parámetros devuelve un estado 404 hasta que se añada la lógica que necesite la aplicación.

Adaptar la carga de recursos

El proyecto original también muestra una adaptación para Android. La diferencia principal del ejemplo es cómo se obtiene el contenido de WebContent: en lugar de leer directamente un archivo del disco, se resuelve un recurso mediante el cargador de clases.

@Override
public InputStream toStream(File file) throws Exception {
  ClassLoader classLoader = Thread.currentThread().getContextClassLoader();
  String path = file.getPath();
  return classLoader.getResourceAsStream(path);
}

Declarar los permisos de red

El ejemplo de Android declara estos permisos en AndroidManifest.xml. La integración completa debe ajustarse al empaquetado y al ciclo de vida de la aplicación en la que se utilice.

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

La librería está escrita en Java sin dependencias de otros proyectos. Los fragmentos documentan su API original y pueden recorrerse junto con la implementación del repositorio.

Código fuente

Explorar el proyecto en GitHub

Escrito por Sergio Soriano

Desarrollo, curiosidad y proyectos compartidos.

Sobre Sergio Soriano