bt.tracker.http.urlencoding

Class BinaryQueryNamedValue

java.lang.Object

bt.tracker.http.urlencoding.BinaryQueryNamedValue

public class BinaryQueryNamedValue
extends Object

A class that represents a parameter in the query string, along with it's decoded value. This class exists because the tracker protocol requires encoding/decoding binary fields out of the query string, that are not part of any Charset

Constructor Summary

Constructors

Constructor and Description
BinaryQueryNamedValue(String name, byte[] value) Create a new named value that is in a query string
BinaryQueryNamedValue(String name, long value) Create a new named value that is in a query string.
BinaryQueryNamedValue(String name, String value) Create a new named value that is in a query string.
BinaryQueryNamedValue(String name, String value, Charset wireEncoding) Create a new named value that is in a query string

Method Summary

Modifier and Type	Method and Description
String	getName() Get the name of this named value
String	getUrlEncodedValue()
byte[]	getValue() Get the value of this named value
String	getValue(Charset charset) Get the value of this named value as a String decoded from the specified charset
long	getValueAsLong() Get the value of this named value as a long
String	getValueAsUtf8Str() Get the value of this named value as a String decoded from UTF-8

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

BinaryQueryNamedValue

public BinaryQueryNamedValue(String name,
                             byte[] value)

Create a new named value that is in a query string

Parameters:

name - the name of the value

value - the value

BinaryQueryNamedValue

public BinaryQueryNamedValue(String name,
                             String value)

Create a new named value that is in a query string. Will be sent as UTF-8.

Parameters:

name - the name of the value

value - the value

BinaryQueryNamedValue

public BinaryQueryNamedValue(String name,
                             String value,
                             Charset wireEncoding)

Create a new named value that is in a query string

Parameters:

name - the name of the value

value - the value

wireEncoding - the charset to encode the value with when sent in a urlrequest

BinaryQueryNamedValue

public BinaryQueryNamedValue(String name,
                             long value)

Create a new named value that is in a query string. Will be sent as UTF-8.

Parameters:

name - the name of the value

value - the value

Method Detail

getName

public String getName()

Get the name of this named value

Returns:

the name of this named value

getValue

public byte[] getValue()

Get the value of this named value

Returns:

the value of this named value

getValueAsUtf8Str

public String getValueAsUtf8Str()

Get the value of this named value as a String decoded from UTF-8

Returns:

the value of this named value as a String decoded from UTF-8

getValue

public String getValue(Charset charset)

Get the value of this named value as a String decoded from the specified charset

Returns:

the value of this named value as a String decoded from the specified charset

getValueAsLong

public long getValueAsLong()

Get the value of this named value as a long

Returns:

the value of this named value as a long

Throws:

IllegalArgumentException - if this string isn't a long

getUrlEncodedValue

public String getUrlEncodedValue()