1		--------------------------------------------------
2				FakeFtpServer Features and Limitations
3		--------------------------------------------------
4
5FakeFtpServer Features
6~~~~~~~~~~~~~~~~~~~~~~
7
8  * Standalone dummy FTP server. Run either within the same JVM as test code or in a different JVM.
9
10  * Implements common FTP server commands.
11
12  * Works out of the box with reasonable and expected behavior. Can simulate most mainline success and error scenarios.
13
14  * In most cases, requires little or no knowledge or understanding of FTP server commands and reply codes.
15
16  * Provides a simulated server file system, including support for file and directory permissions and owner and
17   group authorization based on Unix. This file system can be populated at startup (or thereafter) with
18   directories and files (including arbitrary content) to be retrieved by an FTP client. Any files sent to the server
19   by an FTP client exist within that file system as well, and can be accessed through the file system API, or
20   can even be subsequently retrieved by an FTP client.
21
22  * Allows defining the set of user accounts that control which users can login to the FTP server, and their home
23    (default) directories.
24
25  * Supports active and passive mode data transfers.
26
27  * Use a dynamically chosen free port number for the server control port instead of using the default (21)
28    or hard-coding some other value (set the serverControlPort property of the server to 0).
29
30  * Supports extended address (IPv6) data transfers (RFC2428)
31
32  * Fully supports configuration within the <<Spring Framework>> or other dependency-injection container.
33
34  * Can be used to test FTP client code written in any language
35
36FTP Scenarios Supported by FakeFtpServer
37~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
38
39  Some of the mainline success scenarios that you can simulate with <<FakeFtpServer>> include:
40
41    * Login (USER/PASS): with password, or when no password is required
42
43    * Retrieve existing file (RETR) from the server
44
45    * Send file to the server (STOR,STOU,APPE)
46
47    * List of file entries (LIST) and list of filenames (NLST)
48
49    * Print current working directory (PWD)
50
51    * Change current working directory (CWD)
52
53    * Rename an existing file (RNFR/RNTO)
54
55    * Delete an existing file (DELE)
56
57    * Create directory (MKD)
58
59    * Remove directory (RMD)
60
61    * Both active and passive mode (PASV) data transfers
62
63    * Extended Address (IPv6) data transfers (EPRT and EPSV commands)
64
65  Some of the error scenarios that you can simulate with <<FakeFtpServer>> include:
66
67    * Failed login (USER/PASS): no such user, wrong password
68
69    * Invalid client requests: missing required parameter, not logged in
70
71    * Failed retrieve (RETR): no such file, missing required access permissions for the current user
72
73    * Failed send (STOR,STOU,APPE): missing required access permissions for the current user
74
75    * Failed change current working directory (CWD): no such directory, missing required access permissions for the current user
76
77    * Failed delete an existing file (DELE): file does not exist, missing required access permissions for the current user
78
79    * Failed rename (RNFR/RNTO): no such file, missing required access permissions for the current user
80
81    * Failed create directory (MKD): parent directory does not exist, directory already exists, missing required access permissions for the current user
82
83    * Failed remove directory (RMD): no such directory, directory not empty, missing required access permissions for the current user
84
85
86FakeFtpServer Limitations
87~~~~~~~~~~~~~~~~~~~~~~~~~
88
89  Not all FTP features, error scenarios and reply codes can be simulated using <<FakeFtpServer>>. Features and
90  scenarios not supported include:
91
92  * Leaving the data connection open across multiple client requests.
93
94  * Transmission mode other than 'Stream'. The STRU command is implemented but has no effect (NOOP).
95
96  * Data Types other than ASCII and IMAGE (binary).
97
98  * Vertical Format Control other than the default (NON PRINT).
99
100  * Record Structure and Page Structure. The STRU command is implemented but has no effect (NOOP).
101
102  * Error Recovery and Restart. The REST command is implemented but has no effect (NOOP).
103
104  * Structure Mount. The SMNT command is implemented but has no effect (NOOP).
105
106  * Abort. The ABOR command is implemented but has no effect (NOOP).
107
108  * Allocate. The ALLO command is implemented but has no effect (NOOP).
109
110  []
111
112  For unsupported features, error scenarios and reply codes, consider using <<StubFtpServer>> instead, which
113  provides a lower-level abstraction and finer control over exact server reply codes and responses.
114