Usar los adaptadores de Sling

Slingofrece un patrón de adaptador para traducir convenientemente objetos que implementan la interfaz Adaptable. Esta interfaz proporciona un método genérico adaptableTo() que traducirá el objeto al tipo de clase que se pasa como argumento.

Por ejemplo, para traducir un objeto Resource al objeto Node correspondiente, simplemente puede hacer lo siguiente:

Node node = resource.adaptTo(Node.class);

Casos de uso

Existen los siguientes casos de uso:

• Obtenga objetos específicos de la implementación.

  Por ejemplo, una implementación basada en JCR de la interfaz genérica Resource proporciona acceso al JCR subyacente Node.

• Creación de accesos directos de objetos que requieren que se pasen objetos de contexto internos.

  Por ejemplo, el ResourceResolver basado en JCR contiene una referencia al JCR Session de la solicitud, que a su vez es necesario para muchos objetos que funcionarán en base a esa sesión de solicitud, como PageManager o UserManager.

• Acceso directo a servicios.

  Un caso poco común: sling.getService() también es sencillo.

Valor devuelto nulo

adaptTo() puede devolver null.

Esto se debe a varios motivos, entre ellos:

• la implementación no admite el tipo de destinatario
• no está activo un generador de adaptador que maneje este caso (p. ej. debido a que faltan referencias de servicio)
• error en la condición interna
• el servicio no está disponible

Es importante que gestione el caso nulo con gracia. En el caso de las representaciones jsp, puede ser aceptable que el jsp falle si el resultado es un fragmento de contenido vacío.

Almacenamiento en caché

Para mejorar el rendimiento, las implementaciones pueden almacenar en caché el objeto devuelto desde una llamada obj.adaptTo(). Si obj es el mismo, el objeto devuelto es el mismo.

Este almacenamiento en caché se realiza para todos los casos basados en AdapterFactory.

Sin embargo, no hay ninguna regla general: el objeto puede ser una instancia nueva o una existente. Esto significa que no se puede confiar en ninguno de los comportamientos. Por lo tanto, es importante, especialmente dentro de AdapterFactory, que los objetos se puedan reutilizar en este escenario.

Cómo funciona

Existen varias maneras de implementar Adaptable.adaptTo():

• Por el objeto mismo; implementar el propio método y asignar a determinados objetos.

• Por un AdapterFactory`, que puede asignar objetos arbitrarios.

  Los objetos deben seguir implementando la interfaz Adaptable y deben extender SlingAdaptable (que pasa la llamada adaptTo a un administrador de adaptadores central).

  Esto permite enganchar el mecanismo adaptTo para las clases existentes, como Resource.

• Una combinación de ambos.

En el primer caso, los javadocs pueden indicar qué adaptTo-targets son posibles. Sin embargo, para subclases específicas como el recurso basado en JCR, a menudo esto no es posible. En este último caso, las implementaciones de AdapterFactory suelen formar parte de las clases privadas de un paquete y, por lo tanto, no se exponen en una API de cliente ni se enumeran en javadocs. En teoría, sería posible acceder a todas las AdapterFactory implementaciones desde el tiempo de ejecución del OSGi servicio y observar sus configuraciones "adaptables" (fuentes y destinatarios), pero no asignarlas entre sí. Al final, esto depende de la lógica interna, que debe ser documentada. De ahí esta referencia.

Referencia

Sling

El recurso se adapta a:

​ ResourceResolverse adapta a:

​ SlingHttpServletRequestse adapta a:

Aún no hay destinatarios, pero implementa Adaptable y se puede usar como fuente en un AdapterFactory personalizado.

​ SlingHttpServletResponsese adapta a:

WCM

La página se adapta a:

​ Componentes se adapta a:

Los templarios se adaptan a:

Seguridad

Autorizable, ​ Usuario y ​ Grupo se adaptan a:

DAM

El recurso se adapta a:

Etiquetado

Las etiquetas se adaptan a:

Otras

Además, Sling / JCR / OCM también proporciona un [AdapterFactory](https://sling.apache.org/site/adapters.html#Adapters-AdapterFactory) para objetos OCM (Object Content Mapping) personalizados.