/**
   * Retrieves an album from the provider, and put it in the cache
   *
   * @param ref The reference to the album
   * @param provider The provider from which retrieve the album
   * @return The album, or null if the provider says so
   */
  public Album retrieveAlbum(final String ref, final ProviderIdentifier provider) {
    if (ref == null) {
      // Force get stack trace
      try {
        throw new RuntimeException();
      } catch (RuntimeException e) {
        Log.e(TAG, "retrieveAlbum called with a null reference", e);
      }
      return null;
    }

    // Try from cache
    Album output = mCache.getAlbum(ref);

    if (output == null && provider != null) {
      ProviderConnection pc = PluginsLookup.getDefault().getProvider(provider);
      if (pc != null) {
        IMusicProvider binder = pc.getBinder();

        if (binder != null) {
          try {
            output = binder.getAlbum(ref);
            onAlbumUpdate(provider, output);
          } catch (DeadObjectException e) {
            Log.e(TAG, "Provider died while retrieving album");
          } catch (RemoteException e) {
            Log.e(TAG, "Unable to retrieve the album", e);
          }
        }
      }
    }

    return output;
  }
  /** Called by the providers when the details of a song have been updated. */
  @Override
  public void onSongUpdate(ProviderIdentifier provider, final Song s) throws RemoteException {
    if (s == null) {
      Log.w(TAG, "Provider " + provider.mName + " sent in a null songUpdate");
      return;
    }

    try {
      Song cached = mCache.getSong(s.getRef());
      boolean wasLoaded = false;
      boolean changed = false;

      if (cached == null) {
        mCache.putSong(provider, s);
        changed = true;
        cached = s;
      } else {
        wasLoaded = cached.isLoaded();
        if (s.isLoaded() && !cached.isIdentical(s)) {
          cached.setAlbum(s.getAlbum());
          cached.setArtist(s.getArtist());
          cached.setSourceLogo(s.getLogo());
          cached.setDuration(s.getDuration());
          cached.setTitle(s.getTitle());
          cached.setYear(s.getYear());
          cached.setOfflineStatus(s.getOfflineStatus());
          cached.setAvailable(s.isAvailable());
          cached.setIsLoaded(s.isLoaded());
          changed = true;
        }
      }

      if (!wasLoaded && cached.isLoaded()) {
        // Match the album with the artist
        Artist artist = mCache.getArtist(s.getArtist());
        if (artist == null && s.getArtist() != null) {
          artist = retrieveArtist(s.getArtist(), provider);
        }

        if (artist != null) {
          Album album = mCache.getAlbum(s.getAlbum());
          if (album == null && s.getAlbum() != null) {
            album = retrieveAlbum(s.getAlbum(), provider);
          }

          if (album != null) {
            artist.addAlbum(album.getRef());
          }
        }
      }

      if (changed) {
        postSongForUpdate(cached);
      }
    } catch (Exception e) {
      Log.e(TAG, "Exception while updating song data", e);
    }
  }
  /** Called by the providers when the details of an album have been updated. */
  @Override
  public void onAlbumUpdate(ProviderIdentifier provider, final Album a) throws RemoteException {
    if (a == null) {
      Log.w(TAG, "Provider returned a null album");
      return;
    }

    Album cached = mCache.getAlbum(a.getRef());
    boolean modified = false;

    // See IProviderCallback.aidl in providerlib for more info about the logic of updating
    // the Album objects
    if (cached == null) {
      mCache.putAlbum(provider, a);
      cached = a;
      modified = true;
    } else if (!cached.isLoaded() || !cached.isIdentical(a)) {
      cached.setName(a.getName());
      cached.setYear(a.getYear());
      cached.setIsLoaded(a.isLoaded());
      cached.setProvider(a.getProvider());

      if (cached.getSongsCount() != a.getSongsCount()) {
        Iterator<String> songsIt = a.songs();
        while (songsIt.hasNext()) {
          String songRef = songsIt.next();
          cached.addSong(songRef);
        }
      }

      modified = true;
    }

    if (cached.getProvider() == null) {
      Log.e(TAG, "Provider for " + cached.getRef() + " is null!");
    }

    if (modified) {
      // Add the album to each artist of the song (once)
      Iterator<String> songs = a.songs();

      while (songs.hasNext()) {
        String songRef = songs.next();
        Song song = retrieveSong(songRef, a.getProvider());

        if (song != null && song.isLoaded()) {
          String artistRef = song.getArtist();
          if (artistRef != null) {
            Artist artist = retrieveArtist(artistRef, song.getProvider());

            if (artist != null) {
              artist.addAlbum(a.getRef());
            } else {
              if (DEBUG) Log.e(TAG, "Artist is null!");
            }
          }
        } else {
          if (DEBUG) Log.e(TAG, "Song is null!");
        }
      }

      postAlbumForUpdate(cached);
    }
  }