diff options
author | Alex Shpak <alex-shpak@users.noreply.github.com> | 2018-10-30 15:56:42 +0100 |
---|---|---|
committer | Alex Shpak <alex-shpak@users.noreply.github.com> | 2018-10-30 15:56:42 +0100 |
commit | 5535f8740060e3f237cc12124dd892565d6d2814 (patch) | |
tree | a48fd3ba604d3757f002f914dd4520618dedbdbd /exampleSite/content/docs/rx-jersey-server.md | |
parent | b571e84efd027d047166125c38ee935c6171e305 (diff) |
Fill example site with Lorem Ipsum
Diffstat (limited to 'exampleSite/content/docs/rx-jersey-server.md')
-rw-r--r-- | exampleSite/content/docs/rx-jersey-server.md | 64 |
1 files changed, 0 insertions, 64 deletions
diff --git a/exampleSite/content/docs/rx-jersey-server.md b/exampleSite/content/docs/rx-jersey-server.md deleted file mode 100644 index 105e581..0000000 --- a/exampleSite/content/docs/rx-jersey-server.md +++ /dev/null @@ -1,64 +0,0 @@ -## Jersey Server -Register `RxJerseyServerFeature` in `resourceConfig` -```java -resourceConfig.register(RxJerseyServerFeature.class); -``` -Or with configuration -```java -RxJerseyServerFeature rxJerseyServerFeature = new RxJerseyServerFeature() - .register(AuthInterceptor.class); - -resourceConfig.register(rxJerseyServerFeature); -``` - -Update your resource adding rx return type: -```java -@Path("/") -public class HelloResource { - - @GET - public Single<HelloEntity> getAsync() { - return Single.just(new HelloEntity()); - } - - - public static class HelloEntity { - public String hello = "world"; - } -} -``` - -## Inteceptor -You can use RxJava enabled interceptors. Result of such interceptor will be ignored. Thrown or returned error would be redirected to jersey. - -#### RxJava -```java -public class SimpleInterceptor implements ObservableRequestInterceptor<Void> { - public Observable<Void> intercept(ContainerRequestContext requestContext) { - return Observable.empty(); - } -} -``` - -#### RxJava 2 -```java -public class SimpleInterceptor implements CompletableRequestInterceptor { - public Completable intercept(ContainerRequestContext requestContext) { - return Observable.complete(); - } -} -``` - - -## Important notes -#### RxJava - - It's recommended to use `rx.Single` as return type (Representing single response entity). - - Multiple elements emitted in `Observable` will be treated as error. - - Empty `Observable` or `null` value in `Observable` or `Single` will be treated as `204: No content`. - - `Completable` will be executed and `204: No content` will be returned. - -#### RxJava 2 - - It's recommended to use `io.reactivex.Maybe` which could be 0 or 1 item or an error. - - Multiple elements emitted in `Observable` or `Flowable` will be treated as error. - - Empty `Observable`/`Maybe` will be treated as `204: No content`. - - `Completable` will be executed and `204: No content` will be returned. |