Soporte de externos en el perfil Liberty

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

¿Qué puedo utilizar directamente en el perfil 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, o es posible que resulten afectadas durante la aplicación de servicio o actualización de los releases futuros. La siguiente es una lista de casos de ejemplo de elementos internos del producto cuya dependencia debe evitar durante la inclusión, aunque no se limita a los mismos:
  • Los nombres de los archivos jar de binarios del producto, por ejemplo, los que están incluidos en el directorio ${wlp.install.dir}/dev. Compile su código en estos archivos JAR utilizando las herramientas o la opción javac -extdirs.
    [8.5.5.4 o posterior]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.
    Consulte Alteración temporal de las clases del SDK Java.
  • Uso directo de los binarios del producto del 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.
  • No utilice el archivo console.log para el proceso automatizado de la salida del servidor. En su lugar, utilice el archivo messages.log para acceder y procesar los mensajes, que proporciona información más detallada, en un formato que es más fácil de procesar.

¿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.

Para plataformas i de IBMExiste una excepción a la política de que no se realizan modificaciones en el contenido de ${wlp.install.dir}/etc. El archivo ${wlp.install.dir}/etc/default.env se crea cuando instala el perfil Liberty en las plataformas IBM® iSeries utilizando Installation Manager. Este archivo también se crea o se sustituye con el mandato iAdmin POSTINSTALL durante las instalaciones del gestor de trabajos y de archivado. El mandato iAdmin se encuentra en el directorio ${wlp.install.dir}/lib/native/os400/bin. Consulte Mandato iAdmin.

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 del perfil 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 impacto de los cambios incompatibles antes de decidir si utilizar API de terceros.


Icono que indica el tipo de tema Tema de referencia

Términos y condiciones para centros de información | Comentarios


Icono de indicación de fecha y hora Última actualización: 15 de junio de 2015
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=phil&product=was-libcore-mp&topic=rwlp_profile_externals
Nombre de archivo:rwlp_profile_externals.html