Ir al contenido principal

Cómo crear la web para tu proyecto con Maven

En posts anteriores hemos visto cómo incluir la información de nuestro proyecto (desarrolladores, licencias, organización, ...) y el entorno de desarrollo (control de versiones, listas de correo, etc...) en nuestro pom.xml . También hemos visto cómo crear un proyecto multimódulo con Maven.

¿No estaría bien que nuestro proyecto tuviese una web con toda esta información? ¿Y si además os dijera que la podamos hacer de una manera muy sencilla con Maven? Con el plugin maven-site-plugin podemos hacerlo. Pero vamos paso por paso.

1) Creamos el proyecto


Primero necesitamos un proyecto con el que poder trastear. Para este ejemplo voy a utilizar un projecto opensource de Github. En concreto, el proyecto de una empresa poco conocida... Twitter creo que se llama ;D
Vosotros podéis utilizar otros proyectos de ejemplo, o crearos uno propio, lo que más os apetezca. Yo me voy a descargar el proyecto Twitter4J.

2) Añadimos el plugin maven-site-plugin en el pom.xml

<build>
  <plugins>
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-site-plugin</artifactId>
      <version>3.0</version>
      <configuration>
      <port>9000</port>
      <tempWebappDirectory>${basedir}/target/site/tmp</tempWebappDirectory>
      <locales>en,es</locales>
      <reportPlugins>
        <plugin>
           <groupId>org.apache.maven.plugins</groupId>
           <artifactId>maven-project-info-reports-plugin</artifactId>
           <version>2.2</version>
           <reports>
             <report>index</report>
             <report>project-team</report>
             <report>license</report>
             <report>mailing-list</report>
             <report>dependencies</report>
             <report>plugin-management</report>
             <report>cim</report>
             <report>issue-tracking</report>
             <report>scm</report>
             <report>summary</report>
           </reports>
         </plugin>
       </reportPlugins>
     </configuration>
   </plugin>
 </plugins>
</build>

Ver pom.xml completo del proyecto.

3) Desplegamos la web

mvn install -Dmaven.test.skip=true
mvn site:run

Accedemos a http://localhost:9000 y vemos que nuestro proyecto ya tiene una web!!!


Comentarios

Entradas populares de este blog

Leer un fichero properties con java.util.Properties

Los ficheros .properties son simples ficheros de texto que se suelen utilizar para guardar parámetros de configuración, en forma de pares clave-valor. Ejemplo de fichero: configuration.properties #User parameters user.name=Ana user.language=spanish Si estamos usando Java, podemos utilizar la clase java.util.Properties para leer los parámetros de este fichero: private static final String USER_NAME = "user.name"; private static final String USER_LANGUAGE = "user.language"; public void showProperties() throws Exception { Properties p = new Properties(); InputStream is = App.class.getResourceAsStream("/configuration.properties"); p.load(is); is.close(); String userName = p.getProperty(USER_NAME); String userCountry = p.getProperty(USER_LANGUAGE); System.out.println("userName: "+userName); System.out.println("userLanguage: "+userCountry); } Después de ejecutar este método, obtendríamos la siguiente salida: ...

JSF 2.0: Managed Beans (III)

Anteriormente ya hemos visto que cuando se declara un bean, tenemos que darle un scope: application, session, view, request, none. Un scope es un mapeo entre nombres y objetos que se almacena durante un determinado periodo de tiempo. En este post vamos a explicar cada uno de ellos. Si declaramos el bean desde el fichero faces-config.xml, indicamos el scope en <managed-bean-scope> y si queremos hacerlo con anotaciones, utilizaremos @{Application,Session,View,Request,None}Scoped Application Con este scope, se guarda la información durante toda la vida de la aplicación web, independientemente de todas las peticiones y sesiones que se realicen. Este bean se instancia con la primera petición a la aplicación y desaparece cuando la aplicación web se elimina del servidor. Si queremos que el bean se instancie antes de que se muestre la primera página de la aplicación, usamos la propiedad eager a true. @ManagedBean(eager=true) ó <managed-bean eager="true"> Session...

JSF 2.0: Message bundles

Los message bundles son ficheros .properties que guardan mensajes del tipo clave=valor. Si centralizamos todos los mensajes de nuestra aplicación en estos ficheros, es más fácil poder localizarlos si queremos realizar algún cambio y también nos ayuda para la internacionalización de la aplicación. Ejemplo: messages.properties (en src/java/com/examples) con dos mensajes name=Tu nombre: age=Tu edad: ¿Cómo los declaramos? 1) En cada página JSF donde lo necesitemos <f:loadBundle basename="com.examples.messages" var="msgs"/> 2) De manera global en faces-config.xml <application>      <resource-bundle>           <base-name>com.examples.messages</base-name>           <var>msg</var>      </resource-bundle> </application> Esta opción es más eficiente ya que sólo crea el bundle una v...