[Fiware-webui] Fwd: [Fiware-ngsi] XML support removed from Orion Context Broker GEri in March sprint version

[Philipp Slusallek]

Hi,

This could be interesting to at least the POI and FIVES GE.


Best,

    Philipp


-------- Weitergeleitete Nachricht --------
Betreff: 	[Fiware-ngsi] XML support removed from Orion Context Broker
GEri in March sprint version
Datum: 	Wed, 3 Feb 2016 17:25:15 +0100
Von: 	Fermín Galán Márquez <fermin.galanmarquez at telefonica.com>
An: 	fiware-data at lists.fiware.org, fiware-iot at lists.fiware.org,
fiware-ngsi at lists.fiware.org



Hi,

XML support was deprecated in Orion Context Broker 0.23.0 (in summer
2015). This was motivated by the feedback gathered during years in many
FIWARE events with developers (Campus Party, Developers week, FIWARE
hackathons, etc.): it is a fact that developer community prefers JSON in
REST API instead of XML. In fact, the next version of NGSIv2 will be
entirely based on JSON.

Thus, maintaining both XML and JSON at the same time in the current API
is a severe burden in development and documentation tasks for the Orion
team, without an actual gain (in this sense, our rationale is very
similar to the one that lead JIRA to stop XML support, see
https://developer.atlassian.com/jiradev/jira-apis/jira-rest-apis/jira-rest-api-tutorials/jira-rest-api-version-2-tutorial#JIRARESTAPIVersion2Tutorial-IntroductiontoJIRA%27sRESTAPI).
Therefore, *we have decided to remove XML support from Orion Context
Broker in the near future*. The plan is that the version corresponding
to February sprint  (i.e. Orion 0.28.0) will be the last one supporting
XML, as has been recently announced to FIWARE Lab users (see attached
email). In other words, the version corresponding to March sprint will
not include XML support. JSON support (either NGSIv1 or NGSIv2) will remain.

We don't oversee any major issue in existing systems (clients,
notifications receivers, context providers, etc.) based in Orion
developed during the last year or even before (given that even before
XML was "official" deprecated in 0.23.0, we haven't talked about XML in
any public presentations/speech/workshops/etc. since time before, thus
developers working with Orion are mainly using JSON nowadays). The only
issue to take into account is with old legacy integrations. For these
cases, there are 3 options:

 1. Migrate client/receiver/cpr API to NGSIv2 JSON. Probably the best
    option if you want to take the most of the newer NGSIv2 API (e.g.
    subscription filters, etc.). However, note that NGSIv2 is yet in
    "beta" status, with some areas not fully specified and others in
    which small changes may occur.
 2. Migrate client/receiver/cpr API to NGSIv1 JSON. Probably, the best
    option by the time being from an stability and manteniability point
    of view. NGSIv1 JSON support will remain during a long time.
 3. Keep using the last Orion version supporting XML (Orion 0.28.0). Old
    versions will remain available (either in RPM and code source form)
    so you can keep using it (details are provided at
    https://github.com/telefonicaid/fiware-orion/blob/develop/doc/manuals/deprecated.md#using-old-orion-versions).
    However, note that doing this, you will be "stalled" at an old
    version and could be missing new and potentially useful
    functionality for your use case. Thus, this is recommend only as a
    temporal solution or for legacy system that doesn't need any
    functional evolution.

Note that this announce has been made 2 months in advance the first
Orion version without XML get released, which should be  enough time for
users still using XML to take decision on migration/keep (and, in the
former case, to schedule specific migration actions). Don't hesitate to
contact me if you are in this case and have specific questions/doubts
about it, e.g. how to migrate from XML to JSON specific API operations, etc.

Please, forward this message to whoever you think it may be interested.
Thanks!

Best regards,

------
Fermín

PD. This message is being sent to fiware-data due to Orion Context
Broker GE belongs to the Data chapter. It is also sent to fiware-ngsi
mailing list due to Orion is reference implementation for NGSI API.
Finally, it is also sent to fiware-iot as there are GEris in that
chapter (e.g IoT Broker) that integrate with Orion (note that I'm not a
member of the fiware-iot mailing list, so if you reply to this message
in that list, please include also my email in the reply).

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

Este mensaje y sus adjuntos se dirigen exclusivamente a su destinatario,
puede contener información privilegiada o confidencial y es para uso
exclusivo de la persona o entidad de destino. Si no es usted. el
destinatario indicado, queda notificado de que la lectura, utilización,
divulgación y/o copia sin autorización puede estar prohibida en virtud
de la legislación vigente. Si ha recibido este mensaje por error, le
rogamos que nos lo comunique inmediatamente por esta misma vía y
proceda a su destrucción.

The information contained in this transmission is privileged and
confidential information intended only for the use of the individual or
entity named above. If the reader of this message is not the intended
recipient, you are hereby notified that any dissemination, distribution
or copying of this communication is strictly prohibited. If you have
received this transmission in error, do not read it. Please immediately
reply to the sender that you have received this communication in error
and then delete it.

Esta mensagem e seus anexos se dirigem exclusivamente ao seu
destinatário, pode conter informação privilegiada ou confidencial e
é para uso exclusivo da pessoa ou entidade de destino. Se não é vossa
senhoria o destinatário indicado, fica notificado de que a leitura,
utilização, divulgação e/ou cópia sem autorização pode estar
proibida em virtude da legislação vigente. Se recebeu esta mensagem
por erro, rogamos-lhe que nos o comunique imediatamente por esta mesma
via e proceda a sua destruição

-- 

-------------------------------------------------------------------------
Deutsches Forschungszentrum für Künstliche Intelligenz (DFKI) GmbH
Trippstadter Strasse 122, D-67663 Kaiserslautern

Geschäftsführung: 
  Prof. Dr. Dr. h.c. mult. Wolfgang Wahlster (Vorsitzender)
  Dr. Walter Olthoff
Vorsitzender des Aufsichtsrats: 
  Prof. Dr. h.c. Hans A. Aukes

Sitz der Gesellschaft: Kaiserslautern (HRB 2313)
USt-Id.Nr.: DE 148646973, Steuernummer:  19/673/0060/3
---------------------------------------------------------------------------



-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.fiware.org/private/fiware-webui/attachments/20160203/5511c465/attachment.html>
-------------- next part --------------
An embedded message was scrubbed...
From: <no-reply at account.lab.fiware.org>
Subject: [FIWARE Lab] New Orion Context Broker Release (0.27.0)
Date: Mon, 1 Feb 2016 11:50:33 +0000
Size: 17609
URL: <https://lists.fiware.org/private/fiware-webui/attachments/20160203/5511c465/attachment.eml>
-------------- next part --------------
Since January 1st, old domains won't be supported and messages sent to any domain different to @lists.fiware.org will be lost.
Please, send your messages using the new domain (Fiware-ngsi at lists.fiware.org) instead of the old one.
_______________________________________________
Fiware-ngsi mailing list
Fiware-ngsi at lists.fiware.org
https://lists.fiware.org/listinfo/fiware-ngsi
-------------- next part --------------
A non-text attachment was scrubbed...
Name: philipp_slusallek.vcf
Type: text/x-vcard
Size: 441 bytes
Desc: not available
URL: <https://lists.fiware.org/private/fiware-webui/attachments/20160203/5511c465/attachment.vcf>