Hacer un servicio de SAOP con Apache Netbeans 12

 

Vamos a crear un simple servicio de SOAP con Java y Netbeans 12. Para esto vamos a requerir la version 1.8 de Java ya que sin esta no vamos apoder crear el servicio.

Lo primero que vamos hacer es crear un proyecto nuevo usando Maven. Dentro los templates de Maven tenemos que buscar el tipo de proyecto llamado Web Application, como se puede ver en la siguiente imagen.

Luego de esto vamos a tener una ventana con algunas otras opciones que se tienen que completar. Por ejemplo el nombre del proyecto, el Group Id que podemos dejarlo como esta y la direccion donde queremos guardar nuestro proyecto. Adicional a esto el nombre del paquete donde vamos a guardar nuestro código.

 

Para este proyecto vamos a seleccionar Java 7 y Glassfish que es nuestro servidor web.

Luego le damos finalizar.

Si no tenemos instalada la versión de Java 1.8 vamos a ver una ventana como la siguiente donde se tiene que seleccionar el JDK 1.8

 

Ahora tenemos que instalar el JDK 1.8 luego de esto simplemente lo tenemos que agregar al Netbeans. Como se puede ver en la siguiente imagen. Seleccionamos esta plataforma para el desarrollo de nuestro programa.

Cuando el proyecto este listo debemos dar clic derecho sobre el proyecto y seleccionar el menú de otros. En este menú vamos a poder ver una serie de opciones para crear diferentes archivos. Vamos a ir a la carpeta web services donde esta el tipo Web Service. Es la primera opción en esta carpeta. Esta es la que tenemos que utilizar.

Lo que tenemos que realizar ahora es simplemente agregar el nombre de nuestro servicio y el paquete donde se desea guardar. Con estos dos valores tenemos que dar finalizar y estamos listos para continuar con nuestro servicio de SOAP.

Como se puede observar ya tenemos listo el código para iniciar a escribir nuestro nuevo servicio.

Tenemos un método que se llama Hello, solamente tenemos que publicar el servicio a nuestro servidor de Galssfish o correr la aplicación. 

Apache Netbeans 12 Payara y JDK14 Para crear servicios de Rest

Hace unos días tenía que hacer un servicio de Rest pero no quería utilizar los JDK anteriores al 14 de Java. encontré que se puede utilizar un proyecto de Micro Payara con JEE8 (Jakarta) para crear esto.

Lo primero que vamos a hacer es crear un proyecto nuevo en Netbeans usando Maven.

Buscamos el que dice Payara Micro Application, damos clic en siguiente luego de esto debemos de asignarle un nombre a nuestro proyecto y damos clic en siguiente.

En mi caso vamos a seleccionar la versión 5.201 del servidor de Payara. Luego clic en finalizar.

Dentro de mi proyecto voy a crear un paquete nuevo que se va a llamar codebase

En este paquete vamos a crear unas clases POJO que utilizaremos para generar nuestros objetos de Json. Vamos a crear una clase que se llama Article donde vamos a tener unas variables para describir artículos que tendremos en nuestro sistema.

Ahora si es tiempo de agregar nuestro primero servicio de Rest. Siguiendo los pasos a continuación

1.       Clic derecho sobre el proyecto

2.       New

3.       Clic sobre otros

4.       Buscamos la carpeta que dice Web Services

5.       Y seleccionamos Restful Web Services From Patterns

Ahora hacemos clic en siguiente hasta llegar a esta pantalla. Donde tenemos que hacer algunos cambios. Primero el paquete donde queremos guardar las clases relacionadas a nuestros APIs, el path donde estará ubicado nuestro servicio, el nombre del recurso. Es importante no olvidar cambiar el MIME Type a json que es la forma que nuestro API va a responder. El campo final no es tan importante cambiarlo ya que lo podemos hacer después para retornar una lista de objetos.

Cuando tenemos todo listo damos clic en finalizar.

Esto genera un nuevo paquete con dos clases. La clase que tiene nuestra definición del API que seria ArticleResource y la clase con la configuración de nuestro servicio. Vamos a ir a la clase ArticleResource.

 

La clase AricleResource va a tener los verbos de Rest. Para nuestro ejemplo vamos a utilizar únicamente el verbo de GET.

En este método vamos a inicializar la lista como se puede ver en la línea 45 y la vamos a retornar.

Ya estamos listos para correr nuestra aplicación.

Cuando corremos nuestra aplicación se va a correr un servidor de Payara en le console out de Netbeans vamos a poder ver la dirección que podemos usar para ver nuestro servicio en el browser.

En el output vamos a poder ver el URL en mi caso esta corriendo sobre el puerto 8081.

Cuando lo abrimos en el navegador de internet se puede ver el resultado de nuestro API de artículos que muestra un json.

Ejemplo

JDK 14 Switch

Con JDK14 tenemos otra forma de usar la operación switch para seleccionar entre diferentes opciones. Esta es una característica preview, por lo que tenemos que asegurarnos de marcarla de esta manera para poder ejecutarla.  

Lo primero que vamos hacer es un proyecto nuevo con Apache Netbeans, donde vamos a tener el ejemplo de como podemos ver el switch en el JDK 8 y como se podría hacer con el JDK 14.

Como vemos tenemos una variable con el dato suministrado por el usuario. Para nuestro ejemplo que tipo de música le gusta.

Como estamos acostumbrados podemos ver el case el valor posible que selecciona el usuario, seguido de dos puntos. Esta sentencia nos permite tener un bloque de código donde agregamos las acciones del programa a seguir si es la opción elegida. Como podemos ver en la línea 27. Luego de esto simplemente agregamos un break para terminar nuestro switch.

Ahora como podríamos hacerlo en JDK14

La sintaxis es muy diferente pero el resultado es el mismo. Se ve más simple y fácil de leer. Cada uno de los posibles escenarios (case) van seguidos de -> con la instrucción que deseamos ejecutar si se selecciona una opción en particular.

Ejemplo