Programming with JenaBean

1. Programming with JenaBean Sources for examples can be found @ http://jenabean.googlecode.com/svn/jenabean-lab1 Taylor Cowan Travelocity 8982

2. [] a foaf:Person; • foaf:name Taylor Cowan; • foaf:weblog <http://thewebsemantic.com>; • foaf:workplaceHomepage <http://www.travelocity.com>; • foaf:holdsAccount <http://twitter.com/tcowan>; • foaf:currentProject <http://jenabean.googlecode.com>; • foaf:currentProject <http://geosparql.googlecode.com>; • foaf:currentProject <http://jo4neo.googlecode.com>;

3. Model m = ModelFactory.createDefaultModel(); Thing todaysTopic = new Thing("http://jenabean.googlecode.com", m); new Thing(m).isa(Foaf.Person.class) .name("Taylor Cowan") .weblog(URI.create("http://thewebsemantic.com")) .holdsAccount(URI.create("http://twitter.com/tcowan")) .currentProject(todaysTopic) .currentProject(URI.create("http://jo4neo.googlecode.com")); @see Card.java in package example.fluentwriter

4. AGENDA • Semantic Web Introduction • RDF basics • Coding Towards Jena’s Semantic Web Framework API • Java to Model Binding with JenaBean • Java to Model Binding with Fluent Interfaces

5. Why Not Microformats? • <xsl:choose> • <xsl:when test="(false() = not((.//*[not(ancestor-or-self::*[local-name() = 'del']) = true() and contains(concat(' ',normalize-space(@class),' '),' fn ') and (local-name() = 'img' or local-name() = 'area')]/@alt) and (string-length(normalize-space(.//*[not(ancestor-or-self::*[local-name() = 'del']) = true() and contains(concat(' ',normalize-space(@class),' '),' fn ') and (local-name() = 'img' or local-name() = 'area')]/@alt)) = string-length(translate(normalize-space(.//*[not(ancestor-or-self::*[local-name() = 'del']) = true() and contains(concat(' ',normalize-space(@class),' '),' fn ') and (local-name() = 'img' or local-name() = 'area')]/@alt),' ',''))))) or (false() = not((.//*[not(ancestor-or-self::*[local-name() = 'del']) = true() and contains(concat(' ',normalize-space(@class),' '),' fn ') and (local-name() = 'abbr')]/@title) and (string-length(normalize-space(.//*[not(ancestor-or-self::*[local-name() = 'del']) = true() and contains(concat(' ',normalize-space(@class),' '),' fn ') and (local-name() = 'abbr')]/@title)) = string-length(translate(normalize-space(.//*[not(ancestor-or-self::*[local-name() = 'del']) = true() and contains(concat(' ',normalize-space(@class),' '),' fn ') and (local-name() = 'abbr')]/@title),' ',''))))) or (false() = not((.//*[not(ancestor-or-self::*[local-name() = 'del']) = true() and contains(concat(' ',normalize-space(@class),' '),' fn ') and not(local-name() = 'abbr' or local-name() = 'img')]) and (string-length(normalize-space(.//*[not(ancestor-or-self::*[local-name() = 'del']) = true() and contains(concat(' ',normalize-space(@class),' '),' fn ') and not(local-name() = 'abbr' or local-name() = 'img' or local-name() = 'area')][1])) = string-length(translate(normalize-space(.//*[not(ancestor-or-self::*[local-name() = 'del']) = true() and contains(concat(' ',normalize-space(@class),' '),' fn ') and not(local-name() = 'abbr' or local-name() = 'img')][1]),' ','')))))"> http://suda.co.uk/projects/microformats/hcard/xhtml2vcard.xsl

6. Some example foaf: <http://www.ibm.com/developerworks/xml/library/j-jena/> a dc:Article ; dc:creator "Philip McCarthy"^^xsd:string ; dc:subject "jena, rdf, java, semantic web"^^xsd:string ; dc:title "Introduction to Jena"^^xsd:string .

7. Equivalent Raw Jena API Client Code • String NS = "http://purl.org/dc/elements/1.1/"; • OntModel m = ModelFactory.createOntologyModel(); • OntClassarticleCls = m.createClass(NS +"Article"); • Individual i = articleCls.createIndividual( • "http://www.ibm.com/developerworks/xml/library/j-jena/"); • Property title = m.getProperty(NS + "title"); • Literal l = m.createTypedLiteral("Introduction to Jena"); • i.setPropertyValue(title,l); • Property creator = m.getProperty(NS + "creator"); • l = m.createTypedLiteral("Philip McCarthy"); • i.setPropertyValue(creator,l); • Property subject = m.getProperty(NS + "subject"); • l = m.createTypedLiteral("jena, rdf, java, semantic web"); • i.setPropertyValue(subject,l); • m.write(System.out, "N3");

8. You need to create unique URI’s for every entity. You must specify the type of each primitive value. Properties must be created for each bean property. The impedance mismatch is similar to what we had with RDBMS Pain Points of Raw Jena API Programming

9. Creating The Same Assertions with JenaBean • Model m = ModelFactory.createDefaultModel(); • Bean2RDF writer = new Bean2RDF(m); • Article article = new Article( • "http://www.ibm.com/developerworks/xml/library/j-jena/"); • article.setCreator("Philip McCarthy"); • article.setTitle("Introduction to Jena"); • article.setSubject("jena, rdf, java, semantic web"); • writer.save(article); • m.write(System.out, "N3");

10. The JenaBean Project • Hosted at Google code • Bean binding, not code generation • Doesn’t use byte code interweaving • Doesn’t require implementing an interface • http://jenabean.googlecode.com

11. Programming with JenaBean is Simple • Bean2RDF writes objects • RDF2Bean reads objects • 3 Annotations • @Idspecifies unique field • @Namespaceprovides a domain • @RdfProperty maps java properties to RDF properties

12. The Simplest Possible Example • packageexamples.model; • importthewebsemantic.Id; • publicclass Person { • @Id • private String email; • public String getEmail() { returnemail;} • publicvoidsetEmail(String email) { • this.email = email;} • } <http://examples.model/Person> a <http://www.w3.org/2000/01/rdf-schema#Class> ; <http://thewebsemantic.com/javaclass> "examples.model.Person" . <http://examples.model/Person/thewebsemantic@gmail.com> a <http://examples.model/Person> ; <http://examples.model/email> "thewebsemantic@gmail.com"^^xsd:string .

13. Saving an Instance of Person • Model m = ModelFactory.createOntologyModel(); • Bean2RDF writer = new Bean2RDF(m); • Person p = new Person(); • p.setEmail("person@example.com"); • writer.save(p); • m.write(System.out, "N3"); • … • <http://example/Person> a owl:Class ; • <http://thewebsemantic.com/javaclass> "example.Person" . • <http://example/Person/taylor_cowan@yahoo.com> a <http://example/Person> ; • <http://example/email> "taylor_cowan@yahoo.com"^^xsd:string .

14. Overriding the Default Namespace • packageexamples.model; • importthewebsemantic.Id; • importthewebsemantic.Namespace; • @Namespace("http://mydomain#") • publicclass Person { … } <http://mydomain#Person> a <http://www.w3.org/2000/01/rdf-schema#Class> ; <http://thewebsemantic.com/javaclass> "examples.model.Person" . <http://mydomain#Person/thewebsemantic@gmail.com> a <http://mydomain#Person> ; <http://mydomain#email> "thewebsemantic@gmail.com"^^xsd:string .

15. Overriding the Default Property Bindings • @Namespace(“http://mydomain#”) • publicclass Person { • private String email; • @RdfProperty(FOAF.NS + "name") • private String name; <http://mydomain#Person> a <http://www.w3.org/2000/01/rdf-schema#Class> ; <http://thewebsemantic.com/javaclass> "examples.model.Person" . <http://mydomain#Person/thewebsemantic@gmail.com> a <http://mydomain#Person> ; <http://xmlns.com/foaf/0.1/name> "Taylor Cowan"^^xsd:string .

16. Extending Person to Support Friendship • public Collection<Person> friends = new • LinkedList<Person>(); • @RdfProperty("http://xmlns.com/foaf/0.1/knows") • public Collection<Person> getFriends() { returnfriends;}

17. Loading Beans from a Model • RDF2Bean reader = new RDF2Bean(m); • Person p = reader.load(Person.class,"person@example.com"); • Collection<Person> allPeople = reader.load(Person.class);

18. JenaBean Support for OWL Entailments publicclass Location { • @Id • public String id; public String name; @RdfProperty(transitive=true) public Collection<Location> within; @RdfProperty(inverseOf="within") public Collection<Location> contains; … <http://example.transitive/within> a rdf:Property , owl:TransitiveProperty . <http://example.transitive/contains> a rdf:Property ; owl:inverseOf <http://example.transitive/within> .

19. Reading Existing RDF/OWL • Up till this point we were generating the triples • JenaBean + annotations controlled the URI’s • The model knew the provenance of all data (the originating java class)

20. Example Geonames “feature” entry Jenabean will bind to existing URI’s <Feature rdf:about="http://sws.geonames.org/3333156/"> <name>London Borough of Islington</name> <alternateName xml:lang="fr">Islington</alternateName> <inCountryrdf:resource="http://www.geonames.org/countries/#GB"/> <population>185500</population> <wgs84_pos:lat>51.5333333</wgs84_pos:lat> <wgs84_pos:long>-0.1333333</wgs84_pos:long> </Feature>

21. Crafting beans for existing RDF requires care 1 @Namespace("http://www.geonames.org/ontology#") publicclass Feature { @Id private URI uri; @RdfProperty("http://www.w3.org/2003/01/geo/wgs84_pos#lat") publicdoublelat; 2 3 4 • Namespace must accurately match • Your java’s classname must match the Ontology class • Your @Id must be of type java.net.URI • All property URI’s must match the Ontology property

22. JenaBean can auto discover JenaBeans, provided it knows the package(s) 1: Model m = ModelFactory.createDefaultModel(); 2: m.read("http://ws.geonames.org/search?q=london&type=rdf"); 3: RDF2Bean reader = new RDF2Bean(m); 4: reader.bindAll("com.foo", "com.bar"); // type safe binding by class reader.bind(Feature.class); // or package reader.bind(Feature.class.getPackage());

23. JenaBean tip: handling lang encoded strings • If your data has something like this: • <alternateName xml:lang="es">Londres</alternateName> • Then use JenaBean‘s special type “LocalizedString“ public Collection<LocalizedString> alternateName; example.geonames

24. Query Support • Most most practical purposes there’s no need to utilize anything other than Jena’s ARQ api to query. JenaBean’s reader (RDF2Bean) can transform a node given it’s URI or it’s representation as a jena Resource… // load using a Jena Resource reader.load(Human.class, jenaResource); // load any node using it’s URI reader.load(Human.class, "http://any.uri");

25. thewebsemantic.SparqlUtil String query = "prefix ntn: <http://semanticbible.org/ns/2006/NTNames#>\n" + "SELECT ?s WHERE { ?s a ntn:Woman }"; Model m = ModelFactory.createOntologyModel(); m.read("file:NTNames.owl"); m.read("file:NTN-individuals.owl"); RDF2Bean reader = new RDF2Bean(m); reader.bindAll("example.query"); Collection<Woman> women = Sparql.exec(m, Woman.class, query); for (Human human : women) System.out.println(human.label + ":" + human.comment); example.query

26. Summary • @Namespace(“http://yournamespace.goes.here”) • Applies to class declaration • @Id • Applies to field or getter method • Should be a String or primitive type, or wrapper type • type java.net.URI is special • @RdfProperty(“http://specific.property.uri”) • Applies to field or getter method • Remember: by definition, JavaBeans must have a default constructor.

27. Summary • writer.save(mybean) • writer.saveDeep(mybean) • Save this and all related objects • reader.load(Class.class, key); • reader.loadDeep(…); • take care, could place entire graph into memory. • reader.bindAll(package, package, …); • Makes jenabean aware of your beans

28. JenaBean Fluent Programming API • AKA method chaining, foo.this().that().bar(); • A “Fluent Interface” aims to provide more readable code • A significant departure from JavaBeans • Is always connected to the jena graph • Entirely interface (not class) driven • Allows Individuals to morph into their various classes • Allows use of vocabulary terms against any Individual regardless of classification.

29. Example: wgs84 geo vocabulary importthewebsemantic.As; importthewebsemantic.Functional; importthewebsemantic.Namespace; @Namespace("http://www.w3.org/2003/01/geo/wgs84_pos#") publicinterface Geo extends As { interface Point extends Geo{} @Functional Geo lat(float l); Float lat(); @Functional Geo long_(float l); Float long_(); }

30. A fluent api + good IDE makes things fun

31. Create a new anonymous iCal event. Ical t = new Thing(m).isa(Ical.Vevent.class); Create a newiCal event with URI Ical t = new Thing(“http://uri”, m). isa(Ical.Vevent.class);

32. Full Example: Creating an iCal event for the meetup 1: Ical.Vevent t = new Thing(m).isa(Ical.Vevent.class); 2: t.uid("event_11978192@meetup.com"). 3: dtstart("20100124T200000Z"). 4: dtend("20100124T220000Z"). 5: summary("Jena Semantic Web…"). 6: location("Parisoma - …") 7: .as(Geo.class). 8: lat(37.77f). 9: long_(-122.41f); [] a ical:Vevent ; ical:dtend "20100124T220000Z" ; ical:dtstart "20100124T200000Z" ; ical:location "Parisoma - " ; ical:summary "Jena Semantic Web…" ; ical:uid "event_11978192@meetup.com" ; geo:lat "37.77"^^xsd:float ; geo:long "-122.41"^^xsd:float .

33. JenaBean comes with a few common vocabulary interfaces • thewebsemantic.vocabulary.Foaf • Geo • Ical • DCTerms • Sioc • Skos • Rdfs • ReviewVocab • You may want to copy and modify in some cases.

34. Fluent API summary: • Your interface should extend thewebsemantic.As • Provides polymorphic “as(Class)” to other vocabs. • Provides easy type declaration with “isa(Class)” • Use the @Namespace annotation to bind to the vocabulary • Name setters according to vocab, taking either an Object (literal) or anther Thing (relationship to other Individuals) • Name getters according to vocab, returning the same vocabulary type and taking no arguments. • If the vocabulary term collides with reserved term (as with long), append a dash. • Plural properties should return a Collection.

35. Create your own foaf document using the fluent interface. Integrate Jena/JenaBean with restlets restlets.org Use your favorite framework (struts, stripes, spring mvc) and create a user registration screen. Write JenaBeans that bind to jamendo or other music ontology at http://dbtune.org Write a foaf crawler beginning with Berners-Lee that traverses his social graph. Project Ideas cc nickjohnson http://flickr.com/photots/npj/

36. Taylor Cowanhttp://thewebsemantic.com http://twitter.com/tcowan Travelocitytaylor.cowan@travelocity.com