/*
 * Licensed to the Apache Software Foundation (ASF) under one or more
 * contributor license agreements.  See the NOTICE file distributed with
 * this work for additional information regarding copyright ownership.
 * The ASF licenses this file to You under the Apache License, Version 2.0
 * (the "License"); you may not use this file except in compliance with
 * the License.  You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package org.apache.commons.vfs2.provider.ftp;

import java.net.Proxy;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.List;

import org.apache.commons.net.ftp.FTPReply;
import org.apache.commons.net.ftp.parser.FTPFileEntryParserFactory;
import org.apache.commons.vfs2.FileSystem;
import org.apache.commons.vfs2.FileSystemConfigBuilder;
import org.apache.commons.vfs2.FileSystemOptions;

The config builder for various ftp configuration options.
/**
 * The config builder for various ftp configuration options.
 */
public class FtpFileSystemConfigBuilder extends FileSystemConfigBuilder {

    private static final String _PREFIX = FtpFileSystemConfigBuilder.class.getName();

    private static final FtpFileSystemConfigBuilder BUILDER = new FtpFileSystemConfigBuilder();

    private static final String AUTODETECT_UTF8 = _PREFIX + ".AUTODETECT_UTF8";
    private static final String CONNECT_TIMEOUT = _PREFIX + ".CONNECT_TIMEOUT";
    private static final String DATA_TIMEOUT = _PREFIX + ".DATA_TIMEOUT";
    private static final String DEFAULT_DATE_FORMAT = _PREFIX + ".DEFAULT_DATE_FORMAT";
    private static final String ENCODING = _PREFIX + ".ENCODING";
    private static final String FACTORY_KEY = FTPFileEntryParserFactory.class.getName() + ".KEY";
    private static final String FILE_TYPE = _PREFIX + ".FILE_TYPE";
    private static final String PASSIVE_MODE = _PREFIX + ".PASSIVE";
    private static final String PROXY = _PREFIX + ".PROXY";
    private static final String RECENT_DATE_FORMAT = _PREFIX + ".RECENT_DATE_FORMAT";
    private static final String REMOTE_VERIFICATION = _PREFIX + ".REMOTE_VERIFICATION";
    private static final String SERVER_LANGUAGE_CODE = _PREFIX + ".SERVER_LANGUAGE_CODE";
    private static final String SERVER_TIME_ZONE_ID = _PREFIX + ".SERVER_TIME_ZONE_ID";
    private static final String SHORT_MONTH_NAMES = _PREFIX + ".SHORT_MONTH_NAMES";
    private static final String SO_TIMEOUT = _PREFIX + ".SO_TIMEOUT";
    private static final String USER_DIR_IS_ROOT = _PREFIX + ".USER_DIR_IS_ROOT";
    private static final String TRANSFER_ABORTED_OK_REPLY_CODES = _PREFIX + ".TRANSFER_ABORTED_OK_REPLY_CODES";

    private FtpFileSystemConfigBuilder() {
        super("ftp.");
    }

    
Create new config builder with specified prefix string.
Params:
prefix – prefix string to use for parameters of this config builder.
Since:
2.1/**
     * Create new config builder with specified prefix string.
     *
     * @param prefix prefix string to use for parameters of this config builder.
     * @since 2.1
     */
    protected FtpFileSystemConfigBuilder(final String prefix) {
        super(prefix);
    }

    
Gets the singleton instance.
Returns:
the singleton instance./**
     * Gets the singleton instance.
     *
     * @return the singleton instance.
     */
    public static FtpFileSystemConfigBuilder getInstance() {
        return BUILDER;
    }

    @Override
    protected Class<? extends FileSystem> getConfigClass() {
        return FtpFileSystem.class;
    }

    public static List<Integer> getSaneTransferAbortedOkReplyCodes() {
        // See VFS-674, its accompanying PR and https://github.com/apache/commons-vfs/pull/51 as to why 426 and 550 are here
        return new ArrayList<>(Arrays.asList(FTPReply.TRANSFER_ABORTED, FTPReply.FILE_UNAVAILABLE));
    }

    
Gets whether to try to autodetect the server encoding (only UTF8 is supported).
Params:
opts – The FileSystemOptions.
Returns:
True if autodetection should be done.
Since:
2.4/**
     * Gets whether to try to autodetect the server encoding (only UTF8 is supported).
     *
     * @param opts The FileSystemOptions.
     * @return True if autodetection should be done.
     * @since 2.4
     */
    public Boolean getAutodetectUtf8(final FileSystemOptions opts) {
        return getBoolean(opts, AUTODETECT_UTF8);
    }

    
Gets the timeout in milliseconds to use for the socket connection.
Params:
opts – The FileSystemOptions.
Returns:
The timeout in milliseconds to use for the socket connection.
Since:
2.1/**
     * Gets the timeout in milliseconds to use for the socket connection.
     *
     * @param opts The FileSystemOptions.
     * @return The timeout in milliseconds to use for the socket connection.
     * @since 2.1
     */
    public Integer getConnectTimeout(final FileSystemOptions opts) {
        return getInteger(opts, CONNECT_TIMEOUT);
    }

    
Params:
opts – The FileSystemOptions.
Returns:
The encoding.
Since:
2.0/**
     * @param opts The FileSystemOptions.
     * @return The encoding.
     * @since 2.0
     */
    public String getControlEncoding(final FileSystemOptions opts) {
        return getString(opts, ENCODING);
    }

    
Params:
opts – The FileSystemOptions.
See Also:
setDataTimeout
Returns:
The timeout for opening the data channel in milliseconds./**
     * @param opts The FileSystemOptions.
     * @return The timeout for opening the data channel in milliseconds.
     * @see #setDataTimeout
     */
    public Integer getDataTimeout(final FileSystemOptions opts) {
        return getInteger(opts, DATA_TIMEOUT);
    }

    
Get the default date format used by the server. See FTPClientConfig for details and examples. 
Params:
opts – The FileSystemOptions
Returns:
The default date format./**
     * Get the default date format used by the server. See {@link org.apache.commons.net.ftp.FTPClientConfig} for
     * details and examples.
     *
     * @param opts The FileSystemOptions
     * @return The default date format.
     */
    public String getDefaultDateFormat(final FileSystemOptions opts) {
        return getString(opts, DEFAULT_DATE_FORMAT);
    }

    
Params:
opts – The FileSystemOptions.
See Also:
setEntryParser
Returns:
the key to the EntryParser./**
     * @param opts The FileSystemOptions.
     * @see #setEntryParser
     * @return the key to the EntryParser.
     */
    public String getEntryParser(final FileSystemOptions opts) {
        return getString(opts, FACTORY_KEY);
    }

    
Params:
opts – The FlleSystemOptions.
See Also:
setEntryParserFactory
Returns:
An FTPFileEntryParserFactory./**
     * @param opts The FlleSystemOptions.
     * @see #setEntryParserFactory
     * @return An FTPFileEntryParserFactory.
     */
    public FTPFileEntryParserFactory getEntryParserFactory(final FileSystemOptions opts) {
        return (FTPFileEntryParserFactory) getParam(opts, FTPFileEntryParserFactory.class.getName());
    }

    
Gets the file type parameter.
Params:
opts – The FileSystemOptions.
Returns:
A FtpFileType
Since:
2.1/**
     * Gets the file type parameter.
     *
     * @param opts The FileSystemOptions.
     * @return A FtpFileType
     * @since 2.1
     */
    public FtpFileType getFileType(final FileSystemOptions opts) {
        return getEnum(FtpFileType.class, opts, FILE_TYPE);
    }

    
Params:
opts – The FileSystemOptions.
See Also:
setPassiveMode
Returns:
true if passive mode is set./**
     * @param opts The FileSystemOptions.
     * @return true if passive mode is set.
     * @see #setPassiveMode
     */
    public Boolean getPassiveMode(final FileSystemOptions opts) {
        return getBoolean(opts, PASSIVE_MODE);
    }

    
Gets the Proxy.
Params:
opts – The FileSystemOptions.
Returns:
the Proxy
Since:
2.1/**
     * Gets the Proxy.
     *
     * @param opts The FileSystemOptions.
     * @return the Proxy
     * @since 2.1
     */
    public Proxy getProxy(final FileSystemOptions opts) {
        return (Proxy) this.getParam(opts, PROXY);
    }

    
See FTPClientConfig for details and examples. 
Params:
opts – The FileSystemOptions.
Returns:
The recent date format./**
     * See {@link org.apache.commons.net.ftp.FTPClientConfig} for details and examples.
     *
     * @param opts The FileSystemOptions.
     * @return The recent date format.
     */
    public String getRecentDateFormat(final FileSystemOptions opts) {
        return getString(opts, RECENT_DATE_FORMAT);
    }

    
Gets whether to use remote verification.
Params:
opts – The FileSystemOptions.
Returns:
True if remote verification should be done./**
     * Gets whether to use remote verification.
     *
     * @param opts The FileSystemOptions.
     * @return True if remote verification should be done.
     */
    public Boolean getRemoteVerification(final FileSystemOptions opts) {
        return getBoolean(opts, REMOTE_VERIFICATION);
    }

    
Get the language code used by the server. See FTPClientConfig for details and examples. 
Params:
opts – The FilesystemOptions.
Returns:
The language code of the server./**
     * Get the language code used by the server. See {@link org.apache.commons.net.ftp.FTPClientConfig} for details and
     * examples.
     *
     * @param opts The FilesystemOptions.
     * @return The language code of the server.
     */
    public String getServerLanguageCode(final FileSystemOptions opts) {
        return getString(opts, SERVER_LANGUAGE_CODE);
    }

    
See FTPClientConfig for details and examples. 
Params:
opts – The FileSystemOptions.
Returns:
The server timezone id./**
     * See {@link org.apache.commons.net.ftp.FTPClientConfig} for details and examples.
     *
     * @param opts The FileSystemOptions.
     * @return The server timezone id.
     */
    public String getServerTimeZoneId(final FileSystemOptions opts) {
        return getString(opts, SERVER_TIME_ZONE_ID);
    }

    
See FTPClientConfig for details and examples. 
Params:
opts – The FileSystemOptions.
Returns:
An array of short month names./**
     * See {@link org.apache.commons.net.ftp.FTPClientConfig} for details and examples.
     *
     * @param opts The FileSystemOptions.
     * @return An array of short month names.
     */
    public String[] getShortMonthNames(final FileSystemOptions opts) {
        return (String[]) getParam(opts, SHORT_MONTH_NAMES);
    }

    
Params:
opts – The FileSystem options.
See Also:
getDataTimeout
Returns:
The timeout value in milliseconds.
Since:
2.0/**
     * @param opts The FileSystem options.
     * @return The timeout value in milliseconds.
     * @see #getDataTimeout
     * @since 2.0
     */
    public Integer getSoTimeout(final FileSystemOptions opts) {
        return getInteger(opts, SO_TIMEOUT);
    }

    
Returns Boolean.TRUE if VFS should treat the user directory as the root directory. Defaults to Boolean.TRUE if the method setUserDirIsRoot(FileSystemOptions, boolean) has not been invoked. 
Params:
opts – The FileSystemOptions.
See Also:
setUserDirIsRoot
Returns:
Boolean.TRUE if VFS treats the user directory as the root directory./**
     * Returns {@link Boolean#TRUE} if VFS should treat the user directory as the root directory. Defaults to
     * <code>Boolean.TRUE</code> if the method {@link #setUserDirIsRoot(FileSystemOptions, boolean)} has not been
     * invoked.
     *
     * @param opts The FileSystemOptions.
     * @return <code>Boolean.TRUE</code> if VFS treats the user directory as the root directory.
     * @see #setUserDirIsRoot
     */
    public Boolean getUserDirIsRoot(final FileSystemOptions opts) {
        return getBoolean(opts, USER_DIR_IS_ROOT, Boolean.TRUE);
    }

    
Params:
opts – The FileSystem options.
Returns:
The list of reply codes (apart from 200) that are considered as OK when prematurely
closing a stream.
Since:
2.4/**
     * @param opts The FileSystem options.
     * @return The list of reply codes (apart from 200) that are considered as OK when prematurely
     * closing a stream.
     * @since 2.4
     */
    @SuppressWarnings("unchecked")
    public List<Integer> getTransferAbortedOkReplyCodes(final FileSystemOptions opts) {
        return (List<Integer>) getParam(opts, TRANSFER_ABORTED_OK_REPLY_CODES);
    }

    
Sets whether to try to autodetect the server encoding (only UTF8 is supported).
Params:
opts – The FileSystemOptions.
autodetectUTF8 – true if autodetection should be done.
Since:
2.4/**
     * Sets whether to try to autodetect the server encoding (only UTF8 is supported).
     *
     * @param opts The FileSystemOptions.
     * @param autodetectUTF8 true if autodetection should be done.
     * @since 2.4
     */
    public void setAutodetectUtf8(final FileSystemOptions opts, final Boolean autodetectUTF8) {
        setParam(opts, AUTODETECT_UTF8, autodetectUTF8);
    }

    
Sets the timeout for the initial control connection.
 If you set the connectTimeout to null no connectTimeout will be set. 
Params:
opts – The FileSystemOptions.
connectTimeout – the timeout value in milliseconds
Since:
2.1/**
     * Sets the timeout for the initial control connection.
     * <p>
     * If you set the connectTimeout to {@code null} no connectTimeout will be set.
     * </p>
     *
     * @param opts The FileSystemOptions.
     * @param connectTimeout the timeout value in milliseconds
     * @since 2.1
     */
    public void setConnectTimeout(final FileSystemOptions opts, final Integer connectTimeout) {
        setParam(opts, CONNECT_TIMEOUT, connectTimeout);
    }

    
See FTP.setControlEncoding for details and examples. 
Params:
opts – The FileSystemOptions.
encoding – the encoding to use
Since:
2.0/**
     * See {@link org.apache.commons.net.ftp.FTP#setControlEncoding} for details and examples.
     *
     * @param opts The FileSystemOptions.
     * @param encoding the encoding to use
     * @since 2.0
     */
    public void setControlEncoding(final FileSystemOptions opts, final String encoding) {
        setParam(opts, ENCODING, encoding);
    }

    
Set the data timeout for the ftp client.
 If you set the dataTimeout to null, no dataTimeout will be set on the ftp client. 
Params:
opts – The FileSystemOptions.
dataTimeout – The timeout value./**
     * Set the data timeout for the ftp client.
     * <p>
     * If you set the {@code dataTimeout} to {@code null}, no dataTimeout will be set on the ftp client.
     * </p>
     *
     * @param opts The FileSystemOptions.
     * @param dataTimeout The timeout value.
     */
    public void setDataTimeout(final FileSystemOptions opts, final Integer dataTimeout) {
        setParam(opts, DATA_TIMEOUT, dataTimeout);
    }

    
Set the default date format used by the server. See FTPClientConfig for details and examples. 
Params:
opts – The FileSystemOptions.
defaultDateFormat – The default date format./**
     * Set the default date format used by the server. See {@link org.apache.commons.net.ftp.FTPClientConfig} for
     * details and examples.
     *
     * @param opts The FileSystemOptions.
     * @param defaultDateFormat The default date format.
     */
    public void setDefaultDateFormat(final FileSystemOptions opts, final String defaultDateFormat) {
        setParam(opts, DEFAULT_DATE_FORMAT, defaultDateFormat);
    }

    
Set the FQCN of your FileEntryParser used to parse the directory listing from your server.
 If you do not use the default commons-net FTPFileEntryParserFactory e.g. by using setEntryParserFactory this is the "key" parameter passed as argument into your custom factory. 
Params:
opts – The FileSystemOptions.
key – The key./**
     * Set the FQCN of your FileEntryParser used to parse the directory listing from your server.
     * <p>
     * If you do not use the default commons-net FTPFileEntryParserFactory e.g. by using {@link #setEntryParserFactory}
     * this is the "key" parameter passed as argument into your custom factory.
     * </p>
     *
     * @param opts The FileSystemOptions.
     * @param key The key.
     */
    public void setEntryParser(final FileSystemOptions opts, final String key) {
        setParam(opts, FACTORY_KEY, key);
    }

    
FTPFileEntryParserFactory which will be used for ftp-entry parsing.
Params:
opts – The FileSystemOptions.
factory – instance of your factory/**
     * FTPFileEntryParserFactory which will be used for ftp-entry parsing.
     *
     * @param opts The FileSystemOptions.
     * @param factory instance of your factory
     */
    public void setEntryParserFactory(final FileSystemOptions opts, final FTPFileEntryParserFactory factory) {
        setParam(opts, FTPFileEntryParserFactory.class.getName(), factory);
    }

    
Sets the file type parameter.
Params:
opts – The FileSystemOptions.
ftpFileType – A FtpFileType
Since:
2.1/**
     * Sets the file type parameter.
     *
     * @param opts The FileSystemOptions.
     * @param ftpFileType A FtpFileType
     * @since 2.1
     */
    public void setFileType(final FileSystemOptions opts, final FtpFileType ftpFileType) {
        setParam(opts, FILE_TYPE, ftpFileType);
    }

    
Enter into passive mode.
Params:
opts – The FileSystemOptions.
passiveMode – true if passive mode should be used./**
     * Enter into passive mode.
     *
     * @param opts The FileSystemOptions.
     * @param passiveMode true if passive mode should be used.
     */
    public void setPassiveMode(final FileSystemOptions opts, final boolean passiveMode) {
        setParam(opts, PASSIVE_MODE, passiveMode ? Boolean.TRUE : Boolean.FALSE);
    }

    
Sets the Proxy.
 You might need to make sure that passive mode is activated. 
Params:
opts – the FileSystem options.
proxy – the Proxy
Since:
2.1/**
     * Sets the Proxy.
     * <p>
     * You might need to make sure that {@link #setPassiveMode(FileSystemOptions, boolean) passive mode} is activated.
     * </p>
     *
     * @param opts the FileSystem options.
     * @param proxy the Proxy
     * @since 2.1
     */
    public void setProxy(final FileSystemOptions opts, final Proxy proxy) {
        setParam(opts, PROXY, proxy);
    }

    
See FTPClientConfig for details and examples. 
Params:
opts – The FileSystemOptions.
recentDateFormat – The recent date format./**
     * See {@link org.apache.commons.net.ftp.FTPClientConfig} for details and examples.
     *
     * @param opts The FileSystemOptions.
     * @param recentDateFormat The recent date format.
     */
    public void setRecentDateFormat(final FileSystemOptions opts, final String recentDateFormat) {
        setParam(opts, RECENT_DATE_FORMAT, recentDateFormat);
    }

    
Sets whether to use remote verification.
Params:
opts – The FileSystemOptions.
remoteVerification – True if verification should be done./**
     * Sets whether to use remote verification.
     *
     * @param opts The FileSystemOptions.
     * @param remoteVerification True if verification should be done.
     */
    public void setRemoteVerification(final FileSystemOptions opts, final boolean remoteVerification) {
        setParam(opts, REMOTE_VERIFICATION, remoteVerification);
    }

    
Set the language code used by the server. See FTPClientConfig for details and examples. 
Params:
opts – The FileSystemOptions.
serverLanguageCode – The servers language code./**
     * Set the language code used by the server. See {@link org.apache.commons.net.ftp.FTPClientConfig} for details and
     * examples.
     *
     * @param opts The FileSystemOptions.
     * @param serverLanguageCode The servers language code.
     */
    public void setServerLanguageCode(final FileSystemOptions opts, final String serverLanguageCode) {
        setParam(opts, SERVER_LANGUAGE_CODE, serverLanguageCode);
    }

    
See FTPClientConfig for details and examples. 
Params:
opts – The FileSystemOptions.
serverTimeZoneId – The server timezone id./**
     * See {@link org.apache.commons.net.ftp.FTPClientConfig} for details and examples.
     *
     * @param opts The FileSystemOptions.
     * @param serverTimeZoneId The server timezone id.
     */
    public void setServerTimeZoneId(final FileSystemOptions opts, final String serverTimeZoneId) {
        setParam(opts, SERVER_TIME_ZONE_ID, serverTimeZoneId);
    }

    
See FTPClientConfig for details and examples. 
Params:
opts – The FileSystemOptions.
shortMonthNames – an array of short month name Strings./**
     * See {@link org.apache.commons.net.ftp.FTPClientConfig} for details and examples.
     *
     * @param opts The FileSystemOptions.
     * @param shortMonthNames an array of short month name Strings.
     */
    public void setShortMonthNames(final FileSystemOptions opts, final String[] shortMonthNames) {
        String[] clone = null;
        if (shortMonthNames != null) {
            clone = new String[shortMonthNames.length];
            System.arraycopy(shortMonthNames, 0, clone, 0, shortMonthNames.length);
        }

        setParam(opts, SHORT_MONTH_NAMES, clone);
    }

    
Sets the socket timeout for the FTP client.
 If you set the soTimeout to null, no socket timeout will be set on the ftp client. 
Params:
opts – The FileSystem options.
soTimeout – The timeout value in milliseconds.
Since:
2.0/**
     * Sets the socket timeout for the FTP client.
     * <p>
     * If you set the {@code soTimeout} to {@code null}, no socket timeout will be set on the ftp client.
     * </p>
     *
     * @param opts The FileSystem options.
     * @param soTimeout The timeout value in milliseconds.
     * @since 2.0
     */
    public void setSoTimeout(final FileSystemOptions opts, final Integer soTimeout) {
        setParam(opts, SO_TIMEOUT, soTimeout);
    }

    
Use user directory as root (do not change to fs root).
Params:
opts – The FileSystemOptions.
userDirIsRoot – true if the user directory should be treated as the root./**
     * Use user directory as root (do not change to fs root).
     *
     * @param opts The FileSystemOptions.
     * @param userDirIsRoot true if the user directory should be treated as the root.
     */
    public void setUserDirIsRoot(final FileSystemOptions opts, final boolean userDirIsRoot) {
        setParam(opts, USER_DIR_IS_ROOT, userDirIsRoot ? Boolean.TRUE : Boolean.FALSE);
    }

    
Sets the list of reply codes that are considered as OK when prematurely closing a stream.
 If you set the replyCodes to an empty list, all reply codes besides 200 will be considered as an error. 
Params:
opts – The FileSystem options.
replyCodes – The reply codes.
Since:
2.4/**
     * Sets the list of reply codes that are considered as OK when prematurely closing a stream.
     * <p>
     * If you set the {@code replyCodes} to an empty list, all reply codes besides 200 will be
     * considered as an error.
     * </p>
     *
     * @param opts The FileSystem options.
     * @param replyCodes The reply codes.
     * @since 2.4
     */
    public void setTransferAbortedOkReplyCodes(final FileSystemOptions opts, final List<Integer> replyCodes) {
        setParam(opts, TRANSFER_ABORTED_OK_REPLY_CODES, replyCodes);
    }
}