Package io.wcm.handler.url

Interface UrlBuilder

  • @ProviderType
public interface UrlBuilder
    Define URL handling requests using builder pattern.

    • Method Detail

      • selectors

        @NotNull
@NotNull UrlBuilder selectors​(String selectors)
        Set selectors
        Parameters:
        selectors - Selector string
        Returns:
        URL builder

      • extension

        @NotNull
@NotNull UrlBuilder extension​(String extension)
        Set file extension
        Parameters:
        extension - file extension
        Returns:
        URL builder

      • suffix

        @NotNull
@NotNull UrlBuilder suffix​(String suffix)
        Set suffix
        Parameters:
        suffix - Suffix string
        Returns:
        URL builder

      • queryString

        @NotNull
@NotNull UrlBuilder queryString​(String queryString)
        Set query parameters string
        Parameters:
        queryString - Query parameters string (properly url-encoded)
        Returns:
        URL builder

      • queryString

        @NotNull
@NotNull UrlBuilder queryString​(String queryString,
                                Set<String> inheritableParameterNames)
        Set query parameters string
        Parameters:
        queryString - Query parameters string (properly url-encoded)
        inheritableParameterNames - Names of query string parameters that should be inherited from the current request
        Returns:
        URL builder

      • fragment

        @NotNull
@NotNull UrlBuilder fragment​(String fragment)
        Set fragment identifier
        Parameters:
        fragment - Fragment identifier
        Returns:
        URL builder

      • urlMode

        @NotNull
@NotNull UrlBuilder urlMode​(UrlMode urlMode)
        Set URL mode for externalizing the URL
        Parameters:
        urlMode - URL mode. If null, default URL mode is used.
        Returns:
        URL builder

      • build

        @Nullable
@Nullable String build()
        Build URL
        Returns:
        URL

      • buildExternalLinkUrl

        @Nullable
@Nullable String buildExternalLinkUrl()
        Build externalized URL that links to a content page. This may only be used if a page was given in the UrlHandler.get(Page) call.
        Returns:
        URL

      • buildExternalLinkUrl

        @Nullable
@Nullable String buildExternalLinkUrl​(@Nullable
                                      @Nullable com.day.cq.wcm.api.Page targetPage)
        Build externalized URL that links to a content page.
        Parameters:
        targetPage - Target page of internal link (e.g. for checking url configuration and secure mode)
        Returns:
        URL

      • buildExternalResourceUrl

        @Nullable
@Nullable String buildExternalResourceUrl()
        Build externalized URL that links to a resource (e.g. image, CSS or JavaScript reference).
        Returns:
        URL

      • buildExternalResourceUrl

        @Nullable
@Nullable String buildExternalResourceUrl​(@Nullable
                                          @Nullable org.apache.sling.api.resource.Resource targetResource)
        Build externalized URL that links to a resource (e.g. image, CSS or JavaScript reference).
        Parameters:
        targetResource - Target resource of resource link (e.g. for checking url configuration)
        Returns:
        URL