https://github.com/vlingo/xoom-http

The VLINGO XOOM platform SDK for Reactive, scalable, high-throughput, and resilient HTTP server supporting RESTful services running on XOOM LATTICE and XOOM ACTORS.
https://github.com/vlingo/xoom-http

actor-model actors http http-server http-services jvm jvm-languages reactive-programming restful

Last synced: 1 day ago
JSON representation

The VLINGO XOOM platform SDK for Reactive, scalable, high-throughput, and resilient HTTP server supporting RESTful services running on XOOM LATTICE and XOOM ACTORS.

• Host: GitHub
• URL: https://github.com/vlingo/xoom-http
• Owner: vlingo
• License: mpl-2.0
• Created: 2018-02-20T07:29:01.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2023-11-29T22:36:30.000Z (12 months ago)
• Last Synced: 2024-05-01T09:50:26.520Z (7 months ago)
• Topics: actor-model, actors, http, http-server, http-services, jvm, jvm-languages, reactive-programming, restful
• Language: Java
• Homepage: https://vlingo.io
• Size: 1.38 MB
• Stars: 51
• Watchers: 13
• Forks: 15
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

        
# xoom-http

[![Javadocs](http://javadoc.io/badge/io.vlingo.xoom/xoom-http.svg?color=brightgreen)](http://javadoc.io/doc/io.vlingo.xoom/xoom-http) [![Build](https://github.com/vlingo/xoom-http/workflows/Build/badge.svg)](https://github.com/vlingo/xoom-http/actions?query=workflow%3ABuild) [![Download](https://img.shields.io/maven-central/v/io.vlingo.xoom/xoom-http?label=maven)](https://search.maven.org/artifact/io.vlingo.xoom/xoom-http) [![Gitter chat](https://badges.gitter.im/gitterHQ/gitter.png)](https://gitter.im/vlingo-platform-java/http)

The VLINGO XOOM platform SDK Reactive, scalable, high-throughput, and resilient HTTP server supporting REST (RESTful) services running on XOOM LATTICE and XOOM ACTORS.

Docs: https://docs.vlingo.io/xoom-http

### Installation

```xml

  

    

      io.vlingo.xoom

      xoom-http

      1.11.1

      compile

    

  

```

```gradle

dependencies {

    compile 'io.vlingo.xoom:xoom-http:1.11.1'

}

```

### Usage

Reactive, scalable, and resilient HTTP servers and RESTful services running on XOOM LATTICE and XOOM ACTORS.

1. Feature complete

  * Fully actor-based asynchronous requests and responses.

  * Request handling is resource based.

  * Requests that require message body content are auto-mapped to simple Java objects.

  * Supports Media Types, Filters

  * Supports Server-Sent Events [See SSE on Wikipedia](https://en.wikipedia.org/wiki/Server-sent_events)

2. To run the Server:

  * [Use Server#startWith() to start the Server actor](https://github.com/vlingo/xoom-http/blob/master/src/main/java/io/vlingo/xoom/http/resource/Server.java)

  * The light-qualityFactor Server is meant to be run inside VLINGO XOOM Cluster nodes that require RESTful HTTP support.

3. See the following for usage examples:

  * [VLINGO XOOM Http properties file](https://github.com/vlingo/xoom-http/blob/master/src/test/resources/xoom-http.properties)

  * [The user resource sample](https://github.com/vlingo/xoom-http/blob/master/src/main/java/io/vlingo/xoom/http/sample/user/UserResource.java)

  * [The user profile resource sample](https://github.com/vlingo/xoom-http/blob/master/src/main/java/io/vlingo/xoom/http/sample/user/ProfileResource.java)

License (See LICENSE file for full license)

-------------------------------------------

Copyright © 2012-2023 VLINGO LABS. All rights reserved.

This Source Code Form is subject to the terms of the

Mozilla Public License, v. 2.0. If a copy of the MPL

was not distributed with this file, You can obtain

one at https://mozilla.org/MPL/2.0/.