com.frostwire.jlibtorrent.alerts.StateUpdateAlert Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of jlibtorrent Show documentation

A swig Java interface for libtorrent by the makers of FrostWire.

There is a newer version: 1.2.0.18

package com.frostwire.jlibtorrent.alerts;

import com.frostwire.jlibtorrent.TorrentStatus;
import com.frostwire.jlibtorrent.swig.state_update_alert;
import com.frostwire.jlibtorrent.swig.torrent_status_vector;

import java.util.ArrayList;
import java.util.List;

/**
 * This alert is only posted when requested by the user, by calling session::post_torrent_updates()
 * on the session. It contains the torrent status of all torrents that changed
 * since last time this message was posted. Its category is ``status_notification``, but
 * it's not subject to filtering, since it's only manually posted anyway.
 *
 * @author gubatron
 * @author aldenml
 */
public final class StateUpdateAlert extends AbstractAlert {

    public StateUpdateAlert(state_update_alert alert) {
        super(alert);
    }

    /**
     * contains the torrent status of all torrents that changed since last time
     * this message was posted. Note that you can map a torrent status to a specific torrent
     * via its ``handle`` member. The receiving end is suggested to have all torrents sorted
     * by the torrent_handle or hashed by it, for efficient updates.
     *
     * @return
     */
    public List getStatus() {
        torrent_status_vector v = alert.getStatus();
        int size = (int) v.size();

        List l = new ArrayList(size);
        for (int i = 0; i < size; i++) {
            l.add(new TorrentStatus(v.get(i)));
        }

        return l;
    }
}