# benjamon99/rundeck-http-plugin architecture

> Architecture diagram of the GitHub repository benjamon99/rundeck-http-plugin, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/benjamon99/rundeck-http-plugin
- Repository: https://github.com/benjamon99/rundeck-http-plugin

## Overview

This repository is a Rundeck notification plugin that sends configurable HTTP requests when a job notification fires. Rundeck invokes the plugin, which resolves URL/method/body settings, selects a request strategy, executes the request, and dispatches a matching notification handler after receiving a response. The README documents GET, POST, PUT, DELETE and request customization; sampled code shows the strategy and handler wiring. The request-method strategies are grouped by responsibility; unshown success-handler source is retained because the plugin registers it. Evidence is limited to the README and the sampled plugin/strategy files.

Main entry points: [`src/main/java/com/exercise/rundeck/plugin/exercise/HttpNotificationPlugin.java`](https://github.com/benjamon99/rundeck-http-plugin/blob/main/src/main/java/com/exercise/rundeck/plugin/exercise/HttpNotificationPlugin.java) (HTTP notification plugin), [`src/main/java/com/exercise/rundeck/plugin/exercise/interfaces/NotificationHandlerStrategy.java`](https://github.com/benjamon99/rundeck-http-plugin/blob/main/src/main/java/com/exercise/rundeck/plugin/exercise/interfaces/NotificationHandlerStrategy.java) (Handler strategy interface), [`src/main/java/com/exercise/rundeck/plugin/exercise/interfaces/HttpRequestStrategy.java`](https://github.com/benjamon99/rundeck-http-plugin/blob/main/src/main/java/com/exercise/rundeck/plugin/exercise/interfaces/HttpRequestStrategy.java) (Request strategy interface), [`src/main/java/com/exercise/rundeck/plugin/exercise/strategies/httprequest/HttpGetStrategy.java`](https://github.com/benjamon99/rundeck-http-plugin/blob/main/src/main/java/com/exercise/rundeck/plugin/exercise/strategies/httprequest/HttpGetStrategy.java) (GET strategy)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Plugin entry"]
  node_plugin["HTTP notification plugin"]
end

subgraph group_requests["HTTP requests"]
  node_request_api["Request strategy interface"]
  node_get["GET strategy"]
  node_post["POST strategy"]
  node_put["PUT strategy"]
  node_delete["DELETE strategy"]
end

subgraph group_notifications["Notification handlers"]
  node_handler_api["Handler strategy interface"]
  node_start["Start handler"]
  node_success["Success handler"]
  node_failure["Failure handler"]
  node_retry_failure["Retryable failure handler"]
  node_avg_duration["Average duration handler"]
end

node_rundeck(("Rundeck jobs"))
node_http(("HTTP endpoint"))

node_rundeck -->|"invokes"| node_plugin
node_plugin -->|"selects and calls"| node_get
node_plugin -->|"selects and calls"| node_post
node_plugin -->|"selects and calls"| node_put
node_plugin -->|"selects and calls"| node_delete
node_plugin -->|"sends request"| node_http
node_http -->|"returns response"| node_plugin
node_plugin -->|"dispatches trigger"| node_start
node_plugin -->|"dispatches trigger"| node_success
node_plugin -->|"dispatches trigger"| node_failure
node_plugin -->|"dispatches trigger"| node_retry_failure
node_plugin -->|"dispatches trigger"| node_avg_duration
node_get -->|"implements"| node_request_api
node_post -->|"implements"| node_request_api
node_put -->|"implements"| node_request_api
node_delete -->|"implements"| node_request_api
node_start -->|"implements"| node_handler_api
node_success -->|"implements"| node_handler_api
node_failure -->|"implements"| node_handler_api
node_retry_failure -->|"implements"| node_handler_api
node_avg_duration -->|"implements"| node_handler_api

click node_plugin "https://github.com/benjamon99/rundeck-http-plugin/blob/main/src/main/java/com/exercise/rundeck/plugin/exercise/HttpNotificationPlugin.java"
click node_request_api "https://github.com/benjamon99/rundeck-http-plugin/blob/main/src/main/java/com/exercise/rundeck/plugin/exercise/interfaces/HttpRequestStrategy.java"
click node_get "https://github.com/benjamon99/rundeck-http-plugin/blob/main/src/main/java/com/exercise/rundeck/plugin/exercise/strategies/httprequest/HttpGetStrategy.java"
click node_post "https://github.com/benjamon99/rundeck-http-plugin/blob/main/src/main/java/com/exercise/rundeck/plugin/exercise/strategies/httprequest/HttpPostStrategy.java"
click node_put "https://github.com/benjamon99/rundeck-http-plugin/blob/main/src/main/java/com/exercise/rundeck/plugin/exercise/strategies/httprequest/HttpPutStrategy.java"
click node_delete "https://github.com/benjamon99/rundeck-http-plugin/blob/main/src/main/java/com/exercise/rundeck/plugin/exercise/strategies/httprequest/HttpDeleteStrategy.java"
click node_handler_api "https://github.com/benjamon99/rundeck-http-plugin/blob/main/src/main/java/com/exercise/rundeck/plugin/exercise/interfaces/NotificationHandlerStrategy.java"
click node_start "https://github.com/benjamon99/rundeck-http-plugin/blob/main/src/main/java/com/exercise/rundeck/plugin/exercise/strategies/handlernotification/OnStartHandlerNotificationStrategy.java"
click node_success "https://github.com/benjamon99/rundeck-http-plugin/blob/main/src/main/java/com/exercise/rundeck/plugin/exercise/strategies/handlernotification/OnSuccessHandlerNotificationStrategy.java"
click node_failure "https://github.com/benjamon99/rundeck-http-plugin/blob/main/src/main/java/com/exercise/rundeck/plugin/exercise/strategies/handlernotification/OnFailureHandlerNotificationStrategy.java"
click node_retry_failure "https://github.com/benjamon99/rundeck-http-plugin/blob/main/src/main/java/com/exercise/rundeck/plugin/exercise/strategies/handlernotification/OnRetryableFailureHandlerNotificationStrategy.java"
click node_avg_duration "https://github.com/benjamon99/rundeck-http-plugin/blob/main/src/main/java/com/exercise/rundeck/plugin/exercise/strategies/handlernotification/OnAvgDurationHandlerNotificationStrategy.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_plugin toneBlue
class node_request_api,node_get,node_post,node_put,node_delete toneAmber
class node_handler_api,node_start,node_success,node_failure,node_retry_failure,node_avg_duration toneMint
class node_rundeck,node_http toneIndigo
```

## Components

### Plugin entry

- [HTTP notification plugin](https://github.com/benjamon99/rundeck-http-plugin/blob/main/src/main/java/com/exercise/rundeck/plugin/exercise/HttpNotificationPlugin.java): `src/main/java/com/exercise/rundeck/plugin/exercise/HttpNotificationPlugin.java`

### HTTP requests

- [Request strategy interface](https://github.com/benjamon99/rundeck-http-plugin/blob/main/src/main/java/com/exercise/rundeck/plugin/exercise/interfaces/HttpRequestStrategy.java): `src/main/java/com/exercise/rundeck/plugin/exercise/interfaces/HttpRequestStrategy.java`
- [GET strategy](https://github.com/benjamon99/rundeck-http-plugin/blob/main/src/main/java/com/exercise/rundeck/plugin/exercise/strategies/httprequest/HttpGetStrategy.java): `src/main/java/com/exercise/rundeck/plugin/exercise/strategies/httprequest/HttpGetStrategy.java`
- [POST strategy](https://github.com/benjamon99/rundeck-http-plugin/blob/main/src/main/java/com/exercise/rundeck/plugin/exercise/strategies/httprequest/HttpPostStrategy.java): `src/main/java/com/exercise/rundeck/plugin/exercise/strategies/httprequest/HttpPostStrategy.java`
- [PUT strategy](https://github.com/benjamon99/rundeck-http-plugin/blob/main/src/main/java/com/exercise/rundeck/plugin/exercise/strategies/httprequest/HttpPutStrategy.java): `src/main/java/com/exercise/rundeck/plugin/exercise/strategies/httprequest/HttpPutStrategy.java`
- [DELETE strategy](https://github.com/benjamon99/rundeck-http-plugin/blob/main/src/main/java/com/exercise/rundeck/plugin/exercise/strategies/httprequest/HttpDeleteStrategy.java): `src/main/java/com/exercise/rundeck/plugin/exercise/strategies/httprequest/HttpDeleteStrategy.java`

### Notification handlers

- [Handler strategy interface](https://github.com/benjamon99/rundeck-http-plugin/blob/main/src/main/java/com/exercise/rundeck/plugin/exercise/interfaces/NotificationHandlerStrategy.java): `src/main/java/com/exercise/rundeck/plugin/exercise/interfaces/NotificationHandlerStrategy.java`
- [Start handler](https://github.com/benjamon99/rundeck-http-plugin/blob/main/src/main/java/com/exercise/rundeck/plugin/exercise/strategies/handlernotification/OnStartHandlerNotificationStrategy.java): `src/main/java/com/exercise/rundeck/plugin/exercise/strategies/handlernotification/OnStartHandlerNotificationStrategy.java`
- [Success handler](https://github.com/benjamon99/rundeck-http-plugin/blob/main/src/main/java/com/exercise/rundeck/plugin/exercise/strategies/handlernotification/OnSuccessHandlerNotificationStrategy.java): `src/main/java/com/exercise/rundeck/plugin/exercise/strategies/handlernotification/OnSuccessHandlerNotificationStrategy.java`
- [Failure handler](https://github.com/benjamon99/rundeck-http-plugin/blob/main/src/main/java/com/exercise/rundeck/plugin/exercise/strategies/handlernotification/OnFailureHandlerNotificationStrategy.java): `src/main/java/com/exercise/rundeck/plugin/exercise/strategies/handlernotification/OnFailureHandlerNotificationStrategy.java`
- [Retryable failure handler](https://github.com/benjamon99/rundeck-http-plugin/blob/main/src/main/java/com/exercise/rundeck/plugin/exercise/strategies/handlernotification/OnRetryableFailureHandlerNotificationStrategy.java): `src/main/java/com/exercise/rundeck/plugin/exercise/strategies/handlernotification/OnRetryableFailureHandlerNotificationStrategy.java`
- [Average duration handler](https://github.com/benjamon99/rundeck-http-plugin/blob/main/src/main/java/com/exercise/rundeck/plugin/exercise/strategies/handlernotification/OnAvgDurationHandlerNotificationStrategy.java): `src/main/java/com/exercise/rundeck/plugin/exercise/strategies/handlernotification/OnAvgDurationHandlerNotificationStrategy.java`

### Other components

- **Rundeck jobs**
- **HTTP endpoint**

## Connections

- Rundeck jobs → HTTP notification plugin: invokes (evidence: `README.md`)
- HTTP notification plugin → GET strategy: selects and calls (evidence: `src/main/java/com/exercise/rundeck/plugin/exercise/HttpNotificationPlugin.java`)
- HTTP notification plugin → POST strategy: selects and calls (evidence: `src/main/java/com/exercise/rundeck/plugin/exercise/HttpNotificationPlugin.java`)
- HTTP notification plugin → PUT strategy: selects and calls (evidence: `src/main/java/com/exercise/rundeck/plugin/exercise/HttpNotificationPlugin.java`)
- HTTP notification plugin → DELETE strategy: selects and calls (evidence: `src/main/java/com/exercise/rundeck/plugin/exercise/HttpNotificationPlugin.java`)
- HTTP notification plugin → HTTP endpoint: sends request (evidence: `src/main/java/com/exercise/rundeck/plugin/exercise/HttpNotificationPlugin.java`)
- HTTP endpoint → HTTP notification plugin: returns response (evidence: `src/main/java/com/exercise/rundeck/plugin/exercise/HttpNotificationPlugin.java`)
- HTTP notification plugin → Start handler: dispatches trigger (evidence: `src/main/java/com/exercise/rundeck/plugin/exercise/HttpNotificationPlugin.java`)
- HTTP notification plugin → Success handler: dispatches trigger (evidence: `src/main/java/com/exercise/rundeck/plugin/exercise/HttpNotificationPlugin.java`)
- HTTP notification plugin → Failure handler: dispatches trigger (evidence: `src/main/java/com/exercise/rundeck/plugin/exercise/HttpNotificationPlugin.java`)
- HTTP notification plugin → Retryable failure handler: dispatches trigger (evidence: `src/main/java/com/exercise/rundeck/plugin/exercise/HttpNotificationPlugin.java`)
- HTTP notification plugin → Average duration handler: dispatches trigger (evidence: `src/main/java/com/exercise/rundeck/plugin/exercise/HttpNotificationPlugin.java`)
- GET strategy → Request strategy interface: implements (evidence: `src/main/java/com/exercise/rundeck/plugin/exercise/strategies/httprequest/HttpGetStrategy.java`)
- POST strategy → Request strategy interface: implements (evidence: `src/main/java/com/exercise/rundeck/plugin/exercise/strategies/httprequest/HttpPostStrategy.java`)
- PUT strategy → Request strategy interface: implements (evidence: `src/main/java/com/exercise/rundeck/plugin/exercise/strategies/httprequest/HttpPutStrategy.java`)
- DELETE strategy → Request strategy interface: implements (evidence: `src/main/java/com/exercise/rundeck/plugin/exercise/strategies/httprequest/HttpDeleteStrategy.java`)
- Start handler → Handler strategy interface: implements (evidence: `src/main/java/com/exercise/rundeck/plugin/exercise/strategies/handlernotification/OnStartHandlerNotificationStrategy.java`)
- Success handler → Handler strategy interface: implements (evidence: `src/main/java/com/exercise/rundeck/plugin/exercise/strategies/handlernotification/OnSuccessHandlerNotificationStrategy.java`)
- Failure handler → Handler strategy interface: implements (evidence: `src/main/java/com/exercise/rundeck/plugin/exercise/strategies/handlernotification/OnFailureHandlerNotificationStrategy.java`)
- Retryable failure handler → Handler strategy interface: implements (evidence: `src/main/java/com/exercise/rundeck/plugin/exercise/strategies/handlernotification/OnRetryableFailureHandlerNotificationStrategy.java`)
- Average duration handler → Handler strategy interface: implements (evidence: `src/main/java/com/exercise/rundeck/plugin/exercise/strategies/handlernotification/OnAvgDurationHandlerNotificationStrategy.java`)
