Hey all, I spent some time last week digging into OpenAPI and spiking out how it could be integrated into Solr. I came away very impressed. It opens a lot of really cool doors: auto-generated clients and docs, "Swagger UI", backcompat/api-breakage detection, etc. There's a LOT to gain.
Another takeaway from my spike though was that OpenAPI is much more "do-able" in JAX-RS projects. It's possible to create annotation-drive OpenAPI specs without JAX-RS, but it requires more explicit (and duplicative) documentation of each API's inputs and ouputs, which probably isn't maintainable in a project as large as ours. With that in mind, I'm planning on returning to the JAX-RS spike Eric and I did months back, and updating it to cover some of the issues this thread brought to light. In particular: security integration and serving collection/core-specific APIs. If that pans out, we can figure out next steps from there. (A SIP? A JIRA?) Before I start that effort though, I figured it'd be worth double-checking that there are no -1's/vetos on the idea sight-unseen? If so, let me know! Best, Jason On Fri, Jan 7, 2022 at 5:36 PM Eric Pugh <[email protected]> wrote: > > I wanted to share that our hack day did happen, but it went a bit sideways as > we spent the first half of the day experimenting with how to support CORS in > Solr. So API related, but not JAX-RS API specific. The second half of the > day got consumed by $dayjob. > > We’re going to pick it up again next month, and dig into trying out how > existing Solr security would work. > > https://github.com/gerlowskija/solr/tree/cors_stuff if you want to see. > > Eric > > > On Dec 9, 2021, at 10:06 AM, Eric Pugh <[email protected]> > wrote: > > Thank everyone for the input, it’s been a productive conversation! > > Jason and I are planning on another hack day Jan 7th to take some of the > feedback, and work more on how our spike can help meet some concerns/show > promise, so we’ll report back then! > > We’re planning on zooming during US East Coast hours, and I’ll drop the Zoom > invite in the ASF Slack for anyone who wants to join in and say hi! > > Eric > > > > On Dec 7, 2021, at 3:47 PM, Mark Miller <[email protected]> wrote: > > Two cents from the peanut gallery: > > I’ve looked at this before. My opinion: > > Our stuff was a just terrible, take your pick on the api version. Reasons are > numerous. > > Custom end points is an anti feature. Even worse for cloud. > > JAX-RS looked ridiculously sensible. > > > -- > - MRM > > > _______________________ > Eric Pugh | Founder & CEO | OpenSource Connections, LLC | 434.466.1467 | > http://www.opensourceconnections.com | My Free/Busy > Co-Author: Apache Solr Enterprise Search Server, 3rd Ed > This e-mail and all contents, including attachments, is considered to be > Company Confidential unless explicitly stated otherwise, regardless of > whether attachments are marked as such. > > > _______________________ > Eric Pugh | Founder & CEO | OpenSource Connections, LLC | 434.466.1467 | > http://www.opensourceconnections.com | My Free/Busy > Co-Author: Apache Solr Enterprise Search Server, 3rd Ed > This e-mail and all contents, including attachments, is considered to be > Company Confidential unless explicitly stated otherwise, regardless of > whether attachments are marked as such. > --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
