org.alfresco.bm.http

Class AuthenticatedHttpEventProcessor

java.lang.Object

org.alfresco.bm.driver.event.AbstractEventProcessor

org.alfresco.bm.http.AuthenticatedHttpEventProcessor

All Implemented Interfaces:

org.alfresco.bm.driver.event.EventProcessor, org.springframework.beans.factory.Aware, org.springframework.beans.factory.BeanNameAware

public abstract class AuthenticatedHttpEventProcessor
extends org.alfresco.bm.driver.event.AbstractEventProcessor

A base class used for EventProcessors that makes use of HTTP-calls that should be done when authenticated against Alfresco. Subclasses can just do the HTTP-call(s) without having to worry about authentication. Use #executeHttpMethodAuthenticated(HttpRequestBase, String) instead of using HttpClient manually or #executeHttpMethodAsAdmin(HttpRequestBase) to run as Alfresco Administrator.

Supports both BASIC Authentication only.

Author:

Frederik Heremans, Derek Hulley

Field Summary

Fields inherited from class org.alfresco.bm.driver.event.AbstractEventProcessor

DEFAULT_AUTO_CLOSE_SESSION_ID, DEFAULT_AUTO_PROPAGATE_SESSION_ID, DEFAULT_CHART, DEFAULT_WARN_DELAY, logger

Constructor Summary

Constructors

Constructor and Description
AuthenticatedHttpEventProcessor(HttpClientProvider httpClientProvider, AuthenticationDetailsProvider authDetailProvider, String baseUrl)

Method Summary

Modifier and Type	Method and Description
protected <T> T	executeHttpMethodAsAdmin(org.apache.http.client.methods.HttpRequestBase request, HttpRequestCallback<T> callback) Execute the given method, authenticated as the Alfresco Administrator.
protected <T> T	executeHttpMethodAsUser(org.apache.http.client.methods.HttpRequestBase request, String username, HttpRequestCallback<T> callback) Execute the given method, authenticated as the given user.
AuthenticationDetailsProvider	getAuthDetailProvider()
String	getFullUrlForPath(String path)
HttpClientProvider	getHttpProvider()
protected void	releaseResources(org.apache.http.client.methods.HttpRequestBase request, org.apache.http.HttpResponse response) Release resources associated with an HTTP request.

Methods inherited from class org.alfresco.bm.driver.event.AbstractEventProcessor

getName, getWarnDelay, isAutoCloseSessionId, isAutoPropagateSessionId, isChart, processEvent, processEvent, register, resumeTimer, setAutoCloseSessionId, setAutoPropagateSessionId, setBeanName, setChart, setEventName, setEventNames, setRegistry, setWarnDelay, stopTimer, suspendTimer, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

AuthenticatedHttpEventProcessor

public AuthenticatedHttpEventProcessor(HttpClientProvider httpClientProvider,
                                       AuthenticationDetailsProvider authDetailProvider,
                                       String baseUrl)

Parameters:

httpClientProvider - provider class for http-client

authDetailProvider - provider for authentication details

baseUrl - the URL to append to

Method Detail

getHttpProvider

public HttpClientProvider getHttpProvider()

Returns:

the HttpClientProvider used by this class.

getAuthDetailProvider

public AuthenticationDetailsProvider getAuthDetailProvider()

Returns:

the AuthenticationDetailsProvider used by this class.

getFullUrlForPath

public String getFullUrlForPath(String path)

Parameters:

path - relative path of the URL from alfresco host.

Returns:

full URL including hostname and port for the given path.

executeHttpMethodAsUser

protected <T> T executeHttpMethodAsUser(org.apache.http.client.methods.HttpRequestBase request,
                                        String username,
                                        HttpRequestCallback<T> callback)

Execute the given method, authenticated as the given user. Automatically closes the response-stream to release the connection. If response should be extracted, this should be done in the HttpRequestCallback.

Parameters:

request - request to execute

username - name of user to authenticate as

callback - called after http-call is executed. When callback returns, the response stream is closed, so all respose-related operations should be done in the callback. Can be null.

Returns:

whatever the callback dictates

executeHttpMethodAsAdmin

protected <T> T executeHttpMethodAsAdmin(org.apache.http.client.methods.HttpRequestBase request,
                                         HttpRequestCallback<T> callback)

Execute the given method, authenticated as the Alfresco Administrator.

Parameters:

request - request to execute

callback - called after http-call is executed. When callback returns, the response stream is closed, so all respose-related operations should be done in the callback. Can be null.

Returns:

whatever the callback dictates

releaseResources

protected void releaseResources(org.apache.http.client.methods.HttpRequestBase request,
                                org.apache.http.HttpResponse response)

Release resources associated with an HTTP request. This method handles exceptions internall so no try-catch is required.

Parameters:

request - the HTTP request that might have open resources (null allowed)