Class AbstractHTTP`Abstract`

Abstract implementation of the OnmsHTTP interface meant to be extended by a concrete class.

Implements

IOnmsHTTP

Hierarchy (view full)

AbstractHTTP
- AxiosHTTP
- GrafanaHTTP

Implements

IOnmsHTTP

Index

Constructors

Accessors

Methods

get getData getOptions getServer head httpDelete onSetServer post put transformJSON transformXML

Constructors

constructor

new AbstractHTTP(server?, timeout?): AbstractHTTP
Create a new HTTP instance.
Parameters
- Optionalserver: OnmsServer
  A server object for immediate configuration.
- Optionaltimeout: number
  How long to wait until timing out requests.
Returns AbstractHTTP
- Defined in src/rest/AbstractHTTP.ts:71

Accessors

options

get options(): OnmsHTTPOptions
The default set of HTTP options associated with this ReST client.

Returns OnmsHTTPOptions
Implementation of IOnmsHTTP.options
- Defined in src/rest/AbstractHTTP.ts:38
set options(o): void
The default options used when making requests with this instance.
Parameters
- o: OnmsHTTPOptions
Returns void
Implementation of IOnmsHTTP.options
- Defined in src/rest/AbstractHTTP.ts:45

server

get server(): OnmsServer
The server associated with this HTTP implementation.

Returns OnmsServer
Implementation of IOnmsHTTP.server
- Defined in src/rest/AbstractHTTP.ts:56
set server(server): void
The server associated with this instance.
Parameters
- server: OnmsServer
Returns void
Implementation of IOnmsHTTP.server
- Defined in src/rest/AbstractHTTP.ts:60

Methods

`Abstract`get

get(url, options?): Promise<OnmsResult<any>>
Make an HTTP GET call. This must be implemented by the concrete implementation.
Parameters
- url: string
- Optionaloptions: OnmsHTTPOptions
Returns Promise<OnmsResult<any>>
Implementation of IOnmsHTTP.get
- Defined in src/rest/AbstractHTTP.ts:81

`Protected`getData

getData(response): any
Attempt to extract the data from a response.
Parameters
- response: any
Returns any
- Defined in src/rest/AbstractHTTP.ts:112

`Protected`getOptions

getOptions(options?): OnmsHTTPOptions
Get the union of [[OnmsHTTPOptions]] based on the passed options, defaults, and options in the [[OnmsServer]] associated with this request. Order of precedence is passed options -> server options -> default options.
Parameters
- Optionaloptions: OnmsHTTPOptions
Returns OnmsHTTPOptions
- Defined in src/rest/AbstractHTTP.ts:164

`Protected`getServer

getServer(options?): OnmsServer
Get the [[OnmsServer]] object that should be used for making requests. Favors the one passed in the [[OnmsHTTPOptions]], otherwise it falls back to the default server associated with the HTTP implementation.
Parameters
- Optionaloptions: OnmsHTTPOptions
Returns OnmsServer
- Defined in src/rest/AbstractHTTP.ts:149

`Abstract`head

head(url, options?): Promise<OnmsResult<any>>
Make an HTTP HEAD call. This must be implemented by the concrete implementation.
Parameters
- url: string
- Optionaloptions: OnmsHTTPOptions
Returns Promise<OnmsResult<any>>
Implementation of IOnmsHTTP.head
- Defined in src/rest/AbstractHTTP.ts:84

`Abstract`httpDelete

httpDelete(url, options?): Promise<OnmsResult<any>>
Make an HTTP DELETE call. This must be overridden by the concrete implementation.
Parameters
- url: string
- Optionaloptions: OnmsHTTPOptions
Returns Promise<OnmsResult<any>>
Implementation of IOnmsHTTP.httpDelete
- Defined in src/rest/AbstractHTTP.ts:93

`Protected`onSetServer

onSetServer(): void
Implementers should override this method if they have actions that need to be performed (like clearing a cache) when server settings change.

Returns void
- Defined in src/rest/AbstractHTTP.ts:178

`Abstract`post

post(url, options?): Promise<OnmsResult<any>>
Make an HTTP POST call. This must be overridden by the concrete implementation.
Parameters
- url: string
- Optionaloptions: OnmsHTTPOptions
Returns Promise<OnmsResult<any>>
Implementation of IOnmsHTTP.post
- Defined in src/rest/AbstractHTTP.ts:90

`Abstract`put

put(url, options?): Promise<OnmsResult<any>>
Make an HTTP PUT call. This must be overridden by the concrete implementation.
Parameters
- url: string
- Optionaloptions: OnmsHTTPOptions
Returns Promise<OnmsResult<any>>
Implementation of IOnmsHTTP.put
- Defined in src/rest/AbstractHTTP.ts:87

`Protected`transformJSON

transformJSON(data): any
A convenience method for implementers to use to turn JSON into a javascript object. Use this to process a JSON response before returning it in an [[OnmsResult]] object.
Parameters
- data: any
Returns any
- Defined in src/rest/AbstractHTTP.ts:99

`Protected`transformXML

transformXML(data): any
A convenience method for implementers to use to turn XML into a javascript object. Use this to process an XML response before returning it in an [[OnmsResult]] object.
Parameters
- data: any
Returns any
- Defined in src/rest/AbstractHTTP.ts:107