XdevUpload
Die Upload-Komponente ermöglicht den Zugriff auf das lokale Dateisystem des Client, um beliebige Dateien auszuwählen und anschließend auf den Server hochzuladen.
Variante 1: Property "Immediate = false"
Die Komponente besteht aus einem Button, der den lokalen Dateimanager aufruft und die Auswahl einer Datei ermöglicht sowie aus einem zweiten Button, der den Upload-Vorgang startet.
Zwischen den Buttons wird der Name der ausgewählten Datei angezeigt. Wichtig: Der Upload startet erst, wenn der Button "Upload" gedrückt wird.
Variante 2: Property "Immediate = true"
Die Komponente besteht aus nur einem Button. Dieser löst den Filechooser und den Upload sofort aus. Wichtig: Der Upload wird sofort nach der Dateiauswahl ausgelöst.
Die Upload-Komponente benötigt einen "Receiver", der auf Serverseite die Datei empfängt und weiterverarbeitet. Der Receiver kann im Konstruktor oder im INIT-Event des jeweiligen Fensters initialisiert werden. Siehe CodeBeipspiel unten.
Wichtige Properties:
ButtonCaption - Beschriftung des Upload-Buttons.
Receiver - Der Receiver ist ein Objekt, das die Verarbeitung der Datei auf Serverseite übernimmt.
Wichtige Events:
uploadFailed - Wird ausgelöst, wenn der Upload fehlschlägt.
uploadFinished - Wird ausgelöst, sobald der Upload beendet ist. Zu diesem Zeitpunkt steht noch nicht fest, ob der Upload erfolgreich war oder nicht.
updateProgress - Wird regelmäßig während des Uploads ausgelöst. Damit ist es möglich, den Fortschritt des Uploads zu verfolgen.
uploadStarted - Wird ausgelöst, sobald der Upload begonnen hat.
uploadSucceeded - Wird ausgelöst, sobald der Upload beendet ist und erfolgreich war.
Databinding:
Kein Databinding vorhanden.
Examples:
Upload einer Datei
public class MainView extends XdevView {
File file;
public MainView() {
super();
this.initUI();
final Receiver receiver = new Receiver() {
@Override
public OutputStream receiveUpload(final String filename, final String mimeType) {
// Create upload stream to write to
FileOutputStream fos = null;
try {
// Get path to servlet's temp directory
final File temporaryDirectory = (File) VaadinServlet.getCurrent().getServletContext().getAttribute(ServletContext.TEMPDIR);
// Concatenate temporaryDirectory with filename and open the file for writing.
MainView.this.file = new File(temporaryDirectory, filename);
// Create the output stream
fos = new FileOutputStream(MainView.this.file);
} catch (final java.io.FileNotFoundException e) {
Notification.show("Could not open file", Type.ERROR_MESSAGE);
return null;
}
return fos;
}
};
// Set Receiver for upload component
this.upload.setReceiver(receiver);
}