Después de mucho tiempo tratando con la configuración de Glassfish y tras varios quebraderos de cabeza me he decidido a escribir este artículo para tratar de aclarar un poco el tema de servir contenido estático con Glassfish.
La propiedad alternatedocroot de Glassfish se asemeja en parte a la directiva Alias del servidor web Apache. Esta propiedad nos va a permitir acceder a carpetas que están fuera del contenedor del servidor. Una de las ventajas que nos puede proporcionar este hecho es que podemos tener las imágenes del proyecto fuera del mismo, disminuyendo así, por poner un ejemplo, el peso del fichero .war a desplegar.
Lo primero que hay que saber es que no hay que tocar la configuración de Glassfish para conseguir nuestro objetivo de servir contenido estático, sino que debemos modificar el fichero sun-web.xml de nuestro proyecto java. Para ello tenemos que añadir la siguiente propiedad dentro del elemento sun-web-app:
<sun-web-app ...>
....
<property name="alternatedocroot_1" value="from=/{ruta virtual}/*
dir={ruta física}" />
....
</sun-web-app ...>
Explicamos a continuación cada uno de los elementos. En el name tenemos que indicar la propiedad de la configuración de Glassfish que queremos definir para este proyecto. Si quisiéramos definir más de un elemento de este tipo simplemente habría que iterar el número del nombre del alternatedocroot.
El campo value se compone de dos partes:
1. Elemento from: indica a partir de qué dirección URL se ha de servir el contenido estático.
2. Elemento dir: indica la ruta física donde tengamos almacenado el contenido estático.
Con un ejemplo se ve claro:
<property name="alternatedocroot_1" value="from=/img/* dir=/srv/web/img/"/>
Esta propiedad está indicando al servidor Glassfish que las consultas realizadas sobre la dirección http://localhost/img/ serán resueltas buscando la información en la carpeta /srv/web/img/. En caso de tener el servidor sobre Windows la propiedad se escribiría de la siguiente forma:
<property name="alternatedocroot_1" value="from=/img/* dir=c:\server\img\"/>
Es importante tener en cuenta que el nombre de la última carpeta de la ruta física ha de coincidir con el nombre de la ruta virtual. En el caso en que pusiéramos dos carpetas en el elemento from, dichas carpetas deberían ser las últimas de la ruta física.
Para terminar voy a poner un enlace del que he sacado gran parte de esta información, aparte de los foros de Java de Sun y el “ensayo-error”. El enlace es del blog de Jan Luehe, uno de los desarrolladores de Glassfish:
Tags: configuración, Glassfish
Hola, puedes asesorarme con un alternatedocroot?? Hice pruebas en Windows y funciona perfecto. Pero en un unix no funciona, cuando navego al directorio el navegador muestra error 404 The requested resource () is not available. Hay que cambiar algo para que funcione en un directorio Unix?? Al parecer mi directorio es un Symbolic Link.
Puede que se trate de un problema de permisos. Asegúrate de que el usuario que ejecuta glassfish tenga permisos (e incluso te diría que fuera el propietario de la carpeta) para acceder a las carpetas y ficheros indicados en la redirección. Espero que te sirva de ayuda.
Saludos.