+52 55 4336 6356, +52 55 4336 6368 contacto@semantiq.com.mx

Introducción

En esta ocasión vamos a instalar y a configurar una Instancia de Marklogic API REST con el lenguaje de programación Java. Dicha instancia estará conectada a una base de datos de MarkLogic. Para el ejemplo se va a utilizar el sistema operativo Windows 10.

Requerimientos

Primero necesitamos instalar y/o descargar lo que se en lista a continuación:

JDK 8 o superior

Descargamos y ejecutamos el archivo .exe

Apache Tomcat versión 9

Descargamos y descomprimimos el archivo .zip

Eclipse

Instalamos la versión que se muestra a continuación

Segundo paso iniciamos nuestro Eclipse para poder crear nuestro proyecto.

Crear y configurar proyecto

Para crear un proyecto damos clic en file – new – Dynamic Web Project

Ingresamos el nombre del proyecto y damos clic en New Runtime para configurar Apache Tomcat

Seleccionamos la versión 9 y damos clic en siguiente.

Seleccionamos la carpeta que descomprimimos anteriormente y damos clic en finalizar.

Una vez configurado el Apache Tomcat v9.0 en la opción de Configuration damos clic en Modify.

Seleccionamos en la lista desplegable la opción «Default Configuration for Apache Tomcat v9.0»

Damos clic en siguiente

Damos clic en siguiente

Seleccionamos el check «Generate web.xml deployment descriptor»

Posteriormente creamos y configuramos el Servlet

Crear y configurar Servlet

Desplegamos el proyecto celular, del mismo modo la opción de Java Resources y damos clic derecho en src.

Seleccionamos New – Servlet

Ingresamos la siguiente configuración:

Editamos la URL mapping

Seleccionamos la siguiente configuración de los métodos que se van a crear

Ingresamos el siguiente código en el archivo Celular.java

Ejecutamos el servidor

Después de eso se va a crear un servidor de aplicaciones

Servidor de aplicaciones MarkLogic API REST

Ejecutamos el siguiente código en el cmd

curl --anyauth --user admin:admin -X POST -d@"Desktop/
ml-api-java/celulares_config.json" -i -H "Content-type: 
application/json" http://localhost:8002/v1/rest-apis

Indicamos el usuario y contraseña que utilizamos para ingresar a la interfaz de administrador de MarkLogic, la ruta donde del archivo celulares_config.json y la url donde se estará creando la instacia API REST

En el archivo celulares_config indicamos el nombre de la instancia API REST, la base de datos el puerto y el bosque que se va a crear.

Base de datos

Para este ejemplo creamos una base de datos llamada celulares. Si aún no sabes como crear una base de datos puedes consultar nuestro artículo MarkLogic Bases de Datos.

Ingresamos el siguiente código al editor de XQuery Console con el lenguaje de programación de JavaScript.

Si quieres aprender como insertar documentos puedes consultar nuestro artículo Insertar datos con la interfaz de Query Console

Dependencias MarkLogic archivo POM.xml

Finalmente para crear un archivo pom, nos vamos al explorador de proyectos seleccionamos con clic derecho el proyecto celular y seguimos las opciones como se muestra en las imágenes:

Damos clic en finalizar

Genera el archivo pom.xml como se muestra en la imagen

Para descargar las dependencias de java-client-api seleccionamos la opcion de «Dependencies»

Ingresamos los datos que se muestran en la imagen, damos clic en ok y despues damos clic en guardar o presionamos la combinación del teclado Crlt+S.

En el archivo pom nos genera las siguientes etiquetas

Código Java y librerías

Como resultado vamos a poder ingresar el siguiente código a la clase Celular.java e importamos las librerías

Ejecutamos la aplicación Web

También puedes consultar la página oficial de MarkLogic para obtener más información acerca de Marklogic API REST Java conectada a una base de datos.

Códigos

Puedes descargar los códigos que utilizamos en el siguiente link de github