HNHacker News
TopNewBestAskShowJobs

seanpk8

1 karma · joined February 1, 2016

https://twitter.com/seanpk8
submissionscomments
seanpk8··on Show HN: BlueOak Server Maximizes the Value of Swagger API for Node.js Devs
I really like the "single source of truth" too.

How much does Ramses integrate with the data source "automatically"? Is it like StrongLoop/LoopBack?

We've found that for most of our projects we're not connecting directly to a database, but instead trying to present an (mobile or web) app-specific API that abstracts/unifies/focusses the many data sources and services that may be needed.

For example, one recent project involved data coming from some old SOAP services, new HTTP (but not exactly RESTful) endpoints, and several public APIs too.

seanpk8··on Show HN: BlueOak Server Maximizes the Value of Swagger API for Node.js Devs
You write your own handler and use the combination of the `operationId` field and an additional `x-handler` field to location your function. You can think of it like this: `pathHandler = require('${project-root}/handlers/${x-handler}').${operationId}`

The server provides dependency injection so that when you implement your handler-level function it can access several re-usable services to do the "real work". Generally my handlers are limited to getting the parameters off the request, passing them on to a (chain of) service(s) and getting the response back out to the client.

I hope the wiki has some good additional info if you're interested: https://github.com/blueoakjs/blueoak-server/wiki

seanpk8··on Show HN: BlueOak Server Maximizes the Value of Swagger API for Node.js Devs
Take a look at our newly released express.js-based, "swagger-matic", server runtime for Node.js.

BlueOak Server is "swagger-matic" because it maximizes the value of your Swagger API by using it to drive runtime behavior: It loads your Swagger API, connects the paths it defines to your implementation code, exposes that API to the network, and validates that every request is well-formed per that API.

We've got a lot of value from using it on our projects, and hope you will too, or, at least your criticism will help us make it better for us :-)

seanpk8··on Ask HN: What are some examples of great B2B landing pages?
I'm biased on this one: http://www.pointsource.com/sites/microsites/index.html#/insu...

... so it would also be interesting to have some feedback :-)