MetaInfo (I2P Anonymous Network - Java Documentation

java.lang.Object
- org.klomp.snark.MetaInfo

```
public class MetaInfo
extends java.lang.Object
```
Note: this class is buggy, as it doesn't propogate custom meta fields into the bencoded info data, and from there to the info_hash. At the moment, though, it seems to work with torrents created by I2P-BT, I2PRufus and Azureus.

コンストラクタの概要

コンストラクタ
コンストラクタ	説明
`MetaInfo(java.io.InputStream in)`	Creates a new MetaInfo from the given InputStream.
`MetaInfo(java.lang.String announce, java.lang.String name, java.lang.String name_utf8, java.util.List<java.util.List<java.lang.String>> files, java.util.List<java.lang.Long> lengths, int piece_length, byte[] piece_hashes, long length, boolean privateTorrent, java.util.List<java.util.List<java.lang.String>> announce_list, java.lang.String created_by)`	Called by Storage when creating a new torrent from local data
`MetaInfo(java.util.Map<java.lang.String,BEValue> m)`	Creates a new MetaInfo from a Map of BEValues and the SHA1 over the original bencoded info dictonary (this is a hack, we could reconstruct the bencoded stream and recalculate the hash).

メソッドの概要

すべてのメソッド staticメソッドインスタンス・メソッド concreteメソッド
修飾子とタイプ	メソッド	説明
`boolean`	`checkPiece(int piece, byte[] bs, int off, int length)`	Checks that the given piece has the same SHA1 hash as the given byte array.
`(package private) boolean`	`checkPiece(PartialPiece pp)`
`java.lang.String`	`getAnnounce()`	Returns the string representing the URL of the tracker for this torrent.
`java.util.List<java.util.List<java.lang.String>>`	`getAnnounceList()`	Returns a list of lists of urls.
`java.lang.String`	`getComment()`	The comment string or null.
`java.lang.String`	`getCreatedBy()`	The created-by string or null.
`long`	`getCreationDate()`	The creation date (ms) or zero.
`java.util.List<java.util.List<java.lang.String>>`	`getFiles()`	Returns a list of lists of file name hierarchies or null if it is a single name.
`byte[]`	`getInfoBytes()`
`byte[]`	`getInfoHash()`	Returns the original 20 byte SHA1 hash over the bencoded info map.
`java.util.List<java.lang.Long>`	`getLengths()`	Returns a list of Longs indication the size of the individual files, or null if it is a single file.
`java.lang.String`	`getName()`	Returns the requested name for the file or toplevel directory.
`static java.lang.String`	`getNameAndInfoHash(java.io.InputStream in, byte[] infoHashOut)`	Efficiently returns the name and the 20 byte SHA1 hash of the info dictionary in a torrent file Caller must close stream.
`(package private) byte[]`	`getPieceHashes()`	Returns the piece hashes.
`int`	`getPieceLength(int piece)`	Return the length of a piece.
`int`	`getPieces()`	Returns the number of pieces.
`byte[]`	`getTorrentData()`	Called by servlet to save a new torrent file generated from local data
`long`	`getTotalLength()`	Returns the total length of the torrent in bytes.
`boolean`	`isPrivate()`	Is it a private torrent?
`static void`	`main(java.lang.String[] args)`
`MetaInfo`	`reannounce(java.lang.String announce)`	Creates a copy of this MetaInfo that shares everything except the announce URL.
`java.lang.String`	`toString()`

クラスから継承されたメソッド java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- コンストラクタの詳細
  - MetaInfo
```
MetaInfo(java.lang.String announce,
         java.lang.String name,
         java.lang.String name_utf8,
         java.util.List<java.util.List<java.lang.String>> files,
         java.util.List<java.lang.Long> lengths,
         int piece_length,
         byte[] piece_hashes,
         long length,
         boolean privateTorrent,
         java.util.List<java.util.List<java.lang.String>> announce_list,
         java.lang.String created_by)
```
    Called by Storage when creating a new torrent from local data
    
    パラメータ:
    
    announce - may be null
    
    files - null for single-file torrent
    
    lengths - null for single-file torrent
    
    announce_list - may be null
    
    created_by - may be null
  - MetaInfo
```
public MetaInfo(java.io.InputStream in)
         throws java.io.IOException
```
    Creates a new MetaInfo from the given InputStream. The InputStream must start with a correctly bencoded dictonary describing the torrent. Caller must close the stream.
    
    例外:
    
    java.io.IOException
  - MetaInfo
```
public MetaInfo(java.util.Map<java.lang.String,BEValue> m)
         throws InvalidBEncodingException
```
    Creates a new MetaInfo from a Map of BEValues and the SHA1 over the original bencoded info dictonary (this is a hack, we could reconstruct the bencoded stream and recalculate the hash). Will NOT throw a InvalidBEncodingException if the given map does not contain a valid announce string. WILL throw a InvalidBEncodingException if the given map does not contain a valid info dictionary.
    
    例外:
    
    InvalidBEncodingException
- メソッドの詳細
  - getNameAndInfoHash
```
public static java.lang.String getNameAndInfoHash(java.io.InputStream in,
                                                  byte[] infoHashOut)
                                           throws java.io.IOException
```
    Efficiently returns the name and the 20 byte SHA1 hash of the info dictionary in a torrent file Caller must close stream.
    
    パラメータ:
    
    infoHashOut - 20-byte out parameter
    
    例外:
    
    java.io.IOException
    
    導入されたバージョン:
    
    0.8.5
  - getAnnounce
```
public java.lang.String getAnnounce()
```
    Returns the string representing the URL of the tracker for this torrent.
    
    戻り値:
    
    may be null!
  - getAnnounceList
```
public java.util.List<java.util.List<java.lang.String>> getAnnounceList()
```
    Returns a list of lists of urls.
    
    導入されたバージョン:
    
    0.9.5
  - getInfoHash
```
public byte[] getInfoHash()
```
    Returns the original 20 byte SHA1 hash over the bencoded info map.
  - getPieceHashes
```
byte[] getPieceHashes()
```
    Returns the piece hashes. Only used by storage so package local.
  - getName
```
public java.lang.String getName()
```
    Returns the requested name for the file or toplevel directory. If it is a toplevel directory name getFiles() will return a non-null List of file name hierarchy name.
  - isPrivate
```
public boolean isPrivate()
```
    Is it a private torrent?
    
    導入されたバージョン:
    
    0.9
  - getFiles
```
public java.util.List<java.util.List<java.lang.String>> getFiles()
```
    Returns a list of lists of file name hierarchies or null if it is a single name. It has the same size as the list returned by getLengths().
  - getLengths
```
public java.util.List<java.lang.Long> getLengths()
```
    Returns a list of Longs indication the size of the individual files, or null if it is a single file. It has the same size as the list returned by getFiles().
  - getComment
```
public java.lang.String getComment()
```
    The comment string or null. Not available for locally-created torrents.
    
    導入されたバージョン:
    
    0.9.7
  - getCreatedBy
```
public java.lang.String getCreatedBy()
```
    The created-by string or null. Not available for locally-created torrents.
    
    導入されたバージョン:
    
    0.9.7
  - getCreationDate
```
public long getCreationDate()
```
    The creation date (ms) or zero. As of 0.9.19, available for locally-created torrents.
    
    導入されたバージョン:
    
    0.9.7
  - getPieces
```
public int getPieces()
```
    Returns the number of pieces.
  - getPieceLength
```
public int getPieceLength(int piece)
```
    Return the length of a piece. All pieces are of equal length except for the last one (getPieces()-1).
    
    例外:
    
    java.lang.IndexOutOfBoundsException - when piece is equal to or greater then the number of pieces in the torrent.
  - checkPiece
```
public boolean checkPiece(int piece,
                          byte[] bs,
                          int off,
                          int length)
```
    Checks that the given piece has the same SHA1 hash as the given byte array. Returns random results or IndexOutOfBoundsExceptions when the piece number is unknown.
  - checkPiece
```
boolean checkPiece(PartialPiece pp)
```
    戻り値:
    
    good
    
    導入されたバージョン:
    
    0.9.1
  - getTotalLength
```
public long getTotalLength()
```
    Returns the total length of the torrent in bytes.
  - toString
```
public java.lang.String toString()
```
    オーバーライド:
    
    toString クラス内 java.lang.Object
  - reannounce
```
public MetaInfo reannounce(java.lang.String announce)
                    throws InvalidBEncodingException
```
    Creates a copy of this MetaInfo that shares everything except the announce URL. Drops any announce-list. Preserves infohash and info map, including any non-standard fields.
    
    パラメータ:
    
    announce - may be null
    
    例外:
    
    InvalidBEncodingException
  - getTorrentData
```
public byte[] getTorrentData()
```
    Called by servlet to save a new torrent file generated from local data
  - getInfoBytes
```
public byte[] getInfoBytes()
```
    導入されたバージョン:
    
    0.8.4
  - main
```
public static void main(java.lang.String[] args)
```
    導入されたバージョン:
    
    0.8.5

クラス MetaInfo

コンストラクタの概要

メソッドの概要

クラスから継承されたメソッド java.lang.Object

コンストラクタの詳細

MetaInfo

MetaInfo

MetaInfo

メソッドの詳細

getNameAndInfoHash

getAnnounce

getAnnounceList

getInfoHash

getPieceHashes

getName

isPrivate

getFiles

getLengths

getComment

getCreatedBy

getCreationDate

getPieces

getPieceLength

checkPiece

checkPiece

getTotalLength

toString

reannounce

getTorrentData

getInfoBytes

main