Package com.wowza.wms.http
Interface IHTTPRequest
public interface IHTTPRequest
-
Field Summary
Fields -
Method Summary
Modifier and TypeMethodDescriptionint
Get the content length of the body of the messageGet the request content typegetForwardedIP
(String excludeAddresses) Get X-[real-forwarded] addressGet a HTTP header value such as 'Content-Length'byte[]
Returns the header as bytesGet a copy of the HTTP request header mapGet a Set of the header namesgetHost()
Returns the domain name and possibly the port of the server for which the HTTP Request is being sent to, for both HTTP 1.1 and HTTP 2.0Get the body of the message as an input streamint
getIntHeader
(String name) Get a HTTP header value such as 'Content-Length' and return as intGet locale of request (Example: en-us)Get the method invokation method: GET, POST, HEADbyte[]
Return the message bytesgetParameter
(String name) Get a parameter valueGet the entire parameter MapGet a Set of parameter namesString[]
getParameterValues
(String name) Get a multi-value parameter as an array of StringgetPath()
Returns the HTTP path element of the requestGet the request protocol (example: HTTP/1.1)Get the query string part of the url (everything after the ?)Get the remote ip address of the requestGet the remote host name (if known) if not return ip addressGet the full request URIGet the request url (same as URI minus the query string)Get the request scheme (Example "http")Get the name of the server (Example: "Wowza Streaming Engine")int
Get the port this request was received onboolean
Returns true if the request is a HEAD requestboolean
isSecure()
Returns true is the request is protected by SSLboolean
Returns true if upgrade request (WebSocket,...)void
If the body of the message contains parameter data (data in name value pairs separated by & character) call this routine to decode those parameters and add them to the parameter map.void
parseBodyForParams
(boolean doDecode) If the body of the message contains parameter data (data in name value pairs separated by & character) call this routine to decode those parameters and add them to the parameter map.
-
Field Details
-
HTTP_HEADER_X_REAL_IP
- See Also:
-
HTTP_HEADER_X_FORWARDED_FOR
- See Also:
-
PROPERTY_X_FORWARDED_LIST
- See Also:
-
-
Method Details
-
getHeaderMap
Get a copy of the HTTP request header map- Returns:
- copy of the HTTP request header map
-
getHeader
Get a HTTP header value such as 'Content-Length'- Parameters:
name
- header name- Returns:
- header value
-
getIntHeader
Get a HTTP header value such as 'Content-Length' and return as int- Parameters:
name
- header name- Returns:
- header value
-
getHeaderNames
Get a Set of the header names- Returns:
- Set of header names
-
getMethod
String getMethod()Get the method invokation method: GET, POST, HEAD- Returns:
- method
-
getQueryString
String getQueryString()Get the query string part of the url (everything after the ?)- Returns:
- query string
-
getContentLength
int getContentLength()Get the content length of the body of the message- Returns:
- content length of the body of the message
-
getRequestURI
String getRequestURI()Get the full request URI- Returns:
- full request URI
-
getRequestURL
String getRequestURL()Get the request url (same as URI minus the query string)- Returns:
- request url
-
getContentType
String getContentType()Get the request content type- Returns:
- request content type
-
parseBodyForParams
void parseBodyForParams(boolean doDecode) If the body of the message contains parameter data (data in name value pairs separated by & character) call this routine to decode those parameters and add them to the parameter map.- Parameters:
doDecode
- true to decode the params as though they are url params
-
parseBodyForParams
void parseBodyForParams()If the body of the message contains parameter data (data in name value pairs separated by & character) call this routine to decode those parameters and add them to the parameter map. -
getParameter
Get a parameter value- Parameters:
name
- parameter name- Returns:
- parameter value
-
getParameterNames
Get a Set of parameter names- Returns:
- Set of parameter names
-
getParameterValues
Get a multi-value parameter as an array of String- Parameters:
name
- parameter name- Returns:
- multi-value parameter as an array of String
-
getParameterMap
Get the entire parameter Map- Returns:
- parameter Map
-
getInputStream
InputStream getInputStream()Get the body of the message as an input stream- Returns:
- body of the message as an input stream
-
getProtocol
String getProtocol()Get the request protocol (example: HTTP/1.1)- Returns:
- request protocol
-
getScheme
String getScheme()Get the request scheme (Example "http")- Returns:
- request scheme
-
getServerName
String getServerName()Get the name of the server (Example: "Wowza Streaming Engine")- Returns:
- name of the server
-
getServerPort
int getServerPort()Get the port this request was received on- Returns:
- the port this request was received on
-
getRemoteAddr
String getRemoteAddr()Get the remote ip address of the request- Returns:
- remote ip address of the request
-
getForwardedIP
Get X-[real-forwarded] address -
getRemoteHost
String getRemoteHost()Get the remote host name (if known) if not return ip address- Returns:
- remote host name
-
getLocale
Locale getLocale()Get locale of request (Example: en-us)- Returns:
- locale of request
-
isSecure
boolean isSecure()Returns true is the request is protected by SSL- Returns:
- true is the request is protected by SSL
-
getPath
String getPath()Returns the HTTP path element of the request- Returns:
- HTTP path element of the request
-
getHeaderBytes
byte[] getHeaderBytes()Returns the header as bytes- Returns:
- header as bytes
-
getMsgBytes
byte[] getMsgBytes()Return the message bytes- Returns:
- message bytes
-
isHeadRequest
boolean isHeadRequest()Returns true if the request is a HEAD request- Returns:
- true if the request is a HEAD request
-
isUpgradeRequest
boolean isUpgradeRequest()Returns true if upgrade request (WebSocket,...)- Returns:
- Returns true if upgrade request
-
getHost
String getHost()Returns the domain name and possibly the port of the server for which the HTTP Request is being sent to, for both HTTP 1.1 and HTTP 2.0- Returns:
- the domain name, to possibly include the port for the service requested ( if it is non-standard ), or an empty string if it is not defined
-