Invocar un servicio Java

Para llamar a un servicio Java™, puede descubrir una clase Java y generar un servicio externo. A continuación, puede utilizar el servicio externo en un flujo de servicios para invocar el servicio Java.

Antes de empezar

Antes de crear el servicio externo, añada el archivo JAR que contiene las clases que necesita, tal como se describe en Adición de archivos gestionados. Para obtener información sobre el ámbito de los archivos JAR cargados, consulte Gestión de archivos externos.

Si los archivos JAR que necesita están incluidos en un kit de herramientas, puede añadir una dependencia a dicho kit de herramientas para acceder a estos archivos. Véase Modificación de las dependencias del kit de herramientas.

Importante: el comportamiento transaccional para la integración Java de servicios externos no está garantizado y, por lo tanto, no está definido.

Acerca de esta tarea

Para utilizar un servicio Java en el diseñador, primero descubra la clase Java y, a continuación, genere un servicio externo a partir de ella. El servicio externo contiene operaciones con entradas y salidas basadas en la clase Java descubierta. Cuando descubre un servicio, si ya existe un servicio externo correspondiente en el diseñador, puede sobrescribir el servicio existente o crear uno nuevo.

Realice los pasos siguientes para descubrir una clase Java y generar un servicio externo.

  1. Cree un servicio externo de una de las maneras siguientes:
    • Junto a Servicios en la navegación de la biblioteca, pulse el signo más (+). Seleccione Servicio externo. En la página Nuevo servicio externo, elija Servicio Java, REST o web.
    • En el editor Flujo de servicios , seleccione una tarea Servicio . En la pestaña Implementación del servicio, pulse Nuevo. En la página Nuevo servicio externo, elija Descubrir un servicio existente.
  2. Seleccione Servicio Java desde archivo de servidor como método para descubrir un servicio.
  3. Junto a Archivo gestionado, pulse Seleccionar y seleccione el archivo que desee.
  4. Junto a Clase Java, seleccione la clase que desee en la lista desplegable. Pulse Finalizar.
  5. Se crea un servicio externo con un enlace Java. Las operaciones y sus entradas y salidas se basan en los métodos de la clase Java descubierta. En la sección Detalles, se muestra el nombre del servicio. También puede añadir una documentación. Se muestra el espacio de nombres descubierto. Al seleccionar Enlace se muestra el tipo de enlace Java . Pulse un parámetro y seleccione Enlace para ver el tipo nativo del parámetro.
    Nota: Si una operación se puede invocar correctamente desde un flujo de servicios depende del enlace de la clase, el método, los tipos de parámetro y el tipo de resultado del método:
    • La clase Java debe ser 'public'.
    • El método debe ser 'public'.
    • El método debe ser 'static' o la clase Java debe tener un constructor público sin argumentos.
    • Cada uno de los tipos de parámetro, así como el tipo de resultado (si no es 'void'), debe ser uno de los siguientes:
      Tipo Java Tipo de parámetro de operación
      byte, Byte Integer
      short, Short Integer
      int, Integer Integer
      long, Long Decimal
      float, Float Decimal
      double, Double Decimal
      boolean, Boolean Boolean
      char, Character String
      String String
      java.util.Calendar Date
      org.jdom.Element XMLElement
      org.jdom.Document XMLDocument
      java.util.Map Map
Sugerencia: Puesto que las firmas de método Java que se inspeccionan en las clases cumplidas no contienen información sobre los nombres de parámetro, se generan nombres y números genéricos para ellos, por ejemplo, Parámetro 1 (Serie), Parámetro 2 (Entero). Puede añadir clases de BeanInfo que proporcionen información adicional sobre las clases y sus métodos.

Resultados

Después de crear el servicio externo, puede seleccionarlo como una implementación de un servicio en un flujo de servicios. Seleccione la operación que desea utilizar en la lista desplegable de operaciones y correlacione las entradas y salidas en la pestaña Correlación de datos. Consulte Creación de un flujo de servicios.

Si la operación tiene un tipo de parámetro que es Map, XMLElemento XMLDocument, utilice la API JavaScript para construir el argumento o para descomponer el valor de retorno.