Polyglot

Becoming a Polyglot
Simple API Engines in 5 Languages
Kirsten Hunter
@synedra
http://www.princesspolymath.com

Kirsten Hunter
@synedra
Introduction
Kirsten Hunter
Kirsten Hunter
@synedra

Kirsten Hunter
@synedra
The Challenge
Siloed Communities
Poor Understanding of
Language Differences
Fear of the Unknown
Exclusivity

Kirsten Hunter
@synedra
The Solution
• Simple API Project
• Mongo Backend
• Single Page Application Front End
• Identically functioning API Engines in 5
Languages

Kirsten Hunter
@synedra
Fortune Cookie
Server
Engines use data from
mongo db
Each engine presents
full API capability
* GET
* PUT
* POST
* DELETE
Github / Docker
synedra/polyglot
c9.io
python image
clone github repo

Kirsten Hunter
@synedra
Single Page Application

Kirsten Hunter
@synedra
Mongo Setup
load quoteid.jsonStartup mongo
/etc/init.d/mongodb start
{
"content": "Boredom: the
desire for desires.",
"index": 1998,
"author": "Leo Tolstoy"
},
mongoimport --collection quotes --file quoteid.json --type json
jsonArray

Kirsten Hunter
@synedra
Schema
Modeling
RAML
OpenAPI

Kirsten Hunter
@synedra
RAML 0.8
title: Fortune Cookie
version: V1
baseUri: http://www.fortunecookieserver.com/api/v1
/quotes:
displayName: Quotes
get:
description: Get a list of quotes
queryParameters:
random:
description: Retrieve a random quote
required: false
default: false
type: boolean
responses:
200:
body:
application/json:
example: |
[
{"content":"That which does not kill us makes us stronger.",
"author":"Sun Yi",
"id":1
}
]

Kirsten Hunter
@synedra
{
"swagger": "2.0",
"info": {
"title": "Fortune Cookie API",
"description": "Random quote of the day",
"version": "1.0.0"
},
"host": "api.fortunecookieserver.com",
"schemes": [
"http"
],
"basePath": "/v1",
"produces": [
"application/json"
],
"paths": {
"/quotes": {
"get": {
"summary": "Quotes",
"description": "This is a quote server.n",
"tags": [
"Quotes"
],
"responses": {
"200": {
"description": "An array of products",
"schema": {
"type": "array",
"items": {
"$ref": "#/definitions/Quote"
}
}
},

Kirsten Hunter
@synedra
PHP - Mongo Setup// Routes
$app->group('/api/quotes', function () {
// Setup DB connection
$mongo = new MongoClient('mongodb://localhost:27017');
$mongo->connect();
$db = $mongo->test;
$quotes = $db->selectCollection('quotes');
$this->get('', function (Request $request, Response $response, array $args) use ($quotes) {
$this->logger->info("Fetching 10 records…n");
$results = [];
foreach ($quotes->find([], ['_id' => 0])->sort(['index' => -1])->limit(10) as $quote) {
$results[] = $quote;
}
$response
->getBody()->write(json_encode($results, JSON_PRETTY_PRINT));
$newResponse = $response->withHeader(
'Content-type',
'application/json; charset=utf-8'
);
return $newResponse;
});

Kirsten Hunter
@synedra
PHP - Route// Routes
$app->group('/api/quotes', function () {
// Setup DB connection
$mongo = new MongoClient('mongodb://localhost:27017');
$mongo->connect();
$db = $mongo->test;
$quotes = $db->selectCollection('quotes');
$this->get('', function (Request $request, Response $response, array $args) use ($quotes) {
$this->logger->info("Fetching 10 records…n");
$results = [];
foreach ($quotes->find([], ['_id' => 0])->sort(['index' => -1])->limit(10) as $quote) {
$results[] = $quote;
}
$response
->getBody()->write(json_encode($results, JSON_PRETTY_PRINT));
$newResponse = $response->withHeader(
'Content-type',
'application/json; charset=utf-8'
);
return $newResponse;
});

Kirsten Hunter
@synedra
PHP - Static
$app->get('/', function(Request $request, Response $response, $args) {
return $response->getBody()->write('Hello World from PHP Slim');
});
$app->get('/demo', function(Request $request, Response $response, $args) {
$content = file_get_contents('../static/index.html');
return $response->getBody()->write($content);
});

Kirsten Hunter
@synedra
Perl - Mongo Setup
use Dancer;
use Dancer::Plugin::CRUD;
use MongoDB;
my $client = MongoDB->connect();
my $db = $client->get_database('test');
my $quotes = $db->get_collection('quotes');
my $json = JSON->new->allow_nonref;
set content_type => 'application/json';
get '/' => sub{
return {message => "Hello from Perl and Dancer"};
};
set public => path(dirname(__FILE__), '..', 'static');
get "/demo/?" => sub {
send_file '/index.html'
};
get '/api/quotes' => sub {
my $response = $quotes->find()->sort({'index' => -1})->limit(10);
my @results = ();
while(my $quote = $response->next) {
push (@results,
{"content" => $quote->{'content'},
"index" => $quote->{'index'},
"author" => $quote->{'author'}
}
);
}
if (! scalar (@results)) {
status 404;
return;
}
return @results;
};

Kirsten Hunter
@synedra
Perl - Static Files
use Dancer;
use Dancer::Plugin::CRUD;
use MongoDB;
my $client = MongoDB->connect();
my $db = $client->get_database('test');
my $quotes = $db->get_collection('quotes');
my $json = JSON->new->allow_nonref;
set content_type => 'application/json';
get '/' => sub{
return {message => "Hello from Perl and Dancer"};
};
set public => path(dirname(__FILE__), '..', 'static');
get "/demo/?" => sub {
send_file '/index.html'
};
my @results = ();
push (@results,
}
);
}
status 404;
return;
}
return @results;
};

Kirsten Hunter
@synedra
Perl - Routes
my @results = ();
push (@results,
}
);
}
status 404;
return;
}
return @results;
};

Kirsten Hunter
@synedra
Python - Mongo Setup
resp = Response(dumps(quotes, default=default),
mimetype='application/json')
return resp
def delete(self, quote_id):
print "Quote id is %s" % quote_id
try:
mongo.db.quotes.remove({
'index': int(quote_id)
})
except Exception as ve:
print ve
abort(400, str(ve))
return '', 204
def put(self, quote_id):
args = parser.parse_args()
if not (args['content'] or args['author']):
return 'Missing data', 400
existing_quote = mongo.db.quotes.find_one({"index": int(quote_id)})
args['content'] = args['content'] if args['content'] else existing_quote["content"]
args['author'] = args['author'] if args['author'] else existing_quote["author"]
try:
mongo.db.quotes.update({
'index': quote_id
},{
'$set': {
'content': args['content'],
'author': args['author']
}
}, upsert=False)
print ve
abort(400, str(ve))
return 201
# TodoList
# shows a list of all todos, and lets you POST to add new tasks
class QuoteList(Resource):
def get(self):
quotes = mongo.db.quotes.find().sort("index", -1).limit(10)
return resp

Kirsten Hunter
@synedra
Python - Static
return resp
…
@app.route('/')
def hello_world():
return 'Hello from Flask!'
@app.route('/demo')
def serve_page():
return send_from_directory(STATIC_ROOT, "index.html")
abort(400, str(ve))
return '', 204
def put(self, quote_id):
if not (args['content'] or args['author']):
return 'Missing data', 400
existing_quote = mongo.db.quotes.find_one({"index": int(quote_id)})
args['content'] = args['content'] if args['content'] else existing_quote["content"]
args['author'] = args['author'] if args['author'] else existing_quote["author"]
try:
mongo.db.quotes.update({
'index': quote_id
},{
'$set': {
'content': args['content'],
'author': args['author']
}
}, upsert=False)
print ve
abort(400, str(ve))
return 201
# TodoList
# shows a list of all todos, and lets you POST to add new tasks
def get(self):
return resp
def post(self):

Kirsten Hunter
@synedra
Python - Route
# shows a list of all quotes, and lets you POST to add new quotes
def get(self):
return resp
def post(self):
print quotes[0]
args["index"] = int(quotes[0]["index"]) + 1
print args
try:
mongo.db.quotes.insert(args)
except Error as ve:
abort(400, str(ve))
return 201
api.add_resource(QuoteList, '/api/quotes')
api.add_resource(Quote, '/api/quotes/<quote_id>')

Kirsten Hunter
@synedra
Ruby - Mongo Setup
end
get '/' do
content_type :html
"Hello World from Sinatra"
end
before do
content_type 'application/json'
end
namespace "/api" do
# list all
get '/quotes' do
Quote.all.desc(:index).limit(10).to_json
end
get '/quotes/random' do
newnumber = Quote.count
random_num = rand(newnumber)
quote = Quote.find_by(index: random_num.to_i)
return status 404 if quote.nil?
quote.to_json
end
# view one
get '/quotes/:index' do
quote = Quote.find_by(index: params[:index].to_i)
quote.to_json
end
# create
post '/quotes' do
newnumber = Quote.count + 1
@json = JSON.parse(request.body.read)
quote = Quote.new(
content: @json['content'],
author: @json['author'],
index: newnumber)
quote.save
newnumber.to_json
end
# update
put '/quotes/:index' do

Kirsten Hunter
@synedra
end
get '/' do
content_type :html
"Hello World from Sinatra"
end
before do
content_type 'application/json'
end
namespace "/api" do
# list all
get '/quotes' do
end
quote.to_json
end
# view one
quote.to_json
end
# create
post '/quotes' do
quote = Quote.new(
index: newnumber)
quote.save
newnumber.to_json
end
# update
Ruby - Static

Kirsten Hunter
@synedra
namespace "/api" do
# list all
get '/quotes' do
end
quote.to_json
end
# view one
quote.to_json
end
# create
post '/quotes' do
quote = Quote.new(
index: newnumber)
quote.save
newnumber.to_json
end
# update
quote.update(
author: @json['author']
)
quote.save
params[:index].to_json
end
Ruby - Route

Kirsten Hunter
@synedra
app.use('/api', router);
// REST API
router.route('/quotes/random')
.get(function(req, res, next) {
var random = Math.floor(Math.random() * quotecount);
Quote.findOne({"index":random},
function (err, result) {
if (err) {
console.log(err);
res.redirect('/quotes/random');
}
res.send(result);
})
});
router.route('/quotes')
var result = Quote.find().sort({'index': -1}).limit(10);
result.exec(function(err, quotes) {
res.send(quotes);
});
})
.post(function(req, res, next) {
if(!req.body.hasOwnProperty('content')) {
res.statusCode = 400;
return res.send('Error 400: Post syntax incorrect.');
}
quotecount = quotecount+1;
var newQuote;
if (req.body.hasOwnProperty('author')) {
newQuote = new Quote({'content': req.body.content, 'author': req.body.author, 'index': quotecount});
} else {
newQuote = new Quote({'content': req.body.content, 'index':quotecount});
}
newQuote.save(function (err, newQuote) {
if (err) return console.error(err);
res.json(quotecount);
});;
});
router.route('/quotes/:index')
Quote.findOne({"index":req.params.index},
res.send(result);
Node - Mongo Setup

Kirsten Hunter
@synedra
if (err) {
console.log(err);
}
res.send(result);
})
});
res.send(quotes);
});
})
}
var newQuote;
} else {
}
});;
});
res.send(result);
});
})
.put(function(req, res, next) {
if(!req.body.hasOwnProperty('content') && (!req.body.hasOwnProperty('author'))) {
}
var query = {'index':req.params.index};
Node - Express Static

Kirsten Hunter
@synedra
if (err) {
console.log(err);
}
res.send(result);
})
});
res.send(quotes);
});
})
}
var newQuote;
} else {
}
});;
});
res.send(result);
});
})
.put(function(req, res, next) {
if(!req.body.hasOwnProperty('content') && (!req.body.hasOwnProperty('author'))) {
}
var query = {'index':req.params.index};
Node - Express Routes

Kirsten Hunter
@synedra
Node - Hapi Static
server.route({
method : 'GET', path : '/demo/{path*}', handler : {
directory : {
path : '../static',
listing : false,
index : true
}}})});
server.route([
{
method: 'GET',
path: '/',
handler: function(request, reply) {
reply('Hello world from hapi');
}}]);

Kirsten Hunter
@synedra
Node - Hapi Routes
server.route([
{
method: 'GET',
path: '/api/quotes/random',
handler: function(request, reply) {
var random = Math.floor(Math.random() * quotecount);
Quote.findOne({"index":random},
reply(result);
})
}
},

Kirsten Hunter
@synedra
Questions?
Kirsten Hunter
@synedra

Polyglot

Recomendados

Recomendados

Mais conteúdo relacionado

Destaque

Destaque (20)

Mais de Kirsten Hunter

Mais de Kirsten Hunter (13)

Último

Último (20)

Polyglot