Introduction


JustFTP is an ActiveX component (justftp.dll) that is used to access network resources using the Internet FTP protocol.

JustFTP is designed to be used in VBScript applications or ASP/ASP.NET Web pages. See the sample code for file transfers etc. using ASP and VBScript. It is ideal for scheduled file transfers written in VBScript / JavaScript.

It can be easily "driven" by scripting languages such as VBScript, JavaScript, ASP, ASP.NET. Also, because it exposes a COM IDispatch "Dual Interface", any modern language that supports COM / ActiveX can be used to "drive" the JustFTP component. (Visual Basic or C/C++ for example.) 

JustFTP frees you from the networking details. It enables you to get on with your file transfers and administrative tasks. Similar components are often overly complex when, really, you just need to 'get' or 'send' a known file.

However we also understand that a remote directory listing can be quite useful at times. Therefore we have included a basic "DIR" function that your scripts or ASP pages can use to traverse the remote file system. This functionality is left up to the user of JustFTP. VBScript sample code to sort the directory results and look for specific files is straightforward. We may include some of these samples on our site as we get time.

Methods

The following 9 methods are provided by the JustFTP component.
All methods return a simple string result (either "OK" or "Fail").

The Dir method also returns a directory listing of the remote server for the directory specified. This is a string listing of files and directories returned in the "DirList" variable that is passed to the method. The returned directory listing shows files prefixed by the two characters "F-", directories prefixed by a "D-". This provides an easy way to tell if a name returned is a sub-directory name or an actual file.

Get and Send are binary (image) file transfer functions.
The GetASC and SendASC have been provided for use where FTP ASCII file transfers are required (eg. UNIX/Linux). 

A major feature of the JustFTP component is that there is no need to maintain an FTP "session". Each method call sets up a session, performs the required function, then closes the session automatically, this makes administrative scripting of file transfers easy and robust.

No testing for obscure error codes is required. Just test for the string "OK" (or "Fail") to control the flow of your script - see sample code below.

Methods provided:

Dir(RemoteHost, RemoteDir, DirList, UserName, Password)
Get(LocalFile,  RemoteHost,  RemoteDir,  RemoteFilename,  UserName,  Password)
GetASC(LocalFile,  RemoteHost,  RemoteDir,  RemoteFilename,  UserName, Password )
MakeDir(RemoteHost,  RemoteDir,  NewRemoteDir,  UserName,  Password)
RemoveDir(RemoteHost, RemoteDir, DirToDelete,  UserName,  Password)
RemoveFile(RemoteHost, RemoteDir, RemoteFilename, UserName, Password )
RenameFile(RemoteHost, RemoteDir, RemoteExistingFilename, RemoteNewFilename, UserName, Password)
Send( LocalFile,  RemoteHost,  RemoteDir,  RemoteFilename,  UserName,  Password)
SendASC(LocalFile,  RemoteHost,  RemoteDir,  RemoteFilename,  UserName,  Password)

These methods cater for most of the common FTP file manipulation requirements.  All methods take username and password credentials, if these are not required, an empty string ("") may be used.

Note: RemoveDir will remove (delete) an empty remote Directory or folder only. MakeDir will make (create) a remote Directory or folder.

 

See Code Examples

Download the trial version 404 KB



 

Google
 
Web easterndigitalsoftware.com

Copyright 2006 Eastern Digital Pty. Ltd. Australia.  ABN 87 004 274 051
Home | Contact us | Products | Downloads | Support | Privacy Policy