如何在HTL/Sightly中访问URL后缀？AEM/Sling实现咨询

首先，你不需要依赖AJAX或者单独的Servlet来渲染页面内容——AEM的组件化模型（结合HTL和Sling Model）就能完美解决这个需求，而且完全贴合Sling的资源导向原则。下面分步骤给你讲清楚：

一、直接在HTL中读取URL后缀（最简单的服务器端渲染方式） #

你可以直接在HTL模板里通过${request.pathInfo.suffix}获取URL后缀，拆分后直接渲染内容，不需要额外的Servlet：

<sly data-sly-test.suffix="${request.pathInfo.suffix}">
    <%-- 拆分后缀，注意后缀以/开头，所以数组第一个元素是空字符串 --%>
    <sly data-sly-set.nameParts="${suffix.split('/')}" />
    <sly data-sly-test="${nameParts.length >= 3}">
        <div class="staff-profile">
            <h1>Hello, ${nameParts[1]} ${nameParts[2]}!</h1>
            <p>这里可以展示更多该人员的信息，比如从JCR或外部服务获取的详情</p>
        </div>
    </sly>
    <sly data-sly-test="${nameParts.length < 3}">
        <p>请在URL后添加正确的姓名格式，例如：/mypage.html/john/smith</p>
    </sly>
</sly>
<sly data-sly-test="${!suffix}">
    <p>请提供姓名后缀，格式：/mypage.html/[名字]/[姓氏]</p>
</sly>

这种方式直接在服务器端完成渲染，性能好，也完全符合AEM的开发规范。

二、用Sling Model封装业务逻辑（更易维护的方案） #

如果需要从后端（比如JCR、外部API）获取人员的详细信息，推荐用Sling Model来封装后缀解析和数据获取逻辑，让HTL只负责渲染：

1. 创建Sling Model类 #

package com.yourproject.models;

import org.apache.sling.api.SlingHttpServletRequest;
import org.apache.sling.models.annotations.Model;
import javax.inject.Inject;

@Model(adaptables = SlingHttpServletRequest.class)
public class StaffProfileModel {
    private String firstName;
    private String lastName;
    // 可以添加更多字段，比如邮箱、部门等

    @Inject
    public StaffProfileModel(SlingHttpServletRequest request) {
        // 解析URL后缀
        String suffix = request.getRequestPathInfo().getSuffix();
        if (suffix != null) {
            String[] parts = suffix.split("/");
            if (parts.length >= 3) {
                this.firstName = parts[1];
                this.lastName = parts[2];
                // 这里可以添加从JCR查询或调用外部API获取人员详情的逻辑
            }
        }
    }

    // Getter方法
    public String getFirstName() {
        return firstName;
    }

    public String getLastName() {
        return lastName;
    }
}

2. 在HTL中使用Sling Model #

<sly data-sly-use.profile="com.yourproject.models.StaffProfileModel">
    <sly data-sly-test="${profile.firstName && profile.lastName}">
        <div class="staff-profile">
            <h1>Profile: ${profile.firstName} ${profile.lastName}</h1>
            <%-- 渲染更多从Model获取的信息 --%>
        </div>
    </sly>
    <sly data-sly-test="${!profile.firstName || !profile.lastName}">
        <p>无效的URL格式，请使用：/mypage.html/[名字]/[姓氏]</p>
    </sly>
</sly>

三、如果确实需要AJAX动态加载数据 #

如果你的页面需要在用户交互后动态更新内容，再考虑用Servlet+AJAX的方式，此时要注意Servlet的规范写法：

1. 规范编写Servlet（关联ResourceType而非硬编码路径） #

避免硬编码paths，而是关联到你的mypage页面的resourceType，这样更符合Sling的资源导向：

package com.yourproject.servlets;

import com.fasterxml.jackson.databind.ObjectMapper;
import org.apache.sling.api.SlingHttpServletRequest;
import org.apache.sling.api.SlingHttpServletResponse;
import org.apache.sling.api.servlets.SlingAllMethodsServlet;
import org.apache.sling.servlets.annotations.SlingServletResourceTypes;
import javax.servlet.Servlet;
import java.io.IOException;
import java.util.HashMap;
import java.util.Map;

@SlingServletResourceTypes(
    resourceTypes = "yourproject/components/pages/mypage",
    selectors = "profile-data",
    extensions = "json",
    methods = "GET"
)
public class StaffProfileServlet extends SlingAllMethodsServlet implements Servlet {
    @Override
    protected void doGet(SlingHttpServletRequest request, SlingHttpServletResponse response) throws IOException {
        String suffix = request.getRequestPathInfo().getSuffix();
        String firstName = "";
        String lastName = "";

        if (suffix != null) {
            String[] parts = suffix.split("/");
            if (parts.length >=3) {
                firstName = parts[1];
                lastName = parts[2];
            }
        }

        // 构建JSON响应
        Map<String, String> profileData = new HashMap<>();
        profileData.put("firstName", firstName);
        profileData.put("lastName", lastName);
        // 添加更多从后端获取的信息

        response.setContentType("application/json");
        response.setCharacterEncoding("UTF-8");
        new ObjectMapper().writeValue(response.getWriter(), profileData);
    }
}

2. 在HTL中用JavaScript调用Servlet #

<sly data-sly-test.suffix="${request.pathInfo.suffix}">
    <div id="profile-container"></div>
    <script>
        // 获取当前URL的后缀
        const suffix = "${suffix}";
        // 拼接Servlet的请求路径
        const apiUrl = `${window.location.pathname}.profile-data.json${suffix}`;

        fetch(apiUrl)
            .then(res => res.json())
            .then(data => {
                document.getElementById('profile-container').innerHTML = `
                    <h2>${data.firstName} ${data.lastName}</h2>
                    <p>动态加载的人员信息</p>
                `;
            })
            .catch(err => console.error('加载数据失败:', err));
    </script>
</sly>

总结最优实践 #

• 优先选择服务器端渲染：用HTL+Sling Model的方式，这是AEM推荐的组件化开发模式，性能更高，也更易维护。
• 避免不必要的AJAX：只有在需要动态交互时才使用Servlet+AJAX，且Servlet要关联resourceType而非硬编码路径。
• 直接使用request.pathInfo.suffix：不要手动拼接requestURI，这个API是Sling提供的标准方式，更安全可靠。

内容的提问来源于stack exchange，提问作者mrjayviper