Tag-Bibliotheken

Die Tag-Bibliotheken von Granite, CQ und Sling verleihen Ihnen Zugriff auf spezifische Funktionen für die Verwendung im JSP-Skript der Vorlagen und Komponenten.

Die Tag-Bibliothek von Granite

Die Tag-Bibliothek von Granite enthält hilfreiche Funktionen.

Bei der Entwicklung des JSP-Skripts einer Granite-UI-Komponente empfiehlt es sich, den folgenden Code oben im Skript einzufügen:

<%@include file="/libs/granite/ui/global.jsp?lang=de"%>

Das globale Objekt deklariert zudem die Sling-Bibliothek.

<%@taglib prefix="sling" uri="https://sling.apache.org/taglibs/sling" %>

ui:includeClientLib

Das <ui:includeClientLib>-Tag enthält eine AEM HTML-Client-Bibliothek, bei der es sich um eine js-, css- oder Designbibliothek handeln kann. Für mehrere Inklusionen verschiedener Typen, z. B. js und css, muss dieses Tag mehrmals in der jsp-Datei verwendet werden. Dieses Tag ist ein praktischer Wrapper für die Dienstschnittstelle [com.adobe.granite.ui.clientlibs.HtmlLibraryManager](https://helpx.adobe.com/de/experience-manager/6-4/sites/developing/using/reference-materials/javadoc/com/adobe/granite/ui/clientlibs/HtmlLibraryManager.html).

Es weist folgende Attribute auf:

kategorien - Eine Liste kommagetrennter Client-Lib-Kategorien. Dies bezieht alle Javascript-Dateien und CSS-Bibliotheken für die betreffenden Kategorien mit ein. Der Designname wird aus der Abfrage extrahiert.

Entspricht: com.adobe.granite.ui.clientlibs.HtmlLibraryManager#writeIncludes

theme - Eine Liste von kommagetrennten Client-Lib-Kategorien. Dies beinhaltet alle designbezogenen Bibliotheken (CSS und JS) für die entsprechenden Kategorien. Der Designname wird aus der Abfrage extrahiert.

Entspricht: com.adobe.granite.ui.clientlibs.HtmlLibraryManager#writeThemeInclude

js - Eine Liste kommagetrennter Client-Lib-Kategorien. Dies bezieht alle Javascript-Bibliotheken für die betreffenden Kategorien mit ein.

Entspricht: com.adobe.granite.ui.clientlibs.HtmlLibraryManager#writeJsInclude

css - Eine Liste kommagetrennter Client-Lib-Kategorien. Dies bezieht alle CSS-Bibliotheken für die betreffenden Kategorien mit ein.

Entspricht: com.adobe.granite.ui.clientlibs.HtmlLibraryManager#writeCssInclude

themed - Ein Flag, das nur die Bibliotheken mit oder ohne Themen anzeigt, sollte eingeschlossen werden. Wenn ausgelassen, sind beide Sätze enthalten. Gilt nur, wenn nur JS oder nur CSS enthalten ist (nicht wenn Kategorien oder Designs enthalten sind).

Das <ui:includeClientLib>-Tag kann wie folgt in einem JSP verwendet werden:

<%-- all: js + theme (theme-js + css) --%>
<ui:includeClientLib categories="cq.wcm.edit" />

<%-- only js libs --%>
<ui:includeClientLib js="cq.collab.calendar, cq.security" />

<%-- theme only (theme-js + css) --%>
<ui:includeClientLib theme="cq.collab.calendar, cq.security" />

<%-- css only --%>
<ui:includeClientLib css="cq.collab.calendar, cq.security" />

Tag-Bibliothek von CQ

Die Tag-Bibliothek von CQ enthält hilfreiche Funktionen.

Das Skript muss mit dem folgenden Code beginnen, damit Sie die Tag-Bibliothek von CQ im Skript verwenden können:

<%@taglib prefix="cq" uri="https://www.day.com/taglibs/cq/1.0" %>
HINWEIS

Wenn die Datei /libs/foundation/global.jsp im Skript enthalten ist, wird die Datei taglib automatisch deklariert.

Wenn Sie das JSP-Skript einer AEM-Komponente entwickeln, sollten Sie folgenden Code am Anfang des Skripts einfügen:

<%@include file="/libs/foundation/global.jsp?lang=de"%>

Es deklariert die Taglibs sling, CQ und jstl und stellt die regelmäßig verwendeten Skriptobjekte bereit, die durch das <cq:defineObjects />-Tag definiert werden. Dies verkürzt und vereinfacht den JSP-Code der Komponente.

cq:text

Das <cq:text>-Tag ist ein Bedienkomfort-Tag, das Komponententext in einem JSP ausgibt.

Es weist die folgenden optionalen Attribute auf:

property - Name der zu verwendenden Eigenschaft. Der Name steht im Bezug zur aktuellen Ressource.

value - Wert, der für die Ausgabe verwendet wird. Falls dieses Attribut vorhanden ist, wird die Nutzung des Attributs property außer Kraft gesetzt.

oldValue - Wert, der für die Ausgabe verwendet werden soll. Falls dieses Attribut vorhanden ist, wird die Nutzung des Attributs property außer Kraft gesetzt.

escapeXml - Definiert, ob die Zeichen <>, &, ' und " in der resultierenden Zeichenfolge in die entsprechenden Zeichenentitäts-Codes konvertiert werden sollen. Der Standardwert lautet false. Beachten Sie, dass der Escapevorgang nach der optionalen Formatierung angewendet wird.

format - Optionales java.text.Format für die Formatierung des Textes.

noDiff - Unterdrückt die Berechnung einer Diff-Ausgabe, auch wenn eine Diff-Info vorhanden ist.

tagClass - CSS-Klassenname eines Elements, das eine nicht leere Ausgabe umgibt. Wenn leer, wird kein Element hinzugefügt.

tagName - Name des Elements, das eine nicht leere Ausgabe umgibt. Standardmäßig ist DIV eingestellt.

placeholder - Standardwert, der im Bearbeitungsmodus für null oder leeren Text, d. h. den Platzhalter, verwendet wird. Beachten Sie, dass nach der optionalen Formatierung und dem Escapevorgang die standardmäßige Prüfung ausgeführt wird, d. h. er wird im vorliegenden Format in die Ausgabe geschrieben. Standardwert ist:

<div><span class="cq-text-placeholder">&para;</span></div>

default - Standardwert für Null oder leeren Text. Beachten Sie, dass nach der optionalen Formatierung und dem Escapevorgang die standardmäßige Prüfung ausgeführt wird, d. h. er wird im vorliegenden Format in die Ausgabe geschrieben.

Einige Beispiele dafür, wie das <cq:text>-Tag in einem JSP verwendet werden kann:

<cq:text property="jcr:title" tagName="h2"/>
<cq:text property="jcr:description" tagName="p"/>

<cq:text value="<%= listItem.getTitle() %>" tagName="h4" placeholder="" />
<cq:text value="<%= listItem.getDescription() %>" tagName="p" placeholder=""/>

<cq:text property="jcr:title" value="<%= title %>" tagName="h3"/><%
    } else if (type.equals("link")) {
        %><cq:text property="jcr:title" value="<%= "\u00bb " + title %>" tagName="p" tagClass="link"/><%
    } else if (type.equals("extralarge")) {
        %><cq:text property="jcr:title" value="<%= title %>" tagName="h1"/><%
    } else {
        %><cq:text property="jcr:title" value="<%= title %>" tagName="h2"/><%

<cq:text property="jcr:description" placeholder="" tagName="small"/>

<cq:text property="tableData"
               escapeXml="false"
               placeholder="<img src=\"/libs/cq/ui/resources/0.gif\" class=\"cq-table-placeholder\" alt=\"\">"
    />

<cq:text property="text"/>

<cq:text property="image/jcr:description" placeholder="" tagName="small"/>
<cq:text property="text" tagClass="text"/>

cq:setContentBundle

Das <cq:setContentBundle>-Tag erstellt einen Kontext für die i18n-lokale Anpassung und speichert ihn in der Konfigurationsvariablen javax.servlet.jsp.jstl.fmt.localizationContext.

Es weist folgende Attribute auf:

language - Die Sprache des Gebietsschemas, für das das Ressourcen-Bundle abgerufen werden soll.

source - Die Quelle, aus der das Gebietsschema entnommen werden soll. Sie können sie auf einen der folgenden Werte einstellen:

  • static - das Gebietsschema wird, falls verfügbar, aus dem language Attribut übernommen, andernfalls aus dem Standardgebietsschema des Servers.

  • page - das Gebietsschema wird aus der Sprache der aktuellen Seite oder Ressource (sofern verfügbar) entnommen, andernfalls aus dem language Attribut (sofern verfügbar), andernfalls aus dem Standardgebietsschema des Servers.

  • request - Das Gebietsschema wird aus dem Anforderungsgebietsschema ( request.getLocale()) übernommen.

  • auto : Das Gebietsschema wird, falls verfügbar, aus dem language Attribut übernommen, andernfalls aus der Sprache der aktuellen Seite oder Ressource, falls verfügbar, aus der Anforderung.

Falls das source-Attribut nicht festgelegt ist:

  • Wenn das Attribut language festgelegt ist, lautet das Attribut source standardmäßig "static.

  • Wenn das Attribut language nicht festgelegt ist, wird für das Attribut source standardmäßig auto verwendet.

Das "content bundle" kann einfach von Standard-JSTL <fmt:message>-Tags verwendet werden. Die Suche von Nachrichten anhand von Schlüsselwörtern hat zwei Aspekte:

  1. Zunächst werden die JCR-Eigenschaften der zugrunde liegenden Ressource, die derzeit wiedergegeben wird, nach Übersetzungen durchsucht. Auf diese Weise können Sie ein einfaches Komponentendialogfeld definieren, um diese Werte zu bearbeiten.
  2. Wenn der Knoten keine Eigenschaft mit dem exakt gleichen Namen wie das Schlüsselwort enthält, wird ein Ressourcenpaket aus der Sling-Anforderung (SlingHttpServletRequest.getResourceBundle(Locale)) )) geladen. Die Sprache oder das Gebietsschema für dieses Bundle wird durch die Sprach- und Quellattribute des <cq:setContentBundle>-Tags definiert.

Das <cq:setContentBundle>-Tag kann wie folgt in einem JSP verwendet werden.

Für Seiten, die ihre Sprache definieren:

... %><cq:setContentBundle source="page"/><%  %>
<div class="error"><fmt:message key="Hello"/>
</div> ...

Für von Benutzern personalisierte Seiten:

... %><cq:setContentBundle scope="request"/><% %>
<div class="error"><fmt:message key="Hello"/>
</div> ...

cq:include

Das <cq:include>-Tag enthält eine Ressource in die aktuelle Seite.

Es weist folgende Attribute auf:

flush

  • Ein boolescher Wert, der definiert, ob die Ausgabe geleert werden soll, bevor das Ziel eingefügt wird.

path

  • Der Pfad zum Ressourcenobjekt, das in die aktuelle Anforderungsverarbeitung eingefügt werden soll. Ein relativer Pfad wird an den Pfad der aktuellen Ressource angehängt, deren Skript die angegebene Ressource enthält. path und resourceType oder script müssen angegeben sein.

resourceType

  • Der Ressourcentypen der Ressource, die hinzugefügt werden soll. Wenn der Ressourcentyp festgelegt ist, muss der Pfad der genaue Pfad zu einem Ressourcenobjekt sein: in diesem Fall wird das Hinzufügen von Parametern, Selektoren und Erweiterungen zum Pfad nicht unterstützt.
  • Falls die einzufügende Ressource mit dem path-Attribut angegeben ist, das nicht in eine Ressource aufgelöst werden kann, erstellt das Tag möglicherweise ein synthetisches Ressourcenobjekt aus dem Pfad und diesem Ressourcentyp.
  • path und resourceType oder script müssen angegeben sein.

script

  • Das JSP-Skript, das einbezogen werden soll. path und resourceType oder script müssen angegeben sein.

ignoreComponentHierarchy

  • Eine boolesches Element, das steuert, ob die Komponentenhierarchie für die Skriptauflösung ignoriert werden soll. Bei „true“ werden nur die Suchpfade berücksichtigt.

Beispiel:

<%@taglib prefix="cq" uri="https://www.day.com/taglibs/cq/1.0" %><%
%><div class="center">
    <cq:include path="trail" resourceType="foundation/components/breadcrumb" />
    <cq:include path="title" resourceType="foundation/components/title" />
    <cq:include script="redirect.jsp"/>
    <cq:include path="par" resourceType="foundation/components/parsys" />
</div>

Soll <%@ include file="myScript.jsp" %> oder <cq:include script="myScript.jsp" %> verwendet werden, um ein Skript einzuschließen?

  • Die <%@ include file="myScript.jsp" %>-Direktive informiert den JSP-Compiler, eine vollständige Datei in die aktuelle Datei einzuschließen. Es ist, als ob die Inhalte der enthaltenen Datei direkt in die Originaldatei eingefügt würden.
  • Mit dem Tag <cq:include script="myScript.jsp"> wird die Datei zur Laufzeit eingeschlossen.

Sollten Sie <cq:include> oder <sling:include> verwenden?

  • Bei der Entwicklung von AEM-Komponenten empfiehlt Adobe die Verwendung von <cq:include>.
  • <cq:include> ermöglicht das direkte Einfügen von Skriptdateien anhand ihres Namens, wenn Sie das script-Attribut verwenden. Dabei werden Komponenten- und Ressourcentypvererbung berücksichtigt. Diese ist häufig einfacher als die strikte Einhaltung der Skriptauflösung von Sling mithilfe von Selektoren und Erweiterungen.

cq:includeClientLib

VORSICHT

<cq:includeClientLib> ist seit AEM 5.6 veraltet. <ui:includeClientLib> sollte stattdessen verwendet werden.

Das <cq:includeClientLib>-Tag enthält eine AEM HTML-Client-Bibliothek, bei der es sich um eine js-, css- oder Designbibliothek handeln kann. Für mehrere Inklusionen verschiedener Typen, z. B. js und css, muss dieses Tag mehrmals in der jsp-Datei verwendet werden. Dieses Tag ist ein praktischer Wrapper für die Dienstschnittstelle com.day.cq.widget.HtmlLibraryManager.

Es weist folgende Attribute auf:

kategorien - Eine Liste kommagetrennter Client-Lib-Kategorien. Dies bezieht alle Javascript-Dateien und CSS-Bibliotheken für die betreffenden Kategorien mit ein. Der Designname wird aus der Abfrage extrahiert.

Entspricht: com.day.cq.widget.HtmlLibraryManager#writeIncludes

theme - Eine Liste von kommagetrennten Client-Lib-Kategorien. Dies beinhaltet alle designbezogenen Bibliotheken (CSS und JS) für die entsprechenden Kategorien. Der Designname wird aus der Abfrage extrahiert.

Entspricht: com.day.cq.widget.HtmlLibraryManager#writeThemeInclude

js - Eine Liste kommagetrennter Client-Lib-Kategorien. Dies bezieht alle Javascript-Bibliotheken für die betreffenden Kategorien mit ein.

Entspricht: com.day.cq.widget.HtmlLibraryManager#writeJsInclude

css - Eine Liste kommagetrennter Client-Lib-Kategorien. Dies bezieht alle CSS-Bibliotheken für die betreffenden Kategorien mit ein.

Entspricht: com.day.cq.widget.HtmlLibraryManager#writeCssInclude

themed - Ein Flag, das nur die Bibliotheken mit oder ohne Themen anzeigt, sollte eingeschlossen werden. Wenn ausgelassen, sind beide Sätze enthalten. Gilt nur, wenn nur JS oder nur CSS enthalten ist (nicht wenn Kategorien oder Designs enthalten sind).

Das <cq:includeClientLib>-Tag kann wie folgt in einem JSP verwendet werden:

<%-- all: js + theme (theme-js + css) --%>
<cq:includeClientLib categories="cq.wcm.edit" />

<%-- only js libs --%>
<cq:includeClientLib js="cq.collab.calendar, cq.security" />

<%-- theme only (theme-js + css) --%>
<cq:includeClientLib theme="cq.collab.calendar, cq.security" />

<%-- css only --%>
<cq:includeClientLib css="cq.collab.calendar, cq.security" />

cq:defineObjects

Das <cq:defineObjects>-Tag stellt die folgenden, regelmäßig verwendeten Skriptobjekte zur Verfügung, auf die der Entwickler verweisen kann. Sie stellt auch die Objekte offen, die durch das <sling:defineObjects>-Tag definiert werden.

componentContext

  • das aktuelle Komponentenkontextobjekt der Anfrage (com.day.cq.wcm.api.components.ComponentContext-Schnittstelle).

component

  • das aktuelle AEM-Komponentenobjekt der aktuellen Ressource (com.day.cq.wcm.api.components.Component-Schnittstelle).

currentDesign

  • das aktuelle Entwurfsobjekt der aktuellen Seite (com.day.cq.wcm.api.designer.Design-Schnittstelle).

currentPage

  • das aktuelle AEM WCM-Seitenobjekt (com.day.cq.wcm.api.Page-Schnittstelle).

currentStyle

  • das aktuelle Stilobjekt der aktuellen Zelle (com.day.cq.wcm.api.designer.Style-Schnittstelle).

designer

  • das designer-Objekt für den Zugriff auf Entwurfsinformationen (com.day.cq.wcm.api.designer.Designer-Schnittstelle).

editContext

  • das Bearbeitungskontext-Objekt der AEM-Komponente (com.day.cq.wcm.api.components.EditContext-Schnittstelle).

pageManager

  • das Seitenmanager-Objekt für Vorgänge auf Seitenebene (com.day.cq.wcm.api.PageManager-Schnittstelle).

pageProperties

  • das Seiteneigenschaftenobjekt der aktuellen Seite (org.apache.sling.api.resource.ValueMap).

Eigenschaften

  • das Eigenschaftenobjekt der aktuellen Ressource (org.apache.sling.api.resource.ValueMap).

resourceDesign

  • das Entwurfsobjekt der Ressourcenseite (com.day.cq.wcm.api.designer.Design-Schnittstelle).

resourcePage

  • das Ressourcenseitenobjekt (com.day.cq.wcm.api.Page-Schnittstelle).
  • Es weist folgende Attribute auf:

requestName

  • von Sling geerbt

responseName

  • von Sling geerbt

resourceName

  • von Sling geerbt

nodeName

  • von Sling geerbt

logName

  • von Sling geerbt

resourceResolverName

  • von Sling geerbt

slingName

  • von Sling geerbt

componentContextName

  • spezifisch für wcm

editContextName

  • spezifisch für wcm

propertiesName

  • spezifisch für wcm

pageManagerName

  • spezifisch für wcm

currentPageName

  • spezifisch für wcm

resourcePageName

  • spezifisch für wcm

pagePropertiesName

  • spezifisch für wcm

componentName

  • spezifisch für wcm

designerName

  • spezifisch für wcm

currentDesignName

  • spezifisch für wcm

resourceDesignName

  • spezifisch für wcm

currentStyleName

  • spezifisch für wcm

Beispiel

<%@page session="false" contentType="text/html; charset=utf-8" %><%
%><%@ page import="com.day.cq.wcm.api.WCMMode" %><%
%><%@taglib prefix="cq" uri="https://www.day.com/taglibs/cq/1.0" %><%
%><cq:defineObjects/>
HINWEIS

Wenn die Datei /libs/foundation/global.jsp im Skript enthalten ist, wird das Tag <cq:defineObjects /> automatisch eingefügt.

cq:requestURL

Das <cq:requestURL>-Tag schreibt die aktuelle Anforderungs-URL in den JspWriter. Die beiden Tags <cq:addParam> und <cq:removeParam> können im Hauptteil dieses Tags verwendet werden, um die aktuelle Anforderungs-URL zu ändern, bevor sie geschrieben wird.

Sie können Links zur aktuellen Seite mit variierenden Parametern erstellen. Beispielsweise können Sie die Anforderung umwandeln:

mypage.html?mode=view&query=something in mypage.html?query=something.

Die Verwendung von addParam oder removeParam ändert nur das Vorkommen des angegebenen Parameters, alle anderen Parameter sind nicht betroffen.

<cq:requestURL> hat kein Attribut.

Beispiele:

<a href="<cq:requestURL><cq:removeParam name="language"/></cq:requestURL>">remove filter</a>
<a title="filter results" href="<cq:requestURL><cq:addParam name="language" value="${bucket.value}"/></cq:requestURL>">${label} (${bucket.count})</a>

cq:addParam

Das <cq:addParam>-Tag fügt dem umschließenden <cq:requestURL>-Tag einen Anforderungsparameter mit dem angegebenen Namen und Wert hinzu.

Es weist folgende Attribute auf:

name

  • Name des Parameters, der hinzugefügt werden soll

value

  • Wert des Parameters, der hinzugefügt werden soll

Beispiel:

<a title="filter results" href="<cq:requestURL><cq:addParam name="language" value="${bucket.value}"/></cq:requestURL>">${label} (${bucket.count})</a>

cq:removeParam

Das <cq:removeParam>-Tag entfernt einen Anforderungsparameter mit dem angegebenen Namen und Wert aus dem umschließenden <cq:requestURL>-Tag. Wenn kein Wert angegeben wird, werden alle Parameter mit dem jeweiligen Namen entfernt.

Es weist folgende Attribute auf:

name

  • Name des Parameters, der entfernt werden soll

Beispiel:

<a href="<cq:requestURL><cq:removeParam name="language"/></cq:requestURL>">remove filter</a>

Tag-Bibliothek von Sling

Die Tag-Bibliothek von Sling enthält hilfreiche Sling-Funktionen.

Wenn Sie die Tag-Bibliothek von Sling in Ihrem Skript verwenden, muss das Skript mit dem folgenden Code beginnen:

<%@ taglib prefix="sling" uri="https://sling.apache.org/taglibs/sling/1.0" %>
HINWEIS

Wenn die Datei /libs/foundation/global.jsp im Skript enthalten ist, wird das sling-Tag automatisch deklariert.

sling:include

Das <sling:include>-Tag enthält eine Ressource in die aktuelle Seite.

Es weist folgende Attribute auf:

flush

  • Ein boolescher Wert, der definiert, ob die Ausgabe geleert werden soll, bevor das Ziel eingefügt wird.

Ressource

  • Das Ressourcenobjekt, das in die aktuelle Anforderungsverarbeitung eingefügt werden soll. resource oder path muss angegeben werden. Wenn beide angegeben sind, hat resource Vorrang.

path

  • Der Pfad zum Ressourcenobjekt, das in die aktuelle Anforderungsverarbeitung eingefügt werden soll. Ein relativer Pfad wird an den Pfad der aktuellen Ressource angehängt, deren Skript die angegebene Ressource enthält. resource oder path muss angegeben werden. Wenn beide angegeben sind, hat resource Vorrang.

resourceType

  • Der Ressourcentypen der Ressource, die hinzugefügt werden soll. Wenn der Ressourcentyp festgelegt ist, muss der Pfad der genaue Pfad zu einem Ressourcenobjekt sein: in diesem Fall wird das Hinzufügen von Parametern, Selektoren und Erweiterungen zum Pfad nicht unterstützt.
  • Falls die einzufügende Ressource mit dem path-Attribut angegeben ist, das nicht in eine Ressource aufgelöst werden kann, erstellt das Tag möglicherweise ein synthetisches Ressourcenobjekt aus dem Pfad und diesem Ressourcentyp.

replaceSelectors

  • Beim Versenden werden die Selektoren durch den Wert dieses Attributs ersetzt.

addSelectors

  • Beim Versenden wird der Wert dieses Attributs den Selektoren hinzugefügt.

replaceSuffix

  • Beim Versenden wird das Suffix durch den Wert dieses Attributs ersetzt.
HINWEIS

Die Auflösung der Ressource und des Skripts, die im Tag <sling:include> enthalten sind, ist identisch mit der einer normalen Sling-URL-Auflösung. Standardmäßig werden die Selektoren, die Erweiterung usw. der aktuellen Anforderung auch für das enthaltene Skript verwendet. Sie können mithilfe der Tag-Attribute geändert werden: Zum Beispiel können Sie replaceSelectors="foo.bar" die Selektoren überschreiben.

Beispiele:

<div class="item"><sling:include path="<%= pathtoinclude %>"/></div>
<sling:include resource="<%= par %>"/>
<sling:include addSelectors="spool"/>
<sling:include resource="<%= par %>" resourceType="<%= newType %>"/>
<sling:include resource="<%= par %>" resourceType="<%= newType %>"/>
<sling:include replaceSelectors="content" />

sling:defineObjects

Das <sling:defineObjects>-Tag stellt die folgenden, regelmäßig verwendeten Skriptobjekte zur Verfügung, auf die der Entwickler verweisen kann:

slingRequest

  • SlingHttpServletRequest-Objekt, bietet Zugriff auf die Informationen der HTTP-Anforderungskopfzeile – erweitert die standardmäßige HttpServletRequest – und auf Sling-spezifische Dinge wie Ressource, Pfadinformationen, Selektor usw.

slingResponse

  • SlingHttpServletResponse-Objekt, bietet Zugriff für die HTTP-Antwort, die vom Server erstellt wird. Dies ist derzeit dieselbe wie die HttpServletResponse, von der aus sie erweitert wird.request
  • das Standard-JSP-Anforderungsobjekt, bei dem es sich um eine reine HttpServletRequest handelt.response
  • das Standard-JSP-Antwortobjekt, bei dem es sich um ein reines HttpServletResponse-Objekt handelt.

resourceResolver

  • das aktuelle ResourceResolver-Objekt. Entspricht slingRequest.getResourceResolver()

.sling

  • ein SlingScriptHelper-Objekt, das komfortable Methoden für Skripte enthält, hauptsächlich sling.include('/some/other/resource') zum Einfügen der Antworten anderer Ressourcen innerhalb dieser Antwort (z. B. Einbetten von Kopfzeilen-HTML-Snippets) und sling.getService(foo.bar.Service.class) zum Abrufen der verfügbaren OSGi-Dienste in Sling (Klassennotation abhängig von Skriptingsprache).

Ressource

  • das derzeit zu bearbeitende Ressourcenobjekt, abhängig von der URL der Anforderung. Entspricht slingRequest.getResource().

currentNode

  • Falls die aktuelle Ressource auf einen JCR-Knoten verweist (was in der Regel bei Sling der Fall ist), verleiht dies dem Knotenobjekt direkten Zugriff. Andernfalls ist dieses Objekt nicht definiert.

log

  • Stellt einen SLF4J Logger zum Protokollieren des Sling-Protokollsystems in Skripten bereit, z. B. log.info("Executing my script").

  • Es weist folgende Attribute auf:

requestName

responseName

nodeName

l ogName resourceResolverName

slingName

Beispiel:

<%@page session="false" %><%
%><%@page import="com.day.cq.wcm.foundation.forms.ValidationHelper"%><%
%><%@taglib prefix="sling" uri="https://sling.apache.org/taglibs/sling/1.0" %><%
%><sling:defineObjects/>

Tag-Bibliothek von JSTL

Die JavaServer-Seiten Standard-Tag-Bibliothek enthält viele nützliche und Standard-Tags. Die Kern-, Formatierungs- und Funktionstaglibs werden durch das /libs/foundation/global.jsp definiert, wie im folgenden Codefragment dargestellt.

Auszug aus /libs/foundation/global.jsp

<%@taglib prefix="c" uri="https://java.sun.com/jsp/jstl/core" %>
<%@taglib prefix="fmt" uri="https://java.sun.com/jsp/jstl/fmt" %>
<%@taglib prefix="fn" uri="https://java.sun.com/jsp/jstl/functions" %>

Nach dem Importieren der Datei /libs/foundation/global.jsp können Sie die Präfixe c, fmt und fn verwenden, um auf diese Taglibs zuzugreifen. Die offizielle Dokumentation der JSTL ist verfügbar unter Das Java EE 5-Tutorial – standardmäßige Tag-Bibliothek JavaServer-Seiten.

Auf dieser Seite

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now