Re: GSOC idea: json api for plone

On Mon, 2014-02-24 at 12:05 +0300, Christian Ledermann wrote:


> On Mon, Feb 24, 2014 at 11:49 AM, Jens W. Klein
> <jens-/[email protected]> wrote:
>         As said: json-ld is great, but it does not solve the problem
>         of a
>         Crud-Api. Who needs Linked Data compared to those in need of a
>         JSON-CRUD
>         API? I'd say latter has a majority.
>         
> 
> 
> Yes I agree. What I wanted to point out is that if the read interface
> could be in json-ld 
> it has additional benefits

i agree with Jens' critique on using JSON-LD for an JSON API in the
first place. we need a R/W JSON API first. a semantic API would be
great, but it's not what we really need now. but i'm interested in
investigating more on this topic. let's create a working group on this
and do a PLIP!


> 
> 
>  
>         There've been efforts to make plone.api available as a json
>         api
>         https://github.com/xiru/plone.api.json/network
>         
>         Also theres https://github.com/collective/collective.jsonify
>         around an
>         maybe more.
>         
>         IMO it would be a good start to make all plone.api calls
>         available as
>         json-rpc. Also (with some level of abstraction on
>         serialization/
>         deserialization) then it is easy to get at the same time an
>         xmlrpc api.
>         
>         The task to build a json-rpc plone.api is easy to understand
>         and
>         straight forward, so even for a Plone beginner doable.
>         
>         plone.api.json is probably a good starting point - except it
>         uses grok
>         and does not check security (as far as i can see).
>         
>         Then it can be extended to modify the content-objects in Plone
>         itself
>         and do what elose is needed in daily business.
>         
>         Jens
>         
>         On 2014-02-24 07:43, Christian Ledermann wrote:
>         > as I understand it json-ld is a kind of rdf over json
>         > http://en.wikipedia.org/wiki/JSON-LD
>         >
>         
>         > look at http://www.ohloh..net/p/eea-rdfmarshaller
>         > <http://www.ohloh.net/p/eea-rdfmarshaller> to get an idea
>         what this can
>         > achieve
>         > or live at http://iwlearn.net/iw-projects/970/@@rdf
>         >
>         >
>         > I think in connection with https://stanbol.apache.org/ and
>         > https://github.com/fusepool/fusepool-ecs
>         > this could be a story to get plone into the semantic linked
>         data space
>         >
>         >
>         >
>         > On Sun, Feb 23, 2014 at 3:49 AM, Laurence Rowe
>         <[email protected]
>         
>         > <mailto:[email protected]>> wrote:
>         >
>         >     I think the complexities you mention apply more to the
>         task of
>         >     extracting semantic likes from unstructured content
>         (e.g. from
>         >     within a Plone rich text field.) JSON-LD is about
>         semantically
>         >     annotating structured json, where everything is already
>         split into
>         >     fields. You just need to say what those fields mean and
>         which are
>         >     links to other resources (reference fields in Plone).
>         Basic support
>         >     should be trivial to implement as you could just
>         generate a json-ld
>         >     context from an existing dexterity schema definition.
>         >
>         >     You need to expend a significant amount of effort if you
>         want to
>         >     fully connect your metadata into the semantic web as you
>         need to use
>         >     terms and predicates that are also used by others. Plone
>         already has
>         >     partial support for dublin core metadata through the
>         default
>         >     templates rendering html link elements. You'd want a way
>         to specify
>         >     the predicate url on a dexterity schema field.
>         >
>         >     It's a read-only standard, so it's not going to help
>         with writes,
>         >     JSON-Shema seems to be the relevant standard there. But
>         even basic
>         >     support gives your users the ability to pull down your
>         metadata and
>         >     load it into a SPARQL store for arbitrary querying,
>         without writing
>         >     custom code to parse and load your json.
>         >
>         >     Laurence
>         >
>         >     On 22 February 2014 16:01, Jens W. Klein
>         >     <jens-/[email protected]
>         
>         >     <mailto:jens-/[email protected]>> wrote:
>         >
>         >         Hi,
>         >
>         >         I agree to have a json api for plone. This is
>         essential these days.
>         >
>         >         Ad json.ld:
>         >
>         >         json.ld is - as the name says - a linked data
>         format, thus it
>         >         predicts
>         >         semantic links between the content - in order to
>         make it semantic
>         >         searchable. So the main purpose of json-ld is (more
>         >         comprehensive, but
>         >         like RDF) to provide triples (subject, predicate,
>         object) about the
>         >         content, probably including all its information
>         prepared in this
>         >         way.
>         >
>         >         I fear in most cases this is difficult. To link data
>         in a sematic
>         >         approach we need to inspect this data (manually or
>         automatic) in
>         >         order
>         >         to enrich the links between the data. The Apache
>         Stanbol Project
>         >         helps
>         >         here to make this automatic, but I fear this is a
>          bit
>         >         heavyweight for
>         >         the average Plone "user".
>         >
>         >         So imo json-ld is not the right format for the
>         purpose of a
>         >         simple json
>         >         api. IMO a simple TTW crud API is what we want in
>         95% of cases.
>         >
>         >         I really would like to see Plone supporting json-ld
>         anyway. But
>         >         its out
>         >         of scope of a generic json-api which solves the
>         major daily
>         >         use-cases of
>         >         the Plone integrators there out in the wild.
>         >
>         >         just my 0.02 Euro
>         >
>         >         Jens
>         >
>         >         On 2014-02-14 22:25, Johannes Raggam wrote:
>         >          > After discussing this topic with other sprinters
>         at the
>         >         cathedralsprint,
>         >          > I think a JSON API for Plone would make a nice
>         project.
>         >          >
>         >          > Some of us feel a strong need for a generic JSON
>         API. That
>         >         can help us
>         >          > to build modern user interfaces, decoupled from
>         the backend
>         >         and for data
>         >          > exchange with other web services. Best would be
>         to implement some
>         >          > standard, like JSON-LD ( http://json-ld.org/ ,
>         
>         >          > http://www..w3.org/TR/json-ld/
>         >         <http://www.w3.org/TR/json-ld/> ), which'd give us
>         semantic data
>         >         exchange,
>         >          > which is awesome (more and more web services are
>         agnostic
>         >         about their
>         >          > data-backend and implement real mashup services).
>         Or Hydra:
>         >          > Hypermedia-Driven Web APIs
>         http://www.markus-lanthaler.com/hydra/
>         >          >
>         >          > I agree with Martin, that designing an API needs
>         much
>         >         experience. But I
>         >          > don't see here a blocker for a GSOC project:
>         >          >
>         >          > - There are open standards, which can be
>         implemented (as
>         >         mentioned
>         >          > above),
>         >          > - The mentor can guide, review and optimize the
>         API,
>         >          > - The framework can do this via reviews also.
>         >          >
>         >          > So, what about that?
>         >          >
>         >          > Best,
>         >          > Johannes
>         >
>         >         --
>         >         Klein & Partner KG, member of BlueDynamics Alliance
>         >
>         >
>         >
>         ------------------------------------------------------------------------------
>         >         Managing the Performance of Cloud-Based Applications
>         >         Take advantage of what the Cloud has to offer -
>         Avoid Common
>         >         Pitfalls.
>         >         Read the Whitepaper.
>         >
>         http://pubads.g.doubleclick.net/gampad/clk?id=121054471&iu=/4140/ostg.clktrk
>         >         _______________________________________________
>         >         Plone-developers mailing list
>         >         Plone-developers-5NWGOfrQmneRv+LV9MX5uipxlwaOVQ5f@public.gmane.org
>         
>         >         <mailto:Plone-developers-5NWGOfrQmneRv+LV9MX5uipxlwaOVQ5f@public.gmane.org>
>         >
>         https://lists.sourceforge.net/lists/listinfo/plone-developers
>         >
>         >
>         >
>         >
>         ------------------------------------------------------------------------------
>         >     Managing the Performance of Cloud-Based Applications
>         >     Take advantage of what the Cloud has to offer - Avoid
>         Common Pitfalls.
>         >     Read the Whitepaper.
>         >
>         http://pubads.g.doubleclick.net/gampad/clk?id=121054471&iu=/4140/ostg.clktrk
>         >     _______________________________________________
>         >     Plone-developers mailing list
>         >     Plone-developers-5NWGOfrQmneRv+LV9MX5uipxlwaOVQ5f@public.gmane.org
>         
>         >     <mailto:Plone-developers-5NWGOfrQmneRv+LV9MX5uipxlwaOVQ5f@public.gmane.org>
>         >
>         https://lists.sourceforge.net/lists/listinfo/plone-developers
>         >
>         >
>         >
>         >
>         > --
>         > Best Regards,
>         >
>         > Christian Ledermann
>         >
>         > Nairobi - Kenya
>         > Mobile : +254 702978914
>         >
>         > <*)))>{
>         >
>         > If you save the living environment, the biodiversity that we
>         have left,
>         > you will also automatically save the physical environment,
>         too. But If
>         > you only save the physical environment, you will ultimately
>         lose both.
>         >
>         > 1) Don’t drive species to extinction
>         >
>         > 2) Don’t destroy a habitat that species rely on.
>         >
>         > 3) Don’t change the climate in ways that will result in the
>         above.
>         >
>         > }<(((*>
>         >
>         >
>         
>         >
>         ------------------------------------------------------------------------------
>         > Flow-based real-time traffic analytics software. Cisco
>         certified tool.
>         > Monitor traffic, SLAs, QoS, Medianet, WAAS etc. with NetFlow
>         Analyzer
>         > Customize your own dashboards, set traffic alerts and
>         generate reports.
>         > Network behavioral analysis & security monitoring.
>         All-in-one tool.
>         >
>         http://pubads.g.doubleclick.net/gampad/clk?id=126839071&iu=/4140/ostg.clktrk
>         >
>         >
>         >
>         > _______________________________________________
>         > Plone-developers mailing list
>         > Plone-developers-5NWGOfrQmneRv+LV9MX5uipxlwaOVQ5f@public.gmane.org
>         >
>         https://lists.sourceforge.net/lists/listinfo/plone-developers
>         >
>         
>         
>         --
>         
>         Klein & Partner KG, member of BlueDynamics Alliance
>         
>         
>         ------------------------------------------------------------------------------
>         
>         Flow-based real-time traffic analytics software. Cisco
>         certified tool.
>         Monitor traffic, SLAs, QoS, Medianet, WAAS etc. with NetFlow
>         Analyzer
>         Customize your own dashboards, set traffic alerts and generate
>         reports.
>         Network behavioral analysis & security monitoring. All-in-one
>         tool.
>         http://pubads.g.doubleclick.net/gampad/clk?id=126839071&iu=/4140/ostg.clktrk
>         _______________________________________________
>         Plone-developers mailing list
>         Plone-developers-5NWGOfrQmneRv+LV9MX5uipxlwaOVQ5f@public.gmane.org
>         https://lists.sourceforge.net/lists/listinfo/plone-developers
>         
> 
> 
> 
> 
> -- 
> Best Regards,
> 
> Christian Ledermann
> 
> Nairobi - Kenya
> Mobile : +254 702978914
> 
> <*)))>{
> 
> If you save the living environment, the biodiversity that we have
> left,
> you will also automatically save the physical environment, too. But If
> you only save the physical environment, you will ultimately lose both.
> 
> 1) Don’t drive species to extinction
> 
> 2) Don’t destroy a habitat that species rely on.
> 
> 3) Don’t change the climate in ways that will result in the above.
> 
> }<(((*>
> ------------------------------------------------------------------------------
> Flow-based real-time traffic analytics software. Cisco certified tool.
> Monitor traffic, SLAs, QoS, Medianet, WAAS etc. with NetFlow Analyzer
> Customize your own dashboards, set traffic alerts and generate reports.
> Network behavioral analysis & security monitoring. All-in-one tool.
> http://pubads.g.doubleclick.net/gampad/clk?id=126839071&iu=/4140/ostg.clktrk
> _______________________________________________
> Plone-developers mailing list
> Plone-developers-5NWGOfrQmneRv+LV9MX5uipxlwaOVQ5f@public.gmane.org
> https://lists.sourceforge.net/lists/listinfo/plone-developers

-- 
programmatic  web development
di(fh) johannes raggam / thet
python plone zope development
plone framework  team  member
mail: office-//[email protected]
web:  http://programmatic.pro
      http://bluedynamics.com

------------------------------------------------------------------------------
Flow-based real-time traffic analytics software. Cisco certified tool.
Monitor traffic, SLAs, QoS, Medianet, WAAS etc. with NetFlow Analyzer
Customize your own dashboards, set traffic alerts and generate reports.
Network behavioral analysis & security monitoring. All-in-one tool.
http://pubads.g.doubleclick.net/gampad/clk?id=126839071&iu=/4140/ostg.clktrk

_______________________________________________
Plone-developers mailing list
Plone-developers-5NWGOfrQmneRv+LV9MX5uipxlwaOVQ5f@public.gmane.org
https://lists.sourceforge.net/lists/listinfo/plone-developers

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v2.0.22 (GNU/Linux)

iEYEABECAAYFAlMLHi0ACgkQW4mNMQxDgAeAoACgxY7F098cwgCxIiTqhn9m9561
4vIAoK9gmViO3k2JywAqGafHWHdZQCMu
=aDvr
-----END PGP SIGNATURE-----