org.gitlab4j.api.webhook

Class WebHookManager

java.lang.Object

org.gitlab4j.api.webhook.WebHookManager

public class WebHookManager
extends Object

This class provides a handler for processing GitLab WebHook callouts.

Constructor Summary

Constructors

Constructor and Description
WebHookManager() Create a WebHookManager to handle GitLab webhook events.
WebHookManager(String secretToken) Create a WebHookManager to handle GitLab webhook events which will be verified against the specified secretToken.

Method Summary

Modifier and Type	Method and Description
void	addListener(WebHookListener listener) Adds a WebHook event listener.
void	fireEvent(Event event) Fire the event to the registered listeners.
protected void	fireIssueEvent(IssueEvent issueEvent)
protected void	fireMergeRequestEvent(MergeRequestEvent mergeRequestEvent)
protected void	fireNoteEvent(NoteEvent noteEvent)
protected void	firePushEvent(PushEvent pushEvent)
protected void	fireTagPushEvent(TagPushEvent tagPushEvent)
void	handleEvent(Event event) Verifies the provided Event and fires it off to the registered listeners.
void	handleEvent(javax.servlet.http.HttpServletRequest request) Parses and verifies an Event instance from the HTTP request and fires it off to the registered listeners.
boolean	isValidSecretToken(javax.servlet.http.HttpServletRequest request) Validate the provided secret token found in the HTTP header against the reference secret token.
boolean	isValidSecretToken(String secretToken) Validate the provided secret token against the reference secret token.
void	removeListener(WebHookListener listener) Removes a WebHook event listener.
void	setSecretToken(String secretToken) Set the secret token that received webhook events should be validated against.

Methods inherited from class java.lang.Object

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

Constructor Detail

WebHookManager

public WebHookManager()

Create a WebHookManager to handle GitLab webhook events.

WebHookManager

public WebHookManager(String secretToken)

Create a WebHookManager to handle GitLab webhook events which will be verified against the specified secretToken.

Parameters:

secretToken - the secret token to verify against

Method Detail

setSecretToken

public void setSecretToken(String secretToken)

Set the secret token that received webhook events should be validated against.

Parameters:

secretToken - the secret token to verify against

isValidSecretToken

public boolean isValidSecretToken(String secretToken)

Validate the provided secret token against the reference secret token. Returns true if the secret token is valid or there is no reference secret token to validate against, otherwise returns false.

Parameters:

secretToken - the token to validate

Returns:

true if the secret token is valid or there is no reference secret token to validate against

isValidSecretToken

public boolean isValidSecretToken(javax.servlet.http.HttpServletRequest request)

Validate the provided secret token found in the HTTP header against the reference secret token. Returns true if the secret token is valid or there is no reference secret token to validate against, otherwise returns false.

Parameters:

request - the HTTP request to verify the secret token

Returns:

true if the secret token is valid or there is no reference secret token to validate against

handleEvent

public void handleEvent(javax.servlet.http.HttpServletRequest request)
                 throws GitLabApiException

Parses and verifies an Event instance from the HTTP request and fires it off to the registered listeners.

Parameters:

request - the HttpServletRequest to read the Event instance from

Throws:

GitLabApiException - if the parsed event is not supported

handleEvent

public void handleEvent(Event event)
                 throws GitLabApiException

Verifies the provided Event and fires it off to the registered listeners.

Parameters:

event - the Event instance to handle

Throws:

GitLabApiException - if the event is not supported

addListener

public void addListener(WebHookListener listener)

Adds a WebHook event listener.

Parameters:

listener - the WebHookListener to add

removeListener

public void removeListener(WebHookListener listener)

Removes a WebHook event listener.

Parameters:

listener - the WebHookListener to remove

fireEvent

public void fireEvent(Event event)
               throws GitLabApiException

Fire the event to the registered listeners.

Parameters:

event - the Event instance to fire to the registered event listeners

Throws:

GitLabApiException - if the event is not supported

fireIssueEvent

protected void fireIssueEvent(IssueEvent issueEvent)

fireMergeRequestEvent

protected void fireMergeRequestEvent(MergeRequestEvent mergeRequestEvent)

fireNoteEvent

protected void fireNoteEvent(NoteEvent noteEvent)

firePushEvent

protected void firePushEvent(PushEvent pushEvent)

fireTagPushEvent

protected void fireTagPushEvent(TagPushEvent tagPushEvent)