0
NUXEO PLATFORM
&

API

what is coming in the next releases ?
NUXEO PLATFORM
not only a Content Repository
provide tools to build Content Apps
Configuration Studio
API, SDK, Dev tools,...
BUILD MODERN WEB APPS
Back to the client side
Html 5 / JavaScript
Mobile Apps

Leverage Cloud promises
ECM as a service
Ea...
API

IS THE MAIN ENTRY POINT
API is a major focus for next FastTrack releases
NUXEO API CHALLENGES
expose Nuxeo Platform via http without losing our soul
BEING DYNAMIC
Services to expose depends on deployment option
+oklwevc +ovrinevc -eainevc
wrfoSrie cnesoSrie rltoSrie

Con...
BEING COMPOSABLE
"Pack" several services calls inside the same transaction
udtDc+vldtTs +gnrtPF
paeo
aiaeak
eeaeD

Fetch a...
AND ALSO
efficiently manage streams
bt[
ye]
=>ei
= vl
Mliat=>pi
utPr = an

manage authentication in an easy and pluggable ...
HOW WE BUILT THE AUTOMATION API
expose a dynamic http API
AUTOMATION REST ENDPOINT
Expose Nuxeo entities as REST resources
Documents, Users, Workflows, Tasks ...
CRUD via GET, PUT,...
REST ENDPOINT : GET DOCUMENT
GT/ue/p/1pt/eal-oanwrsae/STsNt HT/.
E nxoaiv/ahdfutdmi/okpcsW/etoe TP11
HT/. 20O
TP11 0 K
Cne...
AUTOMATION RPC : OPERATIONS ENDPOINT
Coarse grained API on top of Java API
each services can contribute Operations
Expose ...
OPERATIONS ENDPOINT
GT/ue/ieatmto/ouetPgPoie HT/.
E nxost/uoainDcmn.aervdr TP11
HT/. 20O
TP11 0 K
CnetTp:apiainjo
otn-ye p...
OPERATIONS ENDPOINT
PS /ue/ieatmto/ouetPgPoie HT/.
OT nxost/uoainDcmn.aervdr TP11
CnetTp:apiainjo+xeus
otn-ye plcto/snnrqe...
DYNAMIC DATA STRUCTURE
Fetch all needed data in one call
CONTROL MARSHALING
use header to control what schemas should be sent
XNDcmnPoete dbicr,cmo,fl
-Xouetrpris ulnoe omn ie

fe...
CONTROL MARSHALING
GT/ue/p/1pt/eal-oanwrsae/STsNt HT/.
E nxoaiv/ahdfutdmi/okpcsW/etoe TP11
<pnsye"otfml:mnsae"
sa tl=fn-ai...
FETCH EXTRA INFO
use R s C n r b t r fetch additional info (Mixins)
e t o t i u o to
urls, breadcrumb info, comments, rela...
FETCH REST CONTRIBUTIONS
GT/ue/p/1pt/eal-oanwrsae/STsNt HT/.
E nxoaiv/ahdfutdmi/okpcsW/etoe TP11
<pnsye"otfml:mnsae"
sa tl...
LEVERAGE ADAPTER SYSTEM
contribute custom logic
@eAatrnm =BAatrNM,
Wbdpe(ae
Odpe.AE
tp ="Oevc" treTp ="ouet)
ye
BSrie, agt...
FETCH AUDIT RECORDS VIA ADAPTER

GT/ue/p/1pt/oanwrsae/Snt/fn clr"6a4"@ui<fn>HT
E nxoaiv/ahdmi/okpcsW/oe<ot oo=#a8f>adt/ot ...
COMPOSABLE API
Expose the API that matches your needs
AUTOMATION CHAINS
Operations have Input / Output and Arguments
Operations can be chained on the service side
one call , on...
COMPOSE CHAIN
via XML / via Drag&Drop
OPERATIONS AND RESOURCES
Bridge Operations and Resource Endpoints
"pipe Operation or Chain" on resource
fthrsuc = fe Oeain...
OPERATIONS AND EXTENSIONS
Contribute new Operations via Extension Point
Contribute new Adapters via Extension Point
Compos...
DYNAMIC AND COMPOSABLE API
Cool, but what is the trade-off
API IS MORE POWERFUL, BUT MORE COMPLEX
Data mapping needs to be dynamic
Calling dynamic endpoints is more complex than sta...
SOLUTION :
Provide introspection
methods and data types
Provide client lib
provides some data mapping
(document, blob)

pr...
MULE CLOUDHUB EXAMPLE
Leverage Java Lib service wrapper
Plug Mule DataSense with Nuxeo Types introspection
Mule fetches da...
DYNAMIC DATA MAPPING
ROADMAP & NEXT STEPS
when is it ready ?
NEXT STEPS : API
API improvements are part of 5.9.x FastTrack releases
REST EndPoints
RestContributors and changes in mars...
NEXT STEPS : CLOUD
nuxeo.io :

Nuxeo Platform as a Service
Codpoiinn +AI+oln IE
lu rvsoig
P
nie D

Scaling
Elastic Search ...
Q&A ?
Upcoming SlideShare
Loading in...5
×

[Webinar] An Hour with the CTO: All About APIs and the Nuxeo Platform

500

Published on

The Nuxeo Platform is based on a component architecture and extension points that allow you to extend and customize exposed services. The latest version of the platform (5.8) offers a set of resource-oriented REST APIs to support the development of content-centric applications. Learn what we did to create these new REST APIs and how you can use them in your own applications.
Spend an hour with Nuxeo CTO, Thierry Delprat as he talks specifics of the Nuxeo REST APIs. During this live webinar Thierry will:
Review the solutions used to make the REST APIs extensible and composable,
Discuss the challenges associated with a dynamic API.
When the REST API was designed, it was important to ensure it contained the same flexibility and richness available with the Java APIs. Be sure to join us to see exactly what we did to make this happen.
If you want to get a head-start, download the REST API package from the Nuxeo Marketplace, or read through the Nuxeo REST API documentation.

Published in: Technology
0 Comments
0 Likes
Statistics
Notes
  • Be the first to comment

  • Be the first to like this

No Downloads
Views
Total Views
500
On Slideshare
0
From Embeds
0
Number of Embeds
1
Actions
Shares
0
Downloads
8
Comments
0
Likes
0
Embeds 0
No embeds

No notes for slide

Transcript of "[Webinar] An Hour with the CTO: All About APIs and the Nuxeo Platform"

  1. 1. NUXEO PLATFORM & API what is coming in the next releases ?
  2. 2. NUXEO PLATFORM not only a Content Repository provide tools to build Content Apps Configuration Studio API, SDK, Dev tools, Test tools Packaging and deployment tools
  3. 3. BUILD MODERN WEB APPS Back to the client side Html 5 / JavaScript Mobile Apps Leverage Cloud promises ECM as a service Easy scaling these 2 trends are driving the Roadmap for 5.9.x fastracks
  4. 4. API IS THE MAIN ENTRY POINT API is a major focus for next FastTrack releases
  5. 5. NUXEO API CHALLENGES expose Nuxeo Platform via http without losing our soul
  6. 6. BEING DYNAMIC Services to expose depends on deployment option +oklwevc +ovrinevc -eainevc wrfoSrie cnesoSrie rltoSrie Contribute custom Services +yutmuiesevc mCsoBsnsSrie Data Structures (users, docs ...) depends on configuration { cmo :{.} omn .., dbicr :{.} ulnoe .., csoShm :{.} utmcea .., .. . }
  7. 7. BEING COMPOSABLE "Pack" several services calls inside the same transaction udtDc+vldtTs +gnrtPF paeo aiaeak eeaeD Fetch all required information in one call aggregate all required info dcatiue +ascae tss+ul o trbts soitd ak rs
  8. 8. AND ALSO efficiently manage streams bt[ ye] =>ei = vl Mliat=>pi utPr = an manage authentication in an easy and pluggable way be HTML/JavaScript friendly nwXLtpeus( e MHtRqet)
  9. 9. HOW WE BUILT THE AUTOMATION API expose a dynamic http API
  10. 10. AUTOMATION REST ENDPOINT Expose Nuxeo entities as REST resources Documents, Users, Workflows, Tasks ... CRUD via GET, PUT, POST, DELETE GT/ue/p/1pt/fn clr"6a4"{ah<fn>HT/. E nxoaiv/ah<ot oo=#a8f>pt}/ot TP11 GT/ue/p/1i/fn clr"6a4"{i}/ot HT/. E nxoaiv/d<ot oo=#a8f>ud<fn> TP11 GT/ue/p/1ue/fn clr"6a4"{srae<fn>HT/. E nxoaiv/sr<ot oo=#a8f>ueNm}/ot TP11 GT/ue/p/1gop<otclr"6a4"{ruI}/ot HT/. E nxoaiv/ru/fn oo=#a8f>gopd<fn> TP11
  11. 11. REST ENDPOINT : GET DOCUMENT GT/ue/p/1pt/eal-oanwrsae/STsNt HT/. E nxoaiv/ahdfutdmi/okpcsW/etoe TP11 HT/. 20O TP11 0 K CnetTp:apiainjo otn-ye plcto/sn { "niytp" "ouet, ett-ye: dcmn" "eoioy:"eal" rpstr" dfut, "i" "a98369-5591-781acc, ud: 639e-804f-c9b08491" "ah:"dfutdmi/okpcsW/etoe, pt" /eal-oanwrsae/STsNt" "ye:"oe, tp" Nt" "tt" "rjc" sae: poet, "esoLbl:"." vrinae" 00, "shceOt:tu, iCekdu" re "il" "etoe, tte: TsNt" "atoiid:"040-01:12.4" lsMdfe" 21-12T31:96Z, .. . }
  12. 12. AUTOMATION RPC : OPERATIONS ENDPOINT Coarse grained API on top of Java API each services can contribute Operations Expose endpoint for Operations GET to retrieve definition POST to execute
  13. 13. OPERATIONS ENDPOINT GT/ue/ieatmto/ouetPgPoie HT/. E nxost/uoainDcmn.aervdr TP11 HT/. 20O TP11 0 K CnetTp:apiainjo otn-ye plcto/sn i""ouetPgPoie" d:Dcmn.aervdr, "ae""aervdr, lbl:PgPoie" "ecito""efr aqey.., dsrpin:Prom ur ." "intr"["od,"ouet"] sgaue: vi" dcmns , "aas: prm"[ { "ae:pg" nm""ae, "ye:itgr, tp""nee" "eurd:as rqie"fle }{ , "ae:qey, nm""ur" "ye:srn" tp""tig, "eurd:as,} rqie"fle , ..] . }
  14. 14. OPERATIONS ENDPOINT PS /ue/ieatmto/ouetPgPoie HT/. OT nxost/uoainDcmn.aervdr TP11 CnetTp:apiainjo+xeus otn-ye plcto/snnrqet {"aas : prm" {"ur":"eet*fo Nt" qey slc rm oe, "ae :0 pg" } } HT/. 20O TP11 0 K CnetTp:apiainjo otn-ye plcto/sn { "niytp" "ouet" ett-ye: dcmns, "aene" 0 pgIdx: , "aeie:2 pgSz" , "aeon" 2 pgCut: , "nre" [ etis: { "niytp" "ouet, ett-ye: dcmn" "eoioy:"eal" rpstr" dfut, "i" "f645a7-5295-1a2bf4, ud: 37a1-d342-40d2f57b" .. . } {..,.. , .} . ] }
  15. 15. DYNAMIC DATA STRUCTURE Fetch all needed data in one call
  16. 16. CONTROL MARSHALING use header to control what schemas should be sent XNDcmnPoete dbicr,cmo,fl -Xouetrpris ulnoe omn ie fetch the data needed on the client side and nothing more GT/ue/p/1pt/eal-oanwrsae/STsNt HT/. E nxoaiv/ahdfutdmi/okpcsW/etoe TP11 <>-Xouetrprisnt,fls/> bXNDcmnPoete oe ie<b
  17. 17. CONTROL MARSHALING GT/ue/p/1pt/eal-oanwrsae/STsNt HT/. E nxoaiv/ahdfutdmi/okpcsW/etoe TP11 <pnsye"otfml:mnsae" sa tl=fn-aiy oopc;> <otclr"6a4"XNDcmnPoete nt,fls/ot fn oo=#a8f>-Xouetrpris oe ie<fn> <sa> /pn HT/. 20O TP11 0 K CnetTp:apiainjo otn-ye plcto/sn { "niytp" "ouet, ett-ye: dcmn" .. . <otclr"6a4""rpris:{ fn oo=#a8f>poete" "oemm_ye:"etxwbmrdw" nt:ietp" tx/-e-akon, "oent" "#el" nt:oe: #Hlo, "ie:ie" [ flsfls: { "ie:{ fl" "ae:"aotpg, nm" lyu.n" "ietp" "mg/n" mm-ye: iaepg, "egh:"32" lnt" 467, "aa:"ie/a98369-5591-781acc dt" fls639e-804f-c9b08491" }}]}../ot .<fn> }
  18. 18. FETCH EXTRA INFO use R s C n r b t r fetch additional info (Mixins) e t o t i u o to urls, breadcrumb info, comments, related documents ... use header to tell server what info is needed XNCnetCtgr bedrm -Xotx-aeoy racub GT/ue/p/1pt/eal-oanwrsae/STsNt HT/. E nxoaiv/ahdfutdmi/okpcsW/etoe TP11 XNCnetCtgr bedrm -Xotx-aeoy racub
  19. 19. FETCH REST CONTRIBUTIONS GT/ue/p/1pt/eal-oanwrsae/STsNt HT/. E nxoaiv/ahdfutdmi/okpcsW/etoe TP11 <pnsye"otfml:mnsae" sa tl=fn-aiy oopc;> <otclr"6a4"XNCnetCtgr bedrm<fn> fn oo=#a8f>-Xotx-aeoy racub/ot <sa> /pn HT/. 20O TP11 0 K CnetTp:apiainjo otn-ye plcto/sn { "niytp" "ouet, ett-ye: dcmn" .. . <otclr"6a4" "otxPrmtr" { fn oo=#a8f> cnetaaees: "racub:{ bedrm" "niytp" "ouet" ett-ye: dcmns, "nre" [ etis: { "niytp" "ouet, ett-ye: dcmn" "eoioy:"eal" rpstr" dfut, "ah:"dfutdmi" pt" /eal-oan, .. . } ..]}}/ot , . <fn> }
  20. 20. LEVERAGE ADAPTER SYSTEM contribute custom logic @eAatrnm =BAatrNM, Wbdpe(ae Odpe.AE tp ="Oevc" treTp ="ouet) ye BSrie, agtye Dcmn" @rdcs{"plcto/snnett") Poue( apiainjo+xniy} pbi casBAatretnsDfutdpe { ulc ls Odpe xed ealAatr expose as business object with custom marshaling GT/ue/p/1pt/oanwrsae/Snt/fn clr"6a4"@ui<fn>HT E nxoaiv/ahdmi/okpcsW/oe<ot oo=#a8f>adt/ot TP GT/ue/p/1pt/oanwrsae/Snt/fn clr"6a4"@oMB<fn>H E nxoaiv/ahdmi/okpcsW/oe<ot oo=#a8f>b/yO/ot T
  21. 21. FETCH AUDIT RECORDS VIA ADAPTER GT/ue/p/1pt/oanwrsae/Snt/fn clr"6a4"@ui<fn>HT E nxoaiv/ahdmi/okpcsW/oe<ot oo=#a8f>adt/ot TP HT/. 20O TP11 0 K CnetTp:apiainjo otn-ye plcto/sn { "niytp""fn clr"6a4"lgnre<fn>, ett-ye:<ot oo=#a8f>oEtis/ot" .. . "nre"[ etis: { "niytp""fn clr"6a4"lgnr<fn>, ett-ye:<ot oo=#a8f>oEty/ot" "rniaNm""dlrt, picplae:tepa" "oTp""oe, dcye:Nt" "vnI""ouetrae" eetd:dcmnCetd, "eoioyd:dfut, rpstrI""eal" "vnDt""040-21:85.9+10" eetae:21-11T65:5240:0, .. . } , <pnsye"otfml:mnsae"../pn<pnsye"otfml:mnsae"}/ sa tl=fn-aiy oopc;>.<sa>sa tl=fn-aiy oopc;><
  22. 22. COMPOSABLE API Expose the API that matches your needs
  23. 23. AUTOMATION CHAINS Operations have Input / Output and Arguments Operations can be chained on the service side one call , one transaction dc= udtDc o > paeo =dc= vldtTs (o)> aiaeak =dc= gnrtPF=Bo)> (o)> eeaeD (lb= Create new Operations via composition
  24. 24. COMPOSE CHAIN via XML / via Drag&Drop
  25. 25. OPERATIONS AND RESOURCES Bridge Operations and Resource Endpoints "pipe Operation or Chain" on resource fthrsuc = fe Oeaino Can ec eore > ed prto r hi PS /ue/p/1pt/oanwrsae/Snt/fn clr"6a4"@pBo.oD<f OT nxoaiv/ahdmi/okpcsW/oe<ot oo=#a8f>o/lbTPF/
  26. 26. OPERATIONS AND EXTENSIONS Contribute new Operations via Extension Point Contribute new Adapters via Extension Point Compose Operations via Workflow
  27. 27. DYNAMIC AND COMPOSABLE API Cool, but what is the trade-off
  28. 28. API IS MORE POWERFUL, BUT MORE COMPLEX Data mapping needs to be dynamic Calling dynamic endpoints is more complex than static API edon.noe"raeouet,{nu:..,prm:.} npitivk(cetDcmn" ipt . aas..) nxocetDcmn(ah nm,tp) ue.raeouetpt, ae ye
  29. 29. SOLUTION : Provide introspection methods and data types Provide client lib provides some data mapping (document, blob) provides a high level simple API (createDocument, addComment ...) does some checks (validate method definition) Java, Javascript, Python, Dart, Php, ObjectiveC ...
  30. 30. MULE CLOUDHUB EXAMPLE Leverage Java Lib service wrapper Plug Mule DataSense with Nuxeo Types introspection Mule fetches datatypes from Nuxeo Use invoke like pattern for dynamic Operations cannot dynamicaly build UI from Automation metadata
  31. 31. DYNAMIC DATA MAPPING
  32. 32. ROADMAP & NEXT STEPS when is it ready ?
  33. 33. NEXT STEPS : API API improvements are part of 5.9.x FastTrack releases REST EndPoints RestContributors and changes in marshaling SDK are in progress JavaScript Angular Dart iOs Android Sample Apps and playground
  34. 34. NEXT STEPS : CLOUD nuxeo.io : Nuxeo Platform as a Service Codpoiinn +AI+oln IE lu rvsoig P nie D Scaling Elastic Search integration NoSQL backend
  35. 35. Q&A ?
  1. A particular slide catching your eye?

    Clipping is a handy way to collect important slides you want to go back to later.

×