org.jolokia.jvmagent.handler

Class JolokiaHttpHandler

java.lang.Object

org.jolokia.jvmagent.handler.JolokiaHttpHandler

All Implemented Interfaces:

com.sun.net.httpserver.HttpHandler

public class JolokiaHttpHandler
extends Object
implements com.sun.net.httpserver.HttpHandler

HttpHandler for handling a Jolokia request

Since:

Mar 3, 2010

Author:

roland

Constructor Summary

Constructors

Constructor and Description
JolokiaHttpHandler(Configuration pConfig) Create a new HttpHandler for processing HTTP request
JolokiaHttpHandler(Configuration pConfig, LogHandler pLogHandler) Create a new HttpHandler for processing HTTP request

Method Summary

Modifier and Type	Method and Description
protected void	checkAuthentication(com.sun.net.httpserver.HttpExchange pHttpExchange) Protocol based authentication checks called very early and before handling a request.
protected Restrictor	createRestrictor() Hook for creating an own restrictor
void	doHandle(com.sun.net.httpserver.HttpExchange pExchange)
void	handle(com.sun.net.httpserver.HttpExchange pHttpExchange) Handle a request.
void	start(boolean pLazy) Start the handler
void	start(boolean pLazy, String pUrl, boolean pSecured) Start the handler and remember connection details which are useful for discovery messages
void	stop() Stop the handler

Methods inherited from class java.lang.Object

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

Constructor Detail

JolokiaHttpHandler

public JolokiaHttpHandler(Configuration pConfig)

Create a new HttpHandler for processing HTTP request

Parameters:

pConfig - jolokia specific config tuning the processing behaviour

JolokiaHttpHandler

public JolokiaHttpHandler(Configuration pConfig,
                          LogHandler pLogHandler)

Create a new HttpHandler for processing HTTP request

Parameters:

pConfig - jolokia specific config tuning the processing behaviour

pLogHandler - log-handler the log handler to use for jolokia

Method Detail

start

public void start(boolean pLazy)

Start the handler

Parameters:

pLazy - whether initialisation should be done lazy.

createRestrictor

protected Restrictor createRestrictor()

Hook for creating an own restrictor

Returns:

return restrictor or null if no restrictor is needed.

start

public void start(boolean pLazy,
                  String pUrl,
                  boolean pSecured)

Start the handler and remember connection details which are useful for discovery messages

Parameters:

pLazy - whether initialisation should be done lazy.

pUrl - agent URL

pSecured - whether the communication is secured or not

stop

public void stop()

Stop the handler

handle

public void handle(com.sun.net.httpserver.HttpExchange pHttpExchange)
            throws IOException

Handle a request. If the handler is not yet started, an exception is thrown. If running with JAAS security enabled it will run as the given subject.

Specified by:

handle in interface com.sun.net.httpserver.HttpHandler

Parameters:

pHttpExchange - the request/response object

Throws:

IOException - if something fails during handling

IllegalStateException - if the handler has not yet been started

checkAuthentication

protected void checkAuthentication(com.sun.net.httpserver.HttpExchange pHttpExchange)
                            throws SecurityException

Protocol based authentication checks called very early and before handling a request. If the check fails a security exception must be thrown The default implementation does nothing and should be overridden for a valid check.

Parameters:

pHttpExchange - exchange to check

Throws:

SecurityException - if check fails.

doHandle

public void doHandle(com.sun.net.httpserver.HttpExchange pExchange)
              throws IOException

Throws:

IOException