-
Notifications
You must be signed in to change notification settings - Fork 140
[Doc] QBit and Vertx3 : Best of both worlds for Microservices
This feature allows you to create a service which can also serve up web pages and web resources for an app. Prior QBit has been more focused on just being a REST microservices, i.e., routing HTTP calls and WebSocket messages to Java methods. Rather then reinvent the world. QBit now supports Vertx 3.
The QBit support for Vertx 3 exceeds the support for Vertx 2.
QBit allows REST style support via annotations.
@RequestMapping(value = "/todo", method = RequestMethod.DELETE)
public void remove(final Callback<Boolean> callback,
final @RequestParam("id") String id) {
Todo remove = todoMap.remove(id);
callback.accept(remove!=null);
}
QBit, microservices lib, also provides integration with Consul, a typed event bus (which can be clustered), and really simplifies complex reactive async callback coordination between services, and a lot more. Please read through the QBit overview.
History: QBit at first only ran inside of Vertx2 . Then we decided to (client driven decision) to make it stand alone and we lost the ability to run it embedded (we did not need it for any project on the road map).
Now you can use QBit features and Vertx 3 features via a mix and match model. You do this by setting up routers and/or a route in Vertx 3 to route to an HttpServer in QBit, and this takes about 1 line of code.
This means we can use Vertx 3's chunking, streaming etc. for complex Http Support. As well as use Vertx 3 as a normal HttpServer, but when we want to use REST style, async callbacks we can use QBit for routing REST calls to Java methods. We can access all of the features of Vertx 3. (QBit was originally a Vertx 2 add-on lib, but then we had clients that wanted to run in standalone and clients who wanted to use it with Servlets / Embedded Jetty. This is more coming back home versus a new thing).
You can run QBit standalone and if you do, it uses Vertx 3 like a network lib, or you can run QBit inside of Vertx 3.
We moved this up for two reasons. We were going to start using Vertx support for DNS to read DNS entries for service discovery in a Heroku like environment. It made no sense to invest a lot of time using Vertx 2 API when we were switching to Vertx 3 in the short time. We also had some services that needed to deliver up an SPA (Single Page App), so we had to extend the support for Vertx anyway or add these features to QBit (which it sort of has but not really its focus so we would rather just delegate that to Vertx 3), and it made no sense to do that with Vertx 2.
Also the Vertx 3 environment is a very vibrant one with many shared philosophies to QBit.
Let's cover where the Vertx3 integration and QBit come in.
We added a new class called a VertxHttpServerBuilder
(extends HttpServerBuilder), which allows one to build a QBit HTTP server from a vertx
object, a vertx
HttpServer
and optionally from a Vertx router
or a Vertx route
.
Note that you can pass QBit HttpServerBuilder
or a QBit HttpServer
to a QBit EndpointServerBuilder
to use that builder instead or HttpServer instead of the default. VertxHttpServerBuilder
is a QBit HttpServerBuilder
so you construct it, associate it with vertx, and then inject it into EndpointServerBuilder
. This is how we integrate with the QBit REST/WebSocket support. If you are using QBit REST with Vertx, that is one integration point.
Also note that you can pass HttpServerBuilder
or a HttpServer
to a ManagedServiceBuilder
to use that builder instead or HttpServer
instead of the default. If you wanted to use QBit REST and QBit Swagger support with Vertx then you would want to use ManagedServiceBuilder with this class.
Read Vertx 3 guide on HTTP routing for more details.
Here are some docs taken from our JavaDocs for QBit VertxHttpServerBuilder
.
VertxHttpServerBuilder
also allows one to pass a shared Vertx object if running inside of the Vertx world. It also allows one to pass a shared vertx HttpServer
if you want to use more than just QBit routing. If you are using Vertx routing or you want to limit this QBit HttpServer
to one route then you can pass a route.
Note: QBits Vertx 2 support is EOL. We will be phasing it out shortly.
Here are some code examples on how to mix and match QBit and Vertx3.
HttpServer httpServer = VertxHttpServerBuilder.vertxHttpServerBuilder()
.setVertx(vertx).setHttpServer(httpServer).setRoute(route).build();
httpServer.start();
Creating a QBit HttpServer server and passing a router so it can register itself as the default route
Router router = Router.router(vertx); //Vertx router
Route route1 = router.route("/some/path/").handler(routingContext -> {
HttpServerResponse response = routingContext.response();
// enable chunked responses because we will be adding data as
// we execute over other handlers. This is only required once and
// only if several handlers do output.
response.setChunked(true);
response.write("route1\n");
// Call the next matching route after a 5 second delay
routingContext.vertx().setTimer(5000, tid -> routingContext.next());
});
//Now install our QBit Server to handle REST calls.
vertxHttpServerBuilder = VertxHttpServerBuilder.vertxHttpServerBuilder()
.setVertx(vertx).setHttpServer(httpServer).setRouter(router);
HttpServer httpServer = vertxHttpServerBuilder.build();
httpServer.start();
Note that you can pass HttpServerBuilder
or a HttpServer
to EndpointServerBuilder
to use that builder instead or HttpServer
instead of the default. If you are using QBit REST with Vertx, that is one integration point.
//Like before
vertxHttpServerBuilder = VertxHttpServerBuilder.vertxHttpServerBuilder()
.setVertx(vertx).setHttpServer(httpServer).setRouter(router);
//Now just inject it into the vertxHttpServerBuilder before you call build
HttpServer httpServer = vertxHttpServerBuilder.build();
endpointServerBuilder.setHttpServer(httpServer);
Also note that you can pass HttpServerBuilder
or a HttpServer
to a ManagedServiceBuilder
to use that builder instead or HttpServer instead of the default.
If you wanted to use QBit REST and QBit Swagger support with Vertx then you would want to use ManagedServiceBuilder
with this class.
//Like before
vertxHttpServerBuilder = VertxHttpServerBuilder.vertxHttpServerBuilder()
.setVertx(vertx).setHttpServer(httpServer).setRouter(router);
//Now just inject it into the vertxHttpServerBuilder before you call build
HttpServer httpServer = vertxHttpServerBuilder.build();
managedServiceBuilder.setHttpServer(httpServer);
Read Vertx guide on routing for more details Vertx Http Ext Manual.
##Where do we go from here
QBit has a health system, and a microservices stats collections system. Vertx 3 provided similar support. QBit has an event bus. Vertx has an event bus. There is no reason why QBit can't provide Vertx implementations of its event bus (this is how the QBit event bus started), or for that matter integrate with Vertx's health system or its stats collection system. QBit has its own service discovery system with implementations that talk to DNS, Consul, or just monitor JSON files to be updated (for Chef Push, or Consul, etcd pull model). There is no reason QBit could not provide an implementation of its Service Discovery that worked with Vertx's clustering support. All of the major internal services that QBit provides are extensible with plugins via interfaces. There is plenty of opportunity for more integration of QBit and Vertx.
QBit and Vertx have both evolved to provide more and more support for microservices and there is a lot of synergy between the two libs.
QBit can also play well with Servlets, Spring MVC, Spring Boot, and other lightweight HTTP libs. QBit comes batteries included.
QBit Website What is Microservices Architecture?
QBit Java Micorservices lib tutorials
The Java microservice lib. QBit is a reactive programming lib for building microservices - JSON, HTTP, WebSocket, and REST. QBit uses reactive programming to build elastic REST, and WebSockets based cloud friendly, web services. SOA evolved for mobile and cloud. ServiceDiscovery, Health, reactive StatService, events, Java idiomatic reactive programming for Microservices.
Reactive Programming, Java Microservices, Rick Hightower
Java Microservices Architecture
[Microservice Service Discovery with Consul] (http://www.mammatustech.com/Microservice-Service-Discovery-with-Consul)
Microservices Service Discovery Tutorial with Consul
[Reactive Microservices] (http://www.mammatustech.com/reactive-microservices)
[High Speed Microservices] (http://www.mammatustech.com/high-speed-microservices)
Reactive Microservices Tutorial, using the Reactor
QBit is mentioned in the Restlet blog
All code is written using JetBrains Idea - the best IDE ever!
Kafka training, Kafka consulting, Cassandra training, Cassandra consulting, Spark training, Spark consulting
Tutorials
- QBit tutorials
- Microservices Intro
- Microservice KPI Monitoring
- Microservice Batteries Included
- RESTful APIs
- QBit and Reakt Promises
- Resourceful REST
- Microservices Reactor
- Working with JSON maps and lists
__
Docs
Getting Started
- First REST Microservice
- REST Microservice Part 2
- ServiceQueue
- ServiceBundle
- ServiceEndpointServer
- REST with URI Params
- Simple Single Page App
Basics
- What is QBit?
- Detailed Overview of QBit
- High level overview
- Low-level HTTP and WebSocket
- Low level WebSocket
- HttpClient
- HTTP Request filter
- HTTP Proxy
- Queues and flushing
- Local Proxies
- ServiceQueue remote and local
- ManagedServiceBuilder, consul, StatsD, Swagger support
- Working with Service Pools
- Callback Builders
- Error Handling
- Health System
- Stats System
- Reactor callback coordination
- Early Service Examples
Concepts
REST
Callbacks and Reactor
Event Bus
Advanced
Integration
- Using QBit in Vert.x
- Reactor-Integrating with Cassandra
- Using QBit with Spring Boot
- SolrJ and service pools
- Swagger support
- MDC Support
- Reactive Streams
- Mesos, Docker, Heroku
- DNS SRV
QBit case studies
QBit 2 Roadmap
-- Related Projects
- QBit Reactive Microservices
- Reakt Reactive Java
- Reakt Guava Bridge
- QBit Extensions
- Reactive Microservices
Kafka training, Kafka consulting, Cassandra training, Cassandra consulting, Spark training, Spark consulting