O Sling Resource Merger fornece serviços para acessar e mesclar recursos. Ela fornece mecanismos de diferenciação para:
Sobreposições de recursos usando o caminhos de pesquisa.
Substituições das caixas de diálogo do componente para a interface habilitada para toque (cq:dialog
), usando a hierarquia de tipo de recurso (por meio da propriedade sling:resourceSuperType
).
Com o Sling Resource Merger, os recursos e/ou propriedades de sobreposição/substituição são mesclados com os recursos/propriedades originais:
O conteúdo da definição personalizada tem uma prioridade mais alta que a do original (ou seja, ela sobreposições ou sobreposições it).
Se necessário, propriedades definido na personalização, indique como o conteúdo mesclado do original deve ser usado.
O Sling Resource Merger e os métodos relacionados só podem ser usados com a interface habilitada para toque (que é a única interface disponível para o AEM as a Cloud Service).
As metas para usar a Fusão de recursos do Sling no AEM são:
certifique-se de que as alterações de personalização não sejam feitas no /libs
.
reduzir a estrutura que é replicada de /libs
.
Ao usar a Fusão de recursos do Sling, não é recomendável copiar toda a estrutura de /libs
como isso resultaria em muitas informações mantidas na personalização (geralmente /apps
). Duplicar informações aumenta desnecessariamente a chance de problemas quando o sistema é atualizado de alguma forma.
Você deve não alterar nada no /libs
caminho.
Isso ocorre porque o conteúdo de /libs
O pode ser substituído sempre que as atualizações forem aplicadas à sua instância.
As sobreposições dependem do caminhos de pesquisa.
As substituições não dependem dos caminhos de pesquisa, elas usam a propriedade sling:resourceSuperType
para fazer a conexão.
No entanto, as sobreposições geralmente são definidas em /apps
, como prática recomendada no AEM as a Cloud Service, definir personalizações em /apps
; isso ocorre porque você não deve alterar nada em /libs
.
A fusão de recursos oferece as seguintes propriedades:
sling:hideProperties
( String
ou String[]
)
Especifica a propriedade, ou lista de propriedades, a ser ocultada.
O curinga *
oculta tudo.
sling:hideResource
( Boolean
)
Indica se os recursos devem ser completamente ocultos, incluindo seus filhos.
sling:hideChildren
( String
ou String[]
)
Contém o nó filho, ou lista de nós filhos, a ser ocultado. As propriedades do nó serão mantidas.
O curinga *
oculta tudo.
sling:orderBefore
( String
)
Contém o nome do nó irmão no qual o nó atual deve ser posicionado.
Essas propriedades afetam como os recursos/propriedades correspondentes/originais (de /libs
) são usados pela sobreposição/substituição (geralmente em /apps
).
Para criar uma sobreposição ou sobreposição, é necessário recriar o nó original, com a estrutura equivalente, no destino (geralmente /apps
). Por exemplo:
Sobreposição
A definição da entrada de navegação do console Sites, como mostrado no painel, é definida em:
/libs/cq/core/content/nav/sites/jcr:title
Para sobrepor isso, crie o seguinte nó:
/apps/cq/core/content/nav/sites
Em seguida, atualize a propriedade jcr:title
conforme necessário.
Substituir
A definição da caixa de diálogo habilitada para toque do console de Textos está definida em:
/libs/foundation/components/text/cq:dialog
Para substituir isso, crie o seguinte nó - por exemplo:
/apps/the-project/components/text/cq:dialog
Para criar qualquer uma dessas opções, basta recriar a estrutura do esqueleto. Para simplificar a recriação da estrutura, todos os nós intermediários podem ser do tipo nt:unstructured
(elas não precisam refletir o tipo de nó original; por exemplo, em /libs
).
Portanto, no exemplo de sobreposição acima, os seguintes nós são necessários:
/apps
/cq
/core
/content
/nav
/sites
Ao usar o Sling Resource Merger (ou seja, ao lidar com a interface padrão habilitada para toque), não é recomendável copiar toda a estrutura de /libs
como resultaria em um excesso de informações mantidas em /apps
. Isso pode causar problemas quando o sistema é atualizado de alguma forma.
Eles, juntamente com a funcionalidade padrão, permitem:
Adicionar uma propriedade do
A propriedade não existe no /libs
definição, mas é obrigatório na variável /apps
sobrepor/substituir.
/apps
Redefinir uma propriedade (não propriedades criadas automaticamente)
A propriedade é definida em /libs
, mas um novo valor é necessário no /apps
sobrepor/substituir.
Crie o nó correspondente em /apps
Crie a propriedade correspondente neste nó (em / apps
)
A propriedade terá uma prioridade com base na configuração do Sling Resource Resolver.
Não há suporte para a alteração do tipo de propriedade.
Se você usar um tipo de propriedade diferente daquele usado em /libs
, o tipo de propriedade definido será usado.
Não há suporte para a alteração do tipo de propriedade.
Redefinir uma propriedade criada automaticamente
Por padrão, as propriedades criadas automaticamente jcr:primaryType
) não estão sujeitos a uma sobreposição/substituição para garantir que o tipo de nó atualmente em /libs
é respeitado. Para impor uma sobreposição/substituição, é necessário recriar o nó em /apps
, oculte explicitamente a propriedade e redefina-a:
Crie o nó correspondente em /apps
com o desejado jcr:primaryType
Criar a propriedade sling:hideProperties
nesse nó, com o valor definido como aquele da propriedade criada automaticamente; por exemplo, jcr:primaryType
Essa propriedade, definida em /apps
, terá prioridade sobre a definida em /libs
Redefinir um nó e seus filhos
O nó e seus filhos são definidos em /libs
, mas uma nova configuração é necessária na variável /apps
sobrepor/substituir.
Combine as ações de:
Ocultar uma propriedade
A propriedade é definida em /libs
, mas não obrigatório no /apps
sobrepor/substituir.
Crie o nó correspondente em /apps
Criar uma propriedade do sling:hideProperties
do tipo String
ou String[]
. Use esta opção para especificar as propriedades que devem ser ocultas/ignoradas. Curingas também podem ser usados. Por exemplo:
*
["*"]
jcr:title
["jcr:title", "jcr:description"]
Ocultar um nó e seus filhos
O nó e seus filhos são definidos em /libs
, mas não obrigatório no /apps
sobrepor/substituir.
Crie o nó correspondente em /apps
Criar uma propriedade do sling:hideResource
Boolean
true
Ocultar filhos de um nó (enquanto mantém as propriedades do nó)
O nó, suas propriedades e seus filhos são definidos em /libs
. O nó e suas propriedades são necessários na variável /apps
sobrepor/substituir, mas alguns ou todos os nós secundários não são necessários no /apps
sobrepor/substituir.
Crie o nó correspondente em /apps
Criar a propriedade sling:hideChildren
:
String[]
/libs
) para ocultar/ignorarO curinga * pode ser usado para ocultar/ignorar todos os nós filhos.
Reordenar nós
O nó e seus irmãos são definidos em /libs
. Uma nova posição é necessária para que o nó seja recriado na /apps
sobrepor/substituir, onde a nova posição é definida em referência ao nó irmão apropriado em /libs
.
Use o sling:orderBefore
propriedade:
Crie o nó correspondente em /apps
Criar a propriedade sling:orderBefore
:
Isso especifica o nó (como em /libs
) que o nó atual deve ser posicionado antes:
String
<before-SiblingName>
O Sling Resource Merger inclui dois provedores de recursos personalizados, um para sobreposições e outro para substituições. Cada um desses pode ser chamado dentro do código usando um ponto de montagem:
Ao acessar o recurso, é recomendável usar o ponto de montagem apropriado.
Isso garante que o Sling Resource Merger seja chamado e que o recurso totalmente mesclado seja retornado (reduzindo a estrutura que precisa ser replicada do /libs
).
Sobreposição:
finalidade: mesclar recursos com base no caminho de pesquisa
ponto de montagem: /mnt/overlay
uso: mount point + relative path
exemplo:
getResource('/mnt/overlay' + '<relative-path-to-resource>');
Substituir:
finalidade: mesclar recursos com base em seu supertipo
ponto de montagem: /mnt/overide
uso: mount point + absolute path
exemplo:
getResource('/mnt/override' + '<absolute-path-to-resource>');