-
Notifications
You must be signed in to change notification settings - Fork 8
/
IOnmsHTTP.ts
64 lines (56 loc) · 2.33 KB
/
IOnmsHTTP.ts
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
/** @hidden */
declare const Promise;
import {IFilterProcessor} from './IFilterProcessor';
import {OnmsHTTPOptions} from './OnmsHTTPOptions';
import {OnmsResult} from './OnmsResult';
import {OnmsServer} from './OnmsServer';
/**
* Interface for making ReST calls to an HTTP server.
* @interface
* @module IOnmsHTTP
*
* Notes to implementors:
* - Implementations of this interface MUST have a constructor that allows an empty
* constructor to be passed (although it is OK to take optional arguments for
* the purposes of unit testing).
* - Implementations MUST always use the current state of the 'server' config property
* when creating requests. If the 'server' property changes, the implementation
* should do whatever is necessary to reconfigure itself.
* - Implementations SHOULD prefer the auth in the OnmsServer (if available)
* over the one in the OnmsHTTPOptions, but should fall back if no auth
* configuration is supplied in the server property.
*/
export interface IOnmsHTTP {
/** The server associated with this instance. */
server: OnmsServer;
/** The default options used when making requests with this instance. */
options: OnmsHTTPOptions;
/**
* Perform an HTTP GET to the provided URL.
* @param url The URL to connect to.
* @param options The [[OnmsHTTPOptions]] options to use when connecting.
* @returns An [[OnmsResult]] result object.
*/
get(url: string, options?: OnmsHTTPOptions): Promise<OnmsResult<any>>;
/**
* Perform an HTTP PUT to the provided URL.
* @param url The URL to connect to.
* @param options The [[OnmsHTTPOptions]] options to use when connecting.
* @returns An [[OnmsResult]] result object.
*/
put(url: string, options?: OnmsHTTPOptions): Promise<OnmsResult<any>>;
/**
* Perform an HTTP POST to the provided URL.
* @param url The URL to connect to.
* @param options The [[OnmsHTTPOptions]] options to use when connecting.
* @returns An [[OnmsResult]] result object.
*/
post(url: string, options?: OnmsHTTPOptions): Promise<OnmsResult<any>>;
/**
* Perform an HTTP DELETE to the provided URL.
* @param url The URL to connect to.
* @param options The [[OnmsHTTPOptions]] options to use when connecting.
* @returns An [[OnmsResult]] result object.
*/
httpDelete(url: string, options?: OnmsHTTPOptions): Promise<OnmsResult<any>>;
}