KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > com > hp > hpl > jena > ontology > Individual


1 /*****************************************************************************
2  * Source code information
3  * -----------------------
4  * Original author Ian Dickinson, HP Labs Bristol
5  * Author email Ian.Dickinson@hp.com
6  * Package Jena 2
7  * Web http://sourceforge.net/projects/jena/
8  * Created 10 Feb 2003
9  * Filename $RCSfile: Individual.java,v $
10  * Revision $Revision: 1.12 $
11  * Release status $State: Exp $
12  *
13  * Last modified on $Date: 2005/02/21 12:04:28 $
14  * by $Author: andy_seaborne $
15  *
16  * (c) Copyright 2002, 2003, 2004, 2005 Hewlett-Packard Development Company, LP
17  * footer for full conditions)
18  * ****************************************************************************/
19
20 // Package
21 ///////////////
22 package com.hp.hpl.jena.ontology;
23
24
25
26
27 // Imports
28 ///////////////
29 import com.hp.hpl.jena.rdf.model.*;
30 import com.hp.hpl.jena.util.iterator.ExtendedIterator;
31
32
33 /**
34  * <p>
35  * Interface that encapsulates an <i>individual</i> in an ontology, sometimes
36  * referred to as a fact or assertion, or a member of the <i>a-box</i>. In order
37  * to be recognised as an individual, rather than a generic resource,
38  * at least one <code>rdf:type</code> statement, referring to a known class,
39  * must be present in the model.
40  * </p>
41  *
42  * @author Ian Dickinson, HP Labs
43  * (<a HREF="mailto:Ian.Dickinson@hp.com" >email</a>)
44  * @version CVS $Id: Individual.java,v 1.12 2005/02/21 12:04:28 andy_seaborne Exp $
45  */
46 public interface Individual
47     extends OntResource
48 {
49     // Constants
50 //////////////////////////////////
51
52
53     // External signature methods
54 //////////////////////////////////
55
56     /**
57      * <p>Assert equivalence between the given individual and this individual. Any existing
58      * statements for <code>sameIndividualAs</code> will be removed.</p>
59      * <p>Note that <code>sameAs</code> and <code>sameIndividualAs</code> are aliases.</p>
60      * @param res The resource that declared to be the same as this individual
61      * @exception OntProfileException If the sameIndividualAs property is not supported in the current language profile.
62      * @deprecated WebOnt have removed <code>owl:sameIndividualAs</code>. Use {@link OntResource#setSameAs} instead.
63      */
64     public void setSameIndividualAs( Resource res );
65
66     /**
67      * <p>Add an individual that is declared to be equivalent to this individual.</p>
68      * <p>Note that <code>sameAs</code> and <code>sameIndividualAs</code> are aliases.</p>
69      * @param res A resource that declared to be the same as this individual
70      * @exception OntProfileException If the sameIndividualAs property is not supported in the current language profile.
71      * @deprecated WebOnt have removed <code>owl:sameIndividualAs</code>. Use {@link OntResource#addSameAs} instead.
72      */
73     public void addSameIndividualAs( Resource res );
74
75     /**
76      * <p>Answer a resource that is declared to be the same as this individual. If there are
77      * more than one such resource, an arbitrary selection is made.</p>
78      * <p>Note that <code>sameAs</code> and <code>sameIndividualAs</code> are aliases.</p>
79      * @return res An ont resource that declared to be the same as this individual
80      * @exception OntProfileException If the sameIndividualAs property is not supported in the current language profile.
81      * @deprecated WebOnt have removed <code>owl:sameIndividualAs</code>. Use {@link OntResource#getSameAs} instead.
82      */
83     public OntResource getSameIndividualAs();
84
85     /**
86      * <p>Answer an iterator over all of the resources that are declared to be equivalent to
87      * this individual. Each elemeent of the iterator will be an {@link OntResource}.</p>
88      * <p>Note that <code>sameAs</code> and <code>sameIndividualAs</code> are aliases.</p>
89      * @return An iterator over the resources equivalent to this individual.
90      * @exception OntProfileException If the sameIndividualAs property is not supported in the current language profile.
91      * @deprecated WebOnt have removed <code>owl:sameIndividualAs</code>. Use {@link OntResource#listSameAs} instead.
92      */
93     public ExtendedIterator listSameIndividualAs();
94
95     /**
96      * <p>Answer true if this individual is the same as the given resource.</p>
97      * @param res A resource to test against
98      * @return True if the resources are declared the same via a <code>sameIndividualAs</code> statement.
99      * @deprecated WebOnt have removed <code>owl:sameIndividualAs</code>. Use {@link OntResource#isSameAs} instead.
100      */
101     public boolean isSameIndividualAs( Resource res );
102     
103     /**
104      * <p>Remove the statement that this individual is the same as the given individual. If this statement
105      * is not true of the current model, nothing happens.</p>
106      * @param res A resource that may be declared to be the sameIndividualAs this resource
107      * @deprecated WebOnt have removed <code>owl:sameIndividualAs</code>. Use {@link OntResource#removeSameAs} instead.
108      */
109     public void removeSameIndividualAs( Resource res );
110     
111
112
113 }
114
115
116 /*
117     (c) Copyright 2002, 2003, 2004, 2005 Hewlett-Packard Development Company, LP
118     All rights reserved.
119
120     Redistribution and use in source and binary forms, with or without
121     modification, are permitted provided that the following conditions
122     are met:
123
124     1. Redistributions of source code must retain the above copyright
125        notice, this list of conditions and the following disclaimer.
126
127     2. Redistributions in binary form must reproduce the above copyright
128        notice, this list of conditions and the following disclaimer in the
129        documentation and/or other materials provided with the distribution.
130
131     3. The name of the author may not be used to endorse or promote products
132        derived from this software without specific prior written permission.
133
134     THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
135     IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
136     OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
137     IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
138     INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
139     NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
140     DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
141     THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
142     (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
143     THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
144 */
145
146
Popular Tags