Soporte externo de Liberty

Las funciones y recursos externos de Liberty se pueden utilizar directamente con la confianza de que estarán disponibles en el próximo release. Es posible que aspectos internos o incidentales de Liberty cambien cuando se le aplique servicio o una actualización en un futuro release.

¿Qué puedo utilizar directamente en Liberty con la confianza de que estará en el siguiente release?

Los siguientes recursos se pueden utilizar directamente y continuarán estando disponibles en el próximo release:
  • Las interfaces de programación de aplicaciones (API) y las interfaces de programación del sistema (SPI) definidas por el contenido de los archivos JAR de los directorios ${wlp.install.dir}/dev.
    • El cargador de clases de aplicación tiene visibilidad en la API proporcionada por las características de la configuración de servidor. Las características de ampliación del producto tienen visibilidad en toda la API y SPI proporcionada por las características de la configuración de servidor.
    • Compile el código con los archivos JAR en los directorios ${wlp.install.dir}/dev. Los archivos JAR de los directorios ${wlp.install.dir}/dev se suministran únicamente para la compilación de aplicaciones y características; no están soportados para el uso en tiempo de ejecución. No utilice estos archivos JAR en aplicaciones, bibliotecas o pruebas.
  • La configuración de servidor, incluidas las características con visibilidad public o protected. Las características públicas y los elementos de configuración se pueden especificar en el archivo server.xml y archivos incluidos; las características protegidas se pueden incluir en sus propias características.
  • Mandatos, scripts y archivados del directorio ${wlp.install.dir}/bin y los subdirectorios.
  • Los programas de utilidad del cliente del directorio ${wlp.install.dir}/clients y los subdirectorios.

¿Qué dependencias debo evitar?

No cree dependencias sobre aspectos incidentales del producto. La creación de dependencias en aspectos incidentales podría afectar negativamente al producto cuando se aplica el servicio o la actualización en futuros releases. Los ejemplos de elementos internos en los que se debe evitar basarse incluyen, pero no se limitan a, los escenarios siguientes:
  • Los nombres de los archivos JAR binarios del producto, por ejemplo, aquellos del directorio ${wlp.install.dir}/dev. Compile su código en estos archivos JAR utilizando las herramientas o la opción javac -extdirs.
    Si utiliza Apache Ant para compilar el código, utilice comodines para evitar dependencias de la versión del archivo JAR específico; por ejemplo:
    <fileset dir="${wlp.install.dir}/dev/api/spec" includes="com.ibm.ws.javaee.servlet.3.0_*.jar"/>
    De forma alternativa, puede utilizar el mandato featureManager classpath para generar una vía de acceso de clases para un conjunto específico de características. Para obtener más información, consulte Liberty: Mandato featureManager.
  • El uso directo de los archivos binarios de producto en el directorio ${wlp.install.dir}/lib. Los únicos archivos JAR que se pueden invocar directamente se encuentran en el directorio ${wlp.install.dir}/bin/tools.
  • Los mensajes generados como salida del servidor en tiempo de ejecución. El texto y la inserción de mensajes están sujetos a cambio en el servicio y las actualizaciones de la versión. Hasta donde sea prácticamente posible, el producto será coherente en los ID de mensaje que se generan como salida en puntos de operación determinados, pero esto no se puede garantizar debido a que pueden cambiar las implementaciones subyacentes.
  • El diseño de la instalación del producto, salvo los directorios /${wlp.install.dir}/bin y ${wlp.install.dir}/dev.
  • Ejemplos y archivos de plantilla del directorio ${wlp.install.dir}/templates. Estos archivos pueden modificarse cuando se aplica el servicio a su instalación.
  • Paquetes Java™ privados o de terceros que no están expuestos explícitamente como API. Durante la ejecución, el cargador de clases de aplicación no puede verlos.
  • Propiedades de configuración no documentadas. El código base de Liberty es común con el código base de WebSphere Application Server tradicional. Por lo tanto, algunas propiedades de configuración en el código base de Liberty podrían no estar documentadas, pero cuando se especifican podrían afectar al comportamiento de Liberty. Puesto que estas propiedades de configuración no se aplican a Liberty, no están soportadas para Liberty. No se han probado para Liberty y posiblemente no funcione de forma fiable en Liberty ahora o en el futuro. Como estas propiedades no están documentadas como un producto externo, se pueden eliminar en cualquier momento.

¿Qué puede modificarse durante la aplicación de servicio o durante una actualización?

Cuando se aplica servicio o se realiza una actualización, es posible que el contenido de los directorios siguientes y sus subdirectorios pueda verse modificado. No realice sus propias modificaciones en los archivos de estas ubicaciones, o es posible que resulten sobregrabadas como resultado de una actualización o de un proceso de mantenimiento del producto:
  • ${wlp.install.dir}/bin
  • ${wlp.install.dir}/clients
  • ${wlp.install.dir}/dev
  • ${wlp.install.dir}/java
  • ${wlp.install.dir}/lib
  • ${wlp.install.dir}/templates
No se realizan modificaciones en el contenido de los directorios siguientes. Estos son sus archivos y aunque se aplique servicio o se ejecute una actualización no se modificarán:
  • ${wlp.install.dir}/etc (donde puede haber añadido un archivo server.env o jvm.options).
  • ${wlp.install.dir}/usr (la ubicación predeterminada de la configuración de usuario y las aplicaciones).
  • Cualquier directorio que no sea el predeterminado que designe a través de la variable de entorno WLP_USER_DIR.

Las API de terceros pueden cambiar con el tiempo sin tener en cuenta la compatibilidad con las versiones anteriores. Estos son los paquetes de Java que se consideran parte de la implementación de las características desarrolladas en las comunidades de código abierto y entregadas como parte de Liberty. Las API de terceros no son visibles para aplicaciones de forma predeterminada; las aplicaciones Java EE con una configuración de cargador de clases que permite explícitamente el acceso de terceros tendrá visibilidad de esos paquetes en el cargador de clases de aplicación, y las aplicaciones OSGi deben importar explícitamente los paquetes. Tenga en cuenta el efecto de los cambios incompatibles antes de decidir utilizar API de terceros.


Icono que indica el tipo de tema Tema de referencia

Nombre de archivo: rwlp_profile_externals.html