Uploading a Directory

JFile allows the user to upload one or more individual files, or a whole directory. JFile's addDirectory method adds the contents of a directory, excluding sub-directories, to the upload. addDirectoryRecursive uploads a directory with its subdirectories, maintaining the original directory structure. When uploading a directory, use SoftArtisans FileUp's SaveRecursive method in your response script, as demonstrated in Exercise 4. To upload a directory recursively, check Recursive. Using the system's native file selection dialog, you cannot browse to a folder and click "Open" to add it to the file/folder list. Instead, enter the directory path and name in the File/Dir input field. To allow the user to browse to a folder and select it, set JFile's UseNativeFileSelection parameter to 0. When UseNativeFileSelection is disabled, JFile will display a platform-neutral file selection dialog box when the user clicks Add Files/Directory. JavaScript methods are case-sensitive.

Recursive Directory Upload

Exercise 4: Uploading a Directory

1. If you created the physical and virtual JFileScripts directories in a previous lesson, go to Step 4. If you did not create the directories, go to Step 2.
   
   
2. Create a directory called JFileScripts.
   
   
3. Create a virtual directory called JFileScripts and map it to the physical JFileScripts you created in Step 2:
   
   
   1. Open the Internet Information Services (IIS) explorer.
   2. Right-click Default Web Site.
   3. Select New -> Virtual Directory.
   4. For Alias, enter JFileScripts.
   5. Browse to the JFileScripts directory you created in step 1.
   6. Check "Read" and "Run scripts."
   7. Click "Finish."
   
   
4. Copy filetransfer.jar (for Netscape) and/or filetransfer.cab (for Internet Explorer) to the directory JFileScripts. These files are in JFile's installation directory (by default, C:\Program Files\SoftArtisans\JFile).
   
   
5. Create a server side upload script:
   
   
   1. Open formresp.asp to edit it. Formresp.asp is a server-side upload processing script that you will find in JFile's Samples\Upload\Simple directory (installed by default at C:\Program Files\SoftArtisans\JFile). Formresp.asp uses SoftArtisans FileUp to process the upload.
   2. Replace the line upl.Form(item).SaveAs filename with upl.SaveRecursive().
   3. Save formresp.asp as RecursJFileResp.asp in the directory JFileScripts.
   
   
6. Create an HTML script containing the following lines. Replace "X:\\FolderName\\SubFolderName" with a valid directory path. Name the script RecursJFile.htm and save it in your JFileScripts directory.

   <!-- The script's onload event calls the function myTransferProgress(), defined below. -->
   <BODY language="javascript" onload="myTransferProgress()">
   
   <APPLET codebase="/JFileScripts" code="softartisans.filetransfer.UploadClient.class" 
   height="0" width="0" mayscript archive="filetransfer.jar" name="fileupload">
   	
   	<!-- The Cabbase parameter specifies the cab file containing the applet. -->
   	<PARAM name="cabbase" value="filetransfer.cab">
   
   	<!-- The PostURL parameter specifies the URL to which the file will be posted. -->
   	<PARAM name="PostURL" value="http://localhost/jfilescripts/RecursJFileResp.asp">
   			
   </APPLET>
   
   <SCRIPT language="Javascript">
   
   // JFile will set the variable SAJFileAppletLoaded to True when the applet is loaded. 
   var SAJFileAppletLoaded = False;
   
   // The function myTransferProgress() adds a directory to the applet's upload list.
   function myTransferProgress()
   	{
   	if(SAJFileAppletLoaded)
   		{
   		// addDirectoryRecursive adds the specified directory to the list of files and folders to 
   		// upload.  Enter a valid directory and path.
   		document.fileupload.addDirectoryRecursive("X:\\FolderName\\SubFolderName")
   		}
   	else
   		alert("Applet is not loaded.");
   	}
   </SCRIPT>
   </BODY>

Understanding the Script

• The BODY tag's onload attribute is set to "myTransferProgress()", that is, when loaded, the script will call the myTransferProgress() function.
  
  
• The APPLET tag adds JFile's UploadClient applet to your web page. We assigned values to several APPLET attributes:
  
  
  • Codebase
    Specifies the directory containing the UploadClient's Java class. If the Java class is in the same directory as the script referencing it - as it is in this exercise - Codebase is optional. When the Java class is in a different directory, specify the complete relative path or URL.
    
    
  • Code
    Specifies the name of the applet's Java class. UploadClient is JFile's upload applet. Java class names are case-sensitive.
    
    
  • Height and Width
    Specify the height and width, in pixels, of a browser-embedded applet. By default, the applet is displayed in a pop-up window. To embed the applet in the main browser window, set the parameter UseAppletInBrowser to 1, as follows.

    	<PARAM name="UseAppletInBrowser" value=1>

    If you do not set UseAppletInBrowser to 1, that is, if you display the applet in a separate window, set Height and Width to 0.
    
    
  • Mayscript
    Specifies that the applet can be manipulated in script.
    
    
  • Archive
    Specifies the archive file containing the Java applet. Filetransfer.jar contains JFile's Java class files for Netscape Navigator.
    
    
  • Name
    Specifies a variable name for this instance of the UploadClient applet. You can assign any name to Name. Use the name you assign to reference the UploadClient applet in script.
    
    
• The Cabbase parameter specifies the cab file containing the Java applet. Filetransfer.cab contains JFile's Java class files for Internet Explorer.
  
  
• The PostURL parameter specifies the URL to which the file will be posted, http://localhost/jfilescripts/RecursJFileResp.asp. RecursJFileResp.asp uses SoftArtisans FileUp to process the upload.
  
  
• The function myTransferProgress() is called by the script's onload event. If the variable SAJFileAppletLoaded is True, that is, if the applet loaded successfully, myTransferProgress() will preset a specified folder for upload, using the method addDirectoryRecursive. addDirectoryRecursive uploads a directory with its subdirectories, maintaining the original directory structure.
  
  

  JavaScript methods are case-sensitive.