jdk/src/java.base/share/classes/sun/net/ftp/impl/FtpClient.java
author martin
Thu, 30 Oct 2014 07:31:41 -0700
changeset 28059 e576535359cc
parent 26720 6b160d97c51d
child 31061 fead7d86d75f
permissions -rw-r--r--
8067377: My hobby: caning, then then canning, the the can-can Summary: Fix ALL the stutters! Reviewed-by: rriggs, mchung, lancea
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
4155
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
     1
/*
23010
6dadb192ad81 8029235: Update copyright year to match last edit in jdk8 jdk repository for 2013
lana
parents: 21278
diff changeset
     2
 * Copyright (c) 2009, 2013, Oracle and/or its affiliates. All rights reserved.
4155
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
     3
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
     4
 *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
     5
 * This code is free software; you can redistribute it and/or modify it
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
     6
 * under the terms of the GNU General Public License version 2 only, as
5506
202f599c92aa 6943119: Rebrand source copyright notices
ohair
parents: 4813
diff changeset
     7
 * published by the Free Software Foundation.  Oracle designates this
4155
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
     8
 * particular file as subject to the "Classpath" exception as provided
5506
202f599c92aa 6943119: Rebrand source copyright notices
ohair
parents: 4813
diff changeset
     9
 * by Oracle in the LICENSE file that accompanied this code.
4155
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    10
 *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    11
 * This code is distributed in the hope that it will be useful, but WITHOUT
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    12
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    13
 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    14
 * version 2 for more details (a copy is included in the LICENSE file that
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    15
 * accompanied this code).
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    16
 *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    17
 * You should have received a copy of the GNU General Public License version
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    18
 * 2 along with this work; if not, write to the Free Software Foundation,
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    19
 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    20
 *
5506
202f599c92aa 6943119: Rebrand source copyright notices
ohair
parents: 4813
diff changeset
    21
 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
202f599c92aa 6943119: Rebrand source copyright notices
ohair
parents: 4813
diff changeset
    22
 * or visit www.oracle.com if you need additional information or have any
202f599c92aa 6943119: Rebrand source copyright notices
ohair
parents: 4813
diff changeset
    23
 * questions.
4155
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    24
 */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    25
package sun.net.ftp.impl;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    26
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    27
import java.net.*;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    28
import java.io.*;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    29
import java.security.AccessController;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    30
import java.security.PrivilegedAction;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    31
import java.text.DateFormat;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    32
import java.text.ParseException;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    33
import java.text.SimpleDateFormat;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    34
import java.util.ArrayList;
24043
81e42b05d08b 8035807: Convert use of sun.misc.BASE64Encoder/Decoder with java.util.Base64
mchung
parents: 23010
diff changeset
    35
import java.util.Base64;
4155
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    36
import java.util.Calendar;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    37
import java.util.Date;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    38
import java.util.Iterator;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    39
import java.util.List;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    40
import java.util.TimeZone;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    41
import java.util.Vector;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    42
import java.util.regex.Matcher;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    43
import java.util.regex.Pattern;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    44
import javax.net.ssl.SSLSocket;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    45
import javax.net.ssl.SSLSocketFactory;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    46
import sun.net.ftp.*;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    47
import sun.util.logging.PlatformLogger;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    48
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    49
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    50
public class FtpClient extends sun.net.ftp.FtpClient {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    51
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    52
    private static int defaultSoTimeout;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    53
    private static int defaultConnectTimeout;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    54
    private static final PlatformLogger logger =
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    55
             PlatformLogger.getLogger("sun.net.ftp.FtpClient");
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    56
    private Proxy proxy;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    57
    private Socket server;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    58
    private PrintStream out;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    59
    private InputStream in;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    60
    private int readTimeout = -1;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    61
    private int connectTimeout = -1;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    62
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    63
    /* Name of encoding to use for output */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    64
    private static String encoding = "ISO8859_1";
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    65
    /** remember the ftp server name because we may need it */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    66
    private InetSocketAddress serverAddr;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    67
    private boolean replyPending = false;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    68
    private boolean loggedIn = false;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    69
    private boolean useCrypto = false;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    70
    private SSLSocketFactory sslFact;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    71
    private Socket oldSocket;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    72
    /** Array of strings (usually 1 entry) for the last reply from the server. */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    73
    private Vector<String> serverResponse = new Vector<String>(1);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    74
    /** The last reply code from the ftp daemon. */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    75
    private FtpReplyCode lastReplyCode = null;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    76
    /** Welcome message from the server, if any. */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    77
    private String welcomeMsg;
18212
22f8c33b0690 8001318: Socket.getLocalAddress not consistent with InetAddress.getLocalHost
khazra
parents: 16730
diff changeset
    78
    /**
22f8c33b0690 8001318: Socket.getLocalAddress not consistent with InetAddress.getLocalHost
khazra
parents: 16730
diff changeset
    79
     * Only passive mode used in JDK. See Bug 8010784.
22f8c33b0690 8001318: Socket.getLocalAddress not consistent with InetAddress.getLocalHost
khazra
parents: 16730
diff changeset
    80
     */
22f8c33b0690 8001318: Socket.getLocalAddress not consistent with InetAddress.getLocalHost
khazra
parents: 16730
diff changeset
    81
    private final boolean passiveMode = true;
4155
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    82
    private TransferType type = TransferType.BINARY;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    83
    private long restartOffset = 0;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    84
    private long lastTransSize = -1; // -1 means 'unknown size'
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    85
    private String lastFileName;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    86
    /**
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    87
     * Static members used by the parser
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    88
     */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    89
    private static String[] patStrings = {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    90
        // drwxr-xr-x  1 user01        ftp   512 Jan 29 23:32 prog
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    91
        "([\\-ld](?:[r\\-][w\\-][x\\-]){3})\\s*\\d+ (\\w+)\\s*(\\w+)\\s*(\\d+)\\s*([A-Z][a-z][a-z]\\s*\\d+)\\s*(\\d\\d:\\d\\d)\\s*(\\p{Print}*)",
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    92
        // drwxr-xr-x  1 user01        ftp   512 Jan 29 1997 prog
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    93
        "([\\-ld](?:[r\\-][w\\-][x\\-]){3})\\s*\\d+ (\\w+)\\s*(\\w+)\\s*(\\d+)\\s*([A-Z][a-z][a-z]\\s*\\d+)\\s*(\\d{4})\\s*(\\p{Print}*)",
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    94
        // 04/28/2006  09:12a               3,563 genBuffer.sh
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    95
        "(\\d{2}/\\d{2}/\\d{4})\\s*(\\d{2}:\\d{2}[ap])\\s*((?:[0-9,]+)|(?:<DIR>))\\s*(\\p{Graph}*)",
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    96
        // 01-29-97    11:32PM <DIR> prog
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    97
        "(\\d{2}-\\d{2}-\\d{2})\\s*(\\d{2}:\\d{2}[AP]M)\\s*((?:[0-9,]+)|(?:<DIR>))\\s*(\\p{Graph}*)"
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    98
    };
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
    99
    private static int[][] patternGroups = {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   100
        // 0 - file, 1 - size, 2 - date, 3 - time, 4 - year, 5 - permissions,
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   101
        // 6 - user, 7 - group
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   102
        {7, 4, 5, 6, 0, 1, 2, 3},
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   103
        {7, 4, 5, 0, 6, 1, 2, 3},
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   104
        {4, 3, 1, 2, 0, 0, 0, 0},
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   105
        {4, 3, 1, 2, 0, 0, 0, 0}};
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   106
    private static Pattern[] patterns;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   107
    private static Pattern linkp = Pattern.compile("(\\p{Print}+) \\-\\> (\\p{Print}+)$");
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   108
    private DateFormat df = DateFormat.getDateInstance(DateFormat.MEDIUM, java.util.Locale.US);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   109
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   110
    static {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   111
        final int vals[] = {0, 0};
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   112
        final String encs[] = {null};
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   113
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   114
        AccessController.doPrivileged(
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   115
                new PrivilegedAction<Object>() {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   116
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   117
                    public Object run() {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   118
                        vals[0] = Integer.getInteger("sun.net.client.defaultReadTimeout", 0).intValue();
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   119
                        vals[1] = Integer.getInteger("sun.net.client.defaultConnectTimeout", 0).intValue();
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   120
                        encs[0] = System.getProperty("file.encoding", "ISO8859_1");
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   121
                        return null;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   122
                    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   123
                });
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   124
        if (vals[0] == 0) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   125
            defaultSoTimeout = -1;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   126
        } else {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   127
            defaultSoTimeout = vals[0];
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   128
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   129
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   130
        if (vals[1] == 0) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   131
            defaultConnectTimeout = -1;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   132
        } else {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   133
            defaultConnectTimeout = vals[1];
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   134
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   135
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   136
        encoding = encs[0];
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   137
        try {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   138
            if (!isASCIISuperset(encoding)) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   139
                encoding = "ISO8859_1";
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   140
            }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   141
        } catch (Exception e) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   142
            encoding = "ISO8859_1";
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   143
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   144
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   145
        patterns = new Pattern[patStrings.length];
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   146
        for (int i = 0; i < patStrings.length; i++) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   147
            patterns[i] = Pattern.compile(patStrings[i]);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   148
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   149
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   150
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   151
    /**
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   152
     * Test the named character encoding to verify that it converts ASCII
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   153
     * characters correctly. We have to use an ASCII based encoding, or else
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   154
     * the NetworkClients will not work correctly in EBCDIC based systems.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   155
     * However, we cannot just use ASCII or ISO8859_1 universally, because in
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   156
     * Asian locales, non-ASCII characters may be embedded in otherwise
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   157
     * ASCII based protocols (eg. HTTP). The specifications (RFC2616, 2398)
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   158
     * are a little ambiguous in this matter. For instance, RFC2398 [part 2.1]
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   159
     * says that the HTTP request URI should be escaped using a defined
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   160
     * mechanism, but there is no way to specify in the escaped string what
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   161
     * the original character set is. It is not correct to assume that
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   162
     * UTF-8 is always used (as in URLs in HTML 4.0).  For this reason,
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   163
     * until the specifications are updated to deal with this issue more
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   164
     * comprehensively, and more importantly, HTTP servers are known to
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   165
     * support these mechanisms, we will maintain the current behavior
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   166
     * where it is possible to send non-ASCII characters in their original
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   167
     * unescaped form.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   168
     */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   169
    private static boolean isASCIISuperset(String encoding) throws Exception {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   170
        String chkS = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ" +
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   171
                "abcdefghijklmnopqrstuvwxyz-_.!~*'();/?:@&=+$,";
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   172
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   173
        // Expected byte sequence for string above
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   174
        byte[] chkB = {48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 65, 66, 67, 68, 69, 70, 71, 72,
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   175
            73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 97, 98, 99,
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   176
            100, 101, 102, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114,
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   177
            115, 116, 117, 118, 119, 120, 121, 122, 45, 95, 46, 33, 126, 42, 39, 40, 41, 59,
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   178
            47, 63, 58, 64, 38, 61, 43, 36, 44};
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   179
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   180
        byte[] b = chkS.getBytes(encoding);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   181
        return java.util.Arrays.equals(b, chkB);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   182
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   183
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   184
    private class DefaultParser implements FtpDirParser {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   185
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   186
        /**
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   187
         * Possible patterns:
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   188
         *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   189
         *  drwxr-xr-x  1 user01        ftp   512 Jan 29 23:32 prog
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   190
         *  drwxr-xr-x  1 user01        ftp   512 Jan 29 1997 prog
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   191
         *  drwxr-xr-x  1 1             1     512 Jan 29 23:32 prog
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   192
         *  lrwxr-xr-x  1 user01        ftp   512 Jan 29 23:32 prog -> prog2000
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   193
         *  drwxr-xr-x  1 username      ftp   512 Jan 29 23:32 prog
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   194
         *  -rw-r--r--  1 jcc      staff     105009 Feb  3 15:05 test.1
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   195
         *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   196
         *  01-29-97    11:32PM <DIR> prog
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   197
         *  04/28/2006  09:12a               3,563 genBuffer.sh
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   198
         *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   199
         *  drwxr-xr-x  folder   0       Jan 29 23:32 prog
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   200
         *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   201
         *  0 DIR 01-29-97 23:32 PROG
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   202
         */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   203
        private DefaultParser() {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   204
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   205
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   206
        public FtpDirEntry parseLine(String line) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   207
            String fdate = null;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   208
            String fsize = null;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   209
            String time = null;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   210
            String filename = null;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   211
            String permstring = null;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   212
            String username = null;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   213
            String groupname = null;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   214
            boolean dir = false;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   215
            Calendar now = Calendar.getInstance();
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   216
            int year = now.get(Calendar.YEAR);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   217
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   218
            Matcher m = null;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   219
            for (int j = 0; j < patterns.length; j++) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   220
                m = patterns[j].matcher(line);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   221
                if (m.find()) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   222
                    // 0 - file, 1 - size, 2 - date, 3 - time, 4 - year,
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   223
                    // 5 - permissions, 6 - user, 7 - group
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   224
                    filename = m.group(patternGroups[j][0]);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   225
                    fsize = m.group(patternGroups[j][1]);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   226
                    fdate = m.group(patternGroups[j][2]);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   227
                    if (patternGroups[j][4] > 0) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   228
                        fdate += (", " + m.group(patternGroups[j][4]));
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   229
                    } else if (patternGroups[j][3] > 0) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   230
                        fdate += (", " + String.valueOf(year));
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   231
                    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   232
                    if (patternGroups[j][3] > 0) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   233
                        time = m.group(patternGroups[j][3]);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   234
                    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   235
                    if (patternGroups[j][5] > 0) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   236
                        permstring = m.group(patternGroups[j][5]);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   237
                        dir = permstring.startsWith("d");
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   238
                    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   239
                    if (patternGroups[j][6] > 0) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   240
                        username = m.group(patternGroups[j][6]);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   241
                    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   242
                    if (patternGroups[j][7] > 0) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   243
                        groupname = m.group(patternGroups[j][7]);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   244
                    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   245
                    // Old DOS format
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   246
                    if ("<DIR>".equals(fsize)) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   247
                        dir = true;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   248
                        fsize = null;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   249
                    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   250
                }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   251
            }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   252
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   253
            if (filename != null) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   254
                Date d;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   255
                try {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   256
                    d = df.parse(fdate);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   257
                } catch (Exception e) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   258
                    d = null;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   259
                }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   260
                if (d != null && time != null) {
24685
215fa91e1b4c 8044461: Cleanup new Boolean and single character strings
rriggs
parents: 24043
diff changeset
   261
                    int c = time.indexOf(':');
4155
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   262
                    now.setTime(d);
26720
6b160d97c51d 8055032: Improve numerical parsing in java.net and sun.net
redestad
parents: 25859
diff changeset
   263
                    now.set(Calendar.HOUR, Integer.parseInt(time, 0, c, 10));
6b160d97c51d 8055032: Improve numerical parsing in java.net and sun.net
redestad
parents: 25859
diff changeset
   264
                    now.set(Calendar.MINUTE, Integer.parseInt(time, c + 1, time.length(), 10));
4155
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   265
                    d = now.getTime();
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   266
                }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   267
                // see if it's a symbolic link, i.e. the name if followed
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   268
                // by a -> and a path
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   269
                Matcher m2 = linkp.matcher(filename);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   270
                if (m2.find()) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   271
                    // Keep only the name then
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   272
                    filename = m2.group(1);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   273
                }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   274
                boolean[][] perms = new boolean[3][3];
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   275
                for (int i = 0; i < 3; i++) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   276
                    for (int j = 0; j < 3; j++) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   277
                        perms[i][j] = (permstring.charAt((i * 3) + j) != '-');
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   278
                    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   279
                }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   280
                FtpDirEntry file = new FtpDirEntry(filename);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   281
                file.setUser(username).setGroup(groupname);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   282
                file.setSize(Long.parseLong(fsize)).setLastModified(d);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   283
                file.setPermissions(perms);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   284
                file.setType(dir ? FtpDirEntry.Type.DIR : (line.charAt(0) == 'l' ? FtpDirEntry.Type.LINK : FtpDirEntry.Type.FILE));
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   285
                return file;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   286
            }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   287
            return null;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   288
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   289
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   290
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   291
    private class MLSxParser implements FtpDirParser {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   292
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   293
        private SimpleDateFormat df = new SimpleDateFormat("yyyyMMddhhmmss");
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   294
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   295
        public FtpDirEntry parseLine(String line) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   296
            String name = null;
24685
215fa91e1b4c 8044461: Cleanup new Boolean and single character strings
rriggs
parents: 24043
diff changeset
   297
            int i = line.lastIndexOf(';');
4155
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   298
            if (i > 0) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   299
                name = line.substring(i + 1).trim();
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   300
                line = line.substring(0, i);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   301
            } else {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   302
                name = line.trim();
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   303
                line = "";
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   304
            }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   305
            FtpDirEntry file = new FtpDirEntry(name);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   306
            while (!line.isEmpty()) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   307
                String s;
24685
215fa91e1b4c 8044461: Cleanup new Boolean and single character strings
rriggs
parents: 24043
diff changeset
   308
                i = line.indexOf(';');
4155
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   309
                if (i > 0) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   310
                    s = line.substring(0, i);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   311
                    line = line.substring(i + 1);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   312
                } else {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   313
                    s = line;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   314
                    line = "";
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   315
                }
24685
215fa91e1b4c 8044461: Cleanup new Boolean and single character strings
rriggs
parents: 24043
diff changeset
   316
                i = s.indexOf('=');
4155
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   317
                if (i > 0) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   318
                    String fact = s.substring(0, i);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   319
                    String value = s.substring(i + 1);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   320
                    file.addFact(fact, value);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   321
                }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   322
            }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   323
            String s = file.getFact("Size");
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   324
            if (s != null) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   325
                file.setSize(Long.parseLong(s));
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   326
            }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   327
            s = file.getFact("Modify");
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   328
            if (s != null) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   329
                Date d = null;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   330
                try {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   331
                    d = df.parse(s);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   332
                } catch (ParseException ex) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   333
                }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   334
                if (d != null) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   335
                    file.setLastModified(d);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   336
                }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   337
            }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   338
            s = file.getFact("Create");
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   339
            if (s != null) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   340
                Date d = null;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   341
                try {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   342
                    d = df.parse(s);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   343
                } catch (ParseException ex) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   344
                }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   345
                if (d != null) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   346
                    file.setCreated(d);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   347
                }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   348
            }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   349
            s = file.getFact("Type");
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   350
            if (s != null) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   351
                if (s.equalsIgnoreCase("file")) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   352
                    file.setType(FtpDirEntry.Type.FILE);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   353
                }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   354
                if (s.equalsIgnoreCase("dir")) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   355
                    file.setType(FtpDirEntry.Type.DIR);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   356
                }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   357
                if (s.equalsIgnoreCase("cdir")) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   358
                    file.setType(FtpDirEntry.Type.CDIR);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   359
                }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   360
                if (s.equalsIgnoreCase("pdir")) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   361
                    file.setType(FtpDirEntry.Type.PDIR);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   362
                }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   363
            }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   364
            return file;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   365
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   366
    };
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   367
    private FtpDirParser parser = new DefaultParser();
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   368
    private FtpDirParser mlsxParser = new MLSxParser();
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   369
    private static Pattern transPat = null;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   370
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   371
    private void getTransferSize() {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   372
        lastTransSize = -1;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   373
        /**
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   374
         * If it's a start of data transfer response, let's try to extract
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   375
         * the size from the response string. Usually it looks like that:
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   376
         *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   377
         * 150 Opening BINARY mode data connection for foo (6701 bytes).
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   378
         */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   379
        String response = getLastResponseString();
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   380
        if (transPat == null) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   381
            transPat = Pattern.compile("150 Opening .*\\((\\d+) bytes\\).");
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   382
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   383
        Matcher m = transPat.matcher(response);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   384
        if (m.find()) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   385
            String s = m.group(1);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   386
            lastTransSize = Long.parseLong(s);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   387
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   388
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   389
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   390
    /**
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   391
     * extract the created file name from the response string:
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   392
     * 226 Transfer complete (unique file name:toto.txt.1).
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   393
     * Usually happens when a STOU (store unique) command had been issued.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   394
     */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   395
    private void getTransferName() {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   396
        lastFileName = null;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   397
        String response = getLastResponseString();
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   398
        int i = response.indexOf("unique file name:");
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   399
        int e = response.lastIndexOf(')');
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   400
        if (i >= 0) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   401
            i += 17; // Length of "unique file name:"
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   402
            lastFileName = response.substring(i, e);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   403
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   404
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   405
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   406
    /**
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   407
     * Pulls the response from the server and returns the code as a
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   408
     * number. Returns -1 on failure.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   409
     */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   410
    private int readServerResponse() throws IOException {
24969
afa6934dd8e8 8041679: Replace uses of StringBuffer with StringBuilder within core library classes
psandoz
parents: 24685
diff changeset
   411
        StringBuilder replyBuf = new StringBuilder(32);
4155
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   412
        int c;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   413
        int continuingCode = -1;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   414
        int code;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   415
        String response;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   416
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   417
        serverResponse.setSize(0);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   418
        while (true) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   419
            while ((c = in.read()) != -1) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   420
                if (c == '\r') {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   421
                    if ((c = in.read()) != '\n') {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   422
                        replyBuf.append('\r');
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   423
                    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   424
                }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   425
                replyBuf.append((char) c);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   426
                if (c == '\n') {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   427
                    break;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   428
                }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   429
            }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   430
            response = replyBuf.toString();
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   431
            replyBuf.setLength(0);
18178
ee71c923891d 8016747: Replace deprecated PlatformLogger isLoggable(int) with isLoggable(Level)
chegar
parents: 16730
diff changeset
   432
            if (logger.isLoggable(PlatformLogger.Level.FINEST)) {
4155
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   433
                logger.finest("Server [" + serverAddr + "] --> " + response);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   434
            }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   435
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   436
            if (response.length() == 0) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   437
                code = -1;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   438
            } else {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   439
                try {
26720
6b160d97c51d 8055032: Improve numerical parsing in java.net and sun.net
redestad
parents: 25859
diff changeset
   440
                    code = Integer.parseInt(response, 0, 3, 10);
4155
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   441
                } catch (NumberFormatException e) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   442
                    code = -1;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   443
                } catch (StringIndexOutOfBoundsException e) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   444
                    /* this line doesn't contain a response code, so
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   445
                    we just completely ignore it */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   446
                    continue;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   447
                }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   448
            }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   449
            serverResponse.addElement(response);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   450
            if (continuingCode != -1) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   451
                /* we've seen a ###- sequence */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   452
                if (code != continuingCode ||
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   453
                        (response.length() >= 4 && response.charAt(3) == '-')) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   454
                    continue;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   455
                } else {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   456
                    /* seen the end of code sequence */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   457
                    continuingCode = -1;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   458
                    break;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   459
                }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   460
            } else if (response.length() >= 4 && response.charAt(3) == '-') {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   461
                continuingCode = code;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   462
                continue;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   463
            } else {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   464
                break;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   465
            }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   466
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   467
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   468
        return code;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   469
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   470
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   471
    /** Sends command <i>cmd</i> to the server. */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   472
    private void sendServer(String cmd) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   473
        out.print(cmd);
18178
ee71c923891d 8016747: Replace deprecated PlatformLogger isLoggable(int) with isLoggable(Level)
chegar
parents: 16730
diff changeset
   474
        if (logger.isLoggable(PlatformLogger.Level.FINEST)) {
4155
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   475
            logger.finest("Server [" + serverAddr + "] <-- " + cmd);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   476
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   477
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   478
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   479
    /** converts the server response into a string. */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   480
    private String getResponseString() {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   481
        return serverResponse.elementAt(0);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   482
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   483
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   484
    /** Returns all server response strings. */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   485
    private Vector<String> getResponseStrings() {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   486
        return serverResponse;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   487
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   488
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   489
    /**
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   490
     * Read the reply from the FTP server.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   491
     *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   492
     * @return <code>true</code> if the command was successful
21278
ef8a3a2a72f2 8022746: List of spelling errors in API doc
malenkov
parents: 18275
diff changeset
   493
     * @throws IOException if an error occurred
4155
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   494
     */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   495
    private boolean readReply() throws IOException {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   496
        lastReplyCode = FtpReplyCode.find(readServerResponse());
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   497
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   498
        if (lastReplyCode.isPositivePreliminary()) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   499
            replyPending = true;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   500
            return true;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   501
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   502
        if (lastReplyCode.isPositiveCompletion() || lastReplyCode.isPositiveIntermediate()) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   503
            if (lastReplyCode == FtpReplyCode.CLOSING_DATA_CONNECTION) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   504
                getTransferName();
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   505
            }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   506
            return true;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   507
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   508
        return false;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   509
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   510
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   511
    /**
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   512
     * Sends a command to the FTP server and returns the error code
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   513
     * (which can be a "success") sent by the server.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   514
     *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   515
     * @param cmd
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   516
     * @return <code>true</code> if the command was successful
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   517
     * @throws IOException
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   518
     */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   519
    private boolean issueCommand(String cmd) throws IOException {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   520
        if (!isConnected()) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   521
            throw new IllegalStateException("Not connected");
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   522
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   523
        if (replyPending) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   524
            try {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   525
                completePending();
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   526
            } catch (sun.net.ftp.FtpProtocolException e) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   527
                // ignore...
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   528
            }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   529
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   530
        sendServer(cmd + "\r\n");
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   531
        return readReply();
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   532
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   533
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   534
    /**
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   535
     * Send a command to the FTP server and check for success.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   536
     *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   537
     * @param cmd String containing the command
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   538
     *
21278
ef8a3a2a72f2 8022746: List of spelling errors in API doc
malenkov
parents: 18275
diff changeset
   539
     * @throws FtpProtocolException if an error occurred
4155
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   540
     */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   541
    private void issueCommandCheck(String cmd) throws sun.net.ftp.FtpProtocolException, IOException {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   542
        if (!issueCommand(cmd)) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   543
            throw new sun.net.ftp.FtpProtocolException(cmd + ":" + getResponseString(), getLastReplyCode());
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   544
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   545
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   546
    private static Pattern epsvPat = null;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   547
    private static Pattern pasvPat = null;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   548
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   549
    /**
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   550
     * Opens a "PASSIVE" connection with the server and returns the connected
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   551
     * <code>Socket</code>.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   552
     *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   553
     * @return the connected <code>Socket</code>
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   554
     * @throws IOException if the connection was unsuccessful.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   555
     */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   556
    private Socket openPassiveDataConnection(String cmd) throws sun.net.ftp.FtpProtocolException, IOException {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   557
        String serverAnswer;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   558
        int port;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   559
        InetSocketAddress dest = null;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   560
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   561
        /**
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   562
         * Here is the idea:
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   563
         *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   564
         * - First we want to try the new (and IPv6 compatible) EPSV command
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   565
         *   But since we want to be nice with NAT software, we'll issue the
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   566
         *   EPSV ALL command first.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   567
         *   EPSV is documented in RFC2428
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   568
         * - If EPSV fails, then we fall back to the older, yet ok, PASV
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   569
         * - If PASV fails as well, then we throw an exception and the calling
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   570
         *   method will have to try the EPRT or PORT command
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   571
         */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   572
        if (issueCommand("EPSV ALL")) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   573
            // We can safely use EPSV commands
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   574
            issueCommandCheck("EPSV");
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   575
            serverAnswer = getResponseString();
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   576
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   577
            // The response string from a EPSV command will contain the port number
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   578
            // the format will be :
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   579
            //  229 Entering Extended PASSIVE Mode (|||58210|)
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   580
            //
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   581
            // So we'll use the regular expresions package to parse the output.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   582
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   583
            if (epsvPat == null) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   584
                epsvPat = Pattern.compile("^229 .* \\(\\|\\|\\|(\\d+)\\|\\)");
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   585
            }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   586
            Matcher m = epsvPat.matcher(serverAnswer);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   587
            if (!m.find()) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   588
                throw new sun.net.ftp.FtpProtocolException("EPSV failed : " + serverAnswer);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   589
            }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   590
            // Yay! Let's extract the port number
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   591
            String s = m.group(1);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   592
            port = Integer.parseInt(s);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   593
            InetAddress add = server.getInetAddress();
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   594
            if (add != null) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   595
                dest = new InetSocketAddress(add, port);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   596
            } else {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   597
                // This means we used an Unresolved address to connect in
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   598
                // the first place. Most likely because the proxy is doing
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   599
                // the name resolution for us, so let's keep using unresolved
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   600
                // address.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   601
                dest = InetSocketAddress.createUnresolved(serverAddr.getHostName(), port);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   602
            }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   603
        } else {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   604
            // EPSV ALL failed, so Let's try the regular PASV cmd
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   605
            issueCommandCheck("PASV");
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   606
            serverAnswer = getResponseString();
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   607
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   608
            // Let's parse the response String to get the IP & port to connect
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   609
            // to. The String should be in the following format :
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   610
            //
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   611
            // 227 Entering PASSIVE Mode (A1,A2,A3,A4,p1,p2)
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   612
            //
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   613
            // Note that the two parenthesis are optional
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   614
            //
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   615
            // The IP address is A1.A2.A3.A4 and the port is p1 * 256 + p2
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   616
            //
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   617
            // The regular expression is a bit more complex this time, because
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   618
            // the parenthesis are optionals and we have to use 3 groups.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   619
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   620
            if (pasvPat == null) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   621
                pasvPat = Pattern.compile("227 .* \\(?(\\d{1,3},\\d{1,3},\\d{1,3},\\d{1,3}),(\\d{1,3}),(\\d{1,3})\\)?");
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   622
            }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   623
            Matcher m = pasvPat.matcher(serverAnswer);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   624
            if (!m.find()) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   625
                throw new sun.net.ftp.FtpProtocolException("PASV failed : " + serverAnswer);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   626
            }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   627
            // Get port number out of group 2 & 3
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   628
            port = Integer.parseInt(m.group(3)) + (Integer.parseInt(m.group(2)) << 8);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   629
            // IP address is simple
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   630
            String s = m.group(1).replace(',', '.');
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   631
            dest = new InetSocketAddress(s, port);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   632
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   633
        // Got everything, let's open the socket!
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   634
        Socket s;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   635
        if (proxy != null) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   636
            if (proxy.type() == Proxy.Type.SOCKS) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   637
                s = AccessController.doPrivileged(
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   638
                        new PrivilegedAction<Socket>() {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   639
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   640
                            public Socket run() {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   641
                                return new Socket(proxy);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   642
                            }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   643
                        });
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   644
            } else {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   645
                s = new Socket(Proxy.NO_PROXY);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   646
            }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   647
        } else {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   648
            s = new Socket();
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   649
        }
18212
22f8c33b0690 8001318: Socket.getLocalAddress not consistent with InetAddress.getLocalHost
khazra
parents: 16730
diff changeset
   650
22f8c33b0690 8001318: Socket.getLocalAddress not consistent with InetAddress.getLocalHost
khazra
parents: 16730
diff changeset
   651
        InetAddress serverAddress = AccessController.doPrivileged(
22f8c33b0690 8001318: Socket.getLocalAddress not consistent with InetAddress.getLocalHost
khazra
parents: 16730
diff changeset
   652
                new PrivilegedAction<InetAddress>() {
22f8c33b0690 8001318: Socket.getLocalAddress not consistent with InetAddress.getLocalHost
khazra
parents: 16730
diff changeset
   653
                    @Override
22f8c33b0690 8001318: Socket.getLocalAddress not consistent with InetAddress.getLocalHost
khazra
parents: 16730
diff changeset
   654
                    public InetAddress run() {
22f8c33b0690 8001318: Socket.getLocalAddress not consistent with InetAddress.getLocalHost
khazra
parents: 16730
diff changeset
   655
                        return server.getLocalAddress();
22f8c33b0690 8001318: Socket.getLocalAddress not consistent with InetAddress.getLocalHost
khazra
parents: 16730
diff changeset
   656
                    }
22f8c33b0690 8001318: Socket.getLocalAddress not consistent with InetAddress.getLocalHost
khazra
parents: 16730
diff changeset
   657
                });
22f8c33b0690 8001318: Socket.getLocalAddress not consistent with InetAddress.getLocalHost
khazra
parents: 16730
diff changeset
   658
4155
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   659
        // Bind the socket to the same address as the control channel. This
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   660
        // is needed in case of multi-homed systems.
18212
22f8c33b0690 8001318: Socket.getLocalAddress not consistent with InetAddress.getLocalHost
khazra
parents: 16730
diff changeset
   661
        s.bind(new InetSocketAddress(serverAddress, 0));
4155
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   662
        if (connectTimeout >= 0) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   663
            s.connect(dest, connectTimeout);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   664
        } else {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   665
            if (defaultConnectTimeout > 0) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   666
                s.connect(dest, defaultConnectTimeout);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   667
            } else {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   668
                s.connect(dest);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   669
            }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   670
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   671
        if (readTimeout >= 0) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   672
            s.setSoTimeout(readTimeout);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   673
        } else if (defaultSoTimeout > 0) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   674
            s.setSoTimeout(defaultSoTimeout);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   675
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   676
        if (useCrypto) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   677
            try {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   678
                s = sslFact.createSocket(s, dest.getHostName(), dest.getPort(), true);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   679
            } catch (Exception e) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   680
                throw new sun.net.ftp.FtpProtocolException("Can't open secure data channel: " + e);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   681
            }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   682
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   683
        if (!issueCommand(cmd)) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   684
            s.close();
4813
654ff751c112 6919185: test/closed/sun/net/ftp/FtpTests fails to compile
jccollet
parents: 4155
diff changeset
   685
            if (getLastReplyCode() == FtpReplyCode.FILE_UNAVAILABLE) {
654ff751c112 6919185: test/closed/sun/net/ftp/FtpTests fails to compile
jccollet
parents: 4155
diff changeset
   686
                // Ensure backward compatibility
654ff751c112 6919185: test/closed/sun/net/ftp/FtpTests fails to compile
jccollet
parents: 4155
diff changeset
   687
                throw new FileNotFoundException(cmd);
654ff751c112 6919185: test/closed/sun/net/ftp/FtpTests fails to compile
jccollet
parents: 4155
diff changeset
   688
            }
4155
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   689
            throw new sun.net.ftp.FtpProtocolException(cmd + ":" + getResponseString(), getLastReplyCode());
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   690
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   691
        return s;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   692
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   693
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   694
    /**
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   695
     * Opens a data connection with the server according to the set mode
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   696
     * (ACTIVE or PASSIVE) then send the command passed as an argument.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   697
     *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   698
     * @param cmd the <code>String</code> containing the command to execute
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   699
     * @return the connected <code>Socket</code>
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   700
     * @throws IOException if the connection or command failed
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   701
     */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   702
    private Socket openDataConnection(String cmd) throws sun.net.ftp.FtpProtocolException, IOException {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   703
        Socket clientSocket;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   704
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   705
        if (passiveMode) {
4813
654ff751c112 6919185: test/closed/sun/net/ftp/FtpTests fails to compile
jccollet
parents: 4155
diff changeset
   706
            try {
654ff751c112 6919185: test/closed/sun/net/ftp/FtpTests fails to compile
jccollet
parents: 4155
diff changeset
   707
                return openPassiveDataConnection(cmd);
654ff751c112 6919185: test/closed/sun/net/ftp/FtpTests fails to compile
jccollet
parents: 4155
diff changeset
   708
            } catch (sun.net.ftp.FtpProtocolException e) {
654ff751c112 6919185: test/closed/sun/net/ftp/FtpTests fails to compile
jccollet
parents: 4155
diff changeset
   709
                // If Passive mode failed, fall back on PORT
654ff751c112 6919185: test/closed/sun/net/ftp/FtpTests fails to compile
jccollet
parents: 4155
diff changeset
   710
                // Otherwise throw exception
654ff751c112 6919185: test/closed/sun/net/ftp/FtpTests fails to compile
jccollet
parents: 4155
diff changeset
   711
                String errmsg = e.getMessage();
654ff751c112 6919185: test/closed/sun/net/ftp/FtpTests fails to compile
jccollet
parents: 4155
diff changeset
   712
                if (!errmsg.startsWith("PASV") && !errmsg.startsWith("EPSV")) {
654ff751c112 6919185: test/closed/sun/net/ftp/FtpTests fails to compile
jccollet
parents: 4155
diff changeset
   713
                    throw e;
654ff751c112 6919185: test/closed/sun/net/ftp/FtpTests fails to compile
jccollet
parents: 4155
diff changeset
   714
                }
654ff751c112 6919185: test/closed/sun/net/ftp/FtpTests fails to compile
jccollet
parents: 4155
diff changeset
   715
            }
4155
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   716
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   717
        ServerSocket portSocket;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   718
        InetAddress myAddress;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   719
        String portCmd;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   720
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   721
        if (proxy != null && proxy.type() == Proxy.Type.SOCKS) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   722
            // We're behind a firewall and the passive mode fail,
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   723
            // since we can't accept a connection through SOCKS (yet)
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   724
            // throw an exception
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   725
            throw new sun.net.ftp.FtpProtocolException("Passive mode failed");
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   726
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   727
        // Bind the ServerSocket to the same address as the control channel
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   728
        // This is needed for multi-homed systems
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   729
        portSocket = new ServerSocket(0, 1, server.getLocalAddress());
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   730
        try {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   731
            myAddress = portSocket.getInetAddress();
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   732
            if (myAddress.isAnyLocalAddress()) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   733
                myAddress = server.getLocalAddress();
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   734
            }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   735
            // Let's try the new, IPv6 compatible EPRT command
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   736
            // See RFC2428 for specifics
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   737
            // Some FTP servers (like the one on Solaris) are bugged, they
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   738
            // will accept the EPRT command but then, the subsequent command
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   739
            // (e.g. RETR) will fail, so we have to check BOTH results (the
21278
ef8a3a2a72f2 8022746: List of spelling errors in API doc
malenkov
parents: 18275
diff changeset
   740
            // EPRT cmd then the actual command) to decide whether we should
4155
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   741
            // fall back on the older PORT command.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   742
            portCmd = "EPRT |" + ((myAddress instanceof Inet6Address) ? "2" : "1") + "|" +
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   743
                    myAddress.getHostAddress() + "|" + portSocket.getLocalPort() + "|";
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   744
            if (!issueCommand(portCmd) || !issueCommand(cmd)) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   745
                // The EPRT command failed, let's fall back to good old PORT
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   746
                portCmd = "PORT ";
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   747
                byte[] addr = myAddress.getAddress();
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   748
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   749
                /* append host addr */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   750
                for (int i = 0; i < addr.length; i++) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   751
                    portCmd = portCmd + (addr[i] & 0xFF) + ",";
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   752
                }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   753
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   754
                /* append port number */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   755
                portCmd = portCmd + ((portSocket.getLocalPort() >>> 8) & 0xff) + "," + (portSocket.getLocalPort() & 0xff);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   756
                issueCommandCheck(portCmd);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   757
                issueCommandCheck(cmd);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   758
            }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   759
            // Either the EPRT or the PORT command was successful
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   760
            // Let's create the client socket
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   761
            if (connectTimeout >= 0) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   762
                portSocket.setSoTimeout(connectTimeout);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   763
            } else {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   764
                if (defaultConnectTimeout > 0) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   765
                    portSocket.setSoTimeout(defaultConnectTimeout);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   766
                }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   767
            }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   768
            clientSocket = portSocket.accept();
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   769
            if (readTimeout >= 0) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   770
                clientSocket.setSoTimeout(readTimeout);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   771
            } else {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   772
                if (defaultSoTimeout > 0) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   773
                    clientSocket.setSoTimeout(defaultSoTimeout);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   774
                }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   775
            }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   776
        } finally {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   777
            portSocket.close();
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   778
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   779
        if (useCrypto) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   780
            try {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   781
                clientSocket = sslFact.createSocket(clientSocket, serverAddr.getHostName(), serverAddr.getPort(), true);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   782
            } catch (Exception ex) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   783
                throw new IOException(ex.getLocalizedMessage());
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   784
            }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   785
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   786
        return clientSocket;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   787
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   788
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   789
    private InputStream createInputStream(InputStream in) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   790
        if (type == TransferType.ASCII) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   791
            return new sun.net.TelnetInputStream(in, false);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   792
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   793
        return in;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   794
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   795
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   796
    private OutputStream createOutputStream(OutputStream out) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   797
        if (type == TransferType.ASCII) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   798
            return new sun.net.TelnetOutputStream(out, false);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   799
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   800
        return out;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   801
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   802
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   803
    /**
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   804
     * Creates an instance of FtpClient. The client is not connected to any
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   805
     * server yet.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   806
     *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   807
     */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   808
    protected FtpClient() {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   809
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   810
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   811
    /**
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   812
     * Creates an instance of FtpClient. The client is not connected to any
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   813
     * server yet.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   814
     *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   815
     */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   816
    public static sun.net.ftp.FtpClient create() {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   817
        return new FtpClient();
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   818
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   819
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   820
    /**
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   821
     * Set the transfer mode to <I>passive</I>. In that mode, data connections
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   822
     * are established by having the client connect to the server.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   823
     * This is the recommended default mode as it will work best through
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   824
     * firewalls and NATs.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   825
     *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   826
     * @return This FtpClient
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   827
     * @see #setActiveMode()
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   828
     */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   829
    public sun.net.ftp.FtpClient enablePassiveMode(boolean passive) {
18212
22f8c33b0690 8001318: Socket.getLocalAddress not consistent with InetAddress.getLocalHost
khazra
parents: 16730
diff changeset
   830
22f8c33b0690 8001318: Socket.getLocalAddress not consistent with InetAddress.getLocalHost
khazra
parents: 16730
diff changeset
   831
        // Only passive mode used in JDK. See Bug 8010784.
22f8c33b0690 8001318: Socket.getLocalAddress not consistent with InetAddress.getLocalHost
khazra
parents: 16730
diff changeset
   832
        // passiveMode = passive;
4155
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   833
        return this;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   834
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   835
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   836
    /**
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   837
     * Gets the current transfer mode.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   838
     *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   839
     * @return the current <code>FtpTransferMode</code>
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   840
     */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   841
    public boolean isPassiveModeEnabled() {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   842
        return passiveMode;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   843
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   844
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   845
    /**
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   846
     * Sets the timeout value to use when connecting to the server,
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   847
     *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   848
     * @param timeout the timeout value, in milliseconds, to use for the connect
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   849
     *        operation. A value of zero or less, means use the default timeout.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   850
     *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   851
     * @return This FtpClient
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   852
     */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   853
    public sun.net.ftp.FtpClient setConnectTimeout(int timeout) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   854
        connectTimeout = timeout;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   855
        return this;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   856
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   857
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   858
    /**
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   859
     * Returns the current connection timeout value.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   860
     *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   861
     * @return the value, in milliseconds, of the current connect timeout.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   862
     * @see #setConnectTimeout(int)
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   863
     */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   864
    public int getConnectTimeout() {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   865
        return connectTimeout;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   866
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   867
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   868
    /**
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   869
     * Sets the timeout value to use when reading from the server,
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   870
     *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   871
     * @param timeout the timeout value, in milliseconds, to use for the read
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   872
     *        operation. A value of zero or less, means use the default timeout.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   873
     * @return This FtpClient
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   874
     */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   875
    public sun.net.ftp.FtpClient setReadTimeout(int timeout) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   876
        readTimeout = timeout;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   877
        return this;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   878
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   879
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   880
    /**
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   881
     * Returns the current read timeout value.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   882
     *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   883
     * @return the value, in milliseconds, of the current read timeout.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   884
     * @see #setReadTimeout(int)
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   885
     */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   886
    public int getReadTimeout() {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   887
        return readTimeout;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   888
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   889
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   890
    public sun.net.ftp.FtpClient setProxy(Proxy p) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   891
        proxy = p;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   892
        return this;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   893
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   894
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   895
    /**
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   896
     * Get the proxy of this FtpClient
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   897
     *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   898
     * @return the <code>Proxy</code>, this client is using, or <code>null</code>
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   899
     *         if none is used.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   900
     * @see #setProxy(Proxy)
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   901
     */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   902
    public Proxy getProxy() {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   903
        return proxy;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   904
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   905
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   906
    /**
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   907
     * Connects to the specified destination.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   908
     *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   909
     * @param dest the <code>InetSocketAddress</code> to connect to.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   910
     * @throws IOException if the connection fails.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   911
     */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   912
    private void tryConnect(InetSocketAddress dest, int timeout) throws IOException {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   913
        if (isConnected()) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   914
            disconnect();
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   915
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   916
        server = doConnect(dest, timeout);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   917
        try {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   918
            out = new PrintStream(new BufferedOutputStream(server.getOutputStream()),
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   919
                    true, encoding);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   920
        } catch (UnsupportedEncodingException e) {
10419
12c063b39232 7084245: Update usages of InternalError to use exception chaining
sherman
parents: 7668
diff changeset
   921
            throw new InternalError(encoding + "encoding not found", e);
4155
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   922
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   923
        in = new BufferedInputStream(server.getInputStream());
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   924
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   925
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   926
    private Socket doConnect(InetSocketAddress dest, int timeout) throws IOException {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   927
        Socket s;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   928
        if (proxy != null) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   929
            if (proxy.type() == Proxy.Type.SOCKS) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   930
                s = AccessController.doPrivileged(
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   931
                        new PrivilegedAction<Socket>() {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   932
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   933
                            public Socket run() {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   934
                                return new Socket(proxy);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   935
                            }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   936
                        });
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   937
            } else {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   938
                s = new Socket(Proxy.NO_PROXY);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   939
            }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   940
        } else {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   941
            s = new Socket();
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   942
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   943
        // Instance specific timeouts do have priority, that means
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   944
        // connectTimeout & readTimeout (-1 means not set)
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   945
        // Then global default timeouts
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   946
        // Then no timeout.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   947
        if (timeout >= 0) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   948
            s.connect(dest, timeout);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   949
        } else {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   950
            if (connectTimeout >= 0) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   951
                s.connect(dest, connectTimeout);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   952
            } else {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   953
                if (defaultConnectTimeout > 0) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   954
                    s.connect(dest, defaultConnectTimeout);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   955
                } else {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   956
                    s.connect(dest);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   957
                }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   958
            }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   959
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   960
        if (readTimeout >= 0) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   961
            s.setSoTimeout(readTimeout);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   962
        } else if (defaultSoTimeout > 0) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   963
            s.setSoTimeout(defaultSoTimeout);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   964
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   965
        return s;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   966
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   967
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   968
    private void disconnect() throws IOException {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   969
        if (isConnected()) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   970
            server.close();
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   971
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   972
        server = null;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   973
        in = null;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   974
        out = null;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   975
        lastTransSize = -1;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   976
        lastFileName = null;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   977
        restartOffset = 0;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   978
        welcomeMsg = null;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   979
        lastReplyCode = null;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   980
        serverResponse.setSize(0);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   981
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   982
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   983
    /**
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   984
     * Tests whether this client is connected or not to a server.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   985
     *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   986
     * @return <code>true</code> if the client is connected.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   987
     */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   988
    public boolean isConnected() {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   989
        return server != null;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   990
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   991
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   992
    public SocketAddress getServerAddress() {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   993
        return server == null ? null : server.getRemoteSocketAddress();
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   994
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   995
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   996
    public sun.net.ftp.FtpClient connect(SocketAddress dest) throws sun.net.ftp.FtpProtocolException, IOException {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   997
        return connect(dest, -1);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   998
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
   999
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1000
    /**
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1001
     * Connects the FtpClient to the specified destination.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1002
     *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1003
     * @param dest the address of the destination server
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1004
     * @throws IOException if connection failed.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1005
     */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1006
    public sun.net.ftp.FtpClient connect(SocketAddress dest, int timeout) throws sun.net.ftp.FtpProtocolException, IOException {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1007
        if (!(dest instanceof InetSocketAddress)) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1008
            throw new IllegalArgumentException("Wrong address type");
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1009
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1010
        serverAddr = (InetSocketAddress) dest;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1011
        tryConnect(serverAddr, timeout);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1012
        if (!readReply()) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1013
            throw new sun.net.ftp.FtpProtocolException("Welcome message: " +
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1014
                    getResponseString(), lastReplyCode);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1015
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1016
        welcomeMsg = getResponseString().substring(4);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1017
        return this;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1018
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1019
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1020
    private void tryLogin(String user, char[] password) throws sun.net.ftp.FtpProtocolException, IOException {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1021
        issueCommandCheck("USER " + user);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1022
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1023
        /*
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1024
         * Checks for "331 User name okay, need password." answer
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1025
         */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1026
        if (lastReplyCode == FtpReplyCode.NEED_PASSWORD) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1027
            if ((password != null) && (password.length > 0)) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1028
                issueCommandCheck("PASS " + String.valueOf(password));
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1029
            }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1030
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1031
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1032
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1033
    /**
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1034
     * Attempts to log on the server with the specified user name and password.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1035
     *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1036
     * @param user The user name
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1037
     * @param password The password for that user
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1038
     * @return <code>true</code> if the login was successful.
21278
ef8a3a2a72f2 8022746: List of spelling errors in API doc
malenkov
parents: 18275
diff changeset
  1039
     * @throws IOException if an error occurred during the transmission
4155
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1040
     */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1041
    public sun.net.ftp.FtpClient login(String user, char[] password) throws sun.net.ftp.FtpProtocolException, IOException {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1042
        if (!isConnected()) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1043
            throw new sun.net.ftp.FtpProtocolException("Not connected yet", FtpReplyCode.BAD_SEQUENCE);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1044
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1045
        if (user == null || user.length() == 0) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1046
            throw new IllegalArgumentException("User name can't be null or empty");
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1047
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1048
        tryLogin(user, password);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1049
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1050
        // keep the welcome message around so we can
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1051
        // put it in the resulting HTML page.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1052
        String l;
24969
afa6934dd8e8 8041679: Replace uses of StringBuffer with StringBuilder within core library classes
psandoz
parents: 24685
diff changeset
  1053
        StringBuilder sb = new StringBuilder();
4155
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1054
        for (int i = 0; i < serverResponse.size(); i++) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1055
            l = serverResponse.elementAt(i);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1056
            if (l != null) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1057
                if (l.length() >= 4 && l.startsWith("230")) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1058
                    // get rid of the "230-" prefix
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1059
                    l = l.substring(4);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1060
                }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1061
                sb.append(l);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1062
            }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1063
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1064
        welcomeMsg = sb.toString();
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1065
        loggedIn = true;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1066
        return this;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1067
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1068
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1069
    /**
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1070
     * Attempts to log on the server with the specified user name, password and
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1071
     * account name.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1072
     *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1073
     * @param user The user name
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1074
     * @param password The password for that user.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1075
     * @param account The account name for that user.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1076
     * @return <code>true</code> if the login was successful.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1077
     * @throws IOException if an error occurs during the transmission.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1078
     */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1079
    public sun.net.ftp.FtpClient login(String user, char[] password, String account) throws sun.net.ftp.FtpProtocolException, IOException {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1080
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1081
        if (!isConnected()) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1082
            throw new sun.net.ftp.FtpProtocolException("Not connected yet", FtpReplyCode.BAD_SEQUENCE);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1083
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1084
        if (user == null || user.length() == 0) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1085
            throw new IllegalArgumentException("User name can't be null or empty");
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1086
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1087
        tryLogin(user, password);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1088
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1089
        /*
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1090
         * Checks for "332 Need account for login." answer
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1091
         */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1092
        if (lastReplyCode == FtpReplyCode.NEED_ACCOUNT) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1093
            issueCommandCheck("ACCT " + account);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1094
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1095
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1096
        // keep the welcome message around so we can
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1097
        // put it in the resulting HTML page.
24969
afa6934dd8e8 8041679: Replace uses of StringBuffer with StringBuilder within core library classes
psandoz
parents: 24685
diff changeset
  1098
        StringBuilder sb = new StringBuilder();
4155
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1099
        if (serverResponse != null) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1100
            for (String l : serverResponse) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1101
                if (l != null) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1102
                    if (l.length() >= 4 && l.startsWith("230")) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1103
                        // get rid of the "230-" prefix
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1104
                        l = l.substring(4);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1105
                    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1106
                    sb.append(l);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1107
                }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1108
            }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1109
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1110
        welcomeMsg = sb.toString();
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1111
        loggedIn = true;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1112
        return this;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1113
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1114
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1115
    /**
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1116
     * Logs out the current user. This is in effect terminates the current
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1117
     * session and the connection to the server will be closed.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1118
     *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1119
     */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1120
    public void close() throws IOException {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1121
        if (isConnected()) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1122
            issueCommand("QUIT");
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1123
            loggedIn = false;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1124
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1125
        disconnect();
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1126
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1127
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1128
    /**
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1129
     * Checks whether the client is logged in to the server or not.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1130
     *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1131
     * @return <code>true</code> if the client has already completed a login.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1132
     */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1133
    public boolean isLoggedIn() {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1134
        return loggedIn;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1135
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1136
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1137
    /**
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1138
     * Changes to a specific directory on a remote FTP server
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1139
     *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1140
     * @param remoteDirectory path of the directory to CD to.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1141
     * @return <code>true</code> if the operation was successful.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1142
     * @exception <code>FtpProtocolException</code>
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1143
     */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1144
    public sun.net.ftp.FtpClient changeDirectory(String remoteDirectory) throws sun.net.ftp.FtpProtocolException, IOException {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1145
        if (remoteDirectory == null || "".equals(remoteDirectory)) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1146
            throw new IllegalArgumentException("directory can't be null or empty");
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1147
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1148
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1149
        issueCommandCheck("CWD " + remoteDirectory);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1150
        return this;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1151
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1152
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1153
    /**
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1154
     * Changes to the parent directory, sending the CDUP command to the server.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1155
     *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1156
     * @return <code>true</code> if the command was successful.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1157
     * @throws IOException
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1158
     */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1159
    public sun.net.ftp.FtpClient changeToParentDirectory() throws sun.net.ftp.FtpProtocolException, IOException {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1160
        issueCommandCheck("CDUP");
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1161
        return this;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1162
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1163
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1164
    /**
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1165
     * Returns the server current working directory, or <code>null</code> if
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1166
     * the PWD command failed.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1167
     *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1168
     * @return a <code>String</code> containing the current working directory,
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1169
     *         or <code>null</code>
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1170
     * @throws IOException
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1171
     */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1172
    public String getWorkingDirectory() throws sun.net.ftp.FtpProtocolException, IOException {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1173
        issueCommandCheck("PWD");
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1174
        /*
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1175
         * answer will be of the following format :
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1176
         *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1177
         * 257 "/" is current directory.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1178
         */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1179
        String answ = getResponseString();
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1180
        if (!answ.startsWith("257")) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1181
            return null;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1182
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1183
        return answ.substring(5, answ.lastIndexOf('"'));
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1184
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1185
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1186
    /**
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1187
     * Sets the restart offset to the specified value.  That value will be
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1188
     * sent through a <code>REST</code> command to server before a file
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1189
     * transfer and has the effect of resuming a file transfer from the
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1190
     * specified point. After a transfer the restart offset is set back to
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1191
     * zero.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1192
     *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1193
     * @param offset the offset in the remote file at which to start the next
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1194
     *        transfer. This must be a value greater than or equal to zero.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1195
     * @throws IllegalArgumentException if the offset is negative.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1196
     */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1197
    public sun.net.ftp.FtpClient setRestartOffset(long offset) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1198
        if (offset < 0) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1199
            throw new IllegalArgumentException("offset can't be negative");
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1200
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1201
        restartOffset = offset;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1202
        return this;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1203
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1204
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1205
    /**
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1206
     * Retrieves a file from the ftp server and writes it to the specified
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1207
     * <code>OutputStream</code>.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1208
     * If the restart offset was set, then a <code>REST</code> command will be
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1209
     * sent before the RETR in order to restart the tranfer from the specified
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1210
     * offset.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1211
     * The <code>OutputStream</code> is not closed by this method at the end
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1212
     * of the transfer.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1213
     *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1214
     * @param name a <code>String<code> containing the name of the file to
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1215
     *        retreive from the server.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1216
     * @param local the <code>OutputStream</code> the file should be written to.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1217
     * @throws IOException if the transfer fails.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1218
     */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1219
    public sun.net.ftp.FtpClient getFile(String name, OutputStream local) throws sun.net.ftp.FtpProtocolException, IOException {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1220
        int mtu = 1500;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1221
        if (restartOffset > 0) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1222
            Socket s;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1223
            try {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1224
                s = openDataConnection("REST " + restartOffset);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1225
            } finally {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1226
                restartOffset = 0;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1227
            }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1228
            issueCommandCheck("RETR " + name);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1229
            getTransferSize();
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1230
            InputStream remote = createInputStream(s.getInputStream());
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1231
            byte[] buf = new byte[mtu * 10];
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1232
            int l;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1233
            while ((l = remote.read(buf)) >= 0) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1234
                if (l > 0) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1235
                    local.write(buf, 0, l);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1236
                }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1237
            }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1238
            remote.close();
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1239
        } else {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1240
            Socket s = openDataConnection("RETR " + name);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1241
            getTransferSize();
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1242
            InputStream remote = createInputStream(s.getInputStream());
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1243
            byte[] buf = new byte[mtu * 10];
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1244
            int l;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1245
            while ((l = remote.read(buf)) >= 0) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1246
                if (l > 0) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1247
                    local.write(buf, 0, l);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1248
                }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1249
            }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1250
            remote.close();
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1251
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1252
        return completePending();
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1253
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1254
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1255
    /**
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1256
     * Retrieves a file from the ftp server, using the RETR command, and
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1257
     * returns the InputStream from* the established data connection.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1258
     * {@link #completePending()} <b>has</b> to be called once the application
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1259
     * is done reading from the returned stream.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1260
     *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1261
     * @param name the name of the remote file
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1262
     * @return the {@link java.io.InputStream} from the data connection, or
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1263
     *         <code>null</code> if the command was unsuccessful.
21278
ef8a3a2a72f2 8022746: List of spelling errors in API doc
malenkov
parents: 18275
diff changeset
  1264
     * @throws IOException if an error occurred during the transmission.
4155
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1265
     */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1266
    public InputStream getFileStream(String name) throws sun.net.ftp.FtpProtocolException, IOException {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1267
        Socket s;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1268
        if (restartOffset > 0) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1269
            try {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1270
                s = openDataConnection("REST " + restartOffset);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1271
            } finally {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1272
                restartOffset = 0;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1273
            }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1274
            if (s == null) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1275
                return null;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1276
            }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1277
            issueCommandCheck("RETR " + name);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1278
            getTransferSize();
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1279
            return createInputStream(s.getInputStream());
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1280
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1281
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1282
        s = openDataConnection("RETR " + name);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1283
        if (s == null) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1284
            return null;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1285
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1286
        getTransferSize();
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1287
        return createInputStream(s.getInputStream());
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1288
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1289
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1290
    /**
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1291
     * Transfers a file from the client to the server (aka a <I>put</I>)
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1292
     * by sending the STOR or STOU command, depending on the
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1293
     * <code>unique</code> argument, and returns the <code>OutputStream</code>
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1294
     * from the established data connection.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1295
     * {@link #completePending()} <b>has</b> to be called once the application
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1296
     * is finished writing to the stream.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1297
     *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1298
     * A new file is created at the server site if the file specified does
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1299
     * not already exist.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1300
     *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1301
     * If <code>unique</code> is set to <code>true</code>, the resultant file
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1302
     * is to be created under a name unique to that directory, meaning
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1303
     * it will not overwrite an existing file, instead the server will
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1304
     * generate a new, unique, file name.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1305
     * The name of the remote file can be retrieved, after completion of the
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1306
     * transfer, by calling {@link #getLastFileName()}.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1307
     *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1308
     * @param name the name of the remote file to write.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1309
     * @param unique <code>true</code> if the remote files should be unique,
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1310
     *        in which case the STOU command will be used.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1311
     * @return the {@link java.io.OutputStream} from the data connection or
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1312
     *         <code>null</code> if the command was unsuccessful.
21278
ef8a3a2a72f2 8022746: List of spelling errors in API doc
malenkov
parents: 18275
diff changeset
  1313
     * @throws IOException if an error occurred during the transmission.
4155
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1314
     */
16730
5f67810e08fb 8011234: Performance regression with ftp protocol when uploading in image mode
alanb
parents: 14342
diff changeset
  1315
    public OutputStream putFileStream(String name, boolean unique)
5f67810e08fb 8011234: Performance regression with ftp protocol when uploading in image mode
alanb
parents: 14342
diff changeset
  1316
        throws sun.net.ftp.FtpProtocolException, IOException
5f67810e08fb 8011234: Performance regression with ftp protocol when uploading in image mode
alanb
parents: 14342
diff changeset
  1317
    {
4155
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1318
        String cmd = unique ? "STOU " : "STOR ";
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1319
        Socket s = openDataConnection(cmd + name);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1320
        if (s == null) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1321
            return null;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1322
        }
16730
5f67810e08fb 8011234: Performance regression with ftp protocol when uploading in image mode
alanb
parents: 14342
diff changeset
  1323
        boolean bm = (type == TransferType.BINARY);
5f67810e08fb 8011234: Performance regression with ftp protocol when uploading in image mode
alanb
parents: 14342
diff changeset
  1324
        return new sun.net.TelnetOutputStream(s.getOutputStream(), bm);
4155
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1325
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1326
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1327
    /**
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1328
     * Transfers a file from the client to the server (aka a <I>put</I>)
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1329
     * by sending the STOR command. The content of the <code>InputStream</code>
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1330
     * passed in argument is written into the remote file, overwriting any
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1331
     * existing data.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1332
     *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1333
     * A new file is created at the server site if the file specified does
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1334
     * not already exist.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1335
     *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1336
     * @param name the name of the remote file to write.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1337
     * @param local the <code>InputStream</code> that points to the data to
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1338
     *        transfer.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1339
     * @param unique <code>true</code> if the remote file should be unique
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1340
     *        (i.e. not already existing), <code>false</code> otherwise.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1341
     * @return <code>true</code> if the transfer was successful.
21278
ef8a3a2a72f2 8022746: List of spelling errors in API doc
malenkov
parents: 18275
diff changeset
  1342
     * @throws IOException if an error occurred during the transmission.
4155
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1343
     * @see #getLastFileName()
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1344
     */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1345
    public sun.net.ftp.FtpClient putFile(String name, InputStream local, boolean unique) throws sun.net.ftp.FtpProtocolException, IOException {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1346
        String cmd = unique ? "STOU " : "STOR ";
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1347
        int mtu = 1500;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1348
        if (type == TransferType.BINARY) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1349
            Socket s = openDataConnection(cmd + name);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1350
            OutputStream remote = createOutputStream(s.getOutputStream());
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1351
            byte[] buf = new byte[mtu * 10];
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1352
            int l;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1353
            while ((l = local.read(buf)) >= 0) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1354
                if (l > 0) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1355
                    remote.write(buf, 0, l);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1356
                }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1357
            }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1358
            remote.close();
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1359
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1360
        return completePending();
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1361
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1362
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1363
    /**
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1364
     * Sends the APPE command to the server in order to transfer a data stream
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1365
     * passed in argument and append it to the content of the specified remote
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1366
     * file.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1367
     *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1368
     * @param name A <code>String</code> containing the name of the remote file
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1369
     *        to append to.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1370
     * @param local The <code>InputStream</code> providing access to the data
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1371
     *        to be appended.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1372
     * @return <code>true</code> if the transfer was successful.
21278
ef8a3a2a72f2 8022746: List of spelling errors in API doc
malenkov
parents: 18275
diff changeset
  1373
     * @throws IOException if an error occurred during the transmission.
4155
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1374
     */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1375
    public sun.net.ftp.FtpClient appendFile(String name, InputStream local) throws sun.net.ftp.FtpProtocolException, IOException {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1376
        int mtu = 1500;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1377
        Socket s = openDataConnection("APPE " + name);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1378
        OutputStream remote = createOutputStream(s.getOutputStream());
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1379
        byte[] buf = new byte[mtu * 10];
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1380
        int l;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1381
        while ((l = local.read(buf)) >= 0) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1382
            if (l > 0) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1383
                remote.write(buf, 0, l);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1384
            }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1385
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1386
        remote.close();
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1387
        return completePending();
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1388
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1389
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1390
    /**
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1391
     * Renames a file on the server.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1392
     *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1393
     * @param from the name of the file being renamed
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1394
     * @param to the new name for the file
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1395
     * @throws IOException if the command fails
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1396
     */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1397
    public sun.net.ftp.FtpClient rename(String from, String to) throws sun.net.ftp.FtpProtocolException, IOException {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1398
        issueCommandCheck("RNFR " + from);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1399
        issueCommandCheck("RNTO " + to);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1400
        return this;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1401
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1402
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1403
    /**
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1404
     * Deletes a file on the server.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1405
     *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1406
     * @param name a <code>String</code> containing the name of the file
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1407
     *        to delete.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1408
     * @return <code>true</code> if the command was successful
21278
ef8a3a2a72f2 8022746: List of spelling errors in API doc
malenkov
parents: 18275
diff changeset
  1409
     * @throws IOException if an error occurred during the exchange
4155
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1410
     */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1411
    public sun.net.ftp.FtpClient deleteFile(String name) throws sun.net.ftp.FtpProtocolException, IOException {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1412
        issueCommandCheck("DELE " + name);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1413
        return this;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1414
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1415
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1416
    /**
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1417
     * Creates a new directory on the server.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1418
     *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1419
     * @param name a <code>String</code> containing the name of the directory
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1420
     *        to create.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1421
     * @return <code>true</code> if the operation was successful.
21278
ef8a3a2a72f2 8022746: List of spelling errors in API doc
malenkov
parents: 18275
diff changeset
  1422
     * @throws IOException if an error occurred during the exchange
4155
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1423
     */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1424
    public sun.net.ftp.FtpClient makeDirectory(String name) throws sun.net.ftp.FtpProtocolException, IOException {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1425
        issueCommandCheck("MKD " + name);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1426
        return this;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1427
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1428
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1429
    /**
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1430
     * Removes a directory on the server.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1431
     *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1432
     * @param name a <code>String</code> containing the name of the directory
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1433
     *        to remove.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1434
     *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1435
     * @return <code>true</code> if the operation was successful.
21278
ef8a3a2a72f2 8022746: List of spelling errors in API doc
malenkov
parents: 18275
diff changeset
  1436
     * @throws IOException if an error occurred during the exchange.
4155
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1437
     */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1438
    public sun.net.ftp.FtpClient removeDirectory(String name) throws sun.net.ftp.FtpProtocolException, IOException {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1439
        issueCommandCheck("RMD " + name);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1440
        return this;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1441
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1442
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1443
    /**
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1444
     * Sends a No-operation command. It's useful for testing the connection
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1445
     * status or as a <I>keep alive</I> mechanism.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1446
     *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1447
     * @throws FtpProtocolException if the command fails
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1448
     */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1449
    public sun.net.ftp.FtpClient noop() throws sun.net.ftp.FtpProtocolException, IOException {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1450
        issueCommandCheck("NOOP");
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1451
        return this;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1452
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1453
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1454
    /**
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1455
     * Sends the STAT command to the server.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1456
     * This can be used while a data connection is open to get a status
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1457
     * on the current transfer, in that case the parameter should be
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1458
     * <code>null</code>.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1459
     * If used between file transfers, it may have a pathname as argument
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1460
     * in which case it will work as the LIST command except no data
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1461
     * connection will be created.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1462
     *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1463
     * @param name an optional <code>String</code> containing the pathname
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1464
     *        the STAT command should apply to.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1465
     * @return the response from the server or <code>null</code> if the
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1466
     *         command failed.
21278
ef8a3a2a72f2 8022746: List of spelling errors in API doc
malenkov
parents: 18275
diff changeset
  1467
     * @throws IOException if an error occurred during the transmission.
4155
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1468
     */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1469
    public String getStatus(String name) throws sun.net.ftp.FtpProtocolException, IOException {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1470
        issueCommandCheck((name == null ? "STAT" : "STAT " + name));
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1471
        /*
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1472
         * A typical response will be:
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1473
         *  213-status of t32.gif:
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1474
         * -rw-r--r--   1 jcc      staff     247445 Feb 17  1998 t32.gif
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1475
         * 213 End of Status
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1476
         *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1477
         * or
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1478
         *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1479
         * 211-jsn FTP server status:
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1480
         *     Version wu-2.6.2+Sun
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1481
         *     Connected to localhost (::1)
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1482
         *     Logged in as jccollet
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1483
         *     TYPE: ASCII, FORM: Nonprint; STRUcture: File; transfer MODE: Stream
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1484
         *      No data connection
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1485
         *     0 data bytes received in 0 files
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1486
         *     0 data bytes transmitted in 0 files
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1487
         *     0 data bytes total in 0 files
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1488
         *     53 traffic bytes received in 0 transfers
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1489
         *     485 traffic bytes transmitted in 0 transfers
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1490
         *     587 traffic bytes total in 0 transfers
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1491
         * 211 End of status
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1492
         *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1493
         * So we need to remove the 1st and last line
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1494
         */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1495
        Vector<String> resp = getResponseStrings();
24969
afa6934dd8e8 8041679: Replace uses of StringBuffer with StringBuilder within core library classes
psandoz
parents: 24685
diff changeset
  1496
        StringBuilder sb = new StringBuilder();
4155
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1497
        for (int i = 1; i < resp.size() - 1; i++) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1498
            sb.append(resp.get(i));
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1499
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1500
        return sb.toString();
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1501
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1502
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1503
    /**
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1504
     * Sends the FEAT command to the server and returns the list of supported
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1505
     * features in the form of strings.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1506
     *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1507
     * The features are the supported commands, like AUTH TLS, PROT or PASV.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1508
     * See the RFCs for a complete list.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1509
     *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1510
     * Note that not all FTP servers support that command, in which case
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1511
     * the method will return <code>null</code>
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1512
     *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1513
     * @return a <code>List</code> of <code>Strings</code> describing the
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1514
     *         supported additional features, or <code>null</code>
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1515
     *         if the command is not supported.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1516
     * @throws IOException if an error occurs during the transmission.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1517
     */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1518
    public List<String> getFeatures() throws sun.net.ftp.FtpProtocolException, IOException {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1519
        /*
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1520
         * The FEAT command, when implemented will return something like:
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1521
         *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1522
         * 211-Features:
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1523
         *   AUTH TLS
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1524
         *   PBSZ
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1525
         *   PROT
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1526
         *   EPSV
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1527
         *   EPRT
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1528
         *   PASV
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1529
         *   REST STREAM
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1530
         *  211 END
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1531
         */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1532
        ArrayList<String> features = new ArrayList<String>();
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1533
        issueCommandCheck("FEAT");
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1534
        Vector<String> resp = getResponseStrings();
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1535
        // Note that we start at index 1 to skip the 1st line (211-...)
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1536
        // and we stop before the last line.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1537
        for (int i = 1; i < resp.size() - 1; i++) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1538
            String s = resp.get(i);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1539
            // Get rid of leading space and trailing newline
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1540
            features.add(s.substring(1, s.length() - 1));
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1541
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1542
        return features;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1543
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1544
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1545
    /**
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1546
     * sends the ABOR command to the server.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1547
     * It tells the server to stop the previous command or transfer.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1548
     *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1549
     * @return <code>true</code> if the command was successful.
21278
ef8a3a2a72f2 8022746: List of spelling errors in API doc
malenkov
parents: 18275
diff changeset
  1550
     * @throws IOException if an error occurred during the transmission.
4155
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1551
     */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1552
    public sun.net.ftp.FtpClient abort() throws sun.net.ftp.FtpProtocolException, IOException {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1553
        issueCommandCheck("ABOR");
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1554
        // TODO: Must check the ReplyCode:
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1555
        /*
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1556
         * From the RFC:
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1557
         * There are two cases for the server upon receipt of this
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1558
         * command: (1) the FTP service command was already completed,
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1559
         * or (2) the FTP service command is still in progress.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1560
         * In the first case, the server closes the data connection
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1561
         * (if it is open) and responds with a 226 reply, indicating
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1562
         * that the abort command was successfully processed.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1563
         * In the second case, the server aborts the FTP service in
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1564
         * progress and closes the data connection, returning a 426
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1565
         * reply to indicate that the service request terminated
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1566
         * abnormally.  The server then sends a 226 reply,
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1567
         * indicating that the abort command was successfully
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1568
         * processed.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1569
         */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1570
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1571
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1572
        return this;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1573
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1574
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1575
    /**
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1576
     * Some methods do not wait until completion before returning, so this
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1577
     * method can be called to wait until completion. This is typically the case
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1578
     * with commands that trigger a transfer like {@link #getFileStream(String)}.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1579
     * So this method should be called before accessing information related to
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1580
     * such a command.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1581
     * <p>This method will actually block reading on the command channel for a
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1582
     * notification from the server that the command is finished. Such a
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1583
     * notification often carries extra information concerning the completion
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1584
     * of the pending action (e.g. number of bytes transfered).</p>
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1585
     * <p>Note that this will return true immediately if no command or action
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1586
     * is pending</p>
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1587
     * <p>It should be also noted that most methods issuing commands to the ftp
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1588
     * server will call this method if a previous command is pending.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1589
     * <p>Example of use:
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1590
     * <pre>
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1591
     * InputStream in = cl.getFileStream("file");
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1592
     * ...
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1593
     * cl.completePending();
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1594
     * long size = cl.getLastTransferSize();
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1595
     * </pre>
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1596
     * On the other hand, it's not necessary in a case like:
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1597
     * <pre>
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1598
     * InputStream in = cl.getFileStream("file");
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1599
     * // read content
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1600
     * ...
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1601
     * cl.logout();
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1602
     * </pre>
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1603
     * <p>Since {@link #logout()} will call completePending() if necessary.</p>
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1604
     * @return <code>true</code> if the completion was successful or if no
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1605
     *         action was pending.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1606
     * @throws IOException
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1607
     */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1608
    public sun.net.ftp.FtpClient completePending() throws sun.net.ftp.FtpProtocolException, IOException {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1609
        while (replyPending) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1610
            replyPending = false;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1611
            if (!readReply()) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1612
                throw new sun.net.ftp.FtpProtocolException(getLastResponseString(), lastReplyCode);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1613
            }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1614
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1615
        return this;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1616
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1617
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1618
    /**
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1619
     * Reinitializes the USER parameters on the FTP server
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1620
     *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1621
     * @throws FtpProtocolException if the command fails
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1622
     */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1623
    public sun.net.ftp.FtpClient reInit() throws sun.net.ftp.FtpProtocolException, IOException {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1624
        issueCommandCheck("REIN");
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1625
        loggedIn = false;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1626
        if (useCrypto) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1627
            if (server instanceof SSLSocket) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1628
                javax.net.ssl.SSLSession session = ((SSLSocket) server).getSession();
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1629
                session.invalidate();
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1630
                // Restore previous socket and streams
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1631
                server = oldSocket;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1632
                oldSocket = null;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1633
                try {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1634
                    out = new PrintStream(new BufferedOutputStream(server.getOutputStream()),
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1635
                            true, encoding);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1636
                } catch (UnsupportedEncodingException e) {
10419
12c063b39232 7084245: Update usages of InternalError to use exception chaining
sherman
parents: 7668
diff changeset
  1637
                    throw new InternalError(encoding + "encoding not found", e);
4155
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1638
                }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1639
                in = new BufferedInputStream(server.getInputStream());
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1640
            }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1641
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1642
        useCrypto = false;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1643
        return this;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1644
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1645
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1646
    /**
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1647
     * Changes the transfer type (binary, ascii, ebcdic) and issue the
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1648
     * proper command (e.g. TYPE A) to the server.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1649
     *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1650
     * @param type the <code>FtpTransferType</code> to use.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1651
     * @return This FtpClient
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1652
     * @throws IOException if an error occurs during transmission.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1653
     */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1654
    public sun.net.ftp.FtpClient setType(TransferType type) throws sun.net.ftp.FtpProtocolException, IOException {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1655
        String cmd = "NOOP";
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1656
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1657
        this.type = type;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1658
        if (type == TransferType.ASCII) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1659
            cmd = "TYPE A";
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1660
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1661
        if (type == TransferType.BINARY) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1662
            cmd = "TYPE I";
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1663
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1664
        if (type == TransferType.EBCDIC) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1665
            cmd = "TYPE E";
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1666
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1667
        issueCommandCheck(cmd);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1668
        return this;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1669
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1670
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1671
    /**
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1672
     * Issues a LIST command to the server to get the current directory
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1673
     * listing, and returns the InputStream from the data connection.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1674
     * {@link #completePending()} <b>has</b> to be called once the application
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1675
     * is finished writing to the stream.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1676
     *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1677
     * @param path the pathname of the directory to list, or <code>null</code>
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1678
     *        for the current working directory.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1679
     * @return the <code>InputStream</code> from the resulting data connection
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1680
     * @throws IOException if an error occurs during the transmission.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1681
     * @see #changeDirectory(String)
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1682
     * @see #listFiles(String)
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1683
     */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1684
    public InputStream list(String path) throws sun.net.ftp.FtpProtocolException, IOException {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1685
        Socket s;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1686
        s = openDataConnection(path == null ? "LIST" : "LIST " + path);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1687
        if (s != null) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1688
            return createInputStream(s.getInputStream());
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1689
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1690
        return null;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1691
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1692
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1693
    /**
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1694
     * Issues a NLST path command to server to get the specified directory
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1695
     * content. It differs from {@link #list(String)} method by the fact that
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1696
     * it will only list the file names which would make the parsing of the
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1697
     * somewhat easier.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1698
     *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1699
     * {@link #completePending()} <b>has</b> to be called once the application
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1700
     * is finished writing to the stream.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1701
     *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1702
     * @param path a <code>String</code> containing the pathname of the
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1703
     *        directory to list or <code>null</code> for the current working
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1704
     *        directory.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1705
     * @return the <code>InputStream</code> from the resulting data connection
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1706
     * @throws IOException if an error occurs during the transmission.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1707
     */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1708
    public InputStream nameList(String path) throws sun.net.ftp.FtpProtocolException, IOException {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1709
        Socket s;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1710
        s = openDataConnection("NLST " + path);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1711
        if (s != null) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1712
            return createInputStream(s.getInputStream());
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1713
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1714
        return null;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1715
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1716
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1717
    /**
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1718
     * Issues the SIZE [path] command to the server to get the size of a
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1719
     * specific file on the server.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1720
     * Note that this command may not be supported by the server. In which
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1721
     * case -1 will be returned.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1722
     *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1723
     * @param path a <code>String</code> containing the pathname of the
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1724
     *        file.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1725
     * @return a <code>long</code> containing the size of the file or -1 if
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1726
     *         the server returned an error, which can be checked with
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1727
     *         {@link #getLastReplyCode()}.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1728
     * @throws IOException if an error occurs during the transmission.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1729
     */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1730
    public long getSize(String path) throws sun.net.ftp.FtpProtocolException, IOException {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1731
        if (path == null || path.length() == 0) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1732
            throw new IllegalArgumentException("path can't be null or empty");
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1733
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1734
        issueCommandCheck("SIZE " + path);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1735
        if (lastReplyCode == FtpReplyCode.FILE_STATUS) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1736
            String s = getResponseString();
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1737
            s = s.substring(4, s.length() - 1);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1738
            return Long.parseLong(s);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1739
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1740
        return -1;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1741
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1742
    private static String[] MDTMformats = {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1743
        "yyyyMMddHHmmss.SSS",
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1744
        "yyyyMMddHHmmss"
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1745
    };
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1746
    private static SimpleDateFormat[] dateFormats = new SimpleDateFormat[MDTMformats.length];
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1747
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1748
    static {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1749
        for (int i = 0; i < MDTMformats.length; i++) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1750
            dateFormats[i] = new SimpleDateFormat(MDTMformats[i]);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1751
            dateFormats[i].setTimeZone(TimeZone.getTimeZone("GMT"));
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1752
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1753
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1754
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1755
    /**
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1756
     * Issues the MDTM [path] command to the server to get the modification
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1757
     * time of a specific file on the server.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1758
     * Note that this command may not be supported by the server, in which
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1759
     * case <code>null</code> will be returned.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1760
     *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1761
     * @param path a <code>String</code> containing the pathname of the file.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1762
     * @return a <code>Date</code> representing the last modification time
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1763
     *         or <code>null</code> if the server returned an error, which
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1764
     *         can be checked with {@link #getLastReplyCode()}.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1765
     * @throws IOException if an error occurs during the transmission.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1766
     */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1767
    public Date getLastModified(String path) throws sun.net.ftp.FtpProtocolException, IOException {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1768
        issueCommandCheck("MDTM " + path);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1769
        if (lastReplyCode == FtpReplyCode.FILE_STATUS) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1770
            String s = getResponseString().substring(4);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1771
            Date d = null;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1772
            for (SimpleDateFormat dateFormat : dateFormats) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1773
                try {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1774
                    d = dateFormat.parse(s);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1775
                } catch (ParseException ex) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1776
                }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1777
                if (d != null) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1778
                    return d;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1779
                }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1780
            }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1781
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1782
        return null;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1783
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1784
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1785
    /**
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1786
     * Sets the parser used to handle the directory output to the specified
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1787
     * one. By default the parser is set to one that can handle most FTP
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1788
     * servers output (Unix base mostly). However it may be necessary for
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1789
     * and application to provide its own parser due to some uncommon
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1790
     * output format.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1791
     *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1792
     * @param p The <code>FtpDirParser</code> to use.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1793
     * @see #listFiles(String)
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1794
     */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1795
    public sun.net.ftp.FtpClient setDirParser(FtpDirParser p) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1796
        parser = p;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1797
        return this;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1798
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1799
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1800
    private class FtpFileIterator implements Iterator<FtpDirEntry>, Closeable {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1801
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1802
        private BufferedReader in = null;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1803
        private FtpDirEntry nextFile = null;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1804
        private FtpDirParser fparser = null;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1805
        private boolean eof = false;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1806
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1807
        public FtpFileIterator(FtpDirParser p, BufferedReader in) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1808
            this.in = in;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1809
            this.fparser = p;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1810
            readNext();
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1811
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1812
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1813
        private void readNext() {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1814
            nextFile = null;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1815
            if (eof) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1816
                return;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1817
            }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1818
            String line = null;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1819
            try {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1820
                do {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1821
                    line = in.readLine();
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1822
                    if (line != null) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1823
                        nextFile = fparser.parseLine(line);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1824
                        if (nextFile != null) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1825
                            return;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1826
                        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1827
                    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1828
                } while (line != null);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1829
                in.close();
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1830
            } catch (IOException iOException) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1831
            }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1832
            eof = true;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1833
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1834
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1835
        public boolean hasNext() {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1836
            return nextFile != null;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1837
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1838
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1839
        public FtpDirEntry next() {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1840
            FtpDirEntry ret = nextFile;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1841
            readNext();
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1842
            return ret;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1843
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1844
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1845
        public void remove() {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1846
            throw new UnsupportedOperationException("Not supported yet.");
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1847
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1848
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1849
        public void close() throws IOException {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1850
            if (in != null && !eof) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1851
                in.close();
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1852
            }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1853
            eof = true;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1854
            nextFile = null;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1855
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1856
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1857
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1858
    /**
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1859
     * Issues a MLSD command to the server to get the specified directory
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1860
     * listing and applies the current parser to create an Iterator of
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1861
     * {@link java.net.ftp.FtpDirEntry}. Note that the Iterator returned is also a
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1862
     * {@link java.io.Closeable}.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1863
     * If the server doesn't support the MLSD command, the LIST command is used
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1864
     * instead.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1865
     *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1866
     * {@link #completePending()} <b>has</b> to be called once the application
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1867
     * is finished iterating through the files.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1868
     *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1869
     * @param path the pathname of the directory to list or <code>null</code>
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1870
     *        for the current working directoty.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1871
     * @return a <code>Iterator</code> of files or <code>null</code> if the
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1872
     *         command failed.
21278
ef8a3a2a72f2 8022746: List of spelling errors in API doc
malenkov
parents: 18275
diff changeset
  1873
     * @throws IOException if an error occurred during the transmission
4155
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1874
     * @see #setDirParser(FtpDirParser)
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1875
     * @see #changeDirectory(String)
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1876
     */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1877
    public Iterator<FtpDirEntry> listFiles(String path) throws sun.net.ftp.FtpProtocolException, IOException {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1878
        Socket s = null;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1879
        BufferedReader sin = null;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1880
        try {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1881
            s = openDataConnection(path == null ? "MLSD" : "MLSD " + path);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1882
        } catch (sun.net.ftp.FtpProtocolException FtpException) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1883
            // The server doesn't understand new MLSD command, ignore and fall
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1884
            // back to LIST
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1885
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1886
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1887
        if (s != null) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1888
            sin = new BufferedReader(new InputStreamReader(s.getInputStream()));
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1889
            return new FtpFileIterator(mlsxParser, sin);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1890
        } else {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1891
            s = openDataConnection(path == null ? "LIST" : "LIST " + path);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1892
            if (s != null) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1893
                sin = new BufferedReader(new InputStreamReader(s.getInputStream()));
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1894
                return new FtpFileIterator(parser, sin);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1895
            }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1896
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1897
        return null;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1898
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1899
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1900
    private boolean sendSecurityData(byte[] buf) throws IOException {
24043
81e42b05d08b 8035807: Convert use of sun.misc.BASE64Encoder/Decoder with java.util.Base64
mchung
parents: 23010
diff changeset
  1901
        String s = Base64.getMimeEncoder().encodeToString(buf);
4155
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1902
        return issueCommand("ADAT " + s);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1903
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1904
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1905
    private byte[] getSecurityData() {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1906
        String s = getLastResponseString();
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1907
        if (s.substring(4, 9).equalsIgnoreCase("ADAT=")) {
24043
81e42b05d08b 8035807: Convert use of sun.misc.BASE64Encoder/Decoder with java.util.Base64
mchung
parents: 23010
diff changeset
  1908
            // Need to get rid of the leading '315 ADAT='
81e42b05d08b 8035807: Convert use of sun.misc.BASE64Encoder/Decoder with java.util.Base64
mchung
parents: 23010
diff changeset
  1909
            // and the trailing newline
81e42b05d08b 8035807: Convert use of sun.misc.BASE64Encoder/Decoder with java.util.Base64
mchung
parents: 23010
diff changeset
  1910
            return Base64.getMimeDecoder().decode(s.substring(9, s.length() - 1));
4155
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1911
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1912
        return null;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1913
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1914
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1915
    /**
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1916
     * Attempts to use Kerberos GSSAPI as an authentication mechanism with the
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1917
     * ftp server. This will issue an <code>AUTH GSSAPI</code> command, and if
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1918
     * it is accepted by the server, will followup with <code>ADAT</code>
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1919
     * command to exchange the various tokens until authentification is
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1920
     * successful. This conforms to Appendix I of RFC 2228.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1921
     *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1922
     * @return <code>true</code> if authentication was successful.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1923
     * @throws IOException if an error occurs during the transmission.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1924
     */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1925
    public sun.net.ftp.FtpClient useKerberos() throws sun.net.ftp.FtpProtocolException, IOException {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1926
        /*
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1927
         * Comment out for the moment since it's not in use and would create
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1928
         * needless cross-package links.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1929
         *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1930
        issueCommandCheck("AUTH GSSAPI");
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1931
        if (lastReplyCode != FtpReplyCode.NEED_ADAT)
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1932
        throw new sun.net.ftp.FtpProtocolException("Unexpected reply from server");
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1933
        try {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1934
        GSSManager manager = GSSManager.getInstance();
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1935
        GSSName name = manager.createName("SERVICE:ftp@"+
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1936
        serverAddr.getHostName(), null);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1937
        GSSContext context = manager.createContext(name, null, null,
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1938
        GSSContext.DEFAULT_LIFETIME);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1939
        context.requestMutualAuth(true);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1940
        context.requestReplayDet(true);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1941
        context.requestSequenceDet(true);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1942
        context.requestCredDeleg(true);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1943
        byte []inToken = new byte[0];
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1944
        while (!context.isEstablished()) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1945
        byte[] outToken
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1946
        = context.initSecContext(inToken, 0, inToken.length);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1947
        // send the output token if generated
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1948
        if (outToken != null) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1949
        if (sendSecurityData(outToken)) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1950
        inToken = getSecurityData();
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1951
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1952
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1953
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1954
        loggedIn = true;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1955
        } catch (GSSException e) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1956
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1957
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1958
         */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1959
        return this;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1960
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1961
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1962
    /**
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1963
     * Returns the Welcome string the server sent during initial connection.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1964
     *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1965
     * @return a <code>String</code> containing the message the server
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1966
     *         returned during connection or <code>null</code>.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1967
     */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1968
    public String getWelcomeMsg() {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1969
        return welcomeMsg;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1970
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1971
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1972
    /**
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1973
     * Returns the last reply code sent by the server.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1974
     *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1975
     * @return the lastReplyCode
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1976
     */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1977
    public FtpReplyCode getLastReplyCode() {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1978
        return lastReplyCode;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1979
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1980
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1981
    /**
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1982
     * Returns the last response string sent by the server.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1983
     *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1984
     * @return the message string, which can be quite long, last returned
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1985
     *         by the server.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1986
     */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1987
    public String getLastResponseString() {
24969
afa6934dd8e8 8041679: Replace uses of StringBuffer with StringBuilder within core library classes
psandoz
parents: 24685
diff changeset
  1988
        StringBuilder sb = new StringBuilder();
4155
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1989
        if (serverResponse != null) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1990
            for (String l : serverResponse) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1991
                if (l != null) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1992
                    sb.append(l);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1993
                }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1994
            }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1995
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1996
        return sb.toString();
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1997
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1998
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  1999
    /**
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2000
     * Returns, when available, the size of the latest started transfer.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2001
     * This is retreived by parsing the response string received as an initial
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2002
     * response to a RETR or similar request.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2003
     *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2004
     * @return the size of the latest transfer or -1 if either there was no
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2005
     *         transfer or the information was unavailable.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2006
     */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2007
    public long getLastTransferSize() {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2008
        return lastTransSize;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2009
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2010
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2011
    /**
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2012
     * Returns, when available, the remote name of the last transfered file.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2013
     * This is mainly useful for "put" operation when the unique flag was
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2014
     * set since it allows to recover the unique file name created on the
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2015
     * server which may be different from the one submitted with the command.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2016
     *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2017
     * @return the name the latest transfered file remote name, or
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2018
     *         <code>null</code> if that information is unavailable.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2019
     */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2020
    public String getLastFileName() {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2021
        return lastFileName;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2022
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2023
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2024
    /**
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2025
     * Attempts to switch to a secure, encrypted connection. This is done by
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2026
     * sending the "AUTH TLS" command.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2027
     * <p>See <a href="http://www.ietf.org/rfc/rfc4217.txt">RFC 4217</a></p>
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2028
     * If successful this will establish a secure command channel with the
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2029
     * server, it will also make it so that all other transfers (e.g. a RETR
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2030
     * command) will be done over an encrypted channel as well unless a
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2031
     * {@link #reInit()} command or a {@link #endSecureSession()} command is issued.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2032
     *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2033
     * @return <code>true</code> if the operation was successful.
21278
ef8a3a2a72f2 8022746: List of spelling errors in API doc
malenkov
parents: 18275
diff changeset
  2034
     * @throws IOException if an error occurred during the transmission.
4155
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2035
     * @see #endSecureSession()
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2036
     */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2037
    public sun.net.ftp.FtpClient startSecureSession() throws sun.net.ftp.FtpProtocolException, IOException {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2038
        if (!isConnected()) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2039
            throw new sun.net.ftp.FtpProtocolException("Not connected yet", FtpReplyCode.BAD_SEQUENCE);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2040
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2041
        if (sslFact == null) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2042
            try {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2043
                sslFact = (SSLSocketFactory) SSLSocketFactory.getDefault();
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2044
            } catch (Exception e) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2045
                throw new IOException(e.getLocalizedMessage());
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2046
            }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2047
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2048
        issueCommandCheck("AUTH TLS");
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2049
        Socket s = null;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2050
        try {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2051
            s = sslFact.createSocket(server, serverAddr.getHostName(), serverAddr.getPort(), true);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2052
        } catch (javax.net.ssl.SSLException ssle) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2053
            try {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2054
                disconnect();
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2055
            } catch (Exception e) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2056
            }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2057
            throw ssle;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2058
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2059
        // Remember underlying socket so we can restore it later
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2060
        oldSocket = server;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2061
        server = s;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2062
        try {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2063
            out = new PrintStream(new BufferedOutputStream(server.getOutputStream()),
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2064
                    true, encoding);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2065
        } catch (UnsupportedEncodingException e) {
10419
12c063b39232 7084245: Update usages of InternalError to use exception chaining
sherman
parents: 7668
diff changeset
  2066
            throw new InternalError(encoding + "encoding not found", e);
4155
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2067
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2068
        in = new BufferedInputStream(server.getInputStream());
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2069
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2070
        issueCommandCheck("PBSZ 0");
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2071
        issueCommandCheck("PROT P");
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2072
        useCrypto = true;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2073
        return this;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2074
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2075
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2076
    /**
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2077
     * Sends a <code>CCC</code> command followed by a <code>PROT C</code>
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2078
     * command to the server terminating an encrypted session and reverting
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2079
     * back to a non crypted transmission.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2080
     *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2081
     * @return <code>true</code> if the operation was successful.
21278
ef8a3a2a72f2 8022746: List of spelling errors in API doc
malenkov
parents: 18275
diff changeset
  2082
     * @throws IOException if an error occurred during transmission.
4155
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2083
     * @see #startSecureSession()
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2084
     */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2085
    public sun.net.ftp.FtpClient endSecureSession() throws sun.net.ftp.FtpProtocolException, IOException {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2086
        if (!useCrypto) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2087
            return this;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2088
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2089
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2090
        issueCommandCheck("CCC");
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2091
        issueCommandCheck("PROT C");
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2092
        useCrypto = false;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2093
        // Restore previous socket and streams
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2094
        server = oldSocket;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2095
        oldSocket = null;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2096
        try {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2097
            out = new PrintStream(new BufferedOutputStream(server.getOutputStream()),
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2098
                    true, encoding);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2099
        } catch (UnsupportedEncodingException e) {
10419
12c063b39232 7084245: Update usages of InternalError to use exception chaining
sherman
parents: 7668
diff changeset
  2100
            throw new InternalError(encoding + "encoding not found", e);
4155
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2101
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2102
        in = new BufferedInputStream(server.getInputStream());
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2103
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2104
        return this;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2105
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2106
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2107
    /**
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2108
     * Sends the "Allocate" (ALLO) command to the server telling it to
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2109
     * pre-allocate the specified number of bytes for the next transfer.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2110
     *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2111
     * @param size The number of bytes to allocate.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2112
     * @return <code>true</code> if the operation was successful.
21278
ef8a3a2a72f2 8022746: List of spelling errors in API doc
malenkov
parents: 18275
diff changeset
  2113
     * @throws IOException if an error occurred during the transmission.
4155
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2114
     */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2115
    public sun.net.ftp.FtpClient allocate(long size) throws sun.net.ftp.FtpProtocolException, IOException {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2116
        issueCommandCheck("ALLO " + size);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2117
        return this;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2118
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2119
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2120
    /**
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2121
     * Sends the "Structure Mount" (SMNT) command to the server. This let the
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2122
     * user mount a different file system data structure without altering his
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2123
     * login or accounting information.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2124
     *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2125
     * @param struct a <code>String</code> containing the name of the
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2126
     *        structure to mount.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2127
     * @return <code>true</code> if the operation was successful.
21278
ef8a3a2a72f2 8022746: List of spelling errors in API doc
malenkov
parents: 18275
diff changeset
  2128
     * @throws IOException if an error occurred during the transmission.
4155
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2129
     */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2130
    public sun.net.ftp.FtpClient structureMount(String struct) throws sun.net.ftp.FtpProtocolException, IOException {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2131
        issueCommandCheck("SMNT " + struct);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2132
        return this;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2133
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2134
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2135
    /**
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2136
     * Sends a SYST (System) command to the server and returns the String
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2137
     * sent back by the server describing the operating system at the
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2138
     * server.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2139
     *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2140
     * @return a <code>String</code> describing the OS, or <code>null</code>
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2141
     *         if the operation was not successful.
21278
ef8a3a2a72f2 8022746: List of spelling errors in API doc
malenkov
parents: 18275
diff changeset
  2142
     * @throws IOException if an error occurred during the transmission.
4155
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2143
     */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2144
    public String getSystem() throws sun.net.ftp.FtpProtocolException, IOException {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2145
        issueCommandCheck("SYST");
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2146
        /*
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2147
         * 215 UNIX Type: L8 Version: SUNOS
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2148
         */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2149
        String resp = getResponseString();
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2150
        // Get rid of the leading code and blank
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2151
        return resp.substring(4);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2152
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2153
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2154
    /**
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2155
     * Sends the HELP command to the server, with an optional command, like
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2156
     * SITE, and returns the text sent back by the server.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2157
     *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2158
     * @param cmd the command for which the help is requested or
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2159
     *        <code>null</code> for the general help
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2160
     * @return a <code>String</code> containing the text sent back by the
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2161
     *         server, or <code>null</code> if the command failed.
21278
ef8a3a2a72f2 8022746: List of spelling errors in API doc
malenkov
parents: 18275
diff changeset
  2162
     * @throws IOException if an error occurred during transmission
4155
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2163
     */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2164
    public String getHelp(String cmd) throws sun.net.ftp.FtpProtocolException, IOException {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2165
        issueCommandCheck("HELP " + cmd);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2166
        /**
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2167
         *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2168
         * HELP
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2169
         * 214-The following commands are implemented.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2170
         *   USER    EPRT    STRU    ALLO    DELE    SYST    RMD     MDTM    ADAT
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2171
         *   PASS    EPSV    MODE    REST    CWD     STAT    PWD     PROT
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2172
         *   QUIT    LPRT    RETR    RNFR    LIST    HELP    CDUP    PBSZ
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2173
         *   PORT    LPSV    STOR    RNTO    NLST    NOOP    STOU    AUTH
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2174
         *   PASV    TYPE    APPE    ABOR    SITE    MKD     SIZE    CCC
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2175
         * 214 Direct comments to ftp-bugs@jsn.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2176
         *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2177
         * HELP SITE
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2178
         * 214-The following SITE commands are implemented.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2179
         *   UMASK           HELP            GROUPS
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2180
         *   IDLE            ALIAS           CHECKMETHOD
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2181
         *   CHMOD           CDPATH          CHECKSUM
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2182
         * 214 Direct comments to ftp-bugs@jsn.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2183
         */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2184
        Vector<String> resp = getResponseStrings();
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2185
        if (resp.size() == 1) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2186
            // Single line response
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2187
            return resp.get(0).substring(4);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2188
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2189
        // on multiple lines answers, like the ones above, remove 1st and last
28059
e576535359cc 8067377: My hobby: caning, then then canning, the the can-can
martin
parents: 26720
diff changeset
  2190
        // line, concat the others.
24969
afa6934dd8e8 8041679: Replace uses of StringBuffer with StringBuilder within core library classes
psandoz
parents: 24685
diff changeset
  2191
        StringBuilder sb = new StringBuilder();
4155
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2192
        for (int i = 1; i < resp.size() - 1; i++) {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2193
            sb.append(resp.get(i).substring(3));
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2194
        }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2195
        return sb.toString();
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2196
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2197
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2198
    /**
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2199
     * Sends the SITE command to the server. This is used by the server
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2200
     * to provide services specific to his system that are essential
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2201
     * to file transfer.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2202
     *
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2203
     * @param cmd the command to be sent.
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2204
     * @return <code>true</code> if the command was successful.
21278
ef8a3a2a72f2 8022746: List of spelling errors in API doc
malenkov
parents: 18275
diff changeset
  2205
     * @throws IOException if an error occurred during transmission
4155
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2206
     */
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2207
    public sun.net.ftp.FtpClient siteCmd(String cmd) throws sun.net.ftp.FtpProtocolException, IOException {
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2208
        issueCommandCheck("SITE " + cmd);
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2209
        return this;
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2210
    }
460e37d40f12 6893702: Overhaul of Ftp Client internal code
jccollet
parents:
diff changeset
  2211
}