com.hp.hpl.jena.ontology.impl.OntResourceImpl Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of jena Show documentation
Show all versions of jena Show documentation
Jena is a Java framework for building Semantic Web applications. It provides a programmatic environment for RDF, RDFS and OWL, SPARQL and includes a rule-based inference engine.
The newest version!
/*****************************************************************************
* Source code information
* -----------------------
* Original author Ian Dickinson, HP Labs Bristol
* Author email [email protected]
* Package Jena 2
* Web http://sourceforge.net/projects/jena/
* Created 25-Mar-2003
* Filename $RCSfile: OntResourceImpl.java,v $
* Revision $Revision: 1.2 $
* Release status $State: Exp $
*
* Last modified on $Date: 2009/10/06 13:04:42 $
* by $Author: ian_dickinson $
*
* (c) Copyright 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009 Hewlett-Packard Development Company, LP
* (see footer for full conditions)
*****************************************************************************/
// Package
///////////////
package com.hp.hpl.jena.ontology.impl;
// Imports
///////////////
import com.hp.hpl.jena.datatypes.xsd.XSDDatatype;
import com.hp.hpl.jena.enhanced.*;
import com.hp.hpl.jena.graph.*;
import com.hp.hpl.jena.shared.*;
import com.hp.hpl.jena.ontology.*;
import com.hp.hpl.jena.rdf.model.*;
import com.hp.hpl.jena.rdf.model.impl.*;
import com.hp.hpl.jena.reasoner.*;
import com.hp.hpl.jena.util.ResourceUtils;
import com.hp.hpl.jena.util.iterator.*;
import com.hp.hpl.jena.vocabulary.*;
import java.util.*;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
/**
*
* Abstract base class to provide shared implementation for implementations of ontology
* resources.
*
*
* @author Ian Dickinson, HP Labs
* (email)
* @version CVS $Id: OntResourceImpl.java,v 1.2 2009/10/06 13:04:42 ian_dickinson Exp $
*/
public class OntResourceImpl
extends ResourceImpl
implements OntResource
{
// Constants
//////////////////////////////////
/** List of namespaces that are reserved for known ontology languages */
public static final String[] KNOWN_LANGUAGES = new String[] {OWL.NS,
RDF.getURI(),
RDFS.getURI(),
DAMLVocabulary.NAMESPACE_DAML_2001_03_URI,
XSDDatatype.XSD};
// Static variables
//////////////////////////////////
/**
* A factory for generating OntResource facets from nodes in enhanced graphs.
* Note: should not be invoked directly by user code: use
* {@link com.hp.hpl.jena.rdf.model.RDFNode#as as()} instead.
*/
@SuppressWarnings("hiding")
public static Implementation factory = new Implementation() {
@Override
public EnhNode wrap( Node n, EnhGraph eg ) {
if (canWrap( n, eg )) {
return new OntResourceImpl( n, eg );
}
else {
throw new ConversionException( "Cannot convert node " + n.toString() + " to OntResource");
}
}
@Override
public boolean canWrap( Node node, EnhGraph eg ) {
// node will support being an OntResource facet if it is a uri or bnode
return node.isURI() || node.isBlank();
}
};
private static final Logger log = LoggerFactory.getLogger( OntResourceImpl.class );
// Instance variables
//////////////////////////////////
// Constructors
//////////////////////////////////
/**
*
* Construct an ontology resource represented by the given node in the given graph.
*
*
* @param n The node that represents the resource
* @param g The enh graph that contains n
*/
public OntResourceImpl( Node n, EnhGraph g ) {
super( n, g );
}
// External signature methods
//////////////////////////////////
/**
* Answer the model that this resource is attached to, assuming that it
* is an {@link OntModel}. If this resource is not attached to any model,
* or is (unusually) attached to a model that is not an OntModel,
* answer null.
* @return The ont model that this resource is attached to, or null.
*/
public OntModel getOntModel() {
Model m = getModel();
return (m instanceof OntModel) ? (OntModel) m : null;
}
/**
*
* Answer the ontology language profile that governs the ontology model to which
* this ontology resource is attached.
*
*
* @return The language profile for this ontology resource
* @throws JenaException if the resource is not bound to an OntModel, since
* that's the only way to get the profile for the resource
*/
public Profile getProfile() {
try {
return ((OntModel) getModel()).getProfile();
}
catch (ClassCastException e) {
throw new JenaException( "Resource " + toString() + " is not attached to an OntModel, so cannot access its language profile" );
}
}
/**
* Answer true if this resource is a symbol in one of the standard ontology
* languages supported by Jena: RDF, RDFS, OWL or DAML+OIL. Since these languages
* have restricted namespaces, this check is simply a convenient way of testing whether
* this resource is in one of those pre-declared namespaces.
* @return True if this is a term in the language namespace for OWL, RDF, RDFS or DAML+OIL.
*/
public boolean isOntLanguageTerm() {
if (!isAnon()) {
for (int i = 0; i < KNOWN_LANGUAGES.length; i++) {
if (getURI().startsWith( KNOWN_LANGUAGES[i] )) {
return true;
}
}
}
return false;
}
// sameAs
/**
* Assert equivalence between the given resource and this resource. Any existing
* statements for sameAs will be removed.
* @param res The resource that is declared to be the same as this resource
* @exception OntProfileException If the {@link Profile#SAME_AS()} property is not supported in the current language profile.
*/
public void setSameAs( Resource res ) {
setPropertyValue( getProfile().SAME_AS(), "SAME_AS", res );
}
/**
* Add a resource that is declared to be equivalent to this resource.
* @param res A resource that declared to be the same as this resource
* @exception OntProfileException If the {@link Profile#SAME_AS()} property is not supported in the current language profile.
*/
public void addSameAs( Resource res ) {
addPropertyValue( getProfile().SAME_AS(), "SAME_AS", res );
}
/**
* Answer a resource that is declared to be the same as this resource. If there is
* more than one such resource, an arbitrary selection is made.
* @return res An ont resource that declared to be the same as this resource
* @exception OntProfileException If the {@link Profile#SAME_AS()} property is not supported in the current language profile.
*/
public OntResource getSameAs() {
return objectAsResource( getProfile().SAME_AS(), "SAME_AS" );
}
/**
* Answer an iterator over all of the resources that are declared to be the same as
* this resource. Each element of the iterator will be an {@link OntResource}.
* @return An iterator over the resources equivalent to this resource.
* @exception OntProfileException If the {@link Profile#SAME_AS()} property is not supported in the current language profile.
*/
public ExtendedIterator listSameAs() {
return listAs( getProfile().SAME_AS(), "SAME_AS", OntResource.class );
}
/**
* Answer true if this resource is the same as the given resource.
* @param res A resource to test against
* @return True if the resources are declared the same via a sameAs statement.
*/
public boolean isSameAs( Resource res ) {
return hasPropertyValue( getProfile().SAME_AS(), "SAME_AS", res );
}
/**
* Remove the statement that this resource is the same as the given resource. If this statement
* is not true of the current model, nothing happens.
* @param res A resource that may be declared to be the sameAs this resource
*/
public void removeSameAs( Resource res ) {
removePropertyValue( getProfile().SAME_AS(), "SAME_AS", res );
}
// differentFrom
/**
* Assert that the given resource and this resource are distinct. Any existing
* statements for differentFrom will be removed.
* @param res The resource that is declared to be distinct from this resource
* @exception OntProfileException If the {@link Profile#DIFFERENT_FROM()} property is not supported in the current language profile.
*/
public void setDifferentFrom( Resource res ) {
setPropertyValue( getProfile().DIFFERENT_FROM(), "DIFFERENT_FROM", res );
}
/**
* Add a statement declaring that this resource is distinct from the given resource.
* @param res A resource that declared to be distinct from this resource
* @exception OntProfileException If the {@link Profile#DIFFERENT_FROM()} property is not supported in the current language profile.
*/
public void addDifferentFrom( Resource res ) {
addPropertyValue( getProfile().DIFFERENT_FROM(), "DIFFERENT_FROM", res );
}
/**
* Answer a resource that is declared to be distinct from this resource. If there is
* more than one such resource, an arbitrary selection is made.
* @return res An ont resource that declared to be different from this resource
* @exception OntProfileException If the {@link Profile#DIFFERENT_FROM()} property is not supported in the current language profile.
*/
public OntResource getDifferentFrom() {
return objectAsResource( getProfile().DIFFERENT_FROM(), "DIFFERENT_FROM" );
}
/**
* Answer an iterator over all of the resources that are declared to be different from
* this resource. Each element of the iterator will be an {@link OntResource}.
* @return An iterator over the resources different from this resource.
* @exception OntProfileException If the {@link Profile#DIFFERENT_FROM()} property is not supported in the current language profile.
*/
public ExtendedIterator listDifferentFrom() {
return listAs( getProfile().DIFFERENT_FROM(), "DIFFERENT_FROM", OntResource.class );
}
/**
* Answer true if this resource is different from the given resource.
* @param res A resource to test against
* @return True if the resources are declared to be distinct via a differentFrom statement.
*/
public boolean isDifferentFrom( Resource res ) {
return hasPropertyValue( getProfile().DIFFERENT_FROM(), "DIFFERENT_FROM", res );
}
/**
* Remove the statement that this resource is different the given resource. If this statement
* is not true of the current model, nothing happens.
* @param res A resource that may be declared to be differentFrom this resource
*/
public void removeDifferentFrom( Resource res ) {
removePropertyValue( getProfile().DIFFERENT_FROM(), "DIFFERENT_FROM", res );
}
// seeAlso
/**
* Assert that the given resource provides additional information about the definition of this resource
* @param res A resource that can provide additional information about this resource
* @exception OntProfileException If the {@link Profile#SEE_ALSO()} property is not supported in the current language profile.
*/
public void setSeeAlso( Resource res ) {
setPropertyValue( getProfile().SEE_ALSO(), "SEE_ALSO", res );
}
/**
* Add a resource that is declared to provided additional information about the definition of this resource
* @param res A resource that provides extra information on this resource
* @exception OntProfileException If the {@link Profile#SEE_ALSO()} property is not supported in the current language profile.
*/
public void addSeeAlso( Resource res ) {
addPropertyValue( getProfile().SEE_ALSO(), "SEE_ALSO", res );
}
/**
* Answer a resource that provides additional information about this resource. If more than one such resource
* is defined, make an arbitrary choice.
* @return res A resource that provides additional information about this resource
* @exception OntProfileException If the {@link Profile#SEE_ALSO()} property is not supported in the current language profile.
*/
public Resource getSeeAlso() {
return objectAsResource( getProfile().SEE_ALSO(), "SEE_ALSO" );
}
/**
* Answer an iterator over all of the resources that are declared to provide addition
* information about this resource.
* @return An iterator over the resources providing additional definition on this resource.
* @exception OntProfileException If the {@link Profile#SEE_ALSO()} property is not supported in the current language profile.
*/
public ExtendedIterator listSeeAlso() {
checkProfile( getProfile().SEE_ALSO(), "SEE_ALSO" );
return WrappedIterator.create( listProperties( getProfile().SEE_ALSO() ) )
.mapWith( new ObjectAsOntResourceMapper() );
}
/**
* Answer true if this resource has the given resource as a source of additional information.
* @param res A resource to test against
* @return True if the res provides more information on this resource.
*/
public boolean hasSeeAlso( Resource res ) {
return hasPropertyValue( getProfile().SEE_ALSO(), "SEE_ALSO", res );
}
/**
* Remove the statement indicating the given resource as a source of additional information
* about this resource. If this statement
* is not true of the current model, nothing happens.
* @param res A resource that may be declared to provide additional information about this resource
*/
public void removeSeeAlso( Resource res ) {
removePropertyValue( getProfile().SEE_ALSO(), "SEE_ALSO", res );
}
// is defined by
/**
* Assert that the given resource provides a source of definitions about this resource. Any existing
* statements for isDefinedBy will be removed.
* @param res The resource that is declared to be a definition of this resource.
* @exception OntProfileException If the {@link Profile#IS_DEFINED_BY()} property is not supported in the current language profile.
*/
public void setIsDefinedBy( Resource res ) {
setPropertyValue( getProfile().IS_DEFINED_BY(), "IS_DEFINED_BY", res );
}
/**
* Add a resource that is declared to provide a definition of this resource.
* @param res A defining resource
* @exception OntProfileException If the {@link Profile#IS_DEFINED_BY()} property is not supported in the current language profile.
*/
public void addIsDefinedBy( Resource res ) {
addPropertyValue( getProfile().IS_DEFINED_BY(), "IS_DEFINED_BY", res );
}
/**
* Answer a resource that is declared to provide a definition of this resource. If there is
* more than one such resource, an arbitrary selection is made.
* @return res An ont resource that is declared to provide a definition of this resource
* @exception OntProfileException If the {@link Profile#IS_DEFINED_BY()} property is not supported in the current language profile.
*/
public Resource getIsDefinedBy() {
return objectAsResource( getProfile().IS_DEFINED_BY(), "IS_DEFINED_BY" );
}
/**
* Answer an iterator over all of the resources that are declared to define
* this resource.
* @return An iterator over the resources defining this resource.
* @exception OntProfileException If the {@link Profile#IS_DEFINED_BY()} property is not supported in the current language profile.
*/
public ExtendedIterator listIsDefinedBy() {
checkProfile( getProfile().IS_DEFINED_BY(), "IS_DEFINED_BY" );
return WrappedIterator.create( listProperties( getProfile().IS_DEFINED_BY() ) )
.mapWith( new ObjectAsOntResourceMapper() );
}
/**
* Answer true if this resource is defined by the given resource.
* @param res A resource to test against
* @return True if res defines this resource.
*/
public boolean isDefinedBy( Resource res ) {
return hasPropertyValue( getProfile().IS_DEFINED_BY(), "IS_DEFINED_BY", res );
}
/**
* Remove the statement that this resource is defined by the given resource. If this statement
* is not true of the current model, nothing happens.
* @param res A resource that may be declared to define this resource
*/
public void removeDefinedBy( Resource res ) {
removePropertyValue( getProfile().IS_DEFINED_BY(), "IS_DEFINED_BY", res );
}
// version info
/**
* Assert that the given string is the value of the version info for this resource. Any existing
* statements for versionInfo will be removed.
* @param info The version information for this resource
* @exception OntProfileException If the {@link Profile#VERSION_INFO()} property is not supported in the current language profile.
*/
public void setVersionInfo( String info ) {
checkProfile( getProfile().VERSION_INFO(), "VERSION_INFO" );
removeAll( getProfile().VERSION_INFO() );
addVersionInfo( info );
}
/**
* Add the given version information to this resource.
* @param info A version information string for this resource
* @exception OntProfileException If the {@link Profile#VERSION_INFO()} property is not supported in the current language profile.
*/
public void addVersionInfo( String info ) {
checkProfile( getProfile().VERSION_INFO(), "VERSION_INFO" );
addProperty( getProfile().VERSION_INFO(), getModel().createLiteral( info ) );
}
/**
* Answer the version information string for this object. If there is
* more than one such resource, an arbitrary selection is made.
* @return A version info string
* @exception OntProfileException If the {@link Profile#VERSION_INFO()} property is not supported in the current language profile.
*/
public String getVersionInfo() {
checkProfile( getProfile().VERSION_INFO(), "VERSION_INFO" );
try {
return getRequiredProperty( getProfile().VERSION_INFO() ).getString();
}
catch (PropertyNotFoundException ignore) {
return null;
}
}
/**
* Answer an iterator over all of the version info strings for this resource.
* @return An iterator over the version info strings for this resource.
* @exception OntProfileException If the {@link Profile#VERSION_INFO()} property is not supported in the current language profile.
*/
public ExtendedIterator listVersionInfo() {
checkProfile( getProfile().VERSION_INFO(), "VERSION_INFO" );
return WrappedIterator.create( listProperties( getProfile().VERSION_INFO() ) )
.mapWith( new ObjectAsStringMapper() );
}
/**
* Answer true if this resource has the given version information
* @param info Version information to test for
* @return True if this resource has info as version information.
*/
public boolean hasVersionInfo( String info ) {
checkProfile( getProfile().VERSION_INFO(), "VERSION_INFO" );
return hasProperty( getProfile().VERSION_INFO(), info );
}
/**
* Remove the statement that the given string provides version information about
* this resource. If this statement
* is not true of the current model, nothing happens.
* @param info A version information string to be removed
*/
public void removeVersionInfo( String info ) {
checkProfile( getProfile().VERSION_INFO(), "VERSION_INFO" );
Literal infoAsLiteral = ResourceFactory.createPlainLiteral( info );
getModel().remove( this, getProfile().VERSION_INFO(), infoAsLiteral );
}
// label
/**
* Assert that the given string is the value of the label for this resource. Any existing
* statements for label will be removed.
* @param label The label for this resource
* @param lang The language attribute for this label (EN, FR, etc) or null if not specified.
* @exception OntProfileException If the {@link Profile#LABEL()} property is not supported in the current language profile.
*/
public void setLabel( String label, String lang ) {
checkProfile( getProfile().LABEL(), "LABEL" );
removeAll( getProfile().LABEL() );
addLabel( label, lang );
}
/**
* Add the given label to this resource.
* @param label A label string for this resource
* @param lang The language attribute for this label (EN, FR, etc) or null if not specified.
* @exception OntProfileException If the {@link Profile#LABEL()} property is not supported in the current language profile.
*/
public void addLabel( String label, String lang ) {
addLabel( getModel().createLiteral( label, lang ) );
}
/**
* Add the given label to this resource.
* @param label The literal label
* @exception OntProfileException If the {@link Profile#LABEL()} property is not supported in the current language profile.
*/
public void addLabel( Literal label ) {
addPropertyValue( getProfile().LABEL(), "LABEL", label );
}
/**
* Answer the label string for this object. If there is
* more than one such resource, an arbitrary selection is made.
* @param lang The language attribute for the desired label (EN, FR, etc) or null for don't care. Will
* attempt to retreive the most specific label matching the given language
* @return A label string matching the given language, or null if there is no matching label.
* @exception OntProfileException If the {@link Profile#LABEL()} property is not supported in the current language profile.
*/
public String getLabel( String lang ) {
checkProfile( getProfile().LABEL(), "LABEL" );
if (lang == null || lang.length() == 0) {
// don't care which language version we get
try {
return getRequiredProperty( getProfile().LABEL() ).getString();
}
catch (PropertyNotFoundException ignore) {
return null;
}
}
else {
// search for the best match for the specified language
return selectLang( listProperties( getProfile().LABEL() ), lang );
}
}
/**
* Answer an iterator over all of the label literals for this resource.
* @param lang The language to restrict any label values to, or null to select all languages
* @return An iterator over RDF {@link Literal}'s.
* @exception OntProfileException If the {@link Profile#LABEL()} property is not supported in the current language profile.
*/
public ExtendedIterator listLabels( String lang ) {
checkProfile( getProfile().LABEL(), "LABEL" );
return WrappedIterator.create( listProperties( getProfile().LABEL() ) )
.filterKeep( new LangTagFilter( lang ) )
.mapWith( new ObjectMapper() );
}
/**
* Answer true if this resource has the given label
* @param label The label to test for
* @param lang The optional language tag, or null for don't care.
* @return True if this resource has label as a label.
*/
public boolean hasLabel( String label, String lang ) {
return hasLabel( getModel().createLiteral( label, lang ) );
}
/**
* Answer true if this resource has the given label
* @param label The label to test for
* @return True if this resource has label as a label.
*/
public boolean hasLabel( Literal label ) {
boolean found = false;
ExtendedIterator i = listLabels( label.getLanguage() );
while (!found && i.hasNext()) {
found = label.equals( i.next() );
}
i.close();
return found;
}
/**
* Remove the statement that the given string is a label for
* this resource. If this statement
* is not true of the current model, nothing happens.
* @param label A label string to be removed
* @param lang A lang tag
*/
public void removeLabel( String label, String lang ) {
removeLabel( getModel().createLiteral( label, lang ) );
}
/**
* Remove the statement that the given string is a label for
* this resource. If this statement
* is not true of the current model, nothing happens.
* @param label A label literal to be removed
*/
public void removeLabel( Literal label ) {
removePropertyValue( getProfile().LABEL(), "LABEL", label );
}
// comment
/**
* Assert that the given string is the comment on this resource. Any existing
* statements for comment will be removed.
* @param comment The comment for this resource
* @param lang The language attribute for this comment (EN, FR, etc) or null if not specified.
* @exception OntProfileException If the {@link Profile#COMMENT()} property is not supported in the current language profile.
*/
public void setComment( String comment, String lang ) {
checkProfile( getProfile().COMMENT(), "COMMENT" );
removeAll( getProfile().COMMENT() );
addComment( comment, lang );
}
/**
* Add the given comment to this resource.
* @param comment A comment string for this resource
* @param lang The language attribute for this comment (EN, FR, etc) or null if not specified.
* @exception OntProfileException If the {@link Profile#COMMENT()} property is not supported in the current language profile.
*/
public void addComment( String comment, String lang ) {
addComment( getModel().createLiteral( comment, lang ) );
}
/**
* Add the given comment to this resource.
* @param comment The literal comment
* @exception OntProfileException If the {@link Profile#COMMENT()} property is not supported in the current language profile.
*/
public void addComment( Literal comment ) {
checkProfile( getProfile().COMMENT(), "COMMENT" );
addProperty( getProfile().COMMENT(), comment );
}
/**
* Answer the comment string for this object. If there is
* more than one such resource, an arbitrary selection is made.
* @param lang The language attribute for the desired comment (EN, FR, etc) or null for don't care. Will
* attempt to retreive the most specific comment matching the given language
* @return A comment string matching the given language, or null if there is no matching comment.
* @exception OntProfileException If the {@link Profile#COMMENT()} property is not supported in the current language profile.
*/
public String getComment( String lang ) {
checkProfile( getProfile().COMMENT(), "COMMENT" );
if (lang == null) {
// don't care which language version we get
try {
return getRequiredProperty( getProfile().COMMENT() ).getString();
}
catch (PropertyNotFoundException ignore) {
// no comment :-)
return null;
}
}
else {
// search for the best match for the specified language
return selectLang( listProperties( getProfile().COMMENT() ), lang );
}
}
/**
* Answer an iterator over all of the comment literals for this resource.
* @return An iterator over RDF {@link Literal}'s.
* @exception OntProfileException If the {@link Profile#COMMENT()} property is not supported in the current language profile.
*/
public ExtendedIterator listComments( String lang ) {
checkProfile( getProfile().COMMENT(), "COMMENT" );
return WrappedIterator.create( listProperties( getProfile().COMMENT() ) )
.filterKeep( new LangTagFilter( lang ) )
.mapWith( new ObjectMapper() );
}
/**
* Answer true if this resource has the given comment.
* @param comment The comment to test for
* @param lang The optional language tag, or null for don't care.
* @return True if this resource has comment as a comment.
*/
public boolean hasComment( String comment, String lang ) {
return hasComment( getModel().createLiteral( comment, lang ) );
}
/**
* Answer true if this resource has the given comment.
* @param comment The comment to test for
* @return True if this resource has comment as a comment.
*/
public boolean hasComment( Literal comment ) {
boolean found = false;
ExtendedIterator i = listComments( comment.getLanguage() );
while (!found && i.hasNext()) {
found = comment.equals( i.next() );
}
i.close();
return found;
}
/**
* Remove the statement that the given string is a comment on
* this resource. If this statement
* is not true of the current model, nothing happens.
* @param comment A comment string to be removed
* @param lang A lang tag
*/
public void removeComment( String comment, String lang ) {
removeComment( getModel().createLiteral( comment, lang ) );
}
/**
* Remove the statement that the given string is a comment on
* this resource. If this statement
* is not true of the current model, nothing happens.
* @param comment A comment literal to be removed
*/
public void removeComment( Literal comment ) {
removePropertyValue( getProfile().COMMENT(), "COMMENT", comment );
}
// rdf:type
/**
* Set the RDF type (i.e. the class) for this resource, replacing any
* existing rdf:type property. Any existing statements for the RDF type
* will first be removed.
*
* @param cls The RDF resource denoting the new value for the rdf:type property,
* which will replace any existing type property.
*/
public void setRDFType( Resource cls ) {
setPropertyValue( RDF.type, "rdf:type", cls );
}
/**
* Add the given class as one of the rdf:type's for this resource.
*
* @param cls An RDF resource denoting a new value for the rdf:type property.
*/
public void addRDFType( Resource cls ) {
addPropertyValue( RDF.type, "rdf:type", cls );
}
/**
*
* Answer the rdf:type (ie the class) of this resource. If there
* is more than one type for this resource, the return value will be one of
* the values, but it is not specified which one (nor that it will consistently
* be the same one each time). Equivalent to getRDFType( false ).
*
*
* @return A resource that is the rdf:type for this resource, or one of them if
* more than one is defined.
*/
public Resource getRDFType() {
return getRDFType( false );
}
/**
*
* Answer the rdf:type (ie the class) of this resource. If there
* is more than one type for this resource, the return value will be one of
* the values, but it is not specified which one (nor that it will consistently
* be the same one each time).
*
*
* @param direct If true, only consider the direct types of this resource, and not
* the super-classes of the type(s).
* @return A resource that is the rdf:type for this resource, or one of them if
* more than one is defined.
*/
public Resource getRDFType( boolean direct ) {
ExtendedIterator i = null;
try {
i = listRDFTypes( direct );
return i.hasNext() ? i.next(): null;
}
finally {
i.close();
}
}
/**
*
* Answer an iterator over the RDF classes to which this resource belongs.
*
*
* @param direct If true, only answer those resources that are direct types
* of this resource, not the super-classes of the class etc.
* @return An iterator over the set of this resource's classes, each of which
* will be a {@link Resource}.
*/
public ExtendedIterator listRDFTypes( boolean direct ) {
ExtendedIterator i = listDirectPropertyValues( RDF.type, "rdf:type", Resource.class, getProfile().SUB_CLASS_OF(), direct, false );
// we only want each result once
return UniqueExtendedIterator.create( i );
}
/**
*
* Answer true if this resource is a member of the class denoted by the
* given URI.
*
* @param uri Denotes the URI of a class to which this value may belong
* @return True if this resource has the given class as one of its rdf:type's.
*/
public boolean hasRDFType( String uri ) {
return hasRDFType( getModel().getResource( uri ) );
}
/**
*
* Answer true if this resource is a member of the class denoted by the
* given class resource. Includes all available types, so is equivalent to
*
* hasRDF( ontClass, false );
*
*
* @param ontClass Denotes a class to which this value may belong
* @return True if this resource has the given class as one of its rdf:type's.
*/
public boolean hasRDFType( Resource ontClass ) {
return hasRDFType( ontClass, "unknown", false );
}
/**
*
* Answer true if this resource is a member of the class denoted by the
* given class resource.
*
*
* @param ontClass Denotes a class to which this value may belong
* @param direct If true, only consider the direct types of this resource, ignoring
* the super-classes of the stated types.
* @return True if this resource has the given class as one of its rdf:type's.
*/
public boolean hasRDFType( Resource ontClass, boolean direct ) {
return hasRDFType( ontClass, "unknown", direct );
}
protected boolean hasRDFType( Resource ontClass, String name, boolean direct ) {
checkProfile( ontClass, name );
if (!direct) {
// just an ordinary query - we can answer this directly (more efficient)
return hasPropertyValue( RDF.type, "rdf:type", ontClass );
}
else {
// need the direct version - not so efficient
ExtendedIterator i = null;
try {
i = listRDFTypes( true );
while (i.hasNext()) {
if (ontClass.equals( i.next() )) {
return true;
}
}
return false;
}
finally {
i.close();
}
}
}
/**
* Remove the statement that this resource is of the given RDF type. If this statement
* is not true of the current model, nothing happens.
* @param cls A resource denoting a class that that is to be removed from the classes of this resource
*/
public void removeRDFType( Resource cls ) {
removePropertyValue( RDF.type, "rdf:type", cls );
}
// utility methods
/**
* Answer the cardinality of the given property on this resource. The cardinality
* is the number of distinct values there are for the property.
* @param p A property
* @return The cardinality for the property p on this resource, as an
* integer greater than or equal to zero.
*/
public int getCardinality( Property p ) {
int n = 0;
for (Iterator i = UniqueExtendedIterator.create( listPropertyValues( p ) ); i.hasNext(); n++) {
i.next();
}
return n;
}
/**
*
* Set the value of the given property of this ontology resource to the given
* value, encoded as an RDFNode. Maintains the invariant that there is
* at most one value of the property for a given resource, so existing
* property values are first removed. To add multiple properties, use
* {@link #addProperty( Property, RDFNode ) addProperty}.
*
*
* @param property The property to update
* @param value The new value of the property as an RDFNode, or null to
* effectively remove this property.
*/
public void setPropertyValue( Property property, RDFNode value ) {
// if there is an existing property, remove it
removeAll( property );
// now set the new value
if (value != null) {
addProperty( property, value );
}
}
/**
* Answer the value of a given RDF property for this ontology resource, or null
* if it doesn't have one. The value is returned as an RDFNode, from which
* the concrete data value can be extracted for literals. If the value is
* a resource, it will present the {@link OntResource} facet.
* If there is more than one RDF
* statement with the given property for the current value, it is not defined
* which of the values will be returned.
*
* @param property An RDF property
* @return An RDFNode whose value is the value, or one of the values, of the
* given property. If the property is not defined the method returns null.
*/
public RDFNode getPropertyValue( Property property ) {
Statement s = getProperty( property );
if (s == null) {
return null;
}
else {
return asOntResource( s.getObject() );
}
}
/**
* Answer an iterator over the set of all values for a given RDF property. Each
* value in the iterator will be an RDFNode, representing the value (object) of
* each statement in the underlying model.
*
* @param property The property whose values are sought
* @return An Iterator over the values of the property
*/
public NodeIterator listPropertyValues( Property property ) {
return new NodeIteratorImpl( listProperties( property ).mapWith( new ObjectAsOntResourceMapper() ), null );
}
/**
* Removes this resource from the ontology by deleting any statements that refer to it,
* as either statement-subject or statement-object.
* If this resource is a property, this method will not remove statements
* whose predicate is this property.
* Caveat: Jena RDF models contain statements, not resources per se,
* so this method simulates removal of an object by removing all of the statements that have
* this resource as subject or object, with one exception. If the resource is referenced
* in an RDF List, i.e. as the object of an rdf:first statement in a list cell,
* this reference is not removed. Removing an arbitrary rdf:first
* statement from the midst of a list, without doing other work to repair the list, would
* leave an ill-formed list in the model. Therefore, if this resource is known to appear
* in a list somewhere in the model, it should be separately deleted from that list before
* calling this remove method.
*
*/
public void remove() {
Set stmts = new HashSet();
List lists = new ArrayList();
List skip = new ArrayList();
Property first = getProfile().FIRST();
// collect statements mentioning this object
for (StmtIterator i = listProperties(); i.hasNext(); ) {
stmts.add( i.next() );
}
for (StmtIterator i = getModel().listStatements( null, null, this ); i.hasNext(); ) {
stmts.add( i.next() );
}
// check for lists
for (Iterator i = stmts.iterator(); i.hasNext(); ) {
Statement s = i.next();
if (s.getPredicate().equals( first ) &&
s.getObject().equals( this )) {
// _this_ is referenced from inside a list
// we don't delete this reference, since it would make the list ill-formed
log.debug( toString() + " is referened from an RDFList, so will not be fully removed");
skip.add( s );
}
else if (s.getObject() instanceof Resource){
// check for list-valued properties
Resource obj = s.getResource();
if (obj.canAs( RDFList.class )) {
// this value is a list, so we will want to remove all of the elements
lists.add( obj );
}
}
}
// add in the contents of the lists to the statements to be removed
for (Iterator i = lists.iterator(); i.hasNext(); ) {
Resource r = i.next();
stmts.addAll( ((RDFListImpl) r.as( RDFList.class )).collectStatements() );
}
// skip the contents of the skip list
stmts.removeAll( skip );
// and then remove the remainder
for (Iterator i = stmts.iterator(); i.hasNext(); ) {
i.next().remove();
}
}
/**
* Remove the specific RDF property-value pair from this DAML resource.
*
* @param property The property to be removed
* @param value The specific value of the property to be removed
*/
public void removeProperty( Property property, RDFNode value ) {
getModel().remove( this, property, value );
}
/**
* Answer a view of this resource as an annotation property
* @return This resource, but viewed as an AnnotationProperty
* @exception ConversionException if the resource cannot be converted to an annotation property
*/
public AnnotationProperty asAnnotationProperty() {
return as( AnnotationProperty.class );
}
/**
* Answer a view of this resource as a property
* @return This resource, but viewed as an OntProperty
* @exception ConversionException if the resource cannot be converted to a property
*/
public OntProperty asProperty() {
return as( OntProperty.class );
}
/**
* Answer a view of this resource as an object property
* @return This resource, but viewed as an ObjectProperty
* @exception ConversionException if the resource cannot be converted to an object property
*/
public ObjectProperty asObjectProperty() {
return as( ObjectProperty.class );
}
/**
* Answer a view of this resource as a datatype property
* @return This resource, but viewed as a DatatypeProperty
* @exception ConversionException if the resource cannot be converted to a datatype property
*/
public DatatypeProperty asDatatypeProperty() {
return as( DatatypeProperty.class );
}
/**
* Answer a view of this resource as an individual
* @return This resource, but viewed as an Individual
* @exception ConversionException if the resource cannot be converted to an individual
*/
public Individual asIndividual() {
return as( Individual.class );
}
/**
* Answer a view of this resource as a class
* @return This resource, but viewed as an OntClass
* @exception ConversionException if the resource cannot be converted to a class
*/
public OntClass asClass() {
return as( OntClass.class );
}
/**
* Answer a view of this resource as an ontology description node
* @return This resource, but viewed as an Ontology
* @exception ConversionException if the resource cannot be converted to an ontology description node
*/
public Ontology asOntology() {
return as( Ontology.class );
}
/**
* Answer a view of this resource as an 'all different' declaration
* @return This resource, but viewed as an AllDifferent node
* @exception ConversionException if the resource cannot be converted to an all different declaration
*/
public AllDifferent asAllDifferent() {
return as( AllDifferent.class );
}
/**
* Answer a view of this resource as a data range
* @return This resource, but viewed as a DataRange
* @exception ConversionException if the resource cannot be converted to a data range
*/
public DataRange asDataRange() {
return as( DataRange.class );
}
// Conversion test methods
/**
* Answer true if this resource can be viewed as an annotation property
* @return True if this resource can be viewed as an AnnotationProperty
*/
public boolean isAnnotationProperty() {
return getProfile().ANNOTATION_PROPERTY() != null && canAs( AnnotationProperty.class );
}
/**
* Answer true if this resource can be viewed as a property
* @return True if this resource can be viewed as an OntProperty
*/
public boolean isProperty() {
return canAs( OntProperty.class );
}
/**
* Answer true if this resource can be viewed as an object property
* @return True if this resource can be viewed as an ObjectProperty
*/
public boolean isObjectProperty() {
return getProfile().OBJECT_PROPERTY() != null && canAs( ObjectProperty.class );
}
/**
* Answer true if this resource can be viewed as a datatype property
* @return True if this resource can be viewed as a DatatypeProperty
*/
public boolean isDatatypeProperty() {
return getProfile().DATATYPE_PROPERTY() != null && canAs( DatatypeProperty.class );
}
/**
* Answer true if this resource can be viewed as an individual
* @return True if this resource can be viewed as an Individual
*/
public boolean isIndividual() {
OntModel m = (getModel() instanceof OntModel) ? (OntModel) getModel() : null;
// can we use the reasoner's native abilities to do the isntance test?
boolean useInf = false;
useInf = m.getProfile().THING() != null &&
m.getReasoner() != null &&
m.getReasoner().supportsProperty( ReasonerVocabulary.individualAsThingP );
StmtIterator i = null, j = null;
try {
if (m != null) {
if (!useInf) {
// either not using the OWL reasoner, or not using OWL
// look for an rdf:type of this resource that is a class
for (i = listProperties( RDF.type ); i.hasNext(); ) {
Resource rType = i.nextStatement().getResource();
if (rType.equals( m.getProfile().THING() )) {
// the resource has rdf:type owl:Thing (or equivalent)
return true;
}
// if the type itself is OWL.Class or similar, we should ignore it ... this may
// arise in cases where the user has materialised results of inference and is then
// accessing them from a plain model
if (rType.equals( getProfile().CLASS() )) {
continue;
}
// otherwise, we check to see if the given type is known to be a class
for (j = rType.listProperties( RDF.type ); j.hasNext(); ) {
if (j.nextStatement().getResource().equals( getProfile().CLASS() )) {
// we have found an rdf:type of the subject that is an owl, rdfs or daml Class
// therefore this is an individual
return true;
}
}
}
// apparently not an instance
return false;
}
else {
// using the rule reasoner on an OWL graph, so we can determine
// individuals as those things that have rdf:type owl:Thing
return hasProperty( RDF.type, getProfile().THING() );
}
}
}
finally {
if (i != null) { i.close(); }
if (j != null) { j.close(); }
}
// default - try to convert and return false if fail
return canAs( Individual.class );
}
/**
* Answer true if this resource can be viewed as a class
* @return True if this resource can be viewed as an OntClass
*/
public boolean isClass() {
return canAs( OntClass.class );
}
/**
* Answer true if this resource can be viewed as an ontology description node
* @return True if this resource can be viewed as an Ontology
*/
public boolean isOntology() {
return getProfile().ONTOLOGY() != null && canAs( Ontology.class );
}
/**
* Answer true if this resource can be viewed as a data range
* @return True if this resource can be viewed as a DataRange
*/
public boolean isDataRange() {
return getProfile().DATARANGE() != null && canAs( DataRange.class );
}
/**
* Answer true if this resource can be viewed as an 'all different' declaration
* @return True if this resource can be viewed as an AllDifferent node
*/
public boolean isAllDifferent() {
return getProfile().ALL_DIFFERENT() != null && canAs( AllDifferent.class );
}
// Internal implementation methods
//////////////////////////////////
/** Answer true if the node has the given type in the graph */
protected static boolean hasType( Node n, EnhGraph g, Resource type ) {
// TODO this method doesn't seem to be called anywhere.
boolean hasType = false;
ClosableIterator i = g.asGraph().find( n, RDF.type.asNode(), type.asNode() );
hasType = i.hasNext();
i.close();
return hasType;
}
/**
* Throw an exception if a term is not in the profile
* @param term The term being checked
* @param name The name of the term
* @exception ProfileException if term is null (indicating it is not in the profile)
**/
protected void checkProfile( Object term, String name ) {
if (term == null) {
throw new ProfileException( name, getProfile() );
}
}
/**
* Answer the literal with the language tag that best matches the required language
* @param stmts A StmtIterator over the candidates
* @param lang The language we're searching for, assumed non-null.
* @return The literal value that best matches the given language tag, or null if there are no matches
*/
protected String selectLang( StmtIterator stmts, String lang ) {
String found = null;
while (stmts.hasNext()) {
RDFNode n = stmts.nextStatement().getObject();
if (n instanceof Literal) {
Literal l = (Literal) n;
String lLang = l.getLanguage();
// is this a better match?
if (lang.equalsIgnoreCase( lLang )) {
// exact match
found = l.getString();
break;
}
else if (lLang != null && lLang.length() > 1 && lang.equalsIgnoreCase( lLang.substring( 0, 2 ) )) {
// partial match - want EN, found EN-GB
// keep searching in case there's a better
found = l.getString();
}
else if (found == null && lLang == null) {
// found a string with no (i.e. default) language - keep this unless we've got something better
found = l.getString();
}
}
}
stmts.close();
return found;
}
/** Answer true if the desired lang tag matches the target lang tag */
protected boolean langTagMatch( String desired, String target ) {
return (desired == null) ||
(desired.equalsIgnoreCase( target )) ||
(target.length() > desired.length() && desired.equalsIgnoreCase( target.substring( desired.length() ) ));
}
/** Answer the object of a statement with the given property, .as() the given class */
protected T objectAs( Property p, String name, Class asClass ) {
checkProfile( p, name );
try {
return getRequiredProperty( p ).getObject().as( asClass );
}
catch (PropertyNotFoundException e) {
return null;
}
}
/** Answer the object of a statement with the given property, .as() an OntResource */
protected OntResource objectAsResource( Property p, String name ) {
return objectAs( p, name, OntResource.class );
}
/** Answer the object of a statement with the given property, .as() an OntProperty */
protected OntProperty objectAsProperty( Property p, String name ) {
return objectAs( p, name, OntProperty.class );
}
/** Answer the int value of a statement with the given property */
protected int objectAsInt( Property p, String name ) {
checkProfile( p, name );
return getRequiredProperty( p ).getInt();
}
/** Answer an iterator for the given property, whose values are .as() some class */
protected ExtendedIterator listAs( Property p, String name, Class cls ) {
checkProfile( p, name );
return WrappedIterator.create( listProperties( p ) ).mapWith( new ObjectAsMapper( cls ) );
}
/** Add the property value, checking that it is supported in the profile */
protected void addPropertyValue( Property p, String name, RDFNode value ) {
checkProfile( p, name );
addProperty( p, value );
}
/** Set the property value, checking that it is supported in the profile */
protected void setPropertyValue( Property p, String name, RDFNode value ) {
checkProfile( p, name );
removeAll( p );
addProperty( p, value );
}
/** Answer true if the given property is defined in the profile, and has the given value */
protected boolean hasPropertyValue( Property p, String name, RDFNode value ) {
checkProfile( p, name );
return hasProperty( p, value );
}
/** Add the given value to a list which is the value of the given property */
protected void addListPropertyValue( Property p, String name, RDFNode value ) {
checkProfile( p, name );
// get the list value
if (hasProperty( p )) {
RDFNode cur = getRequiredProperty( p ).getObject();
if (!cur.canAs( RDFList.class )) {
throw new OntologyException( "Tried to add a value to a list-valued property " + p +
" but the current value is not a list: " + cur );
}
RDFList values = cur.as( RDFList.class );
// now add our value to the list
if (!values.contains( value )){
RDFList newValues = values.with( value );
// if the previous values was nil, the return value will be a new list
if (newValues != values) {
removeAll( p );
addProperty( p, newValues );
}
}
}
else {
// create a new list to hold the only value we know so far
addProperty( p, ((OntModel) getModel()).createList( new RDFNode[] {value} ) );
}
}
/** Convert this resource to the facet denoted by cls, by adding rdf:type type if necessary */
protected T convertToType( Resource type, String name, Class cls ) {
checkProfile( type, name );
if (canAs( cls )) {
// don't need to update the model, we already can do the given facet
return as( cls );
}
// we're told that adding this rdf:type will make the as() possible - let's see
addProperty( RDF.type, type );
return as( cls );
}
/**
* Return an iterator of values, respecting the 'direct' modifier
* @param p The property whose values are required
* @param name The short name of the property (for generating error messages)
* @param cls Class object denoting the facet to map the returned values to
* @param orderRel If direct, and we are not using an inference engine, this is the property
* to use to define the maximal lower elements of the partial order
* @param direct If true, only return the direct (adjacent) values
* @param inverse If true, use the inverse of p rather than p
* @return An iterator of nodes that are in relation p to this resource (possibly inverted), which
* have been mapped to the facet denoted by cls.
*/
protected ExtendedIterator listDirectPropertyValues( Property p, String name, Class cls, Property orderRel, boolean direct, boolean inverse ) {
Iterator i = null;
checkProfile( p, name );
Property sc = p;
// check for requesting direct versions of these properties
if (direct) {
sc = getModel().getProperty( ReasonerRegistry.makeDirect( sc.asNode() ).getURI() );
}
// determine the subject and object pairs for the list statements calls
Resource subject = inverse ? null : this;
Resource object = inverse ? this : null;
Map1 mapper = inverse ? new SubjectAsMapper( cls ) : new ObjectAsMapper( cls );
// are we working on an inference graph?
OntModel m = (OntModel) getGraph();
InfGraph ig = null;
if (m.getGraph() instanceof InfGraph) {
ig = (InfGraph) m.getGraph();
}
// can we go direct to the graph?
if (!direct || ((ig != null) && ig.getReasoner().supportsProperty( sc ))) {
// either not direct, or the direct sc property is supported
// ensure we have an extended iterator of statements this rdfs:subClassOf _x
// NB we only want the subjects or objects of the statements
i = getModel().listStatements( subject, sc, object ).mapWith( mapper );
}
else {
i = computeDirectValues( p, orderRel, inverse, subject, object, mapper );
}
return UniqueExtendedIterator.create( i );
}
/**
* In the absence of a reasoner that can compute direct (adjacent) property values,
* we must perform the calculation of the direct values computationally here.
* @param p
* @param orderRel
* @param inverse
* @param subject
* @param object
* @param mapper
* @return
*/
@SuppressWarnings("unchecked")
private Iterator computeDirectValues( Property p, Property orderRel, boolean inverse, Resource subject, Resource object, Map1 mapper ) {
// graph does not support direct directly
ExtendedIterator j = getModel().listStatements( subject, p, object )
.mapWith( mapper );
// collect a list of the candidates
List s = new ArrayList();
for( ; j.hasNext(); ) {
s.add( j.next() );
}
// we need to keep this node out of the iterator for now, else it will spoil the maximal
// generator compression (since all the (e.g.) sub-classes will be sub-classes of this node
// and so will be excluded from the maximal lower elements calculation)
ResourceUtils.removeEquiv( s, orderRel, this );
boolean withheld = s.remove( this );
// we now compress the list by reducing all equivalent values to a single representative
// first partition the list by equivalence under orderRel
List> partition = ResourceUtils.partition( s, orderRel );
Map> equivSets = new HashMap>();
// then reduce each part of the partition to a singleton, but remember the others
s.clear();
for (Iterator> i = partition.iterator(); i.hasNext(); ) {
List part = i.next();
// if this is a singleton we just add it to the compressed candidates
if (part.size() == 1) {
s.add( part.get(0) );
}
else {
// we select a single representative
T r = part.remove( 0 );
// remember the other equivalent values
equivSets.put( r, part );
s.add( r );
}
}
// now s1 contains a reduced set of nodes, in which any fully-connected sub-graph under
// orderRel has been reduced to a single representative
// generate the short list as the maximal bound under the given partial order
s = ResourceUtils.maximalLowerElements( s, orderRel, inverse );
// create a list of these values lower elements, plus their equivalents (if any)
List s2 = new ArrayList();
for (Iterator i = s.iterator(); i.hasNext(); ) {
T r = i.next();
s2.add( r );
if (equivSets.containsKey( r )) {
s2.addAll( equivSets.get( r ) );
}
}
// put myself back if needed
if (withheld) {
s2.add( (T) this );
}
return s2.iterator();
}
/** Remove a specified property-value pair, if it exists */
protected void removePropertyValue( Property prop, String name, RDFNode value ) {
checkProfile( prop, name );
getModel().remove( this, prop, value );
}
/** Answer the given node presenting the OntResource facet if it can */
private static RDFNode asOntResource( RDFNode n ) {
return n.isResource() ? n.as( OntResource.class ) : n;
}
//==============================================================================
// Inner class definitions
//==============================================================================
/** Implementation of Map1 that performs as( Class ) for a given class, against an argument {@link RDFNode} */
protected static class AsMapper implements Map1
{
private Class m_as;
public AsMapper( Class as ) { m_as = as; }
public T map1( RDFNode x ) { return x.as( m_as ); }
}
/** Implementation of Map1 that performs as( Class ) for a given class, against an argument {@link Resource} */
protected static class ResourceAsMapper implements Map1
{
private Class m_as;
public ResourceAsMapper( Class as ) { m_as = as; }
public T map1( Resource x ) { return x.as( m_as ); }
}
/** Implementation of Map1 that performs as( Class ) for a given class, on the subject of a statement */
protected static class SubjectAsMapper implements Map1
{
private Class m_as;
public SubjectAsMapper( Class as ) { m_as = as; }
public T map1( Statement x ) {
return x.getSubject().as( m_as );
}
}
/** Implementation of Map1 that extracts the subject of a statement */
protected static class SubjectMapper implements Map1
{
public Resource map1( Statement x ) {
return x.getSubject();
}
}
/** Implementation of Map1 that performs as( Class ) for a given class, on the object of a statement */
protected static class ObjectAsMapper implements Map1
{
private Class m_as;
public ObjectAsMapper( Class as )
{ m_as = as; }
public T map1( Statement x ) {
return x.getObject().as( m_as );
}
}
/** Implementation of Map1 that performs getString on the object of a statement */
protected class ObjectAsStringMapper implements Map1
{
public String map1( Statement x ) { return x.getString(); }
}
/** Implementation of Map1 that returns the object of a statement */
protected static class ObjectMapper implements Map1
{
public RDFNode map1( Statement x ) { return x.getObject(); }
}
/** Implementation of Map1 that returns the object of a statement as an ont resource */
protected static class ObjectAsOntResourceMapper implements Map1
{
public RDFNode map1( Statement x ) {
return asOntResource( x.getObject() );
}
}
/** Filter for matching language tags on the objects of statements */
protected class LangTagFilter extends Filter
{
protected String m_lang;
public LangTagFilter( String lang ) { m_lang = lang; }
@Override
public boolean accept( Statement x ) {
RDFNode o = x.getObject();
return o.isLiteral() && langTagMatch( m_lang, ((Literal) o).getLanguage() );
}
}
/** Filter for accepting only the given value, based on .equals() */
protected class SingleEqualityFilter
extends Filter
{
private T m_obj;
public SingleEqualityFilter( T x ) { m_obj = x; }
@Override public boolean accept( T x ) {return m_obj.equals( x );}
}
}
/*
(c) Copyright 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009 Hewlett-Packard Development Company, LP
All rights reserved.
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions
are met:
1. Redistributions of source code must retain the above copyright
notice, this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright
notice, this list of conditions and the following disclaimer in the
documentation and/or other materials provided with the distribution.
3. The name of the author may not be used to endorse or promote products
derived from this software without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*/
© 2015 - 2025 Weber Informatics LLC | Privacy Policy