HTTP (Javadocs [I2P+ 2.13.0+] - API Version 0.9.70+)

java.lang.Object
- org.cybergarage.http.HTTP

```
public class HTTP
extends Object
```
Utility class providing HTTP protocol constants and helper methods.
This class contains commonly used HTTP protocol constants including:
- HTTP methods (GET, POST, HEAD, etc.)
- HTTP headers (Content-Type, Host, etc.)
- HTTP status codes and versions
- UPnP-specific constants
Also provides utility methods for URL manipulation and validation.
Version:
1.0

Field Summary

Fields
Modifier and Type	Field and Description
`static String`	`BOOTID_UPNP_ORG` BOOTID.UPNP.ORG header for UPnP device boot ID
`static String`	`CACHE_CONTROL` Cache-Control HTTP header field name
`static String`	`CALLBACK` CALLBACK header for UPnP event subscription
`static String`	`CHARSET` Charset parameter name within Content-Type
`static String`	`CHUNKED` Chunked transfer encoding value
`static String`	`CLOSE` Connection close directive value
`static String`	`CONNECTION` Connection HTTP header field name
`static String`	`CONTENT_LANGUAGE` Content-Language HTTP header field name
`static String`	`CONTENT_LENGTH` Content-Length HTTP header field name
`static String`	`CONTENT_RANGE` Content-Range HTTP header field name
`static String`	`CONTENT_RANGE_BYTES` Bytes range unit value for Content-Range
`static String`	`CONTENT_TYPE` Content-Type HTTP header field name
`static byte`	`CR` Carriage return character
`static String`	`CRLF` HTTP line terminator (CR+LF)
`static String`	`DATE` Date HTTP header field name
`static int`	`DEFAULT_CHUNK_SIZE` Default chunk size in bytes (512KB)
`static int`	`DEFAULT_PORT` Default HTTP port
`static int`	`DEFAULT_TIMEOUT` Default timeout in seconds
`static String`	`EXT` EXT header confirming MAN was understood
`static String`	`GET` GET HTTP method
`static String`	`HEAD` HEAD HTTP method
`static String`	`HEADER_LINE_DELIM` Header line delimiter (colon-space between name and value)
`static String`	`HOST` Host HTTP header field name
`static String`	`KEEP_ALIVE` Keep-Alive HTTP header field name
`static byte`	`LF` Line feed character
`static String`	`LOCATION` Location HTTP header field name (used for redirects)
`static String`	`M_SEARCH` M-SEARCH HTTP method (used by UPnP discovery)
`static String`	`MAN` MAN (Mandatory Extension) header for UPnP discovery
`static String`	`MAX_AGE` Cache-Control max-age directive name
`static String`	`MX` MX (Maximum Wait) header for UPnP discovery
`static String`	`MYNAME` MYNAME header for UPnP device identification
`static String`	`NO_CACHE` Cache-Control no-cache directive value
`static String`	`NOTIFY` NOTIFY HTTP method (used by UPnP eventing)
`static String`	`NT` NT (Notification Type) header for UPnP eventing
`static String`	`NTS` NTS (Notification Sub Type) header for UPnP eventing
`static String`	`POST` POST HTTP method
`static String`	`RANGE` Range HTTP header field name
`static String`	`REQEST_LINE_DELIM` Request line delimiter (space between method, URI, version)
`static String`	`SEQ` SEQ (Sequence Number) header for UPnP eventing
`static String`	`SERVER` Server HTTP header field name
`static String`	`SID` SID (Session ID) header for UPnP eventing
`static String`	`SOAP_ACTION` SOAPAction HTTP header field name
`static String`	`ST` ST (Search Target) header for UPnP discovery
`static String`	`STATUS_LINE_DELIM` Status line delimiter (space between version, code, phrase)
`static String`	`SUBSCRIBE` SUBSCRIBE HTTP method (used by UPnP eventing)
`static String`	`TAB` Tab character
`static String`	`TIMEOUT` TIMEOUT header for UPnP event subscription
`static String`	`TRANSFER_ENCODING` Transfer-Encoding HTTP header field name
`static String`	`UNSUBSCRIBE` UNSUBSCRIBE HTTP method (used by UPnP eventing)
`static String`	`USN` USN (Unique Service Name) header for UPnP discovery
`static String`	`VERSION` Default HTTP version string
`static String`	`VERSION_10` HTTP/1.0 version string
`static String`	`VERSION_11` HTTP/1.1 version string

Constructor Summary
Constructors
Constructor and Description
HTTP()

Constructors
Constructor and Description
`HTTP()`

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static String`	`getAbsoluteURL(String baseURLStr, String relURlStr)` Creates an absolute URL by combining base URL with relative URL.
`static int`	`getChunkSize()` Gets the current default chunk size for HTTP operations.
`static String`	`getHost(String urlStr)` Extracts the host name from a URL string.
`static int`	`getPort(String urlStr)` Extracts the port number from a URL string.
`static String`	`getRequestHostURL(String host, int port)` Creates a request host URL from host and port.
`static boolean`	`isAbsoluteURL(String urlStr)` Checks if a string represents an absolute URL.
`static void`	`setChunkSize(int size)` Sets the default chunk size for HTTP operations.
`static String`	`toRelativeURL(String urlStr)` Converts a URL to a relative URL path with query parameters.
`static String`	`toRelativeURL(String urlStr, boolean withParam)` Converts a URL to a relative URL path.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - BOOTID_UPNP_ORG
```
public static final String BOOTID_UPNP_ORG
```
    BOOTID.UPNP.ORG header for UPnP device boot ID
    See Also:
    Constant Field Values
  - CACHE_CONTROL
```
public static final String CACHE_CONTROL
```
    Cache-Control HTTP header field name
    See Also:
    Constant Field Values
  - CALLBACK
```
public static final String CALLBACK
```
    CALLBACK header for UPnP event subscription
    See Also:
    Constant Field Values
  - CHARSET
```
public static final String CHARSET
```
    Charset parameter name within Content-Type
    See Also:
    Constant Field Values
  - CHUNKED
```
public static final String CHUNKED
```
    Chunked transfer encoding value
    See Also:
    Constant Field Values
  - CLOSE
```
public static final String CLOSE
```
    Connection close directive value
    See Also:
    Constant Field Values
  - CONNECTION
```
public static final String CONNECTION
```
    Connection HTTP header field name
    See Also:
    Constant Field Values
  - CONTENT_LANGUAGE
```
public static final String CONTENT_LANGUAGE
```
    Content-Language HTTP header field name
    See Also:
    Constant Field Values
  - CONTENT_LENGTH
```
public static final String CONTENT_LENGTH
```
    Content-Length HTTP header field name
    See Also:
    Constant Field Values
  - CONTENT_RANGE
```
public static final String CONTENT_RANGE
```
    Content-Range HTTP header field name
    See Also:
    Constant Field Values
  - CONTENT_RANGE_BYTES
```
public static final String CONTENT_RANGE_BYTES
```
    Bytes range unit value for Content-Range
    See Also:
    Constant Field Values
  - CONTENT_TYPE
```
public static final String CONTENT_TYPE
```
    Content-Type HTTP header field name
    See Also:
    Constant Field Values
  - CR
```
public static final byte CR
```
    Carriage return character
    See Also:
    Constant Field Values
  - CRLF
```
public static final String CRLF
```
    HTTP line terminator (CR+LF)
    See Also:
    Constant Field Values
  - DATE
```
public static final String DATE
```
    Date HTTP header field name
    See Also:
    Constant Field Values
  - DEFAULT_CHUNK_SIZE
```
public static final int DEFAULT_CHUNK_SIZE
```
    Default chunk size in bytes (512KB)
    See Also:
    Constant Field Values
  - DEFAULT_PORT
```
public static final int DEFAULT_PORT
```
    Default HTTP port
    See Also:
    Constant Field Values
  - DEFAULT_TIMEOUT
```
public static final int DEFAULT_TIMEOUT
```
    Default timeout in seconds
    See Also:
    Constant Field Values
  - EXT
```
public static final String EXT
```
    EXT header confirming MAN was understood
    See Also:
    Constant Field Values
  - GET
```
public static final String GET
```
    GET HTTP method
    See Also:
    Constant Field Values
  - HEAD
```
public static final String HEAD
```
    HEAD HTTP method
    See Also:
    Constant Field Values
  - HEADER_LINE_DELIM
```
public static final String HEADER_LINE_DELIM
```
    Header line delimiter (colon-space between name and value)
    See Also:
    Constant Field Values
  - HOST
```
public static final String HOST
```
    Host HTTP header field name
    See Also:
    Constant Field Values
  - KEEP_ALIVE
```
public static final String KEEP_ALIVE
```
    Keep-Alive HTTP header field name
    See Also:
    Constant Field Values
  - LF
```
public static final byte LF
```
    Line feed character
    See Also:
    Constant Field Values
  - LOCATION
```
public static final String LOCATION
```
    Location HTTP header field name (used for redirects)
    See Also:
    Constant Field Values
  - M_SEARCH
```
public static final String M_SEARCH
```
    M-SEARCH HTTP method (used by UPnP discovery)
    See Also:
    Constant Field Values
  - MAN
```
public static final String MAN
```
    MAN (Mandatory Extension) header for UPnP discovery
    See Also:
    Constant Field Values
  - MAX_AGE
```
public static final String MAX_AGE
```
    Cache-Control max-age directive name
    See Also:
    Constant Field Values
  - MX
```
public static final String MX
```
    MX (Maximum Wait) header for UPnP discovery
    See Also:
    Constant Field Values
  - MYNAME
```
public static final String MYNAME
```
    MYNAME header for UPnP device identification
    See Also:
    Constant Field Values
  - NO_CACHE
```
public static final String NO_CACHE
```
    Cache-Control no-cache directive value
    See Also:
    Constant Field Values
  - NOTIFY
```
public static final String NOTIFY
```
    NOTIFY HTTP method (used by UPnP eventing)
    See Also:
    Constant Field Values
  - NT
```
public static final String NT
```
    NT (Notification Type) header for UPnP eventing
    See Also:
    Constant Field Values
  - NTS
```
public static final String NTS
```
    NTS (Notification Sub Type) header for UPnP eventing
    See Also:
    Constant Field Values
  - POST
```
public static final String POST
```
    POST HTTP method
    See Also:
    Constant Field Values
  - RANGE
```
public static final String RANGE
```
    Range HTTP header field name
    See Also:
    Constant Field Values
  - REQEST_LINE_DELIM
```
public static final String REQEST_LINE_DELIM
```
    Request line delimiter (space between method, URI, version)
    See Also:
    Constant Field Values
  - SEQ
```
public static final String SEQ
```
    SEQ (Sequence Number) header for UPnP eventing
    See Also:
    Constant Field Values
  - SERVER
```
public static final String SERVER
```
    Server HTTP header field name
    See Also:
    Constant Field Values
  - SID
```
public static final String SID
```
    SID (Session ID) header for UPnP eventing
    See Also:
    Constant Field Values
  - SOAP_ACTION
```
public static final String SOAP_ACTION
```
    SOAPAction HTTP header field name
    See Also:
    Constant Field Values
  - ST
```
public static final String ST
```
    ST (Search Target) header for UPnP discovery
    See Also:
    Constant Field Values
  - STATUS_LINE_DELIM
```
public static final String STATUS_LINE_DELIM
```
    Status line delimiter (space between version, code, phrase)
    See Also:
    Constant Field Values
  - SUBSCRIBE
```
public static final String SUBSCRIBE
```
    SUBSCRIBE HTTP method (used by UPnP eventing)
    See Also:
    Constant Field Values
  - TAB
```
public static final String TAB
```
    Tab character
    See Also:
    Constant Field Values
  - TIMEOUT
```
public static final String TIMEOUT
```
    TIMEOUT header for UPnP event subscription
    See Also:
    Constant Field Values
  - TRANSFER_ENCODING
```
public static final String TRANSFER_ENCODING
```
    Transfer-Encoding HTTP header field name
    See Also:
    Constant Field Values
  - UNSUBSCRIBE
```
public static final String UNSUBSCRIBE
```
    UNSUBSCRIBE HTTP method (used by UPnP eventing)
    See Also:
    Constant Field Values
  - USN
```
public static final String USN
```
    USN (Unique Service Name) header for UPnP discovery
    See Also:
    Constant Field Values
  - VERSION
```
public static final String VERSION
```
    Default HTTP version string
    See Also:
    Constant Field Values
  - VERSION_10
```
public static final String VERSION_10
```
    HTTP/1.0 version string
    See Also:
    Constant Field Values
  - VERSION_11
```
public static final String VERSION_11
```
    HTTP/1.1 version string
    See Also:
    Constant Field Values
- Constructor Detail
  - HTTP
```
public HTTP()
```
- Method Detail
  - getAbsoluteURL
```
public static final String getAbsoluteURL(String baseURLStr,
                                          String relURlStr)
```
    Creates an absolute URL by combining base URL with relative URL.
    Parameters:
    baseURLStr - base URL string
    relURlStr - relative URL to combine with base
    Returns:
    absolute URL string, or empty string if combination fails
  - getChunkSize
```
public static final int getChunkSize()
```
    Gets the current default chunk size for HTTP operations.
    Returns:
    chunk size in bytes
  - getHost
```
public static final String getHost(String urlStr)
```
    Extracts the host name from a URL string.
    Parameters:
    urlStr - URL string to extract host from
    Returns:
    host name, or empty string if URL is invalid
  - getPort
```
public static final int getPort(String urlStr)
```
    Extracts the port number from a URL string. Returns default HTTP port (80) if no port is specified.
    Parameters:
    urlStr - URL string to extract port from
    Returns:
    port number, or default port (80) if URL is invalid or no port specified
  - getRequestHostURL
```
public static final String getRequestHostURL(String host,
                                             int port)
```
    Creates a request host URL from host and port.
    Parameters:
    host - host name or IP address
    port - port number
    Returns:
    URL string in format "http://host:port"
  - isAbsoluteURL
```
public static final boolean isAbsoluteURL(String urlStr)
```
    Checks if a string represents an absolute URL.
    Parameters:
    urlStr - string to check
    Returns:
    true if the string is a valid absolute URL, false otherwise
  - setChunkSize
```
public static final void setChunkSize(int size)
```
    Sets the default chunk size for HTTP operations.
    Parameters:
    size - chunk size in bytes
  - toRelativeURL
```
public static final String toRelativeURL(String urlStr)
```
    Converts a URL to a relative URL path with query parameters.
    Parameters:
    urlStr - URL string to convert
    Returns:
    relative URL path with query parameters
  - toRelativeURL
```
public static final String toRelativeURL(String urlStr,
                                         boolean withParam)
```
    Converts a URL to a relative URL path.
    Parameters:
    urlStr - URL string to convert
    withParam - whether to include query parameters in result
    Returns:
    relative URL path, optionally with query parameters

Class HTTP

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

BOOTID_UPNP_ORG

CACHE_CONTROL

CALLBACK

CHARSET

CHUNKED

CLOSE

CONNECTION

CONTENT_LANGUAGE

CONTENT_LENGTH

CONTENT_RANGE

CONTENT_RANGE_BYTES

CONTENT_TYPE

CR

CRLF

DATE

DEFAULT_CHUNK_SIZE

DEFAULT_PORT

DEFAULT_TIMEOUT

EXT

GET

HEAD

HEADER_LINE_DELIM

HOST

KEEP_ALIVE

LF

LOCATION

M_SEARCH

MAN

MAX_AGE

MX

MYNAME

NO_CACHE

NOTIFY

NT

NTS

POST

RANGE

REQEST_LINE_DELIM

SEQ

SERVER

SID

SOAP_ACTION

ST

STATUS_LINE_DELIM

SUBSCRIBE

TAB

TIMEOUT

TRANSFER_ENCODING

UNSUBSCRIBE

USN

VERSION

VERSION_10

VERSION_11

Constructor Detail

HTTP

Method Detail

getAbsoluteURL

getChunkSize

getHost

getPort

getRequestHostURL

isAbsoluteURL

setChunkSize

toRelativeURL

toRelativeURL