blob: b0e279345076c968af099a31fbe570d49d8522e6 (
plain)
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
|
## RxJersey Proxy Client
Proxy client provides convenient way to call resources without constructing request. Also it allows to reuse resource interfaces between microservices.
In order to enable RxJava in proxy client register Jersey feature
```java
RxJerseyClientFeature rxJerseyClientFeature = new RxJerseyClientFeature()
.register(client); //should be non-blocking client implementation
resourceConfig.register(rxJerseyClientFeature);
```
Default client with Grizzly connector will be used if not provided
## Remote resource injection
You can inject proxy client with `@Remote` annotation, in addition you can inject `WebTarget` or `RxWebTarget`
```java
@Path("/example/")
public class GithubResource {
@Remote("https://api.github.com/")
private GithubApi githubApi;
@Remote("https://api.github.com/")
private WebTarget webTarget;
@GET
@Path("github")
public Single<GithubRepository> getRepository() {
return githubApi.getRepository("alex-shpak", "rx-jersey").toSingle();
}
}
```
## Manual proxy client creation
You can use `WebResourceFactory` from `net.winterly.rxjersey.client` package in order to create proxy client
#### RxJava
```java
WebResourceFactory.newResource(
ResourceInterface.class,
rxWebTarget,
new ObservableClientMethodInvoker()
);
```
#### RxJava 2
```java
WebResourceFactory.newResource(
ResourceInterface.class,
webTarget,
new FlowableClientMethodInvoker()
);
```
## Url resolving
Below is example of URL merging based on `@Remote` annotation value
| Annotation Value | Jersey Context Path | Result URL |
| ----------------------------- | --------------------------- | ---------------------------- |
| @Remote("http://example.com") | http://baseurl.com/resource | http://example.com/ |
| @Remote("/resource/") | http://baseurl.com/some | http://baseurl.com/resource/ |
|
