We use proprietary and third party's cookies to improve your experience and our services, identifying your Internet Browsing preferences on our website; develop analytic activities and display advertising based on your preferences. If you keep browsing, you accept its use. You can get more information on our Cookie Policy
Cookies Policy
Middleware Basic Open API Specification - FIWARE Forge Wiki

Middleware Basic Open API Specification

From FIWARE Forge Wiki

Jump to: navigation, search

Contents

Introduction

FI-WARE Middleware GE Basic API, is based on the Data Distribution Service (DDS) specifications, an OMG Standard defining the API and Protocol for high performance publish-subscribe middleware, and eProsima RPC over DDS, an Remote Procedure Call framework using DDS as the transport and based on the ongoing OMG RPC over DDS standard. For the data serialization the Common Data Serialization (CDR) is used, another standard from the OMG.

Introduction articles for these technologies are provided in the following links:

Intended Audience

This specification is intended for both software developers and reimplementers of this API. For the former, this document provides a full specification of how to use DDS and RPC for DDS (Doxygen API documentation). For the latter, this specification provides a full specification of how to comply with the corresponding OMG Standards.

Middleware GE Basic Open API Specifications

The Middleware Basic API are based on the Open Specifications of the OMG APIs and underlying protocols:

Note: OMG RPC over DDS Standard is a work in progress and several companies have submitted their proposals, including eProsima, one of the members of the middleware GE. The API of eProsima RPC over DDS is aligned with the eProsima proposed standard for RPC over DDS.

RPC over REST

The middleware GE is not a RESTful service, but a set of tools and libraries to interchange data between the different nodes of a distributed system. But, one of the FI-WARE middleware requirements is to offer backwards compatibility with Web Services, specifically RESTful Web Services.

RPC over REST enables the creation and the invocation of RESTful Web Services through the common Basic API used in RPC over DDS, and the future RPC over TCP, both part of the FI-WARE middleware suite.
This API ease the integration or migration of existing web services with the FI-WARE Middleware GE.
RPC over REST supports WADL (Web Application Definition Language) as the IDL to define RESTful Web Services.

eProsima RPC over REST Reference (Rev 0.3.0) - Doxygen (HTML) (PDF)

API Doxygen Documentation (C/C++)

The APIs for DDS and RPC over DDS are offered in many programming languages depending on the implementation. Middleware Basic API is defined C/C++ at this point and it will support other languages in the near future.

The corresponding Doxygen documentation of the APIs is available in the following links:

RPC over DDS

eProsima RPC over DDS API Reference (Rev 0.3.0) - Doxygen (HTML) (PDF)

DDS

The Middleware Basic API supports two different implementations of DDS, RTI DDS and openDDS:

CDR - FastBuffers

Fast Buffers is an implementation of the CDR serialization format. It generates serialization code from an IDL file. The API of the generated code is described in the following link:

eProsima Fast Buffers API Reference (Rev 0.3.0) - Doxygen (HTML) (PDF)

RPC over REST

RPC over REST allows to the creation and the invocation of RESTful Web Services through the common Basic API used in RPC over DDS, but using REST as the transport. The RPC over REST API is described in the following link:

eProsima RPC over REST Reference (Rev 0.3.0) - Doxygen (HTML) (PDF)

Personal tools
Create a book