Hvilke REST-muligheder er der i Upgrade Pack 1
Min kollega Dennis har kigget lidt nærmere på hvad der er i "pakken" - Upgrade Pack 1 - når det gælder REST-tilgang til Dominodata.
Denne video er et godt udgangspunkt: Announcement: REST Services for Domino and XPages.
Der er også en mere uddybende dokumentation her: Extension Library REST Services.
Et kort ekstrakt fra disse er at der er tre måder at tilgå JSON/XML data i en Notes database:
1:Via det OSGi plugin som er installeret når man kører Domino 8.5.3 og har installeret Upgrade Pack 1.
Denne "service" er noget man enablet på sin server. Det foregår flere steder så det er ikke bare en checkbox.
Først og fremmest skal man slå dem til globalt på sit website dokument under "Domino Access services"
Samtidigt skal man i sin klient sætte INI variabler EnableDAS=1. Det giver nogle nye design egenskaber som skal benyttes.
Dete er bl.a. "Allow Domino Data service" på databasen sidste faneblad
Samt en ny egenskab på oversigterne "Allow Domino data services operation". Checkbox på oversigt egenskabernes næstsidste faneblad.
Derefter kan man tilgå data fra databasen som JSON data via <database>/api/data/<specifikke kommandoer>
2:Via Xpage Rest service som er en Xpage custom control
En kontrol der er tilgængelig når man har installeret Upgrade Pack 1. Kan f.eks. bindes til et view eller et dokument eller egen kode. Kan enten returnere JSON eller XML.
Kan ligeledes på enkel vis kobles op mod f.eks grid control'en så man får en data table repræsentation af sine data som kan redigeres og gemmes direkte ned i databasen.
Der ligger demo kode i den nye extension library database. Der er kommet en ny tab kaldet "REST" hvor man kan se fungerende kode eksempler
3: Gennem en "Custom database Servlet" som ikke er en egentlig servlet men en java klasse (servletFactory). Den bor i den pågældende database.
Nås via url'en <database>/xsp/services/<servletnavn>?<eventuelle parametre>
Man finder den ved at skifte til Java perspektiv. Går ned i Java/META-INF/services folderen. Her ligge en fil kaldet servletFactory hvori du skriver navnet på den klasse som er din "Servlet". Derefter lavet du dik java klasse som indeholder din kode. Den skal laves som en servletFactory som extender DefaultServletFactory.