´ noma de Madrid Universidad Auto ´ tica Departamento de Informa

Proyecto de Sistemas Inform´ aticos Pr´ actica - 0

Roberto Marabini Ruiz

Proyecto de Sistemas Inform´aticos

Pr´actica-0

´Indice 1. Objetivos 1.1. Programaci´on con control de versiones . . . . . . . . . . . . . . . . .

2 2

2. Trabajo a Entregar Durante la Primera Semana de la pr´ actica

3

3. Trabajo a Entregar Durante la Segunda Semana de la pr´ actica

5

4. Material a entregar en la pr´ actica

5

A. Ap´ endice: Control de Versiones en Netbeans A.1. Crear un repositorio con el contenido de un proyecto . . A.2. Descargar el Contenido de un Repositorio . . . . . . . . A.3. Subir cambios al repositorio . . . . . . . . . . . . . . . . A.4. Actualizar/revertir cambios del repositorio . . . . . . . . A.5. A˜ nadir un Nuevo Fichero/Enviar Cambios del repositorio A.6. Crear Branches . . . . . . . . . . . . . . . . . . . . . . .

6 6 6 6 7 7 7

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

B. Ap´ endice: Instalando Aplicaciones en Glassfish

7

C. Bibliograf´ıa

8

1

Proyecto de Sistemas Inform´aticos

1.

Pr´actica-0

Objetivos

El objetivo de esta pr´actica es introducir el entorno en el que se desarrollar´an las pr´acticas de la asignatura. Se estudiar´a las siguientes herramientas: El IDE Netbeams. Herramientas de control de versiones: SVN. El servidor de aplicaciones Glassfish. El objetivo principal de la pr´actica es que el estudiante sea capaz de instalar y utilizar el entorno descrito en esta secci´on.

1.1.

Programaci´ on con control de versiones

En este curso, se usar´a la herramienta SVN para facilitar la colaboraci´on entre los miembros del grupo de pr´acticas, de tal forma que puedan compartir y colaborar de forma remota y as´ıncrona. SVN cuenta con dos componentes: un programa servidor, que hace de repositorio de los ficheros y las distintas versiones de ´estos y un programa cliente, que controla la descarga de ficheros y la actualizaci´on de ´estos. El programa servidor se encuentra instalado en la m´aquina www.assembla.com. Conectaros a www.assembla.com y registraros. Como nombre de usuario usad psi nombre apellido. El programa cliente est´a instalado en los equipos de los laboratorios, y est´a a su vez integrado en Netbeans, lo cual facilita la gesti´on de versiones sobre el IDE. Assembla es una instituci´on sin ninguna conexi´on con la UAM por ello recomendamos a los alumnos que hagan sus propios backups del c´ odigo de las pr´ acticas. La gesti´on de versiones con SVN es relativamente compleja, por lo que en estas pr´acticas s´olo veremos los conceptos b´asicos de uso de la herramienta. La gesti´on de versiones se puede realizar sobre l´ınea de comandos enteramente, se recomienda a los estudiantes que lean este tutorial b´asico de SVN (en ingl´es): http://svnbook.redbean.com/en/1.6/svn.tour.html. Un tutorial m´as extenso se puede encontrar en: http://svnbook.red-bean.com/en/1.6/index.html.

2

Proyecto de Sistemas Inform´aticos

Pr´actica-0

Netbeans integra por defecto la herramienta SVN para control de versiones de proyectos. En el ap´endice A se ejemplifica el uso de Netbeans para las acciones m´as usuales con SVN.

2.

Trabajo a Entregar Durante la Primera Semana de la pr´ actica

Como parte de la documentaci´on del curso existe un fichero pdf titulado: “Java EE 6 Development with NetBeans 7”. Ojead el primer cap´ıtulo titulado “Getting started with netbeans”. Los conceptos desarrollados en este primer cap´ıtulo os resultar´an familiares en su mayor´ıa. El cap´ıtulo comienza describiendo como instalar Netbeans lo cual solo ser´a necesario si deseas instalarlo en vuestros ordenadores (en este caso seleccionad el paquete llamado Java EE). A continuaci´on describe la integraci´on de Netbeans con el servidor de aplicaciones Glassfish y con las diversas bases de datos. El cap´ıtulo acaba mostrando como crear una aplicaci´on y comentando diversas ayudas a la programaci´on implementadas en el programa. Leed el primer apartado del cap´ıtulo 2: “Creating our first web application” y cread una primera aplicaci´on web tal y como se describe en el texto. La entrega del c´odigo generado en este primer d´ıa debe seguir la pauta explicada a continuaci´on:

3

Proyecto de Sistemas Inform´aticos

Pr´actica-0

Ejercicio 1: Control de versiones Conectaros a www.assembla.com y registraros Cread un repositorio al que deben tener acceso los tres miembros de vuestro grupo y el usuario “rmarabini2” (usar la pesta˜ na Team) Subid el c´odigo necesario para crear la aplicaci´on cuya descripci´on ACABA en la p´agina 53 (esto es realizar el ejercicio hasta la secci´on titulada Modifiying Netbeans generated code). El c´odigo deber´a subirse de la siguiente manera: • El primer miembro del grupo deber´a crear un proyecto e importarlo al repositorio creado en assembla. (Secci´on “creating our first web application”) • En un ordenador diferente el segundo miembro del grupo (usando su usuario en el repositorio) deber´a: (1) bajarse el repositorio, (2) modificar el fichero index.jsp para que escriba “Hola Mundo” en lugar de “Hello Word“ y (3) subir la modificaci´on al repositorio • En un ordenador diferente el tercer miembro del grupo (usando su usuario en el repositorio) deber´a: (1) bajarse el repositorio, (2) crear un fichero llamado index2.jsp que sea id´entico al fichero index.jsp pero cambiando el saludo ”Hola Mundo“ por ”Hallo Welt“ y (3) subir las modificaciones al repositorio • Una vez que est´e preparada para entregar esta primera parte de la practica cread una rama o ”branch“ con ella y llamadla Practica0Dia1. En el Ap´endice A hay instrucciones sobre como crear ramas.

4

Proyecto de Sistemas Inform´aticos

3.

Pr´actica-0

Trabajo a Entregar Durante la Segunda Semana de la pr´ actica

Realizar el ejercicio descrito en el cap´ıtulo 2 desde la p´agina 53 (“Modifying NetBeans’ generated code”) hasta la p´agina 81 (no es necesario realizar los ejercicios descritos en la secci´on “Securing Web application” y p´aginas siguientes). Al acabar el ejercicio no olvid´eis crear un fichero “.war” y comprobar que se puede utilizar para desplegar una nueva aplicaci´on en un ordenador diferente al usado para su creaci´on (ver Ap´endice B). Este fichero war ser´a utilizado para corregir vuestra pr´actica. Ejercicio 2 - Una Primera Aplicaci´on Web (a realizar durante la segunda semana): Cread un nuevo proyecto WEB e importarlo al repositorio creado en assembla. Completad el ejercicio descrito en las p´aginas 53 y siguientes (hasta la p´agina 81). No os olvid´eis de ir subiendo los diferentes ficheros a medida ´ que los vais creando. USAD EL REPOSITORIO DE SVN COMO UNICO PUNTO DE INTERCAMBIO DE FICHEROS. Una vez que est´e preparada para entregar esta segunda parte de la practica cread una rama o ”branch“ con ella y llamadla Practica0Dia2.

4.

Material a entregar en la pr´ actica

Esta pr´actica no requiere la entrega de ninguna memoria. Utilizando la aplicaci´on moodle se debe entregar el fichero war generado en el Ejercicio 2.

5

Proyecto de Sistemas Inform´aticos

A.

Pr´actica-0

Ap´ endice: Control de Versiones en Netbeans

Netbeans integra por defecto la herramienta SVN para control de versiones de proyectos. A continuaci´on se ejemplifica el uso de Netbeans para las acciones m´as usuales con SVN.

A.1.

Crear un repositorio con el contenido de un proyecto Crea un nuevo proyecto (de tipo javaweb → web application) Seleciona Team→subversion→import en el repositorio Introduzcan los datos del repositorio creado en assembla.com

A.2.

Descargar el Contenido de un Repositorio Selecciona la opci´on Team→Subversion→checkout. La primera vez que hagamos el checkout, deberemos introducir el login de usuario, el password y la URL del repositorio que queremos descargar. En la siguiente pantalla el programa nos preguntar´a que carpeta de nuestro repositorio queremos escoger. Elegir la carpeta deseada.

A.3.

Subir cambios al repositorio

Cuando un miembro del grupo tiene c´odigo en funcionamiento en el proyecto, puede usar la funci´on de commit de SVN para subir los cambios al repositorio, y que el resto de miembros del grupo pueda acceder a ´estos. Adem´as, esta funci´on de commit permite salvar estados intermedios de la pr´actica, de tal forma que posteriores cambios puedan revertirse si ha habido alg´ un problema. Para subir cambios se “clickar´a” con el bot´on derecho en el proyecto y se seleccionar´a la opci´on subversi´on→commit. Aparecer´a una ventana en la que podemos inspeccionar qu´e contenido ha sido modificado y qu´e contenido queremos a˜ nadir

6

Proyecto de Sistemas Inform´aticos

A.4.

Pr´actica-0

Actualizar/revertir cambios del repositorio

Si queremos actualizar cambios de un repositorio deberemos seleccionar la opci´on subversi´on→update, con lo que cualquier cambio que hayan realizado nuestros compa˜ neros ser´a integrado en nuestra copia local. Es importante entender que subversi´on intenta integrar los cambios sobre la copia local, aunque ´estos se hayan realizado sobre un fichero modificado localmente. En el caso de que esta integraci´on (merge) no haya podido ser realizada, se generar´a un conflicto, que el usuario deber´a revisar para acabar de integrar los cambios manualmente y marcar estos cambios como resueltos. Subversion nunca pisar´a cambios locales del usuario, incluso aunque ´estos no hayan sido subidos al repositorio. Subversion permite ir a cualquier estado anterior de un repositorio, seleccionando subversi´on→update to. . . , se puede seleccionar a qu´e versi´on queremos revertir nuestros cambios. Hay que tener cuidado, porque en este caso cualquier modificaci´on local que no haya sido subida al servidor se perder´a.

A.5.

A˜ nadir un Nuevo Fichero/Enviar Cambios del repositorio

Si queremos a˜ nadir un nuevo fichero al repositorio o enviar las u ´ltimas modificaciones elegir: team→subversion→commit

A.6.

Crear Branches

Selecciona Team→Subversion→copy to. En la nueva ventana identifica la linea llamada “repository location”, selecciona “browse” y “new folder”. Escribe el nombre de la nueva “branch” y presiona OK. Para acabar escribe una peque˜ na descripci´on de la nueva “branch” y presiona “copy”.

B.

Ap´ endice: Instalando Aplicaciones en Glassfish

Para hacer un deployment (instalaci´on) de un proyecto de java que generamos con netbeans se suele crear un archivo u ´nico de instalaci´on (.war) que contiene dentro

7

Proyecto de Sistemas Inform´aticos

Pr´actica-0

todo el proyecto. El fichero se crea al ejecutar May´ uscula-F11 o “run→clean and build” y se almacena en la carpeta “dist” dentro de la carpeta del proyecto. Netbeans ejecuta el “deployment” de forma autom´atica en el servidor local y puede configurarse para que lo ejecute en un servidor remoto. A continuaci´on se describe como efectuar el deployment de forma manual. Levantar un dominio del servidor Glassfish: asadmin start-domain domain1 Instalar el projecto contenido en el fichero .war: una vez que el dominio est´e levantado ejecutar asadmin deploy –contextroot myapp [warlocation]/myapp.war Lo que har´a el proyecto accesible en el URL http://remotehost:8080/myapp. En caso de necesidad se puede eliminar una aplicaci´on del servidor o dar de baja el servidor con los comandos: asadmin stop-domain domain1 asadmin undeploy myapp respectivamente.

C.

Bibliograf´ıa Netbeans y Subversion: http://netbeans.org/kb/docs/ide/subversion.html

8