Mailing-List: contact stanbol-dev-help@incubator.apache.org; run by ezmlm
Precedence: bulk
Reply-To: stanbol-dev@incubator.apache.org
Received-SPF: pass (nike.apache.org: domain of rupert.westenthaler@gmail.com
 designates 74.125.82.43 as permitted sender)
MIME-Version: 1.0
In-Reply-To: 
 <798CB1570E93D245815FC1545D41FBA2053B8094@Paperboy.lan.gossinteractive.com>
References: 
 <798CB1570E93D245815FC1545D41FBA2053B7FF3@Paperboy.lan.gossinteractive.com>
	<CAA7LAO1j3zWC_b_SA6x8fVA0EVpG_yz-9qJFxKeY1KqC1Y-c1Q@mail.gmail.com>
	<798CB1570E93D245815FC1545D41FBA2053B8094@Paperboy.lan.gossinteractive.com>
Date: Tue, 2 Aug 2011 13:48:35 +0200
Message-ID: 
 <CAA7LAO1dAaoxTwKic8Tg4Z7Xg8TLpoG=Fc_yTcjdH7C+m3e-Vg@mail.gmail.com>
Subject: Re: Delete, Update locally cached entities
From: Rupert Westenthaler <rupert.westenthaler@gmail.com>
To: stanbol-dev@incubator.apache.org
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: quoted-printable

On Tue, Aug 2, 2011 at 1:20 PM, Rohana Rajapakse
<Rohana.Rajapakse@gossinteractive.com> wrote:
> Hi,
>
> I was under the impression that the entityhub/entity can be used for mana=
ging local (cached) entities. I am confused with what this page/endpoint ht=
tp://localhost:8080/entityhub/entity says (page to get/create/update/delete=
 Entities Managed by the entity hub). Am I missing something here?
>

Yeas the entityhub/entity endpoint supports full CRUD. I was thinking
you talk about updating an entity locally cached for a referenced site
...

Here are some examples for the "entityhub/entity" service endpoint:

create all entities within the parsed RDF graph

curl -X POST -H "Content-Type: application/rdf+xml" --data
"@{rdfXmlFile}" http://localhost:8080/entityhub/entity

Note that Entities are created for all subjects used in triples of the
parsed RDF data. E.g. parsing a RDF file containing a SKOS thesaurus
should create Entities for all skos:Concept's and the
skos:ConcpetScheme.

If one only want to create a specific Entity (and ignore all other
triples) one needs to specify the ID of the Entity to create as
additional parameter.

curl -X POST -H "Content-Type: application/rdf+xml" --data
"@{rdfXmlFile}" http://localhost:8080/entityhub/entity?id=3D{entity-uri}

This will only create the Entity with the id {entity-uri} and ignore
all triples within the parsed {rdfXmlFile} that use an other URI as
subject.


Retrieval works the same as for referenced sites

curl http://localhost:8080/entityhub/entity?id=3D{entity-uri}


Update works the same way. Only use -X PUT instead of -X POST


To delete an Entity use

curl -X DELETE http://localhost:8080/entityhub/entity?id=3D{entity-id}


best
Rupert Westenthaler

>
> Rohana
>
> -----Original Message-----
> From: Rupert Westenthaler [mailto:rupert.westenthaler@gmail.com]
> Sent: 02 August 2011 11:06
> To: stanbol-dev@incubator.apache.org
> Subject: Re: Delete, Update locally cached entities
>
> Hi
>
> On Tue, Aug 2, 2011 at 10:42 AM, Rohana Rajapakse
> <Rohana.Rajapakse@gossinteractive.com> wrote:
>> How do you delete/update locally cached entities in Entityhub? Which
>> endpoint(s) can I use? Can someone pass me a sample CURL instructions
>> please.
>>
> ReferencedSites are read only. Via the RESTful interface there is no
> possibility to delete/update entities.
> Currently there is also no possibility to control the behavior of the
> local cache.
>
> The preferred way to provide this feature would be to use the HTTP
> Cache-Control headers [1] as described by [2].
> This would allow to update the local cache by adding the
> "Cache-Control: max-age=3D0" to a request.
>
> To support this one would also need to extend the interface of the
> ReferencedSite to allow to parse CacheControl parameters along with
> requests.
>
> If this would solve your issue I can create an JIRA issue for this new fe=
ature.
>
> best
> Rupert Westenthaler
>
> [1] http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.9
> [2] http://incubator.apache.org/stanbol/docs/trunk/entityhub/entityhuband=
linkeddata.html#cache-controlhttpwwww3orgprotocolsrfc2616rfc2616-sec14htmls=
ec149
>
>>
>>
>> Thanks
>>
>>
>>
>> Rohana
>>
>>
>>
>>
>> Sign-up for our monthly newsletter www.gossinteractive.com/newsletter
>>
>> Registered Office: c/o Bishop Fleming, Cobourg House, Mayflower Street, =
Plymouth, PL1 1LG. Company Registration No: 3553908
>>
>> This email contains proprietary information, some or all of which may be=
 legally privileged. It is for the intended recipient only. If an addressin=
g or transmission error has misdirected this email, please notify the autho=
r by replying to this email. If you are not the intended recipient you may =
not use, disclose, distribute, copy, print or rely on this email.
>>
>> Email transmission cannot be guaranteed to be secure or error free, as i=
nformation may be intercepted, corrupted, lost, destroyed, arrive late or i=
ncomplete or contain viruses. This email and any files attached to it have =
been checked with virus detection software before transmission. You should =
nonetheless carry out your own virus check before opening any attachment. G=
OSS Interactive Ltd accepts no liability for any loss or damage that may be=
 caused by software viruses.
>>
>> wn virus check before opening any attachment. GOSS Interactive Ltd accep=
ts no liability for any loss or damage that may be caused by software virus=
es.
>>
>>
>>
>>
>
>
>
> --
> | Rupert Westenthaler=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0=C2=A0 rupe=
rt.westenthaler@gmail.com
> | Bodenlehenstra=C3=9Fe 11=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=
=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0=C2=A0 ++43-699-1110890=
7
> | A-5500 Bischofshofen
>


--=20
| Rupert Westenthaler=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0=C2=A0 rupert=
.westenthaler@gmail.com
| Bodenlehenstra=C3=9Fe 11=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =
=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0=C2=A0 ++43-699-11108907
| A-5500 Bischofshofen