如何在 Wicket 1.5 中模仿 HybridUrlCodingStrategy？

Question

我们有一个现有的 Java Wicket 1.4 应用程序，它广泛使用 HybridUrlCodingStrategy：

mount(new HybridUrlCodingStrategy("/myurl", MyPage.class));

这导致我们的 URL 看起来像这样：

http://host/myurl/paramName1/paramValue1/paramName2/paramValue2

我想在 Wicket 1.5 中保留此 URL 格式，但是 HybridUrlCodingStrategy 已被删除。在 wicket 1.5 中，页面安装为：

mountPage("/myurl", MyPage.class);

传统 URL 的结果如下：

http://host/myurl?paramName1=paramValue2&paramName2=paramValue2

我读到我们应该使用 MountedMapper 类，但是查看 Wicket 1.5 示例、API 文档和源代码，我仍然不清楚如何使用 MountedMapper 获得与 HybridUrlCodingStrategy 相同的行为。

有谁知道该怎么做？

Answer 1

也许是这样的：

mountPage("/myurl/paramName1/${paramValue1}/paramName2/${paramValue2}", MyPage.class)

会起作用吗？当然，您必须手动指定参数，这可能需要更多工作。
MountedMapper 类 javadoc 解释了如何使用参数。

我能想到的另一个选择是（注意：这是未经测试的）：

class MyPageParametersEncoder implements IPageParametersEncoder() {
    public PageParameters decodePageParameters(Request request)
    {
        PageParameters parameters = new PageParameters();

        int i = 0;
        for (Iterator<String> segment = request.getUrl().getSegements().iterator(); segment.hasNext()) {
            String key = segment.next();
            String value = segment.next();

            parameters.add(key, value);
        }

        return parameters.isEmpty() ? null : parameters;
    }

    public Url encodePageParameters(PageParameters pageParameters)
    {
        Url url = new Url();

        for (PageParemeters.NamedPair pair : pageParameters.getAllNamed() {
            url.getSegments().add(pair.getKey());
            url.getSegments().add(pair.getValue());
        }

        return url;
    }
}

mount(new MountedMapper("/myurl/", MyPage.class, new MyPageParametersEncoder());

Answer 2

无需自定义 IPageParametersEncoder。

使用 mountPage("/myurl/paramName1/${paramValue1}/paramName2/${paramValue2}", MyPage.class) 时，URL 将类似于 1.4 中的内容，但可以通过 StringValue value1 =parameters.get("paramValue1" 来访问值）。 value2 类似。

根据提取值，mountPage("/myurl/${paramValue1}/${paramValue2}", MyPage.class) 是相同的，只是将使用更短的 URL。

它还支持可选参数 - #{optionalValue3}。

Answer 3

注意：Wicket 1.5.2 中添加了一个新类，以向后兼容 1.4 样式 URL 编码。它称为 UrlPathPageParametersEncoder - 如果您要将 wicket 1.4 应用程序迁移到 1.5，并且您有以下样式的可书签页面链接，请使用它：

www.mysite.com/name1/value1/name2/value2

从 1.4 迁移时我们遇到了完全相同的问题至 1.5。任何已经运行一段时间的 1.4 应用程序都可能有一组从网络上的外部站点指向它的链接。您确实希望应用程序的 Wicket 1.5 版本能够处理这些现有的混合链接而不生成错误。

迁移到 1.5 时，如果没有 1.4 兼容的 IPageParametersEncoder 实现，如果您想避免对读取参数的每个单独 Page 类进行更改，则需要在每次装载中包含完整的参数规范。下面的实现意味着不再需要。只需按照上面 livid 的建议安装页面即可。

我将此 .java 文件作为补丁提交给 Wicket 开发人员 - 他们将来可能会将其包含在 Wicket 中，以便轻松为其他 1.4 迁移器实现向后兼容的 URL 参数编码。

我采用了上面 luniv 的示例代码，并做了一些小的更改以使其编译/工作。以下内容应作为参数编码器，在 1.5 中提供 1.4.x 风格的参数编码。

    package org.apache.wicket.request.mapper.parameter;

    import java.lang.*;

    import org.apache.wicket.request.mapper.parameter.IPageParametersEncoder;

    import java.util.Iterator;

    import org.apache.wicket.request.Request;

    import org.apache.wicket.request.Url;

    import org.apache.wicket.request.mapper.parameter.PageParameters;

    public 
    class HybridPageParametersEncoder implements IPageParametersEncoder
    {
    /**
     * Encodes a URL in the form:
     * 
     * /mountpoint/paramName1/paramValue1/paramName2/paramValue2 
     * 
     * (i.e. a URL using the pre wicket 1.5 Hybrid URL strategy)
     */
    public Url encodePageParameters(PageParameters pageParameters)
    {
        Url url = new Url();

        for (PageParameters.NamedPair pair : pageParameters.getAllNamed())
        {
            url.getSegments().add(pair.getKey());
            url.getSegments().add(pair.getValue());
        }

        return url;
    }

    /**
     * Decodes a URL in the form:
     * 
     * /mountpoint/paramName1/paramValue1/paramName2/paramValue2 
     * 
     * (i.e. a URL using the pre wicket 1.5 Hybrid URL strategy)
     */
    public PageParameters decodePageParameters(Request request)
    {
        PageParameters parameters = new PageParameters();

        int i = 0;
        for (Iterator<String> segment = request.getUrl().getSegments().iterator(); segment.hasNext(); )
        {
            String key = segment.next();
            String value = segment.next();

            parameters.add(key, value);
        }

        return parameters.isEmpty() ? null : parameters;
    }
}