Preferencias de servicios Web

Antes de empezar a desarrollar servicios o clientes Web, puede optimizar el área de trabajo para el desarrollo de servicios Web definiendo distintas preferencias.

Para establecer cualquiera de las preferencias de servicios Web, siga estas instrucciones:
  1. Pulse Ventana > Preferencias para abrir el cuaderno Preferencias.
  2. Expanda Servicios Web o Web y XML y pulse la categoría de preferencia que desea establecer.
  3. Active los recuadros de selección que desea establecer como valores por omisión al crear el servicio Web.
  4. Pulse Aceptar para aplicar los cambios y cerrar el cuaderno Preferencias.
Si requiere más información sobre cualquiera de las opciones, seleccione la opción y pulse F1.

Las herramientas de servicios Web permiten definir las siguientes preferencias:

Emisor de Axis
Esta página permite establecer las siguientes preferencias utilizadas al crear o consumir servicios Web de Axis.
WSDL2Java
  • Generar código para todos los elementos: por omisión, WSDL2Java sólo genera código para aquellos elementos del archivo WSDL a los que se hace referencia. Para obtener más información acerca del funcionamiento de las referencias, consulte el manual de consulta de Axis: http://ws.apache.org/axis/java/reference.html
  • Emitir clases Helper independientes para metadatos: si selecciona esta opción, WSDL2Java creará una clase de ayuda independiente que contendrá los metadatos en lugar de incluirlos en el esqueleto.
  • Preferir beans de construcción a matrices directas para tipos de matriz XML de envoltura: el comportamiento predeterminado es correlacionar esta construcción XML:
    <element name="array">
     <complexType>
      <sequence>
       <element name="item" type="xs:string"/>
      </sequence>
     </complexType>
    </element>
    a una matriz Java SString (String[]). Si prefiere generar una clase JavaBean específica (ArrayOfString) para estos tipos de esquemas, seleccione esta opción.
  • Añadir ámbito a deploy.wsdd: indica cómo desplegar la implementación de servidor. La aplicación utiliza una instancia de la clase de implementación para todas las peticiones. La petición crea una instancia nueva de la clase de implementación para cada petición. La sesión crea una instancia nueva de la clase de implementación para cada sesión.
  • Tiempo de espera en segundos: el valor predeterminado es 45. Utilice -1 para inhabilitar el tiempo de espera.
Java2WSDL
  • Buscar métodos permitidos en clase heredada: si se especifica esta opción, el analizador Java2WSDL buscará en las clases ampliadas para determinar la lista de métodos que deben exportarse al archivo WSDL.
  • Analizar la clase de servicio para compatibilidad con JAX-RPC antes de generar código: si se selecciona, las herramientas examinarán la clase de servicio Java y sus tipos de valores para determinar si satisface los requisitos importantes de la especificación JAX-RPC.
Selección de diálogos emergentes
Las preferencias de diálogos permiten determinar los recuadros de diálogo que se desean mostrar al ejecutar acciones emergentes. Si ha inhabilitado alguno de los diálogos seleccionando "No volver a mostrar este diálogo" en la primera página de un asistente de servicios Web, puede deshacer el cambio borrando el recuadro de selección junto al diálogo que ha determinado ocultar.
Conformidad y validación del perfil
Las preferencias de compatibilidad con WS-I permiten seleccionar el nivel de compatibilidad con SSBP (WS-I Simple SOAP Binding Profile) y WS-I AP (Attachement Profile). Nota: si cambia el nivel de compatibilidad con WS-I cuando se enumera en la vista Tareas lo que no es compatible con WS-I, no se actualizará automáticamente la vista Tareas. Se debe volver a validar el espacio de trabajo antes de que se eliminen los avisos de la vista Tareas. Si desea más información sobre WS-I, consulte: http://www.ws-i.org/
Para las preferencias de validación, puede indicar si deben validarse los archivos WSDL consumidos por los asistentes de los servicios Web, y si debe completarse la validación de WSDL antes de que el asistente proceda con el paso siguiente.
Topología del proyecto
Las preferencias de topología del proyecto permiten:
  • Seleccionar el tipo de proyecto por omisión que los asistentes de servicios Web crearán al generar un cliente de servicios Web. También puede establecer el orden en que se enumerarán los tipos de proyectos en el asistente. Observe que esta selección simplemente es un valor por omisión y se puede seleccionar un tipo de proyecto alternativo.
  • Seleccione si desea generar el servicio Web y el cliente de servicios Web en el mismo proyecto EAR o en proyectos EAR distintos. Si se genera el servicio y el cliente en proyectos EAR distintos puede reducirse la ocasión de conflictos que se producen cuando existen los dos en un solo proyecto EAR, pero se utilizan más recursos del sistema.
Gestión de recursos
Las preferencias de gestión de recursos permiten determinar la creación de archivos y carpetas y sobrescribir los valores por omisión que desea utilizar al crear el servicio Web.
  • Sobrescribir archivos sin avisar: si selecciona esta opción, los asistentes podrán sobrescribir los archivos existentes en el área de trabajo sin avisar al usuario. Si no la la selecciona, se le solicitará cada vez que deba sobrescribirse un archivo.
  • Crear carpetas cuando sea necesario: seleccionar esta opción permite al asistente crear las carpetas necesarias.
  • Reservar archivos sin avisar: seleccione esta opción para reservar archivos sin recibir un mensaje de aviso solicitando confirmación.
  • Fusionar archivo de esqueleto generado: este recuadro de selección está inhabilitado por omisión. Si está habilitado, cuando ya existe un archivo de esqueleto con el mismo nombre en el área de trabajo, el archivo de esqueleto recién generado se fusionará con el archivo de esqueleto existente. Habilite esta recuadro para conservar el código que ya ha modificado en los archivos de esqueleto existentes.

    Tenga en cuenta que, si habilita esta preferencia, si cambia el tipo de retorno de una interfaz, el archivo de esqueleto resultante tendrá un método que devolverá el tipo definido en la interfaz nueva, pero tendrá un cuerpo de método procedente del archivo de esqueleto original (que devolverá un tipo diferente). Esto provocará un error de compilación que será necesario corregir manualmente.

Valores por omisión del caso de ejemplo
Las preferencias de valores por omisión del caso de ejemplo permiten establecer los siguientes valores por omisión del caso de ejemplo que desea utilizar al crear el servicio Web:
  • qué tipo de servicio y cliente Web desea que se seleccione por omisión.
  • qué fases del ciclo de vida del servicio Web desea completar en el asistente.
  • Si desea que se inicie Web Services Explorer por omisión, de modo que pueda publicar el servicio Web a un registro UDDI.
  • Si desea que el tráfico SOAP del servicio Web se direccione mediante el supervisor de TCP/IP de modo que pueda supervisar los paquetes SOAP y, de modo opcional, probar su conformidad WS-I.
Observe que todos estos valores por omisión se pueden alterar temporalmente en el asistente.
Servidor y motor de ejecución
Seleccione el servidor, el entorno de ejecución del servicio Web y la versión de J2EE que desea que se seleccione por omisión en el asistente de servicios Web. Observe que todos estos valores por omisión se pueden alterar temporalmente en el asistente.
Valores por omisión del recurso de prueba
Puede seleccionar si el asistente va a iniciar automáticamente un recurso de prueba y además seleccionar el tipo de recurso de prueba preferido
Archivos WSDL
Al crear un archivo WSDL en el editor WSDL, puede establecer el espacio de nombres de destino por omisión. Si no selecciona cambiar el valor por omisión, el archivo WSDL tendrá de espacio de nombres de destino http://tempuri.org.