com.thetransactioncompany.jsonrpc2.server
Class MessageContext

java.lang.Object
  com.thetransactioncompany.jsonrpc2.server.MessageContext

public class MessageContext
extends java.lang.Object

Context information about JSON-RPC 2.0 request and notification messages.

• The client's host name.
• The client's IP address.
• Whether the request / notification was transmitted securely (e.g. via HTTPS).
• The client principal(s) (user), if authenticated.

Version:

1.5 (2012-02-20)

Author:

Vladimir Dzhuvinov

Nested Class Summary

class

MessageContext.BasicPrincipal Minimal implementation of the Principal interface.

Constructor Summary

MessageContext(javax.servlet.http.HttpServletRequest httpRequest)
Creates a new JSON-RPC 2.0 request / notification context from the specified HTTP request.

MessageContext(java.lang.String clientHostName, java.lang.String clientInetAddress)
Creates a new JSON-RPC 2.0 request / notification context.

MessageContext(java.lang.String clientHostName, java.lang.String clientInetAddress, boolean secure)
Creates a new JSON-RPC 2.0 request / notification context.

MessageContext(java.lang.String clientHostName, java.lang.String clientInetAddress, boolean secure, java.lang.String principalName)
Creates a new JSON-RPC 2.0 request / notification context.

MessageContext(java.lang.String clientHostName, java.lang.String clientInetAddress, boolean secure, java.lang.String[] principalNames)
Creates a new JSON-RPC 2.0 request / notification context.

Method Summary

java.lang.String	getClientHostName() Gets the host name of the client that sent the request / notification.
java.lang.String	getClientInetAddress() Gets the IP address of the client that sent the request / notification.
java.security.Principal	getPrincipal() Returns the first authenticated client principal, null if none.
java.lang.String	getPrincipalName() Returns the first authenticated client principal name, null if none.
java.lang.String[]	getPrincipalNames() Returns the authenticated client principal names, null if none.
java.security.Principal[]	getPrincipals() Returns the authenticated client principals, null if none.
boolean	isSecure() Indicates whether the request / notification was received over a secure HTTPS connection.

Methods inherited from class java.lang.Object

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

Constructor Detail

MessageContext

public MessageContext(java.lang.String clientHostName,
                      java.lang.String clientInetAddress,
                      boolean secure,
                      java.lang.String principalName)

Creates a new JSON-RPC 2.0 request / notification context.

Parameters:

clientHostName - The client host name, null if unknown.

clientInetAddress - The client IP address, null if unknown.

secure - Specifies a request received over HTTPS.

principalName - Specifies the authenticated client principle name, null if unknown. The name must not be an empty or blank string.

MessageContext

public MessageContext(java.lang.String clientHostName,
                      java.lang.String clientInetAddress,
                      boolean secure,
                      java.lang.String[] principalNames)

Creates a new JSON-RPC 2.0 request / notification context.

Parameters:

clientHostName - The client host name, null if unknown.

clientInetAddress - The client IP address, null if unknown.

secure - Specifies a request received over HTTPS.

principalNames - Specifies the authenticated client principle names, null if unknown. The names must not be an empty or blank string.

MessageContext

public MessageContext(java.lang.String clientHostName,
                      java.lang.String clientInetAddress,
                      boolean secure)

Creates a new JSON-RPC 2.0 request / notification context. No authenticated client principal is specified.

Parameters:

clientHostName - The client host name, null if unknown.

clientInetAddress - The client IP address, null if unknown.

secure - Specifies a request received over HTTPS.

MessageContext

public MessageContext(java.lang.String clientHostName,
                      java.lang.String clientInetAddress)

Creates a new JSON-RPC 2.0 request / notification context. Indicates an insecure transport (plain HTTP) and no authenticated client principal.

Parameters:

clientHostName - The client host name, null if unknown.

clientInetAddress - The client IP address, null if unknown.

MessageContext

public MessageContext(javax.servlet.http.HttpServletRequest httpRequest)

Creates a new JSON-RPC 2.0 request / notification context from the specified HTTP request.

Parameters:

httpRequest - The HTTP request.

Method Detail

getClientHostName

public java.lang.String getClientHostName()

Gets the host name of the client that sent the request / notification.

Returns:

The client host name, null if unknown.

getClientInetAddress

public java.lang.String getClientInetAddress()

Gets the IP address of the client that sent the request / notification.

Returns:

The client IP address, null if unknown.

isSecure

public boolean isSecure()

Indicates whether the request / notification was received over a secure HTTPS connection.

Returns:

true If the request was received over HTTPS, false if it was received over plain HTTP.

getPrincipal

public java.security.Principal getPrincipal()

Returns the first authenticated client principal, null if none.

Returns:

The first client principal, null if none.

getPrincipals

public java.security.Principal[] getPrincipals()

Returns the authenticated client principals, null if none.

Returns:

The client principals, null if none.

getPrincipalName

public java.lang.String getPrincipalName()

Returns the first authenticated client principal name, null if none.

Returns:

The frist client principal name, null if none.

getPrincipalNames

public java.lang.String[] getPrincipalNames()

Returns the authenticated client principal names, null if none.

Returns:

The client principal names, null if none.