*
     * @param func the callback function to build XContent
     * @param mediaType the media type for the content builder
     * @return an OutputStream containing the built content, or an empty ByteArrayOutputStream if an error occurs
     */
    public static OutputStream getXContentBuilderOutputStream(final XContentBuilderCallback func, final MediaType mediaType) {

     *
     * @param <T> The return type of the function
     * @param func The function to apply to the virtual host key
     * @param defaultValue The default value to return if no virtual host matches
     * @return The result of applying the function, or the default value
     */
    protected <T> T processVirtualHost(final Function<String, T> func, final T defaultValue) {

         *
         * @param runtime the action runtime
         * @param func the function to execute
         * @return the action response
         */
        public ActionResponse godHandPrologue(final ActionRuntime runtime, final Function<ActionRuntime, ActionResponse> func) {
            return func.apply(runtime);
        }

        /**
         * Monologue hook for action processing.

     *
     * @param <T> The response type.
     * @param func The function to execute.
     * @return The response from the operation.
     */
    public <T> T get(final Function<FesenClient, ActionFuture<T>> func) {
        int retryCount = 0;
        while (true) {
            try {
                return func.apply(this).actionGet(connTimeout, TimeUnit.MILLISECONDS);

            log.debug("UNC is '" + oldUncPath + "'");
            log.debug("Consumed '" + oldUncPath.substring(0, pathConsumed) + "'");
        }
        String dunc = oldUncPath.substring(pathConsumed);
        if (log.isDebugEnabled()) {
            log.debug("Remaining '" + dunc + "'");
        }

        if (dunc.equals("") || dunc.equals("\\")) {
            dunc = "\\";

            } else if (dr.pathConsumed > unc.length()) {
                dr.pathConsumed = unc.length();
            }
            String dunc = unc.substring(dr.pathConsumed);
            if (dunc.equals("")) {
                dunc = "\\";
            }
            if (!dr.path.equals("")) {
                dunc = "\\" + dr.path + dunc;
            }

            unc = dunc;

        when(dr.getShare()).thenReturn("dfs-share");
        when(dr.getPath()).thenReturn("dfs/path");
        when(dr.getPathConsumed()).thenReturn(2); // consume leading \\ from UNC

        String newUnc = l.handleDFSReferral(dr, "\\req\\");
        // dunc is "\\" + path + remaining  - note: path may not have leading backslashes
        assertTrue(newUnc.contains("dfs/path") || newUnc.contains("dfs\\path"));

     */
    String getDomain();

    /**
     * Gets the full UNC path.
     *
     * @return the full UNC path
     */
    String getFullUNCPath();

    /**
     * Sets the path to the resource.
     *
     * @param path the path to set
     */
    void setPath(String path);

    /**
     * Sets the full UNC path components.
     *
     * @param domain the domain name

        final String unc = loc.getUNCPath();
        final String p = loc.getURL().getPath();
        if (p.lastIndexOf('/') != p.length() - 1) {
            throw new SmbException(loc.getURL() + " directory must end with '/'");
        }
        if (unc.lastIndexOf('\\') != unc.length() - 1) {
            throw new SmbException(unc + " UNC must end with '\\'");
        }

     *
     * @return the share this referral points to
     */
    String getShare();

    /**
     * Get the number of characters from the UNC path that were consumed by this referral
     *
     * @return the number of characters from the unc path that were consumed by this referral
     */
    int getPathConsumed();

    /**
     * Get the replacement path for this referral
     *