You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@jena.apache.org by shirren <gi...@git.apache.org> on 2017/10/11 12:39:11 UTC
[GitHub] jena pull request #285: JENA-1398: Marked archaic FOAF terms in the vocabula...
GitHub user shirren opened a pull request:
https://github.com/apache/jena/pull/285
JENA-1398: Marked archaic FOAF terms in the vocabulary as deprecated.
@afs The approach was to download the latest FOAF.rdf from the W3C website from which the FOAF.ttl and FOAF.java file was generated. "Archaic" terms from the spec were then marked as @Deprecated in the Java code. All tests pass. Please provide feedback or comments, thanks in advance.
You can merge this pull request into a Git repository by running:
$ git pull https://github.com/shirren/jena JENA-1398
Alternatively you can review and apply these changes as the patch at:
https://github.com/apache/jena/pull/285.patch
To close this pull request, make a commit to your master/trunk branch
with (at least) the following in the commit message:
This closes #285
----
commit b60f275c0c44f4270f6f7884c9ee1e48af80e960
Author: Shirren Premaratne <sh...@me.com>
Date: 2017-10-11T10:34:59Z
JENA-1398: Marked archaic FOAF terms in the vocabulary as deprecated.
----
---
[GitHub] jena issue #285: JENA-1398: Marked archaic FOAF terms in the vocabulary as d...
Posted by shirren <gi...@git.apache.org>.
Github user shirren commented on the issue:
https://github.com/apache/jena/pull/285
@rvesse I've made those changes. How does the Jena team schedule releases, and do you know when this PR will be released? Thank you so much for working on this projects, it's been invaluable to our team.
---
[GitHub] jena issue #285: JENA-1398: Marked archaic FOAF terms in the vocabulary as d...
Posted by rvesse <gi...@git.apache.org>.
Github user rvesse commented on the issue:
https://github.com/apache/jena/pull/285
Thanks for the updates, looks good to me
We aim to release approximately every three months, the last release was July so we are probably due another release soon. However everything is done on volunteer time so it will really depend on peoples availability
---
[GitHub] jena pull request #285: JENA-1398: Marked archaic FOAF terms in the vocabula...
Posted by shirren <gi...@git.apache.org>.
Github user shirren commented on a diff in the pull request:
https://github.com/apache/jena/pull/285#discussion_r144145886
--- Diff: jena-arq/src/main/java/org/apache/jena/sparql/vocabulary/FOAF.java ---
@@ -19,242 +19,282 @@
package org.apache.jena.sparql.vocabulary ;
/* CVS $Id: $ */
-
+
import org.apache.jena.rdf.model.Model ;
import org.apache.jena.rdf.model.ModelFactory ;
import org.apache.jena.rdf.model.Property ;
import org.apache.jena.rdf.model.Resource ;
-
+
/**
- * Vocabulary definitions from FOAF.ttl
- * @author Auto-generated by schemagen on 09 Jul 2007 16:50
+ * Vocabulary definitions from FOAF.rdf
+ * @author Auto-generated by schemagen on 11 Oct 2017 20:53
*/
public class FOAF {
/** <p>The RDF model that holds the vocabulary terms</p> */
- private static Model m_model = ModelFactory.createDefaultModel();
-
+ private static final Model M_MODEL = ModelFactory.createDefaultModel();
+
/** <p>The namespace of the vocabulary as a string</p> */
public static final String NS = "http://xmlns.com/foaf/0.1/";
-
+
/** <p>The namespace of the vocabulary as a string</p>
- * @see #NS */
+ * @return namespace as String
+ * @see #NS */
public static String getURI() {return NS;}
-
+
/** <p>The namespace of the vocabulary as a resource</p> */
- public static final Resource NAMESPACE = m_model.createResource( NS );
-
- /** <p>A jabber ID for something.</p> */
- public static final Property jabberID = m_model.createProperty( "http://xmlns.com/foaf/0.1/jabberID" );
-
- /** <p>A short informal nickname characterising an agent (includes login identifiers,
- * IRC and other chat nicknames).</p>
- */
- public static final Property nick = m_model.createProperty( "http://xmlns.com/foaf/0.1/nick" );
-
- /** <p>A checksum for the DNA of some thing. Joke.</p> */
- public static final Property dnaChecksum = m_model.createProperty( "http://xmlns.com/foaf/0.1/dnaChecksum" );
-
- /** <p>A topic of some page or document.</p> */
- public static final Property topic = m_model.createProperty( "http://xmlns.com/foaf/0.1/topic" );
-
- /** <p>A theme.</p> */
- public static final Property theme = m_model.createProperty( "http://xmlns.com/foaf/0.1/theme" );
-
- /** <p>An MSN chat ID</p> */
- public static final Property msnChatID = m_model.createProperty( "http://xmlns.com/foaf/0.1/msnChatID" );
-
- /** <p>An OpenID for an Agent.</p> */
- public static final Property openid = m_model.createProperty( "http://xmlns.com/foaf/0.1/openid" );
-
- /** <p>The family_name of some person.</p> */
- public static final Property family_name = m_model.createProperty( "http://xmlns.com/foaf/0.1/family_name" );
-
- /** <p>A homepage of a school attended by the person.</p> */
- public static final Property schoolHomepage = m_model.createProperty( "http://xmlns.com/foaf/0.1/schoolHomepage" );
-
- /** <p>A project this person has previously worked on.</p> */
- public static final Property pastProject = m_model.createProperty( "http://xmlns.com/foaf/0.1/pastProject" );
-
- /** <p>A .plan comment, in the tradition of finger and '.plan' files.</p> */
- public static final Property plan = m_model.createProperty( "http://xmlns.com/foaf/0.1/plan" );
-
- /** <p>A Myers Briggs (MBTI) personality classification.</p> */
- public static final Property myersBriggs = m_model.createProperty( "http://xmlns.com/foaf/0.1/myersBriggs" );
-
- /** <p>A personal mailbox, ie. an Internet mailbox associated with exactly one owner,
- * the first owner of this mailbox. This is a 'static inverse functional property',
- * in that there is (across time and change) at most one individual that ever
- * has any particular value for foaf:mbox.</p>
- */
- public static final Property mbox = m_model.createProperty( "http://xmlns.com/foaf/0.1/mbox" );
-
- /** <p>The gender of this Agent (typically but not necessarily 'male' or 'female').</p> */
- public static final Property gender = m_model.createProperty( "http://xmlns.com/foaf/0.1/gender" );
-
- /** <p>A sha1sum hash, in hex.</p> */
- public static final Property sha1 = m_model.createProperty( "http://xmlns.com/foaf/0.1/sha1" );
-
- /** <p>A link to the publications of this person.</p> */
- public static final Property publications = m_model.createProperty( "http://xmlns.com/foaf/0.1/publications" );
-
+ public static final Resource NAMESPACE = M_MODEL.createResource( NS );
+
/** <p>Indicates an account held by this agent.</p> */
- public static final Property holdsAccount = m_model.createProperty( "http://xmlns.com/foaf/0.1/holdsAccount" );
-
- /** <p>A current project this person works on.</p> */
- public static final Property currentProject = m_model.createProperty( "http://xmlns.com/foaf/0.1/currentProject" );
-
- /** <p>A work info homepage of some person; a page about their work for some organization.</p> */
- public static final Property workInfoHomepage = m_model.createProperty( "http://xmlns.com/foaf/0.1/workInfoHomepage" );
-
- /** <p>Something that was made by this agent.</p> */
- public static final Property made = m_model.createProperty( "http://xmlns.com/foaf/0.1/made" );
-
+ public static final Property account = M_MODEL.createProperty( "http://xmlns.com/foaf/0.1/account" );
+
+ /** <p>Indicates the name (identifier) associated with this online account.</p> */
+ public static final Property accountName = M_MODEL.createProperty( "http://xmlns.com/foaf/0.1/accountName" );
+
+ /** <p>Indicates a homepage of the service provide for this online account.</p> */
+ public static final Property accountServiceHomepage = M_MODEL.createProperty( "http://xmlns.com/foaf/0.1/accountServiceHomepage" );
+
+ /** <p>The age in years of some agent.</p> */
+ public static final Property age = M_MODEL.createProperty( "http://xmlns.com/foaf/0.1/age" );
+
/** <p>An AIM chat ID</p> */
- public static final Property aimChatID = m_model.createProperty( "http://xmlns.com/foaf/0.1/aimChatID" );
-
- /** <p>The primary topic of some page or document.</p> */
- public static final Property primaryTopic = m_model.createProperty( "http://xmlns.com/foaf/0.1/primaryTopic" );
-
- /** <p>A derived thumbnail image.</p> */
- public static final Property thumbnail = m_model.createProperty( "http://xmlns.com/foaf/0.1/thumbnail" );
-
- /** <p>A location that something is based near, for some broadly human notion of
+ public static final Property aimChatID = M_MODEL.createProperty( "http://xmlns.com/foaf/0.1/aimChatID" );
+
+ /** <p>A location that something is based near, for some broadly human notion of
* near.</p>
*/
- public static final Property based_near = m_model.createProperty( "http://xmlns.com/foaf/0.1/based_near" );
-
- /** <p>A workplace homepage of some person; the homepage of an organization they
- * work for.</p>
- */
- public static final Property workplaceHomepage = m_model.createProperty( "http://xmlns.com/foaf/0.1/workplaceHomepage" );
-
- /** <p>Title (Mr, Mrs, Ms, Dr. etc)</p> */
- public static final Property title = m_model.createProperty( "http://xmlns.com/foaf/0.1/title" );
-
- /** <p>A weblog of some thing (whether person, group, company etc.).</p> */
- public static final Property weblog = m_model.createProperty( "http://xmlns.com/foaf/0.1/weblog" );
-
- /** <p>A logo representing some thing.</p> */
- public static final Property logo = m_model.createProperty( "http://xmlns.com/foaf/0.1/logo" );
-
- /** <p>An organization funding a project or person.</p> */
- public static final Property fundedBy = m_model.createProperty( "http://xmlns.com/foaf/0.1/fundedBy" );
-
+ public static final Property based_near = M_MODEL.createProperty( "http://xmlns.com/foaf/0.1/based_near" );
+
+ /** <p>The birthday of this Agent, represented in mm-dd string form, eg. '12-31'.</p> */
+ public static final Property birthday = M_MODEL.createProperty( "http://xmlns.com/foaf/0.1/birthday" );
+
+ /** <p>A current project this person works on.</p> */
+ public static final Property currentProject = M_MODEL.createProperty( "http://xmlns.com/foaf/0.1/currentProject" );
+
/** <p>A depiction of some thing.</p> */
- public static final Property depiction = m_model.createProperty( "http://xmlns.com/foaf/0.1/depiction" );
-
- /** <p>Indicates a homepage of the service provide for this online account.</p> */
- public static final Property accountServiceHomepage = m_model.createProperty( "http://xmlns.com/foaf/0.1/accountServiceHomepage" );
-
- /** <p>A page or document about this thing.</p> */
- public static final Property page = m_model.createProperty( "http://xmlns.com/foaf/0.1/page" );
-
- /** <p>A document that this thing is the primary topic of.</p> */
- public static final Property isPrimaryTopicOf = m_model.createProperty( "http://xmlns.com/foaf/0.1/isPrimaryTopicOf" );
-
- /** <p>The surname of some person.</p> */
- public static final Property surname = m_model.createProperty( "http://xmlns.com/foaf/0.1/surname" );
-
+ public static final Property depiction = M_MODEL.createProperty( "http://xmlns.com/foaf/0.1/depiction" );
+
+ /** <p>A thing depicted in this representation.</p> */
+ public static final Property depicts = M_MODEL.createProperty( "http://xmlns.com/foaf/0.1/depicts" );
+
+ /** <p>A checksum for the DNA of some thing. Joke.</p> */
+ @Deprecated
+ public static final Property dnaChecksum = M_MODEL.createProperty( "http://xmlns.com/foaf/0.1/dnaChecksum" );
+
+ /** <p>The family name of some person.</p> */
+ public static final Property familyName = M_MODEL.createProperty( "http://xmlns.com/foaf/0.1/familyName" );
+
+ /** <p>The family name of some person.</p> */
+ @Deprecated
--- End diff --
@rvesse that's a good idea. I'll make it so.
---
[GitHub] jena pull request #285: JENA-1398: Marked archaic FOAF terms in the vocabula...
Posted by rvesse <gi...@git.apache.org>.
Github user rvesse commented on a diff in the pull request:
https://github.com/apache/jena/pull/285#discussion_r144011336
--- Diff: jena-arq/src/main/java/org/apache/jena/sparql/vocabulary/FOAF.java ---
@@ -19,242 +19,282 @@
package org.apache.jena.sparql.vocabulary ;
/* CVS $Id: $ */
-
+
import org.apache.jena.rdf.model.Model ;
import org.apache.jena.rdf.model.ModelFactory ;
import org.apache.jena.rdf.model.Property ;
import org.apache.jena.rdf.model.Resource ;
-
+
/**
- * Vocabulary definitions from FOAF.ttl
- * @author Auto-generated by schemagen on 09 Jul 2007 16:50
+ * Vocabulary definitions from FOAF.rdf
+ * @author Auto-generated by schemagen on 11 Oct 2017 20:53
*/
public class FOAF {
/** <p>The RDF model that holds the vocabulary terms</p> */
- private static Model m_model = ModelFactory.createDefaultModel();
-
+ private static final Model M_MODEL = ModelFactory.createDefaultModel();
+
/** <p>The namespace of the vocabulary as a string</p> */
public static final String NS = "http://xmlns.com/foaf/0.1/";
-
+
/** <p>The namespace of the vocabulary as a string</p>
- * @see #NS */
+ * @return namespace as String
+ * @see #NS */
public static String getURI() {return NS;}
-
+
/** <p>The namespace of the vocabulary as a resource</p> */
- public static final Resource NAMESPACE = m_model.createResource( NS );
-
- /** <p>A jabber ID for something.</p> */
- public static final Property jabberID = m_model.createProperty( "http://xmlns.com/foaf/0.1/jabberID" );
-
- /** <p>A short informal nickname characterising an agent (includes login identifiers,
- * IRC and other chat nicknames).</p>
- */
- public static final Property nick = m_model.createProperty( "http://xmlns.com/foaf/0.1/nick" );
-
- /** <p>A checksum for the DNA of some thing. Joke.</p> */
- public static final Property dnaChecksum = m_model.createProperty( "http://xmlns.com/foaf/0.1/dnaChecksum" );
-
- /** <p>A topic of some page or document.</p> */
- public static final Property topic = m_model.createProperty( "http://xmlns.com/foaf/0.1/topic" );
-
- /** <p>A theme.</p> */
- public static final Property theme = m_model.createProperty( "http://xmlns.com/foaf/0.1/theme" );
-
- /** <p>An MSN chat ID</p> */
- public static final Property msnChatID = m_model.createProperty( "http://xmlns.com/foaf/0.1/msnChatID" );
-
- /** <p>An OpenID for an Agent.</p> */
- public static final Property openid = m_model.createProperty( "http://xmlns.com/foaf/0.1/openid" );
-
- /** <p>The family_name of some person.</p> */
- public static final Property family_name = m_model.createProperty( "http://xmlns.com/foaf/0.1/family_name" );
-
- /** <p>A homepage of a school attended by the person.</p> */
- public static final Property schoolHomepage = m_model.createProperty( "http://xmlns.com/foaf/0.1/schoolHomepage" );
-
- /** <p>A project this person has previously worked on.</p> */
- public static final Property pastProject = m_model.createProperty( "http://xmlns.com/foaf/0.1/pastProject" );
-
- /** <p>A .plan comment, in the tradition of finger and '.plan' files.</p> */
- public static final Property plan = m_model.createProperty( "http://xmlns.com/foaf/0.1/plan" );
-
- /** <p>A Myers Briggs (MBTI) personality classification.</p> */
- public static final Property myersBriggs = m_model.createProperty( "http://xmlns.com/foaf/0.1/myersBriggs" );
-
- /** <p>A personal mailbox, ie. an Internet mailbox associated with exactly one owner,
- * the first owner of this mailbox. This is a 'static inverse functional property',
- * in that there is (across time and change) at most one individual that ever
- * has any particular value for foaf:mbox.</p>
- */
- public static final Property mbox = m_model.createProperty( "http://xmlns.com/foaf/0.1/mbox" );
-
- /** <p>The gender of this Agent (typically but not necessarily 'male' or 'female').</p> */
- public static final Property gender = m_model.createProperty( "http://xmlns.com/foaf/0.1/gender" );
-
- /** <p>A sha1sum hash, in hex.</p> */
- public static final Property sha1 = m_model.createProperty( "http://xmlns.com/foaf/0.1/sha1" );
-
- /** <p>A link to the publications of this person.</p> */
- public static final Property publications = m_model.createProperty( "http://xmlns.com/foaf/0.1/publications" );
-
+ public static final Resource NAMESPACE = M_MODEL.createResource( NS );
+
/** <p>Indicates an account held by this agent.</p> */
- public static final Property holdsAccount = m_model.createProperty( "http://xmlns.com/foaf/0.1/holdsAccount" );
-
- /** <p>A current project this person works on.</p> */
- public static final Property currentProject = m_model.createProperty( "http://xmlns.com/foaf/0.1/currentProject" );
-
- /** <p>A work info homepage of some person; a page about their work for some organization.</p> */
- public static final Property workInfoHomepage = m_model.createProperty( "http://xmlns.com/foaf/0.1/workInfoHomepage" );
-
- /** <p>Something that was made by this agent.</p> */
- public static final Property made = m_model.createProperty( "http://xmlns.com/foaf/0.1/made" );
-
+ public static final Property account = M_MODEL.createProperty( "http://xmlns.com/foaf/0.1/account" );
+
+ /** <p>Indicates the name (identifier) associated with this online account.</p> */
+ public static final Property accountName = M_MODEL.createProperty( "http://xmlns.com/foaf/0.1/accountName" );
+
+ /** <p>Indicates a homepage of the service provide for this online account.</p> */
+ public static final Property accountServiceHomepage = M_MODEL.createProperty( "http://xmlns.com/foaf/0.1/accountServiceHomepage" );
+
+ /** <p>The age in years of some agent.</p> */
+ public static final Property age = M_MODEL.createProperty( "http://xmlns.com/foaf/0.1/age" );
+
/** <p>An AIM chat ID</p> */
- public static final Property aimChatID = m_model.createProperty( "http://xmlns.com/foaf/0.1/aimChatID" );
-
- /** <p>The primary topic of some page or document.</p> */
- public static final Property primaryTopic = m_model.createProperty( "http://xmlns.com/foaf/0.1/primaryTopic" );
-
- /** <p>A derived thumbnail image.</p> */
- public static final Property thumbnail = m_model.createProperty( "http://xmlns.com/foaf/0.1/thumbnail" );
-
- /** <p>A location that something is based near, for some broadly human notion of
+ public static final Property aimChatID = M_MODEL.createProperty( "http://xmlns.com/foaf/0.1/aimChatID" );
+
+ /** <p>A location that something is based near, for some broadly human notion of
* near.</p>
*/
- public static final Property based_near = m_model.createProperty( "http://xmlns.com/foaf/0.1/based_near" );
-
- /** <p>A workplace homepage of some person; the homepage of an organization they
- * work for.</p>
- */
- public static final Property workplaceHomepage = m_model.createProperty( "http://xmlns.com/foaf/0.1/workplaceHomepage" );
-
- /** <p>Title (Mr, Mrs, Ms, Dr. etc)</p> */
- public static final Property title = m_model.createProperty( "http://xmlns.com/foaf/0.1/title" );
-
- /** <p>A weblog of some thing (whether person, group, company etc.).</p> */
- public static final Property weblog = m_model.createProperty( "http://xmlns.com/foaf/0.1/weblog" );
-
- /** <p>A logo representing some thing.</p> */
- public static final Property logo = m_model.createProperty( "http://xmlns.com/foaf/0.1/logo" );
-
- /** <p>An organization funding a project or person.</p> */
- public static final Property fundedBy = m_model.createProperty( "http://xmlns.com/foaf/0.1/fundedBy" );
-
+ public static final Property based_near = M_MODEL.createProperty( "http://xmlns.com/foaf/0.1/based_near" );
+
+ /** <p>The birthday of this Agent, represented in mm-dd string form, eg. '12-31'.</p> */
+ public static final Property birthday = M_MODEL.createProperty( "http://xmlns.com/foaf/0.1/birthday" );
+
+ /** <p>A current project this person works on.</p> */
+ public static final Property currentProject = M_MODEL.createProperty( "http://xmlns.com/foaf/0.1/currentProject" );
+
/** <p>A depiction of some thing.</p> */
- public static final Property depiction = m_model.createProperty( "http://xmlns.com/foaf/0.1/depiction" );
-
- /** <p>Indicates a homepage of the service provide for this online account.</p> */
- public static final Property accountServiceHomepage = m_model.createProperty( "http://xmlns.com/foaf/0.1/accountServiceHomepage" );
-
- /** <p>A page or document about this thing.</p> */
- public static final Property page = m_model.createProperty( "http://xmlns.com/foaf/0.1/page" );
-
- /** <p>A document that this thing is the primary topic of.</p> */
- public static final Property isPrimaryTopicOf = m_model.createProperty( "http://xmlns.com/foaf/0.1/isPrimaryTopicOf" );
-
- /** <p>The surname of some person.</p> */
- public static final Property surname = m_model.createProperty( "http://xmlns.com/foaf/0.1/surname" );
-
+ public static final Property depiction = M_MODEL.createProperty( "http://xmlns.com/foaf/0.1/depiction" );
+
+ /** <p>A thing depicted in this representation.</p> */
+ public static final Property depicts = M_MODEL.createProperty( "http://xmlns.com/foaf/0.1/depicts" );
+
+ /** <p>A checksum for the DNA of some thing. Joke.</p> */
+ @Deprecated
+ public static final Property dnaChecksum = M_MODEL.createProperty( "http://xmlns.com/foaf/0.1/dnaChecksum" );
+
+ /** <p>The family name of some person.</p> */
+ public static final Property familyName = M_MODEL.createProperty( "http://xmlns.com/foaf/0.1/familyName" );
+
+ /** <p>The family name of some person.</p> */
+ @Deprecated
--- End diff --
For deprecated terms like this where there is a new alternative can we explicitly point to the new term to help users migrate forwards
---
[GitHub] jena issue #285: JENA-1398: Marked archaic FOAF terms in the vocabulary as d...
Posted by shirren <gi...@git.apache.org>.
Github user shirren commented on the issue:
https://github.com/apache/jena/pull/285
@rvesse understand, thanks once again.
---
[GitHub] jena pull request #285: JENA-1398: Marked archaic FOAF terms in the vocabula...
Posted by asfgit <gi...@git.apache.org>.
Github user asfgit closed the pull request at:
https://github.com/apache/jena/pull/285
---