readme.txt

both http and ftp file upload

jClientUpload 1.8
Copyright JavaZOOM 1999-2006
http://www.javazoom.net

==========================================================
jClientUpload support page :
http://www.javazoom.net/applets/jclientupload/jclientupload.html

jClientUpload add-ons page :
http://www.javazoom.net/applets/jclientupload/tools.html

JSP Forums :
http://www.javazoom.net/services/forums/index.jsp
==========================================================

* Open applet_http.html or applet_ftp.html for sample *
* Open documentation/index.html for documentation and FAQ *


-----------------
07/03/2006 : v1.8
-----------------
- GZIP support added for "ziponfly" parameter.
- "startdir" parameter added for file chooser.
- "authentication" parameter added (allowing to prompt user for credentials).
- "blacklist" parameter added.
- "zipignorelist" parameter added.
- "transfertype" extra parameter added for FTP.
- Drag&Drop with whitelist bug fixed.
- Time elapsed bug fixed.
- i18n.properties improved :
   filechooser.dialog.filefilter.label
   filechooser.dialog.filefilter.blacklist
   progress.bar.upload.done.label
   progress.bar.upload.failed.label
   progress.bar.upload.cancelled.label
   taskoutput.linewrap
   dnd
- setProperty JavaScript method improved.
- Documentation updated.
- "Click to activate" (KB912945) workaround for IE included.
- JRE 1.6 support added.
> Add-ons section updated :
   - JCU Explorer : This plugin provides an explorer-like front-end.
   - JSEHTTP : This plugin adds Single Sign On support for NTLM proxy.


-----------------
01/09/2006 : v1.7
-----------------
- Image preview support added to file chooser.
- Custom messages added in i18n.properties for progress bars while uploading :
   progress.bar.upload.label=Uploading {0}% ({1})
   progress.info=overallprogressbar 
   progress.info.label=Overall upload {0}% ({1}/{2})
   progress.info.option=fileratio
- ArrayIndexOutOfBound bug fixed for overallprogressbar with chunksize.
- JavaScript to Applet API improved.
   setProperty(param,value) function added to update parameters.
- lookandfeel property improved :
   classname or auto to select platform L&F.
- Username, password and url could be setup in i18n.properties.
- Documentation improved.


-----------------
09/05/2005 : v1.6
-----------------
- resume feature added for both FTP and HTTP.
- FTPS support added (SSL/TLS implicit and explicit with channel protection).
- overwrite parameter added.
- Renaming feature added through "template" parameter.
- Cancel button could be removed.
- Optional "Select file(s)" button added :
   You could enable a button to browse files/folders through the following
   keys in i18n.properties :
    progress.button.select=Select file(s)
    progress.button.select.color.background=EEEEFF
    progress.button.select.color.foreground=000033
    progress.button.select.disabled.color=000099
- Optional background image added through taskoutput.image.background property.
- Multiple directories upload support improved.
- Read-only devices (CD-ROM/DVD) support added through "tmpfolder" parameter.
- Workaround included for custom HTTP error messages issue.
- Copy/Paste and Drag&Drop support improved for Gnome/Linux and KDE/Linux.
- API improved : Pluggable front-end support added.
- Documentation updated (samples and screenshots included).
> Add-ons section updated :
   - PGP Filter : This plugin allows to PGP encrypt files before upload.
   - PHPScript : This is a working PHP script sample for jClientUpload.

+ Gene6 FTP server support added.
+ Orenosv FTP server support added.


-----------------
05/06/2005 : v1.5
-----------------
- Auto-detect HTTP proxy settings improved.
- Optional progress info added :
   You can select either an overall transfer progress bar 
   or time elapsed (hh:mm:ss) for current transfer through
   "progress.info" and "progress.info.label" i18n properties
- Redirect after upload feature improved :
   "forward" property allows to append parameter.
   cookiename/cookievalue pair supported in "post" parameter.
   url encoding bug fixed.
- Multiple applet instances on same HTML page support added.
- getState and getFilenames JavaScript methods added.
- "encoding" support added to FTP upload.
- JavaScript setParameter bug fixed.
- Documentation updated.


-----------------
02/01/2005 : v1.4
-----------------
- username/password parameters added to support HTTP www-authentication.
- Pluggable pre-processing filter API added.
- i18n.properties improved :
   taskoutput.filter.started
   taskoutput.filter.completed
   taskoutput.filter.failed
- Custom look and feel support added.
- Documentation improved.
+ Add-ons section updated :
  - Scaling Filter : This plugin allows to scale (generate thumbnails
                     or magnify) images before uploading.


-----------------
01/03/2005 : v1.3
-----------------
- "hiddenfile" parameter added to accept/deny hidden files for upload.
- "policy" parameter added to abort/ignore unmatching files to upload.
   (This parameter works with whitelist, maxsize and hiddenfile parameters).
- "ziponfly" parameter added.
- "post" and "postparameters" added to allow HTTP POST request after 
   successfull uploads and before optional URL redirection.
- "errorheader" parameter added to pass custom error message from 
   server-side to jClientUpload.
- "deleteonfail" extra parameter added to delete file on FTP server
   if upload is cancelled or failed.
- Bug fix in FTP remote folders creation.
  (recursive feature added).
- i18n.properties improved :
   menu.color.selection.background property added.
   taskoutput.upload.failed.hidden.error property added.
   taskoutput.upload.failed.whitelist.error property added.
   taskoutput.compress.started property added.
   taskoutput.compress.completed property added.
   taskoutput.compress.failed property added.
- Documentation updated.
+ Add-ons section added :
  - WeakSSL plugin : It allows to run jClientUpload under HTTPS with 
    a self-signed SSL certificate and get rid of "No trusted CA" error.
  - ColdFusion sample upload script.


-----------------
11/02/2004 : v1.2
-----------------
- Base64 parameters encoding support added.
  (Enclose Base64 parameters into [])
- Cookie support added.
- JavaScript to Applet API added.
  setParameter(name,value) added to pass dynamic parameters.
- FTP PASV command support added.
- FTP SITE custom command support added.
- SOCKS proxy support added.
- HTTP proxy support added.
- HTTPS support added.
- Mime-Types support added.
- Internationalization and Multilanguage support improved.
- True Type font support added.
- Colors support bug fixes.
- Documentation updated.

+ GlobalScape FTP server support added.
+ Windows 2003 FTP server support added.
+ JRE 1.5.0 support added.


-----------------
09/01/2004 : v1.1
-----------------
 - Multiple files selection support added.
   maxfiles parameter added.

 - Directory upload support added.
   folderdepth and relativefilename parameters added.

 - Split feature added to support very large uploads (>2GB).   
   It allows to get rid of 2GB HTTP POST limit of web servers such as Apache.
   Cancel button available while splitting.
   Progress bar available while splitting.
   chunksize parameter added.

 - Redirect after upload feature added.
   forward, forwardparameters and forwardtarget parameters added.

 - FTP support.
   username, password, account parameters added.

 - Copy/Paste (ctrl-v, apple-v) support added.

 - Java Web Start and stand alone application support added.
   (FTP JNLP sample and HTTP JNLP included)

 - Design improved to plug any transport protocol.

 - FTP applet sample and HTTP applet sample included.

 - New optional parameters :
   timeout parameter added for underlying socket.

 - Documentation updated.

 + Safari/MacOSX support added.
 + Internet Explorer/MacOSX support added.
 + Mozilla 1.4.1/Linux support added.
 + BulletProof FTP Server support added.
 + Ability FTP Server support added.


-----------------
07/20/2004 : v1.0
-----------------
Features :
 - Upload progress bar available.
 - Drag and drop support.
 - Cancel upload included.
 - Whitelist support.
 - max. file size limit support.
 - Up to 5 additional HTTP parameters support.
 - Large uploads support (more than 1GB).
 - Low memory consuming.
 - Fast and easy deployment (Applet).
 - Multilanguage support.
 - HTTP Multipart/form-data (RFC 1867) compliant.
 - JSP/Servlet, ASP/.NET, PHP, Perl/CGI support for server-side.
 - Customizable colors.
 - Flexible API
   (Cookies support, HTTP 1.0/1.1 support, ...)

Security :
 jClientUpload JAR files include a self-signed X509 certificate to get rid
 of security restrictions (access to local disk to select files to upload).


Note :
----
jClientUpload supports Commons-HTTPClient 2.0.2 and includes Commons-Logging 1.0.4.
Learn more about Commons-Logging : http://jakarta.apache.org/commons/logging/
Learn more about Commons-HTTPClient 2.0 : http://jakarta.apache.org/commons/httpclient/
Learn more about Commons-NET 1.3.0 : http://jakarta.apache.org/commons/net/
Learn more about ORO 2.0.8 : http://jakarta.apache.org/oro/