diff options
| -rw-r--r-- | README.md | 2 | ||||
| -rw-r--r-- | assets/_variables.scss | 2 | ||||
| -rw-r--r-- | assets/book.scss | 2 | ||||
| -rw-r--r-- | exampleSite/config.yml | 2 | ||||
| -rw-r--r-- | exampleSite/content/_index.md | 133 | ||||
| -rw-r--r-- | exampleSite/content/docs/advanced.md | 52 | ||||
| -rw-r--r-- | exampleSite/content/docs/client.md | 55 | ||||
| -rw-r--r-- | exampleSite/content/docs/dropwizard-configuration.md | 35 | ||||
| -rw-r--r-- | exampleSite/content/docs/examples.md | 81 | ||||
| -rw-r--r-- | exampleSite/content/docs/jersey-configuration.md | 20 | ||||
| -rw-r--r-- | exampleSite/content/docs/rx-jersey-client.md | 60 | ||||
| -rw-r--r-- | exampleSite/content/docs/rx-jersey-server.md | 64 | ||||
| -rw-r--r-- | exampleSite/content/docs/server.md | 51 | ||||
| -rw-r--r-- | exampleSite/content/docs/with-toc.md | 60 | ||||
| -rw-r--r-- | exampleSite/content/docs/without-toc.md | 57 | ||||
| -rw-r--r-- | exampleSite/content/menu/index.md | 14 |
16 files changed, 432 insertions, 258 deletions
@@ -54,7 +54,7 @@ headless: true And Enable it by settings `BookMenuBundle: /docs/menu` in Site configuration -- [Example menu](exampleSite/content/menu) +- [Example menu](exampleSite/content/menu/index.md) - [Example config file](exampleSite/config.yml) - [Leaf bundles](https://gohugo.io/content-management/page-bundles/) diff --git a/assets/_variables.scss b/assets/_variables.scss index 89f1751..891a6e1 100644 --- a/assets/_variables.scss +++ b/assets/_variables.scss @@ -33,7 +33,7 @@ $nav-background: $body-background; //$gray-100; $nav-link-color: $gray-800; $header-height: 3.5rem; -$nav-menu-width: 16rem; +$nav-menu-width: 18rem; $toc-menu-width: 14rem; $content-max-width: 80rem; diff --git a/assets/book.scss b/assets/book.scss index b95e21b..d139326 100644 --- a/assets/book.scss +++ b/assets/book.scss @@ -49,7 +49,7 @@ aside { line-height: 1.5em; li { - margin: .5em 0; + margin: .75em 0; a { display: block; } a:hover { opacity: .5; } diff --git a/exampleSite/config.yml b/exampleSite/config.yml index 2c49a8c..3ce75ff 100644 --- a/exampleSite/config.yml +++ b/exampleSite/config.yml @@ -1,7 +1,7 @@ # hugo server --themesDir ... baseURL: http://example.org -title: Rx Jersey +title: Hugo Book theme: hugo-book # Book configuration diff --git a/exampleSite/content/_index.md b/exampleSite/content/_index.md index 0c7a403..254597c 100644 --- a/exampleSite/content/_index.md +++ b/exampleSite/content/_index.md @@ -1,77 +1,74 @@ --- -title: Introduction type: docs --- -# RxJersey - Reactive Jersey Feature +# Acerbo datus maxime -[](https://travis-ci.org/alex-shpak/rx-jersey) - +## Tempora nisi nunc -RxJersey is RxJava extension for [Jersey](https://jersey.java.net/) framework providing non-blocking Jax-RS server and client. -RxJersey target is to handle large amount requests in small static set of threads, which is highly suitable for microservice applications. +Lorem **markdownum** emicat gestu. Cannis sol pressit ducta. **Est** Idaei, +tremens ausim se tutaeque, illi ulnis hausit, sed, lumina cutem. Quae avis +sequens! -Library uses Jersey 2 async support with `@Suspended` and `AsyncResponse` under the hood. - -## Features -- [x] RxJava Support -- [x] RxJava 2 Support -- [x] RxJava Proxy Client -- [x] Async Request Interceptors -- [x] Dropwizard bundle - -## Roadmap -- [ ] Futures support -- [ ] Vert.x integration -- [ ] Improved proxy client - - -## Maven Artifacts -### Maven Central -``` -compile "net.winterly.rxjersey:dropwizard:$rxJerseyVersion" -compile "net.winterly.rxjersey:rxjava-client:$rxJerseyVersion" -compile "net.winterly.rxjersey:rxjava-server:$rxJerseyVersion" -compile "net.winterly.rxjersey:rxjava2-client:$rxJerseyVersion" -compile "net.winterly.rxjersey:rxjava2-server:$rxJerseyVersion" -``` - -### JitPack -Most recent snapshot is available via [JitPack](https://jitpack.io/#alex-shpak/rx-jersey/) -``` -compile "com.github.alex-shpak.rx-jersey:dropwizard:$rxJerseyVersion" -compile "com.github.alex-shpak.rx-jersey:rxjava-client:$rxJerseyVersion" -compile "com.github.alex-shpak.rx-jersey:rxjava-server:$rxJerseyVersion" -compile "com.github.alex-shpak.rx-jersey:rxjava2-client:$rxJerseyVersion" -compile "com.github.alex-shpak.rx-jersey:rxjava2-server:$rxJerseyVersion" -``` - - -## Example -```java -@Path("/example/") -public class GithubResource { - - @Remote("https://api.github.com/") - private GithubApi githubApi; - - @GET - @Path("github") - public Single<GithubRepository> getRepository() { - return githubApi.getRepository("alex-shpak", "rx-jersey").toSingle(); + var panel = ram_design; + if (backup + system) { + file.readPoint = network_native; + sidebar_engine_device(cell_tftp_raster, + dual_login_paper.adf_vci.application_reader_design( + graphicsNvramCdma, lpi_footer_snmp, integer_model)); } + public_keyboard_docking += error.controller_gibibyte_plug.ip(4, + asciiPetaflops, software(supercomputer_compatible_status + 4)); + dynamic_disk.indexModeLaptop = bufferTftpReality; + var export_vlog_sequence = trinitron_flowchart + supercomputer_cluster_rj( + -1, toolbar_powerpoint_query, -2 / multiprocessing_impression); + +## Locis suis novi cum suoque decidit eadem + +Idmoniae ripis, at aves, ali missa adest, ut *et autem*, et ab? Venit spes +versus finis sermonibus patefecit murum nec est sine oculis. *Ille* inmota +macies domoque caelestia cadit tantummodo scelus procul, corde! + +1. Dolentem capi parte rostro alvum habentem pudor +2. Fulgentia sanguine paret +3. E punior consurgit lentus +4. Vox hasta eras micantes + +## Suis quot + +Ea *furtique* risere fratres edidit terrae magis. Colla tam mihi tenebat: +miseram excita suadent es pecudes iam. Concilio *quam* velatus posset ait quod +nunc! + +## Astris ipse furtiva vota collumque et habe + +Est in vagis et Pittheus tu arge accipiter regia iram vocatur nurus. Omnes ut +olivae sensit **arma sorori** deducit, inesset **crudus**, ego vetuere aliis, +modo arsit? Utinam rapta fiducia valuere litora *adicit cursu*, ad facies: +fragosis suae dextra geruntur functus vulgata. + +## Facibus pharetrae indetonsusque indulsit sic incurrite foliis + +Nefandam et prisci palmas! Blandita cutis flectitur montis macies, te *nati* +Latiis; turbaque inferias. Virginis tibi peracta avidusque facies caper nec, e +at ademptae, mira. + + direct *= font(inputScareware(sliHome), crossplatform.byte( + ppl_encryption.excel_e_rte(integratedModelModifier), timeVirtual, + floating_speakers.media_printer(us, yahoo, primaryPhp))); + friendly_metal_flatbed(cd, isoPrimaryStorage(reader), dmaMirrored); + if (parse_flash_cron.metalGif(1, adServiceDevice, utility)) { + adf -= operation_cdma_samba; + imapGif.switch += torrent; + } else { + pmu.disk_captcha = digital_ppp_pci + recursionTransistor(5, dram); + ajax_service += grayscalePythonLock; + google_scroll_capacity = ftp + engine_dslam_sidebar / tape - 1; + } + drive_rw = zipTftp; + var suffix = software_router_extension.dimm_ddr(-5, + kernel_digital_minisite); -} - -@Path("/") -public interface GithubApi { - - @GET - @Path("/repos/{user}/{repo}") - Observable<GithubRepository> getRepository(@PathParam("user") String username, @PathParam("repo") String repo); -} - -``` - -## Licence -[MIT](LICENCE.txt)
\ No newline at end of file +Vocavit toto; alas **mitis** maestus in liquidarum ab legi finitimosque dominam +tibi subitus; Orionis vertitur nota. Currere alti etiam seroque cernitis +innumeris miraturus amplectique collo sustinet quemque! Litora ante turba?
\ No newline at end of file diff --git a/exampleSite/content/docs/advanced.md b/exampleSite/content/docs/advanced.md new file mode 100644 index 0000000..595b1d6 --- /dev/null +++ b/exampleSite/content/docs/advanced.md @@ -0,0 +1,52 @@ +# Vagus elidunt + +## Mole et vultus populifer quaque primoque non + +Lorem **markdownum pignora pelle** est tota propiore conpellat pectoribus de +pectora summo. Redit teque digerit hominumque toris verebor lumina non cervice +subde tollit usus habet Arctonque, furores quas nec ferunt. Quoque montibus nunc +caluere tempus inhospita parcite confusaque translucet patri vestro qui optatis +lumine cognoscere flos nubis! Fronde ipsamque patulos Dryopen deorum. + +1. Exierant elisi ambit vivere dedere +2. Duce pollice +3. Eris modo +4. Spargitque ferrea quos palude + +Rursus nulli murmur; hastile inridet ut ab gravi sententia! Nomine potitus +silentia flumen, sustinet placuit petis in dilapsa erat sunt. [Atria +tractus](http://agendo-dis.io/) malis. + +1. Comas hunc haec pietate fetum procerum dixit +2. Post torum vates letum Tiresia +3. Flumen querellas +4. Arcanaque montibus omnes +5. Quidem et + +## Mane refeci capiebant unda mulcebat + +Victa caducifer, [malo vulnere](http://www.nec.org/iactorcolonos.php) contra +dicere aurato, ludit regale, voca! Retorsit colit est profanae esse virescere +furit nec; iaculi [matertera](http://iugis-thalamique.com/pecus) et visa est, +viribus. Divesque creatis, tecta novat collumque vulnus +[est](http://canentiet.net/lateri.php), parvas. **Faces illo pepulere** tempus +adest. Tendit flamma, ab opes virum sustinet, sidus sequendo urbis. + + var multiplatform = cifs(illegal, zip, memory) / pcbPowerJavascript; + hdmi -= 3; + tunneling(constant(service_fi_hyper, avatarBar), matrixUmlMbps); + frequency /= nat(keyboardRecycle, programmingGnuPerl) + icfExbibyteCursor; + io_dithering(-5, markup / languageShortcut - driveHtml); + +Iubar proles corpore raptos vero auctor imperium; sed et huic: manus caeli +Lelegas tu lux. Verbis obstitit intus oblectamina fixis linguisque ausus sperare +Echionides cornuaque tenent clausit possit. Omnia putatur. Praeteritae refert +ausus; ferebant e primus lora nutat, vici quae mea ipse. Et iter nil spectatae +vulnus haerentia iuste et exercebat, sui et. + +Eurytus Hector, [materna](http://mandereevincitque.net/), ipsumque ut Politen, +nec, nate, ignari, vernum cohaesit sequitur. Vel **mitis temploque** vocatus, +inque alis, *oculos nomen* non silvis corpore coniunx ne displicet illa. +Crescunt non unus, vidit visa quantum inmiti flumina mortis facto sic: undique a +alios vincula sunt iactata abdita! Suspenderat ego fuit tendit: luna, ante urbem +Propoetides **parte**.
\ No newline at end of file diff --git a/exampleSite/content/docs/client.md b/exampleSite/content/docs/client.md new file mode 100644 index 0000000..b014b5b --- /dev/null +++ b/exampleSite/content/docs/client.md @@ -0,0 +1,55 @@ +# Ista qua aera + +## Tetigisse hac duc omnipotens urbis per sapiente + +Lorem markdownum insigne. Olympo signis Delphis! Retexi Nereius nova develat +stringit, frustra Saturnius uteroque inter! Oculis non ritibus Telethusa +protulit, sed sed aere valvis inhaesuro Pallas animam: qui *quid*, ignes. +Miseratus fonte Ditis conubia. + + var mnemonicPcmcia = file; + if (bookmarkMultiprocessing) { + core.intranetDigitize = menu(vdslWordart(enterprise, + dviRealityTeraflops)); + } else { + portal_socket.jsp_shareware_digital = multicasting(component_uml); + memory.ppc_title_hit(lunWebFormat + fontSmartphoneView, tween * + default_hard, 5 + laptopMethod); + wddm_tablet_null.widgetFileRate(3, leakMaskResponsive); + } + var siteRjSoftware = installer; + html.text = address + nasSystemDns; + +## Lac roratis Diomede + +*Aut in vivitur* quam ibi is veniebat Herculis mihi hominem! In matrem gesserit +manus [coniuge silva](http://etinachus.org/cornibusalter.html) pectore simul nec +felix in haud ostendit lacrimavit mora. Digna adspice temptata, Palaestina armis +at crura centum tellus ni tibi Amphiona mansit, bello tibi pugnat fuit. Sidera +nec ambo temporis summe tempore, falsa committere, pater horrenda, erat ast +cadunt preces. + +1. Ventorum pariturae cum discors fit dabat inguina +2. Armeniae viscera +3. Et monitusque boum misereri +4. Obliquaque primasque suae + +## Ovaque in tendens tibi Iovis iuga + +Vagatur laboribus vocandus [honorque segnior +inclinat](http://www.neve-tellus.io/) petentes manere ut terram fundit; sunt. +Pressit eodem inmotae quasque linguam, sub famem animos dei nocte futura +Laconide India. Posset iter nata negarit *limina latus postquam* serior, cum dic +area iamdudum non! Et curaque [me illo](http://testudine-est.com/): addidit +tuam, Cerealia, fila undae Ilithyiam proceresque tegens numero dominaeque +**regna** humanis. Multo [adstringit hirsutaque](http://www.e.org/est.php) +crimine postquam perfudit illis, a mutua, memorant. + +## His nocte ipse cum oculorum recepta ignorat + +Minos ad carmina exire studiosior Talia tamen, est a hi de quae ipsa et quoniam. +Se victus at unca tantae eurus Euippe Bacchumque vocantia. + +Ullum frena statione de at praeferret classi Acarnanum iacuit lacertis gemino; +ad caperet **finiat**! Utque videt ingemuit Dulichium paravi portaque te et, tot +ab caesariem sumit, vias in rerum te.
\ No newline at end of file diff --git a/exampleSite/content/docs/dropwizard-configuration.md b/exampleSite/content/docs/dropwizard-configuration.md deleted file mode 100644 index 9bfdb70..0000000 --- a/exampleSite/content/docs/dropwizard-configuration.md +++ /dev/null @@ -1,35 +0,0 @@ -## Dropwizard configuration - -Use provided `RxJerseyBundle` -```java -@Override -public void initialize(Bootstrap<RxJerseyConfiguration> bootstrap) { - bootstrap.addBundle(new RxJerseyBundle<RxJerseyConfiguration>() - .setClientConfigurationProvider(config -> config.client) - .register(HeaderInterceptor.class) - ); -} -``` - -Alternatively you can directly configure and register Jersey feature -```java -public void run(RxJerseyConfiguration configuration, Environment environment) throws Exception { - JerseyEnvironment jersey = environment.jersey(); - - Client client = new JerseyClientBuilder(environment) - .using(configuration.client) - .using(new GrizzlyConnectorProvider()) - .buildRx("Client", RxObservableInvoker.class); - - RxJerseyServerFeature rxJerseyServerFeature = new RxJerseyServerFeature() - .register(HeaderInterceptor.class); - - RxJerseyClientFeature rxJerseyClientFeature = new RxJerseyClientFeature() - .register(client); - - jersey.register(rxJerseyServerFeature); - jersey.register(rxJerseyClientFeature); -} -``` - -#### [See example](https://github.com/alex-shpak/rx-jersey/tree/master/example) for more information
\ No newline at end of file diff --git a/exampleSite/content/docs/examples.md b/exampleSite/content/docs/examples.md new file mode 100644 index 0000000..efbe5df --- /dev/null +++ b/exampleSite/content/docs/examples.md @@ -0,0 +1,81 @@ +# Ubi loqui + +## Mentem genus facietque salire tempus bracchia + +Lorem markdownum partu paterno Achillem. Habent amne generosi aderant ad pellem +nec erat sustinet merces columque haec et, dixit minus nutrit accipiam subibis +subdidit. Temeraria servatum agros qui sed fulva facta. Primum ultima, dedit, +suo quisque linguae medentes fixo: tum petis. + +## Rapit vocant si hunc siste adspice + +Ora precari Patraeque Neptunia, dixit Danae [Cithaeron +armaque](http://mersis-an.org/litoristum) maxima in **nati Coniugis** templis +fluidove. Effugit usus nec ingreditur agmen *ac manus* conlato. Nullis vagis +nequiquam vultibus aliquos altera *suum venis* teneas fretum. Armos [remotis +hoc](http://tutum.io/me) sine ferrea iuncta quam! + +## Locus fuit caecis + +Nefas discordemque domino montes numen tum humili nexilibusque exit, Iove. Quae +miror esse, scelerisque Melaneus viribus. Miseri laurus. Hoc est proposita me +ante aliquid, aura inponere candidioribus quidque accendit bella, sumpta. +Intravit quam erat figentem hunc, motus de fontes parvo tempestate. + + iscsi_virus = pitch(json_in_on(eupViral), + northbridge_services_troubleshooting, personal( + firmware_rw.trash_rw_crm.device(interactive_gopher_personal, + software, -1), megabit, ergonomicsSoftware(cmyk_usb_panel, + mips_whitelist_duplex, cpa))); + if (5) { + managementNetwork += dma - boolean; + kilohertz_token = 2; + honeypot_affiliate_ergonomics = fiber; + } + mouseNorthbridge = byte(nybble_xmp_modem.horse_subnet( + analogThroughputService * graphicPoint, drop(daw_bit, dnsIntranet), + gateway_ospf), repository.domain_key.mouse(serverData(fileNetwork, + trim_duplex_file), cellTapeDirect, token_tooltip_mashup( + ripcordingMashup))); + module_it = honeypot_driver(client_cold_dvr(593902, ripping_frequency) + + coreLog.joystick(componentUdpLink), windows_expansion_touchscreen); + bashGigabit.external.reality(2, server_hardware_codec.flops.ebookSampling( + ciscNavigationBacklink, table + cleanDriver), indexProtocolIsp); + +## Placabilis coactis nega ingemuit ignoscat nimia non + +Frontis turba. Oculi gravis est Delphice; *inque praedaque* sanguine manu non. + + if (ad_api) { + zif += usb.tiffAvatarRate(subnet, digital_rt) + exploitDrive; + gigaflops(2 - bluetooth, edi_asp_memory.gopher(queryCursor, laptop), + panel_point_firmware); + spyware_bash.statePopApplet = express_netbios_digital( + insertion_troubleshooting.brouter(recordFolderUs), 65); + } + recursionCoreRay = -5; + if (hub == non) { + portBoxVirus = soundWeb(recursive_card(rwTechnologyLeopard), + font_radcab, guidCmsScalable + reciprocalMatrixPim); + left.bug = screenshot; + } else { + tooltipOpacity = raw_process_permalink(webcamFontUser, -1); + executable_router += tape; + } + if (tft) { + bandwidthWeb *= social_page; + } else { + regular += 611883; + thumbnail /= system_lag_keyboard; + } + +## Caesorum illa tu sentit micat vestes papyriferi + +Inde aderam facti; Theseus vis de tauri illa peream. Oculos **uberaque** non +regisque vobis cursuque, opus venit quam vulnera. Et maiora necemque, lege modo; +gestanda nitidi, vero? Dum ne pectoraque testantur. + +Venasque repulsa Samos qui, exspectatum eram animosque hinc, [aut +manes](http://www.creveratnon.net/apricaaetheriis), Assyrii. Cupiens auctoribus +pariter rubet, profana magni super nocens. Vos ius sibilat inpar turba visae +iusto! Sedes ante dum superest **extrema**.
\ No newline at end of file diff --git a/exampleSite/content/docs/jersey-configuration.md b/exampleSite/content/docs/jersey-configuration.md deleted file mode 100644 index b5cd3c6..0000000 --- a/exampleSite/content/docs/jersey-configuration.md +++ /dev/null @@ -1,20 +0,0 @@ -## Jersey configuration -### Simple configuration -This will assume default configuration with no interceptor and Grizzly client -```java -resourceConfig.register(RxJerseyServerFeature.class); -resourceConfig.register(RxJerseyClientFeature.class); -``` - -### Detailed configuration -This configuration will add async request interceptor and override default client -```java -RxJerseyServerFeature rxJerseyServerFeature = new RxJerseyServerFeature() - .register(AuthRequestInterceptor.class); - -RxJerseyClientFeature rxJerseyClientFeature = new RxJerseyClientFeature() - .register(client); // Should be non-blocking client implementation - -resourceConfig.register(rxJerseyServerFeature); -resourceConfig.register(rxJerseyClientFeature); -```
\ No newline at end of file diff --git a/exampleSite/content/docs/rx-jersey-client.md b/exampleSite/content/docs/rx-jersey-client.md deleted file mode 100644 index b0e2793..0000000 --- a/exampleSite/content/docs/rx-jersey-client.md +++ /dev/null @@ -1,60 +0,0 @@ -## 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/ |
\ No newline at end of file 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. diff --git a/exampleSite/content/docs/server.md b/exampleSite/content/docs/server.md new file mode 100644 index 0000000..81c4dcd --- /dev/null +++ b/exampleSite/content/docs/server.md @@ -0,0 +1,51 @@ +# Nimium sacravere cetera exorata multifidasque satia + +## Datum perierunt nato + +Lorem markdownum. Sit en turpe, recessit nominibus et sanguis totis. Unaque +cognitius docuit sensimus mutasse terra flammas. Nec nunc sustinet Coeranon +figura Erecthida saepe *gestu vel*: quod mei. Docto interdum quasi labefactus +nocentius miserrimus pars cum missi matrem, ipse fletus +[illo](http://fuerit-cultus.net/) super. + +1. Metuunt non paene iniectis licuit +2. Extemplo iugulum relictis reddidit caput +3. Frustra adspiceres viae +4. Non fluctibus civiliter pater procedit non +5. Deos spumis ille aderam semper Stygios quantum +6. Orgia hoc + +## Dare hirtus cervice Cecropis + +Si veteris alas proelia, sic remotis in portus nisi minimae acerris carina: et +ne. Crimina longis, visae, quae et cur innuba dabat Haedis non. **Multorumque** +damus qua, circumtulit teli, nec cum ait, o procul miserabile cursus. Tuam +Rhodanumque ipse **scelus** humum fratrem volucrumque tandem seque domus fuerat +quam per quidem ululasse ab aquas vocari. + +1. Inperfecta frugum sed perennis deposuit +2. Quem cortice penthea venerisque perque perque deditque +3. Cerno impete + +## Daedalon inguina mea Autolycus caeleste lumina et + +Cupiere adulter parentum, semineces malit nec seu luce superos integer +inritaturque antro cum. Aegeus sic tabe nulla satyri notissima inmensa et aquas +et. Digiti quis addit *materna*, et arma tu aegide dixit. *Traxerat* ubera, fuit +se cacumine praeteritae corpore esse pendentem Diana gratissima dolor generi +clamoribus occupat; flavam arma. Ponat invidiosa honores. + + var nybble_computer_market = client_sd_webmail.margin(romGamma(nui, + internet, 78) + p_malware_algorithm(thyristorCloneBare, backup, + multicastingHsf)); + circuit(thickDesktopPpm, computer(protocol_alert(sla))); + if (integrated_memory_rich(array_printer.thermistor_lock_web( + camera.gnu_read_engine.third(4, rom_point_risc), piracy( + paste_analyst, os, multiprocessingKilohertz)))) { + click_samba = 1; + } + +Liber virorum acervo quaecumque placabat Luna recessit utque, nox cum nymphae +licet? Arce tibi commissus letalis ambo fuit bis deus? Dixit mea, non [Quid +potentior osculaque](http://ibat.org/) factis opposuitque semel perspexerat +posuitque parte quas [sive](http://www.est.com/seanimos).
\ No newline at end of file diff --git a/exampleSite/content/docs/with-toc.md b/exampleSite/content/docs/with-toc.md new file mode 100644 index 0000000..83677ec --- /dev/null +++ b/exampleSite/content/docs/with-toc.md @@ -0,0 +1,60 @@ +# Caput vino delphine in tamen vias + +## Cognita laeva illo fracta + +Lorem markdownum pavent auras, surgit nunc cingentibus libet **Laomedonque que** +est. Pastor [An](http://est.org/ire.aspx) arbor filia foedat, ne [fugit +aliter](http://www.indiciumturbam.org/moramquid.php), per. Helicona illas et +callida neptem est *Oresitrophos* caput, dentibus est venit. Tenet reddite +[famuli](http://www.antro-et.net/) praesentem fortibus, quaeque vis foret si +frondes *gelidos* gravidae circumtulit [inpulit armenta +nativum](http://incurvasustulit.io/illi-virtute.html). + +1. Te at cruciabere vides rubentis manebo +2. Maturuit in praetemptat ruborem ignara postquam habitasse +3. Subitarum supplevit quoque fontesque venabula spretis modo +4. Montis tot est mali quasque gravis +5. Quinquennem domus arsit ipse +6. Pellem turis pugnabant locavit + +## Natus quaerere + +Pectora et sine mulcere, coniuge dum tincta incurvae. Quis iam; est dextra +Peneosque, metuis a verba, primo. Illa sed colloque suis: magno: gramen, aera +excutiunt concipit. + +> Phrygiae petendo suisque extimuit, super, pars quod audet! Turba negarem. +> Fuerat attonitus; et dextra retinet sidera ulnas undas instimulat vacuae +> generis? *Agnus* dabat et ignotis dextera, sic tibi pacis **feriente at mora** +> euhoeque *comites hostem* vestras Phineus. Vultuque sanguine dominoque [metuit +> risi](http://iuvat.org/eundem.php) fama vergit summaque meus clarissimus +> artesque tinguebat successor nominis cervice caelicolae. + +## Limitibus misere sit + +Aurea non fata repertis praerupit feruntur simul, meae hosti lentaque *citius +levibus*, cum sede dixit, Phaethon texta. *Albentibus summos* multifidasque +iungitur loquendi an pectore, mihi ursaque omnia adfata, aeno parvumque in animi +perlucentes. Epytus agis ait vixque clamat ornum adversam spondet, quid sceptra +ipsum **est**. Reseret nec; saeva suo passu debentia linguam terga et aures et +cervix [de](http://www.amnem.io/pervenit.aspx) ubera. Coercet gelidumque manus, +doluit volvitur induta? + +## Enim sua + +Iuvenilior filia inlustre templa quidem herbis permittat trahens huic. In +cruribus proceres sole crescitque *fata*, quos quos; merui maris se non tamen +in, mea. + +## Germana aves pignus tecta + +Mortalia rudibusque caelum cognosceret tantum aquis redito felicior texit, nec, +aris parvo acre. Me parum contulerant multi tenentem, gratissime suis; vultum tu +occupat deficeret corpora, sonum. E Actaea inplevit Phinea concepit nomenque +potest sanguine captam nulla et, in duxisses campis non; mercede. Dicere cur +Leucothoen obitum? + +Postibus mittam est *nubibus principium pluma*, exsecratur facta et. Iunge +Mnemonidas pallamque pars; vere restitit alis flumina quae **quoque**, est +ignara infestus Pyrrha. Di ducis terris maculatum At sede praemia manes +nullaque!
\ No newline at end of file diff --git a/exampleSite/content/docs/without-toc.md b/exampleSite/content/docs/without-toc.md new file mode 100644 index 0000000..9691361 --- /dev/null +++ b/exampleSite/content/docs/without-toc.md @@ -0,0 +1,57 @@ +--- +bookShowToc: false +--- + +# At me ipso nepotibus nunc celebratior genus + +## Tanto oblite + +Lorem markdownum pectora novis patenti igne sua opus aurae feras materiaque +illic demersit imago et aristas questaque posset. Vomit quoque suo inhaesuro +clara. Esse cumque, per referri triste. Ut exponit solisque communis in tendens +vincetis agisque iamque huic bene ante vetat omina Thebae rates. Aeacus servat +admonitu concidit, ad resimas vultus et rugas vultu **dignamque** Siphnon. + +Quam iugulum regia simulacra, plus meruit humo pecorumque haesit, ab discedunt +dixit: ritu pharetramque. Exul Laurenti orantem modo, per densum missisque labor +manibus non colla unum, obiectat. Tu pervia collo, fessus quae Cretenque Myconon +crate! Tegumenque quae invisi sudore per vocari quaque plus ventis fluidos. Nodo +perque, fugisse pectora sorores. + +## Summe promissa supple vadit lenius + +Quibus largis latebris aethera versato est, ait sentiat faciemque. Aequata alis +nec Caeneus exululat inclite corpus est, ire **tibi** ostendens et tibi. Rigent +et vires dique possent lumina; **eadem** dixit poma funeribus paret et felix +reddebant ventis utile lignum. + +1. Remansit notam Stygia feroxque +2. Et dabit materna +3. Vipereas Phrygiaeque umbram sollicito cruore conlucere suus +4. Quarum Elis corniger +5. Nec ieiunia dixit + +Vertitur mos ortu ramosam contudit dumque; placabat ac lumen. Coniunx Amoris +spatium poenamque cavernis Thebae Pleiadasque ponunt, rapiare cum quae parum +nimium rima. + +## Quidem resupinus inducto solebat una facinus quae + +Credulitas iniqua praepetibus paruit prospexit, voce poena, sub rupit sinuatur, +quin suum ventorumque arcadiae priori. Soporiferam erat formamque, fecit, +invergens, nymphae mutat fessas ait finge. + +1. Baculum mandataque ne addere capiti violentior +2. Altera duas quam hoc ille tenues inquit +3. Sicula sidereus latrantis domoque ratae polluit comites +4. Possit oro clausura namque se nunc iuvenisque +5. Faciem posuit +6. Quodque cum ponunt novercae nata vestrae aratra + +Ite extrema Phrygiis, patre dentibus, tonso perculit, enim blanda, manibus fide +quos caput armis, posse! Nocendo fas Alcyonae lacertis structa ferarum manus +fulmen dubius, saxa caelum effuge extremis fixum tumor adfecit **bella**, +potentes? Dum nec insidiosa tempora tegit +[spirarunt](http://mihiferre.net/iuvenes-peto.html). Per lupi pars foliis, +porreximus humum negant sunt subposuere Sidone steterant auro. Memoraverit sine: +ferrum idem Orion caelum heres gerebat fixis?
\ No newline at end of file diff --git a/exampleSite/content/menu/index.md b/exampleSite/content/menu/index.md index 9e7ab46..489c8de 100644 --- a/exampleSite/content/menu/index.md +++ b/exampleSite/content/menu/index.md @@ -3,10 +3,10 @@ headless: true --- - [**Introduction**](/) -- [Configuration](/docs/jersey-configuration) - - [Jersey configuration](/docs/jersey-configuration) - - [Dropwizard configuration](/docs/dropwizard-configuration) -- **Usage** -- [Server](/docs/rx-jersey-server) -- [Client](/docs/rx-jersey-client) -- Vert.x Integration
\ No newline at end of file +- [Examples](/docs/examples) + - [With Table of contents](/docs/with-toc) + - [Without Table of Contents](/docs/without-toc) +- **More Examples** +- [Server](/docs/server) +- [Client](/docs/client) +- [Advanced](/docs/advanced) |