*/
    protected final SmbAuthException getRequestingException() {
        return sae;
    }

    /**
     * Used internally by jCIFS when an <code>SmbAuthException</code> is trapped to retrieve new user credentials.
     * @param url the URL that requires authentication
     * @param sae the authentication exception that was thrown
     * @return credentials returned by prompt or null if none available

                fos = new FileOutputStream(newFile);
                writer = new BufferedWriter(new OutputStreamWriter(fos, Constants.UTF_8));
                fos = null; // Successfully wrapped, no need to close explicitly
            } catch (final Exception e) {
                if (fos != null) {
                    try {
                        fos.close();

     * Instance a <code>SpnegoContext</code> object by wrapping a {@link SSPContext}
     * with the same mechanism this {@link SSPContext} used.
     *
     * @param source
     *            the {@link SSPContext} to be wrapped
     */
    SpnegoContext(final Configuration config, final SSPContext source) {
        this(config, source, source.getSupportedMechs());
    }

    /**

                fos = new FileOutputStream(newFile);
                writer = new BufferedWriter(new OutputStreamWriter(fos, Constants.UTF_8));
                fos = null; // Successfully wrapped, no need to close explicitly
            } catch (final Exception e) {
                if (fos != null) {
                    try {
                        fos.close();

     */
    public QueryStringBuilder() {
        // Default constructor
    }

    /**
     * Quotes a string value if it contains spaces.
     * Multi-word values are wrapped in double quotes with internal quotes replaced by spaces.
     *
     * @param value the string value to quote
     * @return the quoted string if it contains spaces, otherwise the original value
     */

                fos = new FileOutputStream(newFile);
                writer = new BufferedWriter(new OutputStreamWriter(fos, Constants.UTF_8));
                fos = null; // Successfully wrapped, no need to close explicitly
            } catch (final Exception e) {
                if (fos != null) {
                    try {
                        fos.close();

        } catch (final ContainerNotAvailableException e) {
            if (logger.isDebugEnabled()) {
                logger.debug("Crawler is stopped.", e);
            } else if (logger.isInfoEnabled()) {
                logger.info("Crawler is stopped.");
            }
            exitCode = Constants.EXIT_FAIL;
        } catch (final Throwable t) {
            logger.error("Crawler terminated unexpectedly.", t);

    /**
     * A resolver for login credentials that wraps the standard credential resolver
     * to provide SSO authentication support.
     */
    public static class LoginCredentialResolver {
        /** The wrapped credential resolver. */
        private final TypicalLoginAssist<String, FessUserBean, FessUser>.CredentialResolver resolver;

        /**
         * Creates a new login credential resolver.
         *

    }

    /**
     * Retrieves the character mapping file for the specified dictionary ID.
     * <p>
     * This method looks up the dictionary file and ensures it is a character mapping file
     * before returning it wrapped in an OptionalEntity.
     * </p>
     *
     * @param dictId the dictionary ID to retrieve the character mapping file for
     * @return an OptionalEntity containing the character mapping file if found and valid, empty otherwise

 * </p>
 * <p>
 * Any {@link IOException} thrown by these methods is wrapped and thrown as an {@link IORuntimeException}.
 * </p>
 *
 * @author koichik
 */
public abstract class CopyUtil {

    /**
     * Do not instantiate.
     */
    protected CopyUtil() {
    }