Download automatico degli allegati

Quando l'applicazione Messaggi del dispositivo BlackBerry riceve un messaggio con un allegato, è possibile scaricare automaticamente l'allegato e memorizzarlo sul dispositivo BlackBerry.

Prima di scaricare gli allegati, la classe AttachmentDownloadManager convalida l'allegato. AttachmentDownloadManager genera eccezioni se si verifica una qualsiasi delle seguenti condizioni.

  • L'applicazione tenta di richiamare il download mentre questo è già in corso.
  • L'applicazione tenta di scaricare file di dimensioni pari a zero.
  • La dimensione dell'allegato è superiore a quanto consentito dal criterio IT dell'applicazione o dai dati di configurazione.
  • Gli allegati sono crittografati.
  • Non è disponibile spazio a sufficienza sul dispositivo BlackBerry o sulla scheda SD.

Il metodo AttachmentDownloadManager.download() esegue la verifica durante il processo di download. Se vengono rilevati errori di verifica, il metodo restituisce un'eccezione. Per un elenco dei possibili errori di verifica, vedere la documentazione di riferimento sulle API di BlackBerry Java Development Environment.

Nota: BlackBerry Attachment Service riceve inizialmente tutti gli allegati. Gli handler degli allegati di terzi non possono cambiare questo comportamento predefinito. Per ulteriori informazioni su BlackBerry Attachment Service, consultare la Guida all'amministrazione di BlackBerry Enterprise Server.
  1. Importare le classi e le interfacce richieste.
    import java.io.IOException;
    import net.rim.blackberry.api.mail.*;
    
  2. Implementare l'interfaccia DownloadProgressListener. Creare un'istanza della classe AttachmentDownloadManager.
    public class AutoAttachTest implements DownloadProgressListener 
    {
       AttachmentDownloadManager _adm = new AttachmentDownloadManager();
  3. Utilizzare i metodi disponibili in AttachmentDownloadManager per determinare le informazioni sull'allegato.
    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. Richiamare AttachmentDownloadManager.download() per scaricare l'allegato.
    _adm.download(bodyParts, null, this);
  5. Sovrascrivere i metodi di callback DownloadProgressListener per fornire aggiornamenti sullo stato del download dell'allegato.
    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)
    {
    }
Argomento successivo: Calendario

Le informazioni sono state utili? Inviateci i vostri commenti.