Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

Difference between revisions of "ECF BitTorrent Provider"

(Plug-in Usage: Adding 'LATER' use cases)
(Plug-in Usage: Adding code for the use cases)
Line 51: Line 51:
 
This section will describe how a developer would create a client using the BitTorrent plug-in.
 
This section will describe how a developer would create a client using the BitTorrent plug-in.
  
'''Use Cases'''
+
===Use Cases===
 
# - downloads a single file from a torrent until completion
 
# - downloads a single file from a torrent until completion
 
# - begin downloading a single file from a torrent and stop the download after a period of time
 
# - begin downloading a single file from a torrent and stop the download after a period of time
Line 64: Line 64:
 
# - '''LATER''' begin downloading a file from a torrent and cap the download/upload speeds
 
# - '''LATER''' begin downloading a file from a torrent and cap the download/upload speeds
 
# - '''LATER''' start a download from a torrent and alter the number of connections that can be made
 
# - '''LATER''' start a download from a torrent and alter the number of connections that can be made
 +
 +
 +
===Use Case 1===
 +
 +
try {
 +
    Torrent torrent = new Torrent("eclipse-sdk.torrent");
 +
    Host host = new Host(torrent);
 +
    host.connect();
 +
} catch (IOException e) {
 +
    e.printStackTrace();
 +
}
 +
 +
===Use Case 2===
 +
 +
try {
 +
    Torrent torrent = new Torrent("eclipse-sdk.torrent");
 +
    Host host = new Host(torrent);
 +
    host.connect();
 +
    // after some amount of time has passed
 +
    host.stop();
 +
} catch (IOException e) {
 +
    e.printStackTrace();
 +
}
 +
 +
===Use Case 2.1===
 +
 +
try {
 +
    Torrent torrent = new Torrent("eclipse-sdk.torrent");
 +
    Host host = new Host(torrent);
 +
    host.connect();
 +
    // after some amount of time has passed
 +
    host.stop();
 +
    // more time passes
 +
    host.resume();
 +
} catch (IOException e) {
 +
    e.printStackTrace();
 +
}
  
 
==External Links==
 
==External Links==

Revision as of 19:54, 7 June 2006

Project Lead: Remy Chi Jian Suen

Mentor(s): Wayne Beaton, Scott Lewis, and Chris Aniszczyk

The goal if this project is to create an implementation of the file sharing API provided by the Eclipse Communication Framework using the BitTorrent protocol.

BitTorrent Plug-in Data Model

The package name org.eclipse.bittorrent may be altered when the plug-in is released.

Text in red denotes that the code has not been written yet.

org.eclipse.bittorrent

Host - reads in a Torrent connects to peers to begin seeding or downloading

  • contains exactly one Torrent
  • contains one or more DataFiles
  • contains one or more Pieces

Torrent - a representation of the metainfo stored within a .torrent file


org.eclipse.bittorrent.internal.torrent

DataFile - a representation of a file on the user's system for read/write operations

  • contains one or more Pieces

Piece - a piece of data that is needed to complete a download

  • contains one or more DataFiles


org.eclipse.bittorrent.internal.net

ConnectionPool - a thread pool that manages ConnectionThreads

  • contains exactly one Host
  • contains one or more ConnectionThreads

ConnectionThread - creates a PeerConnection to talk to a peer

  • contains exactly one PeerConnection

PeerConnection - connects to a peer and exchanges information

  • exactly one Host


org.eclipse.bittorrent.internal.encode

BEncodedDictionary - holds the key-value pairs stored within a bencoded string.

Decode - decodes information such as the contents of a torrent file

Encode - converts or alters information for use


Plug-in Usage

This section will describe how a developer would create a client using the BitTorrent plug-in.

Use Cases

  1. - downloads a single file from a torrent until completion
  2. - begin downloading a single file from a torrent and stop the download after a period of time
    1. - resume the download
    2. - cancel the download and delete the downloaded files
  3. - start two downloads from two torrents until completion
  4. - begin two downloads from two torrent and then stop the second one after a period of time
    1. - resume the second download after the first has completed
    2. - cancel the first download and start the second download
  5. - begin downloading from a torrent and monitor its progress with a listener
  6. - LATER start downloading multiple files from a torrent and select which files should be downloaded
  7. - LATER begin downloading a file from a torrent and cap the download/upload speeds
  8. - LATER start a download from a torrent and alter the number of connections that can be made


Use Case 1

try {
    Torrent torrent = new Torrent("eclipse-sdk.torrent");
    Host host = new Host(torrent);
    host.connect();
} catch (IOException e) {
    e.printStackTrace();
}

Use Case 2

try {
    Torrent torrent = new Torrent("eclipse-sdk.torrent");
    Host host = new Host(torrent);
    host.connect();
    // after some amount of time has passed
    host.stop();
} catch (IOException e) {
    e.printStackTrace();
}

Use Case 2.1

try {
    Torrent torrent = new Torrent("eclipse-sdk.torrent");
    Host host = new Host(torrent);
    host.connect();
    // after some amount of time has passed
    host.stop();
    // more time passes
    host.resume();
} catch (IOException e) {
    e.printStackTrace();
}

External Links

Eclipse Communication Framework Website

BitTorrent Specification

Back to the top