Wenn in der Nachrichtenanwendung auf dem BlackBerry-Gerät eine Nachricht mit einer Anlage eingeht, können Sie die Anlage automatisch herunterladen und auf dem BlackBerry-Gerät speichern.

Vor dem Herunterladen von Anlagen überprüft die AttachmentDownloadManager-Klasse die Anlage. AttachmentDownloadManager gibt Ausnahmen aus, wenn eine der folgenden Bedingungen auftritt.

• Die Anwendung versucht, das Herunterladen aufzurufen, obwohl ein solcher Vorgang bereits im Gange ist.
• Die Anwendung versucht, Dateien der Länge null herunterzuladen.
• Die Anlage ist größer als von der Anwendungs-IT-Richtlinie oder von Servicebüchern erlaubt.
• Anlagen sind verschlüsselt.
• Es ist nicht genug Speicherplatz auf dem BlackBerry-Gerät oder der SD-Karte verfügbar.

Die AttachmentDownloadManager.download()-Methode führt während des Download-Vorgangs eine Überprüfung aus. Wenn Überprüfungsfehler gefunden werden, gibt die Methode eine Ausnahme aus. Eine Liste möglicher Überprüfungsfehler finden Sie in der API-Referenz für die BlackBerry Java Development Environment.

1. Importieren Sie die erforderlichen Klassen und Schnittstellen.

   import java.io.IOException;
   import net.rim.blackberry.api.mail.*;
   

2. Implementieren Sie die DownloadProgressListener-Schnittstelle. Erstellen Sie eine Instanz der AttachmentDownloadManager-Klasse.

   public class AutoAttachTest implements DownloadProgressListener 
   {
      AttachmentDownloadManager _adm = new AttachmentDownloadManager();

3. Verwenden Sie die Methoden, die in AttachmentDownloadManager verfügbar sind, um Informationen zur Anlage zu erhalten.

   public String fileSize = getFileSize(BodyPart bodyPart);
   public String fileName = getFileName(BodyPart bodyPart);
   public String fileType = getFileContentType(BodyPart bodyPart);
   public String filePath = getDownloadedFileName(BodyPart bodyPart);

4. Rufen Sie AttachmentDownloadManager.download() auf, um die Anlage herunterzuladen.

   _adm.download(bodyParts, null, this);

5. Setzen Sie die DownloadProgressListener-Rückrufmethoden außer Kraft, um aktuelle Informationen über den Status des Herunterladens der Anlage bereitzustellen.

   private void downloadCancelled(String msg)
   {
      BodyPart bodyPart = (BodyPart) element;
      _screen.displayProgress("Failed to download " + _adm.getFileName(bodyPart));
   }
   private void downloadCompleted(Object element)
   {
      BodyPart bodyPart = (BodyPart) element;
      _screen.displayProgress(_adm.getFileName(bodyPart) + " downloaded.");
   }
   public void updateProgress(Object element, int current, int total)
   {
   }