Clases no modeladas

Algunos componentes contienen clases no modeladas. Para estas clases, el uso de cada clase o interfaz externa se describe en el Javadoc de la clase.

Algunas clases no modeladas se proporcionan con restricciones de acceso de Eclipse aplicadas para proporcionar a los clientes algunas directrices en relación a qué API pueden o no pueden invocar o personalizar. Determinados paquetes y clases están marcados como restringidos; estas clases no se deben utilizar ya que son clases internas que pueden cambiar con el tiempo. Las restricciones de acceso no se deben eliminar del archivo Eclipse.classpath, ya que esto podría hacer que se consumieran clases restringidas, lo que podría causar problemas durante las actualizaciones.

Algunos componentes no modelados contienen clases protegidas de paquete; estas clases no se deben utilizar en código personalizado. Los clientes no deben colocar código personalizado en la misma estructura del paquete para llamar o hacer referencia a clases protegidas de paquete.

Muchas API no modeladas no son directamente personalizables. Sólo las interfaces/clases etiquetadas con la anotación @Implementable se pueden ampliar o implementar. Estas clases tendrán un JavaDoc que detallará cómo personalizarlas o implementarlas. Las clases no modeladas que no están etiquetadas con la anotación @Implementable no se deben ampliar o implementar ya que se pueden añadir nuevas operaciones con el tiempo que pueden afectar a las actualizaciones.

Para las clases etiquetadas con la anotación @Implementable, los mecanismos de personalización típicos para estos tipos de clase son sucesos y estrategias.

Los sucesos permiten a los clientes añadir lógica personalizada en diversos puntos de la aplicación. Para obtener más información sobre cómo añadir escuchas de sucesos, consulte la publicación Persistence Cookbook. as clases de sucesos normalmente se denominan ‘xxxEvent’, así que se pueden identificar fácilmente.

Los patrones de estrategia permiten a los clientes cambiar el comportamiento predeterminado de determinadas funciones de la aplicación. Se proporciona una implementación predeterminada para cada clase de estrategia; sin embargo, los clientes pueden elegir sustituir la implementación predeterminada de cualquiera de las operaciones de estrategia mediante la utilización de enlaces de Guice. Para obtener más información sobre cómo utilizar los enlaces de Guice, consulte la publicación Persistence Cookbook. Las clases de estrategia normalmente se denominan ‘xxxStrategy’, así que se pueden identificar fácilmente.

Nota: Para obtener más información sobre la conformidad para cada componente individual, consulte Detalles de conformidad de componente.