Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/seanox/xml-micro-exchange-java

XML and XPath based volatile NoSQL stateless micro datasource for data exchange for web applications and IoT (implementation for Java)
https://github.com/seanox/xml-micro-exchange-java

acme cloud data-storage exchange java microservice nosql spring spring-boot web-api xml xpath xslt

Last synced: about 1 month ago
JSON representation

XML and XPath based volatile NoSQL stateless micro datasource for data exchange for web applications and IoT (implementation for Java)

Awesome Lists containing this project

README 

        


    

  

  




# Description

The origin of the project is the desire for an easily accessible place for data

exchange on the Internet. Inspired by JSON-Storages the idea of a feature-rich

equivalent based on XML, XPath and XSLT was born. The focus should be on a

public, volatile and short-term data exchange for (static) web-applications and

IoT.



__Just exchange data without an own server landscape.__  

__Just exchange data without knowing and managing all clients.__



XML-Micro-Exchange is a RESTful volatile NoSQL stateless micro datasource for

the Internet. It is designed for easy communication and data exchange of

web-applications and for IoT or for other Internet-based modules and 

components. The XML based datasource is volatile and lives through continuous

use and expires through inactivity. They are designed for active and near

real-time data exchange but not as a real-time capable long-term storage.

Compared to a JSON storage, this datasource supports more dynamics, partial

data access, data transformation, and volatile short-term storage. 



__Why all this?__



- Static web-applications on different clients want to communicate with each

other, e.g. for games, chats and collaboration.

- Smart sensors want to share their data and smart devices want to access this

data and also exchange data with each other.

- Clients can establish dynamically volatile networks.



__In this communication are all participants.__  

__No one is a server or master, all are equal and no one has to know the other.__  

__All meet without obligation.__



# Features

- __RESTful__  

  The REST API supports the HTTP methods OPTIONS, GET, POST, PUT, PATCH,

  DELETE.

- __XPath__  

  XPath axes and functions are used for access, navigation and addressing of

  targets in the data source and it is an integral part of the URI with dynamic

  and functional effects.

- __Multible axes and targets__  

  An XPath axis can address several elements and attributes simultaneously,

  which can be changed with one call.

- __XPath Functions__  

  PUT and PATCH support XML structures and static values (text), as well as

  XPath functions that allow dynamic values. 

- __Data Query__  

  Data can be queried in the form of XML structure or substructure if the XPath

  notation represents an axis, otherwise the XPath is interpreted as an XPath

  function and responded with the result as text. 

  Thus XPath provides a dynamic syntax for queries.

- __Data Transformation__  

  The POST method supports data transformation via XSLT. Similar to GET, data

  can be queried and then transformed with an XSLT template transmitted via

  POST.

- __JSON Support__  

  All requests can be responded by the service in JSON format.

- __Security__  

  This aspect was deliberately considered and implemented here only in a very

  rudimentary form. The storage(-key) with a length of 1 - 64 characters and

  the individual root element can be regarded as secret. In addition, HTTPS is

  supported but without client certificate authorization.

- __ACME Challenge Support__  

  Support of ACME HTTP-01 challenge for automated certificate management e.g.

  with [Let's Encrypt](https://letsencrypt.org/) +

  [Cerbot](https://certbot.eff.org/).

- __Containerization__  

  XML-Micro-Exchange is also available as a container image on Docker Hub:

  https://hub.docker.com/r/seanox/xmex



# Licence Agreement

LIZENZBEDINGUNGEN - Seanox Software Solutions ist ein Open-Source-Projekt, im

Folgenden Seanox Software Solutions oder kurz Seanox genannt.

 

Diese Software unterliegt der Version 2 der Apache License.



Copyright (C) 2024 Seanox Software Solutions



Licensed under the Apache License, Version 2.0 (the "License"); you may not use

this file except in compliance with the License. You may obtain a copy of the

License at



http://www.apache.org/licenses/LICENSE-2.0



Unless required by applicable law or agreed to in writing, software distributed

under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR

CONDITIONS OF ANY KIND, either express or implied. See the License for the

specific language governing permissions and limitations under the License.



# System Requirement

- Java 11 or higher



# Downloads

TODO:



# Docker Image

TODO:



# Free XML-Micro-Exchange

__Before using, you must read, understand and agree to__

__[Terms of Service](https://xmex.seanox.com/terms.html) and__

__[Privacy Policy](https://xmex.seanox.com/privacy.html).__



__Web site and documentation__  

[https://xmex.seanox.com/](https://xmex.seanox.com/)  



__Service Endpoint URL__  

[https://xmex.seanox.com/xmex!](https://xmex.seanox.com/xmex!)   

65536 Storages x 64 kB  

__Please do not get confused, the API is online.  

Requests without storage identifier (see [manual](manual/README.md#manual))

are responded with status 400.__  

See also [OpenAPI YAML](https://raw.githubusercontent.com/seanox/xml-micro-exchange/master/openapi/service.yaml)

or open [OpenAPI YAML in a GUI](https://editor.swagger.io/?url=https://raw.githubusercontent.com/seanox/xml-micro-exchange/master/openapi/service.yaml).



It is a small server (1 Core, 1 GB, 10 GB SSD) in a big data center -- but

apparently enough.  

__Sponsors are always welcome.__  

The project needs if possible more power.  

It costs about 5 Euro per month for 65536 x 1024 kB with double CPU cores and

double memory.



__Example Multiplayer Snake (Online)__  

https://xmex.seanox.com/snake.html



# Manual

* [Table Of Contents](https://github.com/seanox/xml-micro-exchange-java/blob/master/manual/README.md#manual)

* [Motivation](https://github.com/seanox/xml-micro-exchange-java/blob/master/manual/motivation.md)

* [Installation](https://github.com/seanox/xml-micro-exchange-java/blob/master/manual/installation.md)

  * [Windows](https://github.com/seanox/xml-micro-exchange-java/blob/master/manual/installation.md#windows)

  * [Windows Distribution](https://github.com/seanox/xml-micro-exchange-java/blob/master/manual/installation.md#windows-distribution)

  * [Linux](https://github.com/seanox/xml-micro-exchange-java/blob/master/manual/installation.md#linux)

  * [Container](https://github.com/seanox/xml-micro-exchange-java/blob/master/manual/installation.md#container)

* [Configuration](https://github.com/seanox/xml-micro-exchange-java/blob/master/manual/configuration.md)

* [Terms](https://github.com/seanox/xml-micro-exchange-java/blob/master/manual/terms.md)

* [Getting Started](https://github.com/seanox/xml-micro-exchange-java/blob/master/manual/getting-started.md)

* [API](https://github.com/seanox/xml-micro-exchange-java/blob/master/manual/api.md)

    * [DELETE](https://github.com/seanox/xml-micro-exchange-java/blob/master/manual/api-delete.md)

    * [GET](https://github.com/seanox/xml-micro-exchange-java/blob/master/manual/api-get.md)

    * [OPTIONS](https://github.com/seanox/xml-micro-exchange-java/blob/master/manual/api-options.md)

    * [PATCH](https://github.com/seanox/xml-micro-exchange-java/blob/master/manual/api-patch.md)

    * [POST](https://github.com/seanox/xml-micro-exchange-java/blob/master/manual/api-post.md)

    * [PUT](https://github.com/seanox/xml-micro-exchange-java/blob/master/manual/api-put.md)

* [Statistic](https://github.com/seanox/xml-micro-exchange-java/blob/master/manual/statistic.md)

* [Error Handling](https://github.com/seanox/xml-micro-exchange-java/blob/master/manual/error-handling.md)

* [Development](https://github.com/seanox/xml-micro-exchange-java/blob/master/manual/development.md)

* [Build](https://github.com/seanox/xml-micro-exchange-java/blob/master/manual/build.md)

* [Test](https://github.com/seanox/xml-micro-exchange-java/blob/master/manual/test.md)



# Changes 

TODO:



# Contact

[Issues](https://github.com/seanox/xml-online-storage/issues)  

[Requests](https://github.com/seanox/xml-online-storage/pulls)  

[Mail](https://seanox.com/contact)