Dokumentation HTTPUpload Applet 1.3

Dokumentation HTTPUpload Applet 1.3
von Enrico Bär ( 08.06.2007 )
Dieses Applet dient zum verbesserten Upload von Dateien ins Internet. Es verhält sich identisch mit
dem Browser Upload von einem Formular. Die Upload-Methode dabei ist POST. Man kann mehrere
Dateien über eine Dialogbox auswählen und diese automatisch hochladen. Das Applet lädt dabei jede
Datei einzeln hoch, macht also kein Multiupload. Es bekommt für jede Datei die Bestätigung vom
Server. Alternativ kann seit Version 1.1 auch ein FTP-Upload genutzt werden. Der Modus wird über
den Parameter useFTP eingestellt. Beachten Sie, dass der Standardport 21 für FTP (z.B. in
Firmennetzen) meist nicht freigegeben ist. Mit Version 1.1 ist auch die Sprachunterstützung für
Deutsch und Englisch dazugekommen.
Zusätzlich gibt es noch spezielle Funktionen für Bilderuploads. Es ist eine Vorschau für JPEG und
PNG Dateien vorhanden. Für die gleichen Dateitypen können Bilder auch auf eine feste Größe
gebracht werden, bevor sie hochgeladen werden.
Folgende Parameter können dem Applet übergeben werden:
ISOLanguage (1.1)
Gibt die Sprache des Applets an. Derzeit gibt es Unterstützung für Deutsch(„de“) und Englisch („en“).
(String, Default „de“)
maxFiles
maximale Anzahl von Dateien in einem Uploadprozeß. Nur relevant bei limitedFiles TRUE.
(Integer, Default 50)
maxFilesWarning
Warnungstext bei Auswahl von mehr Dateien als in maxFiles angegeben. Nur relevant bei
limitedFiles TRUE.
(String, Default „Upload-Anzahl ist auf 50 beschränkt“ )
limitedFiles
Dateien auf eine Anzahl pro Uploadprozeß beschränken
(Boolean, Default FALSE)
UploadURL
Zielpfad vom Empfangsscript, genau wie im HTML das ACTION-Attribut
(String, z.B. „http://localhost/gal/javaupload.php“ oder „javaupload.php“ )
FTPServer (1.1)
Bezeichnung des FTP-Servers (z.B. „www.kadiba.de“ ). Nur relevant bei useFTP TRUE.
(String, Default leer )
FTPPort (1.1)
Gibt den Port des FTP-Servers an. Nur relevant bei useFTP TRUE.
(Integer, Default 21)
FTPDirectory (1.1)
Gibt das Verzeichnis auf dem FTP-Server an. Falls das Verzeichnis nicht existiert, wird versucht es
anzulegen. Angaben wie „upload/pictures“ sollten auch funktionieren. relevant bei useFTP TRUE.
(String, Default „“)
FTPUser (1.1)
Gibt den Usernamen für den FTP-Account an und ist für das Login notwendig. Nur relevant bei
useFTP TRUE.
(String, Default „“)
FTPPW (1.1)
Gibt das Passwort für den FTP-Account an und ist für das Login notwendig. Nur relevant bei useFTP
TRUE.
(String, Default „“)
FTPPassivMode (1.1)
Gibt den FTP-Connection-Modus an (Passiv oder Aktiv). Nur relevant bei useFTP TRUE.
(Boolean, Default TRUE)
useFTP (1.1)
Bestimmt den Uploadmodus HTTP-Upload oder FTP-Upload.
(Boolean, Default FALSE)
FilterExtensions
Dateifilter für die Auswahl im Dateidialog. Nur relevant bei Filefilter TRUE.
(String, Default „jpg,jpeg,png,gif“)
Filefilter
Dateifilter aktivieren.
(Boolean, Default FALSE)
resizeImageWidth
Bildbreite für Verkleinerung bzw. Vergrößerung (Querformat). Nur relevant bei resizeImage TRUE.
(Integer, Default 500)
resizeImageHeight
Bildhöhe für Verkleinerung bzw. Vergrößerung (Hochformat). Nur relevant bei resizeImage TRUE.
(Integer, Default 500)
resizeQuality
JPEG-Bildqualität für das geänderte Bild. Nur relevant bei resizeImage TRUE.
(Integer, Default 82)
onlyMinResize
Bilder nur Verkleinern. Nur relevant bei resizeImage TRUE.
(Boolean, Default TRUE)
resizeImage
Größenänderung für Bilder aktivieren. WICHTIG: Wird die Größe tatsächlich geändert, entsteht
immer eine JPG-Datei, d.h. die Größenänderung beinhaltet ggf. auch eine Konvertierung. Folgende
Formate können konvertiert werden: GIF, JPG, PNG.
(Boolean, Default FALSE)
startScriptURL(1.3)
Ist eine URL angegeben wird vor dem Upload noch eine Datei geladen. So kann z.B. ein
serverseitiges Script angestartet werden.
finalScriptURL(1.3)
Ist eine URL angegeben wird nach dem Upload noch eine Datei geladen. So kann z.B. ein
serverseitiges Script angestartet werden.
labelAddButton
Bezeichnung für den Hinzufügen-Button.
String, Default „Hinzufügen“)
labelRemoveButton
Bezeichnung für den Entfernen-Button.
(String, Default „Entfernen“ )
labelUploadButton
Bezeichnung für den Upload-Button.
(String, Default „Hochladen“ )
labelCancelButton
Bezeichnung für den Abbrechen-Button
(String, Default „Abbrechen“ )
BackgroundColor
Hintergrundfarbe in HTML-Angabe.
(String, HEX-Wert, z.B. „CC0000“)
TextColor
Textfarbe in HTML-Angabe.
(String, HEX-Wert, z.B. „000000“)
StatusColor
Fensterfarbe in HTML-Angabe.
(String, HEX-Wert, z.B. „FFFFFF“)
Funktionen die mit JavaScript aufrufbar sind:
Oft benötigt man zusätzliche Variablen, die man mit jedem HTTP-Upload mitgeben muß, damit das
Empfangsscript ordentlich funktionieren kann. Dazu können folgende Funktionen hilfreich sein. Es
gibt lediglich zwei Wege. Zum Einen kann ein Formular mit Hidden-Feldern (max. 20) aufgebaut
werden, die dann nach Funktionsaufruf vom Applet einmalig ausgelesen werden, zum Anderen
können die Uploadparameter (unbeschränkt) direkt mit Javascript gesetzt werden. Diese Funktionen
sind für eine Nutzung von FTP unrelevant.
Uploadvariablen
readHTMLUploadParameters()
Es ist möglich ein HTML Formular mit dem Namen „HTMLUpload“ im FORM-Tag auf der AppletSeite anzulegen. Darin können Hidden-Variablen mit folgendem Format anglegt werden, um
Variablen mit dem Upload mitzusenden. Beispiel:
<applet code="...>.......</applet>
<form name="HTMLUpload">
<input type="hidden" name="attribut0" value="id=5">
<input type="hidden" name="attribut1" value="user=V.001">
</form>
<script type="text/javascript">
readHTMLUploadParameters();
<script>
Es werden die Variablen id und user mit den Werten 5 und V.001 für jeden Upload mitgesendet. Im
Formular sind Variablennamen von attribut0 bis attribut19 erlaubt.
setHTMLUploadParameter( String Variable, String Wert )
Hier können dem Upload eine oder mehrere Variablen inklusive Werten mitgegeben werden.
Beispiel: setHTMLUploadParameter( „galerie_id“, „5“ );
clearHTMLUploadParameter()
Alle zusätzlichen Uploadparameter löschen.
removeHTMLUploadParameter( String Variable )
Einen bestimmten Uploadparameter mit dem Wert löschen.
Controlfunktionen:
start()
Applet starten.
stop()
Applet stoppen.
init()
Applet neu initialisieren (Parameter neu auslesen).
setParameter( String Parameter, String Wert ) (1.1)
Sie können alle Appletparameter, die sie mit HTML an das Applet übergeben, ebenfalls mit
JavaScript nachträglich setzen bzw. verändern. Diese Funktion ist nicht mit der Funktion
setHTMLUploadParameter( String Variable, String Wert ) zu verwechseln.
activateButtonRemove()
Ausgewählte Datei entfernen. Entfernen-Button auslösen.
activateButtonCancel()
Upload unterbrechen. Abbrechen-Button auslösen.
Sonstiges
setStatus( String Text )
Der Text erscheint im Statusfenster.
getAppletInfo()
Zeigt die Appletinformationen an.
refresh()
Die Anzeige vom Applet wird refresht.
So sieht die Einbindung in HTML aus
<applet code="org.kadiba.httpupload.HTTPUpload"
archive="applet/HTTPUpload.jar"
mayscript="mayscript"
width="600"
height="350"
name="HTTPUploadApplet"
alt="HTTPUpload.jar by www.kadiba.de">
<param
<param
<param
<param
<param
<param
<param
<param
<param
<param
<param
<param
<param
<param
<param
<param
<param
<param
<param
<param
<param
<param
<param
<param
<param
<param
<param
<param
name="ISOLanguage"
name="maxFiles"
name="maxFilesWarning"
name="UploadURL"
name="startScriptURL"
name="finalScriptURL"
name="FTPServer"
name="FTPPort"
name="FTPDirectory"
name="FTPUser"
name="FTPPW"
name="useFTP"
name="FTPPassivMode"
name="FilterExtensions"
name="resizeImageWidth"
name="resizeImageHeight"
name="onlyMinResize"
name="resizeQuality"
name="limitedFiles"
name="Filefilter"
name="resizeImage"
name="labelAddButton"
name="labelRemoveButton"
name="labelUploadButton"
name="labelCancelButton"
name="BackgroundColor"
name="TextColor"
name="StatusColor"
value="de">
value="100">
value="Die Anzahl pro Upload ist auf 100 begrenzt">
value="java_upload.php">
value="begin.php">
value="end.php">
value="your.ftpserver.com">
value="21">
value="uploaddirectory/pictures">
value="testuser">
value="testpw">
value="false">
value="true">
value="jpg,jpeg,png">
value="500">
value="500">
value="true">
value="100">
value="true">
value="true">
value="true">
value="Hinzufügen">
value="Entfernen">
value="Hochladen">
value="Abbrechen">
value="CC0000">
value="000000">
value="FFFFFF">
Ihr Browser unterstützt keine Applets. Bitte installieren Sie sich aktuelle JDK
von sun. Den Download gibts auf <a href="http://www.java.com/">java.com</a>
</applet>
Achten Sie auf das Schlüsselwort mayscript, falls Sie mit Javascript Funktionen vom Applet aufrufen
wollen.
Viel Spaß
Ihr Kadiba-Team
www.kadiba.de