On Sun, Feb 7, 2021 at 6:10 PM Marc Le Bihan <mlebiha...@gmail.com> wrote:
> I think no tool or no part of Geoserver use the content of the yaml rest > config files at the moment. > Correct, they have been hand-written as a documentation effort during the 2017 code sprint <http://geoserver.org/behind%20the%20scenes/2017/01/23/geoserver-code-sprint-2017.html> . Generating a client was not a goal back then, it's still not today (they are not really being maintained all that much). There is also a separate issue that would need to be handled, that is, the REST representation changes as soon as one of the internal config objects (CatalogInfo implementers) changes, which happens every one and then, but without anyone ever caring to update the YAML files. The changes are always made so that new fields are not mandatory, in order to allow backwards compatibility with the old stored XML files. Nothing in REST needs to be touched, as the representations are build using a reflection like mechanism (XStream in particular), but a client written in a type safe language might have issues adapting. As far as I know, core devs are not generating clients, and my colleagues that are using the REST API do so using a hand-written python library, https://github.com/GeoNode/geoserver-restconfig I guess these clients are tolerant to representation changing, I believe having YAML files that can be used to generate clients from is a worthy goal, but we need more developers to get involved in the project and take care of that part, either by generating the yamls from code (to keep the aligned at all time), or trying to follow the developments as they happen. Aside, it's also a problem we have with the OGC APIs, the yaml service files are pieced together by hand and templated a bit to add a list of valid values, but no attempt is made to check if clients can be generated, and if they would actually work. And again, same deal as above, we need more people, or some sponsorship to figure out a yaml file generation from code, which would make it happen almost effortlessly. Best regards Andrea == GeoServer Professional Services from the experts! Visit http://goo.gl/it488V for more information. == Ing. Andrea Aime @geowolf Technical Lead GeoSolutions S.A.S. Via di Montramito 3/A 55054 Massarosa (LU) phone: +39 0584 962313 fax: +39 0584 1660272 mob: +39 339 8844549 http://www.geo-solutions.it http://twitter.com/geosolutions_it ------------------------------------------------------- *Con riferimento alla normativa sul trattamento dei dati personali (Reg. UE 2016/679 - Regolamento generale sulla protezione dei dati “GDPR”), si precisa che ogni circostanza inerente alla presente email (il suo contenuto, gli eventuali allegati, etc.) è un dato la cui conoscenza è riservata al/i solo/i destinatario/i indicati dallo scrivente. Se il messaggio Le è giunto per errore, è tenuta/o a cancellarlo, ogni altra operazione è illecita. Le sarei comunque grato se potesse darmene notizia. This email is intended only for the person or entity to which it is addressed and may contain information that is privileged, confidential or otherwise protected from disclosure. We remind that - as provided by European Regulation 2016/679 “GDPR” - copying, dissemination or use of this e-mail or the information herein by anyone other than the intended recipient is prohibited. If you have received this email by mistake, please notify us immediately by telephone or e-mail.*
_______________________________________________ Geoserver-devel mailing list Geoserver-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/geoserver-devel
