Uso de adaptadores Sling

🔗 O Slingoffer oferece um padrão de Adaptador para traduzir convenientemente objetos que implementam a interface Adaptável. Essa interface fornece um método genérico adaptTo() que traduzirá o objeto para o tipo de classe que está sendo passado como argumento.

Por exemplo, para traduzir um objeto de Recurso para o objeto Nó correspondente, basta fazer:

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

Casos de uso

Há os seguintes casos de uso:

• Obter objetos específicos de implementação.

  Por exemplo, uma implementação baseada em JCR da interface genérica Resource fornece acesso ao JCR subjacente Node.

• Criação de atalhos de objetos que exigem que objetos de contexto internos sejam passados.

  Por exemplo, o ResourceResolver baseado em JCR contém uma referência para o JCR Session da solicitação, que, por sua vez, é necessário para muitos objetos que funcionarão com base na sessão da solicitação, como o PageManager ou UserManager.

• Atalho para serviços.

  Um caso raro - sling.getService() também é simples.

Valor de Retorno Nulo

adaptTo() pode retornar nulo.

Há várias razões para isso, incluindo:

• a implementação não suporta o tipo de alvo
• uma fábrica de adaptadores que manipula este caso não está ativa (por exemplo, devido à falta de referências de serviço)
• falha na condição interna
• serviço não disponível

É importante lidar com o caso nulo normalmente. Para renderizações de jsp, pode ser aceitável ter a falha de jsp se isso resultar em um conteúdo vazio.

Armazenamento em cache

Para melhorar o desempenho, as implementações podem armazenar em cache o objeto retornado de uma chamada obj.adaptTo(). Se obj for o mesmo, o objeto retornado será o mesmo.

Esse armazenamento em cache é executado para todos os casos baseados em AdapterFactory.

No entanto, não há regra geral - o objeto pode ser uma nova instância ou uma existente. Isso significa que você não pode depender de nenhum dos comportamentos. Portanto, é importante, especialmente dentro de AdapterFactory, que os objetos sejam reutilizáveis neste cenário.

Como funciona

Há várias maneiras de implementar Adaptable.adaptTo():

• Pelo próprio objeto; implementação do próprio método e mapeamento para determinados objetos.

• Por um AdapterFactory, que pode mapear objetos arbitrários.

  Os objetos ainda devem implementar a interface Adaptable e devem estender SlingAdaptable (que passa a chamada adaptTo para um gerenciador central de adaptadores).

  Isso permite que os ganchos sejam conectados ao mecanismo adaptTo para classes existentes, como Resource.

• Uma combinação de ambos.

No primeiro caso, o javadocs pode indicar o que adaptTo-targets é possível. No entanto, para subclasses específicas, como o Recurso baseado em JCR, geralmente isso não é possível. No último caso, as implementações de AdapterFactory normalmente fazem parte das classes privadas de um pacote e, portanto, não são expostas em uma API do cliente, nem listadas em javadocs. Teoricamente, seria possível acessar todas as implementações AdapterFactory do tempo de execução do serviço OSGi e examinar suas configurações "adaptáveis" (fontes e alvos), mas não mapeá-las umas às outras. No fim, isso depende da lógica interna, que deve ser documentada. Daí esta referência.

Referência

Sling

​ O recurso se adapta a:

​ ResourceResolveradapts a:

​ SlingHttpServletRequestadapts a:

Nenhum destino ainda, mas implementa Adaptável e pode ser usado como fonte em um AdapterFactory personalizado.

​ SlingHttpServletResponseadapts para:

WCM

🔗 Pageadapts para:

🔗 Os componentes se adaptam a:

🔗 O modelo se adapta a:

Segurança

Autorizável, ​​Utilizador e ​​Agrupamento

DAM

​​O ativo se adapta a:

Marcação com tags

​​As tags se adaptam a:

Outro

Além disso, Sling / JCR / OCM também fornece um [AdapterFactory](https://sling.apache.org/site/adapters.html#Adapters-AdapterFactory) para objetos MAC personalizados (Mapeamento de conteúdo do objeto).