HTL Java Use-API
HTL Java Use-API를 사용하면 HTL 파일이 사용자 정의 Java 클래스의 도우미 메서드에 액세스할 수 있습니다.
사용 사례
HTL Java Use-API를 사용하면 HTL 파일이 data-sly-use를 통해 사용자 정의 Java 클래스의 도우미 메서드에 액세스할 수 있습니다. 이 방법을 통해 모든 복잡한 비즈니스 논리를 Java 코드에 캡슐화할 수 있지만 HTL 코드는 직접 마크업 생성만 처리합니다.
Java Use-API 오브젝트는 POJO의 기본 생성자를 통해 특정 구현에 의해 인스턴스화된 간단한 POJO가 될 수 있습니다.
Use-API POJO는 다음 서명을 사용하여 init라고 하는 공용 메서드를 노출할 수도 있습니다.
/**
* Initializes the Use bean.
*
* @param bindings All bindings available to the HTL scripts.
**/
public void init(javax.script.Bindings bindings);
bindings 맵에는 Use-API 오브젝트가 처리에 사용할 수 있는 현재 실행된 HTL 스크립트에 컨텍스트를 제공하는 오브젝트가 포함될 수 있습니다.
간단한 예
이 예제에서는 Use-API의 사용 방법에 대해 설명합니다.
노트use-class가 없는 HTL 구성 요소(info,라고 함)부터 시작합니다. 단일 파일 /apps/my-example/components/info.html로 구성됩니다.
<div>
<h1>${properties.title}</h1>
<p>${properties.description}</p>
</div>
/content/my-example/에서 렌더링할 이 구성 요소에 대한 몇 가지 콘텐츠도 추가합니다.
{
"sling:resourceType": "my-example/component/info",
"title": "My Example",
"description": "This Is Some Example Content."
}
이 콘텐츠에 액세스하면 HTL 파일이 실행됩니다. HTL 코드 내에서 현재 리소스의 title 및 description에 액세스하고 이를 표시하기 위해서는 컨텍스트 오브젝트 properties가 사용됩니다. 출력 파일 /content/my-example.html은 다음과 같습니다.
<div>
<h1>My Example</h1>
<p>This Is Some Example Content.</p>
</div>
Use-Class 추가
info 구성 요소는 간단한 기능을 수행하기 위해 use-class가 필요하지 않습니다. 단, HTL에서 수행할 수 없는 작업을 수행해야 하므로 use-class가 필요한 경우가 있습니다. 하지만 다음 사항에 유의하십시오.
노트예를 들어 info 구성 요소가 리소스의 title 및 description 속성을 표시하지만 모두 소문자로 표시하기를 원한다고 가정합니다. HTL에는 문자열을 소문자로 변환하는 메서드가 없으므로 Java use-class를 추가하고 /apps/my-example/component/info/info.html을 다음과 같이 변경할 수 있습니다.
<div data-sly-use.info="Info">
<h1>${info.lowerCaseTitle}</h1>
<p>${info.lowerCaseDescription}</p>
</div>
또한 /apps/my-example/component/info/Info.java가 생성됩니다.
package apps.my_example.components.info;
import com.adobe.cq.sightly.WCMUsePojo;
public class Info extends WCMUsePojo {
private String lowerCaseTitle;
private String lowerCaseDescription;
@Override
public void activate() throws Exception {
lowerCaseTitle = getProperties().get("title", "").toLowerCase();
lowerCaseDescription = getProperties().get("description", "").toLowerCase();
}
public String getLowerCaseTitle() {
return lowerCaseTitle;
}
public String getLowerCaseDescription() {
return lowerCaseDescription;
}
}
자세한 내용은 com.adobe.cq.sightly.WCMUsePojo용 Javadocs를 참조하십시오.
이제 코드의 여러 부분을 살펴보겠습니다.
로컬 및 번들 Java 클래스 비교
Java use-class는 두 가지 방법으로 설치할 수 있습니다.
- 로컬 - 로컬 설치에서 Java 소스 파일은 HTL 파일과 함께 동일한 저장소 폴더에 배치됩니다. 소스는 요청 시 자동으로 컴파일됩니다. 별도의 컴파일 또는 패키징 단계가 필요하지 않습니다.
- 번들 - 번들 설치에서 Java 클래스는 표준 AEM 번들 배포 메커니즘을 사용하여 OSGi 번들 내에서 컴파일되고 배포되어야 합니다(번들 Java 클래스 섹션 참조).
언제 어떤 방법을 사용해야 하는지 알기 위해서는 두 가지 사항을 염두에 두어야 합니다.
- use-class가 해당 구성 요소와 관련된 경우 로컬 Java use-class 가 권장됩니다.
- Java 코드가 여러 HTL 구성 요소에서 액세스되는 서비스를 구현하는 경우 번들 Java 사용 클래스 가 권장됩니다.
이 예에서는 로컬 설치를 사용합니다.