001: /*****************************************************************************
002: * Source code information
003: * -----------------------
004: * Original author Ian Dickinson, HP Labs Bristol
005: * Author email Ian.Dickinson@hp.com
006: * Package Jena 2
007: * Web http://sourceforge.net/projects/jena/
008: * Created 07-May-2003
009: * Filename $RCSfile: HasValueRestrictionImpl.java,v $
010: * Revision $Revision: 1.14 $
011: * Release status $State: Exp $
012: *
013: * Last modified on $Date: 2008/01/02 12:08:03 $
014: * by $Author: andy_seaborne $
015: *
016: * (c) Copyright 2002, 2003, 2004, 2005, 2006, 2007, 2008 Hewlett-Packard Development Company, LP
017: * (see footer for full conditions)
018: *****************************************************************************/package com.hp.hpl.jena.ontology.impl;
019:
020: // Imports
021: ///////////////
022: import com.hp.hpl.jena.enhanced.*;
023: import com.hp.hpl.jena.graph.*;
024: import com.hp.hpl.jena.ontology.*;
025: import com.hp.hpl.jena.rdf.model.*;
026:
027: /**
028: * <p>
029: * Implementation of the hasValue restriction abstraction.
030: * </p>
031: *
032: * @author Ian Dickinson, HP Labs
033: * (<a href="mailto:Ian.Dickinson@hp.com" >email</a>)
034: * @version CVS $Id: HasValueRestrictionImpl.java,v 1.14 2008/01/02 12:08:03 andy_seaborne Exp $
035: */
036: public class HasValueRestrictionImpl extends RestrictionImpl implements
037: HasValueRestriction {
038: // Constants
039: //////////////////////////////////
040:
041: // Static variables
042: //////////////////////////////////
043:
044: /**
045: * A factory for generating HasValueRestriction facets from nodes in enhanced graphs.
046: * Note: should not be invoked directly by user code: use
047: * {@link com.hp.hpl.jena.rdf.model.RDFNode#as as()} instead.
048: */
049: public static Implementation factory = new Implementation() {
050: public EnhNode wrap(Node n, EnhGraph eg) {
051: if (canWrap(n, eg)) {
052: return new HasValueRestrictionImpl(n, eg);
053: } else {
054: throw new ConversionException("Cannot convert node "
055: + n + " to HasValueRestriction");
056: }
057: }
058:
059: public boolean canWrap(Node node, EnhGraph eg) {
060: // node will support being a HasValueRestriction facet if it has rdf:type owl:Restriction or equivalent
061: // and the combination of owl:onProperty and owl:hasValue (or equivalents)
062: Profile profile = (eg instanceof OntModel) ? ((OntModel) eg)
063: .getProfile()
064: : null;
065: return (profile != null)
066: && profile.isSupported(node, eg,
067: HasValueRestriction.class);
068: }
069: };
070:
071: // Instance variables
072: //////////////////////////////////
073:
074: // Constructors
075: //////////////////////////////////
076:
077: /**
078: * <p>
079: * Construct a hasValue restriction node represented by the given node in the given graph.
080: * </p>
081: *
082: * @param n The node that represents the resource
083: * @param g The enh graph that contains n
084: */
085: public HasValueRestrictionImpl(Node n, EnhGraph g) {
086: super (n, g);
087: }
088:
089: // External signature methods
090: //////////////////////////////////
091:
092: // hasValue
093:
094: /**
095: * <p>Assert that this restriction restricts the property to have the given
096: * value. Any existing statements for <code>hasValue</code>
097: * will be removed.</p>
098: * @param value The RDF value (an individual or a literal)
099: * that is the value that the restricted property must have to be a member of the
100: * class defined by this restriction.
101: * @exception OntProfileException If the {@link Profile#HAS_VALUE()} property is not supported in the current language profile.
102: */
103: public void setHasValue(RDFNode value) {
104: setPropertyValue(getProfile().HAS_VALUE(), "HAS_VALUE", value);
105: }
106:
107: /**
108: * <p>Answer the RDF value that all values of the restricted property must be equal to.</p>
109: * @return An RDFNode that is the value of the restricted property
110: * @exception OntProfileException If the {@link Profile#HAS_VALUE()} property is not supported in the current language profile.
111: */
112: public RDFNode getHasValue() {
113: checkProfile(getProfile().HAS_VALUE(), "HAS_VALUE");
114: RDFNode n = getPropertyValue(getProfile().HAS_VALUE());
115:
116: // map to an individual in the case of a resource value
117: if (!(n instanceof Literal) && n.canAs(Individual.class)) {
118: n = n.as(Individual.class);
119: }
120:
121: return n;
122: }
123:
124: /**
125: * <p>Answer true if this property restriction has the given RDF value as the value which all
126: * values of the restricted property must equal.</p>
127: * @param value An RDF value to test
128: * @return True if the given value is the value of the restricted property in this restriction
129: * @exception OntProfileException If the {@link Profile#HAS_VALUE()} property is not supported in the current language profile.
130: */
131: public boolean hasValue(RDFNode value) {
132: return hasPropertyValue(getProfile().HAS_VALUE(), "HAS_VALUE",
133: value);
134: }
135:
136: /**
137: * <p>Remove the statement that this restriction requires the restricted property to have
138: * the given value. If this statement
139: * is not true of the current model, nothing happens.</p>
140: * @param value An RDF value that is to be removed as the required value for the restricted property
141: */
142: public void removeHasValue(RDFNode value) {
143: removePropertyValue(getProfile().HAS_VALUE(), "HAS_VALUE",
144: value);
145: }
146:
147: // Internal implementation methods
148: //////////////////////////////////
149:
150: //==============================================================================
151: // Inner class definitions
152: //==============================================================================
153:
154: }
155:
156: /*
157: (c) Copyright 2002, 2003, 2004, 2005, 2006, 2007, 2008 Hewlett-Packard Development Company, LP
158: All rights reserved.
159:
160: Redistribution and use in source and binary forms, with or without
161: modification, are permitted provided that the following conditions
162: are met:
163:
164: 1. Redistributions of source code must retain the above copyright
165: notice, this list of conditions and the following disclaimer.
166:
167: 2. Redistributions in binary form must reproduce the above copyright
168: notice, this list of conditions and the following disclaimer in the
169: documentation and/or other materials provided with the distribution.
170:
171: 3. The name of the author may not be used to endorse or promote products
172: derived from this software without specific prior written permission.
173:
174: THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
175: IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
176: OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
177: IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
178: INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
179: NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
180: DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
181: THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
182: (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
183: THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
184: */
|