org.ceryle.tm
Interface Facet

All Known Implementing Classes:

FacetImpl

public interface Facet

An interface for a structure containing a Topic Map facet, including its type, value, default value, and constraining facets.

This interface relies on the PSIs defined by the facets.xtm Topic Map:

   publicId: "-//purl.org/ceryle//DOCUMENT Facets for XTM 1.0//EN"
   systemId: "http://purl.org/ceryle/psi/facets/facets.xtm" 

which defines the Topics:

Topic	PSI	type/notes
facets	http://purl.org/ceryle/psi/facets/#facets	Topic: PSI class
hasFacet	http://purl.org/ceryle/psi/facets/#hasFacet	Topic: predicate
facet	http://purl.org/ceryle/psi/facets/#facet	Topic: role
faceted	http://purl.org/ceryle/psi/facets/#faceted	Topic: role
facetType	http://purl.org/ceryle/psi/facets/#facetType	Topic: type
facetName	http://purl.org/ceryle/psi/facets/#facetName	BaseName: string value or ref
facetValue	http://purl.org/ceryle/psi/facets/#facetValue	Occurrence: string value or ref
facetDefault	http://purl.org/ceryle/psi/facets/#facetDefault	Occurrence: string value or ref
facetMinIncl	http://purl.org/ceryle/psi/facets/#facetMinIncl	Occurrence: string value or ref
facetMaxIncl	http://purl.org/ceryle/psi/facets/#facetMaxIncl	Occurrence: string value or ref
facetMinExcl	http://purl.org/ceryle/psi/facets/#facetMinExcl	Occurrence: string value or ref
facetMaxExcl	http://purl.org/ceryle/psi/facets/#facetMaxExcl	Occurrence: string value or ref

Note that there is no setFaceted(Topic) or setFacet(Topic) method, as these required Topics is set via the constructor. Also, this interface does not currently support enumerations - this is planned for a later version.

Copyright 2003 Murray Altheim. All Rights Reserved.

Permission to use, copy, modify and distribute this interface and its accompanying documentation for any purpose and without fee is hereby granted in perpetuity, provided that the above copyright notice and this paragraph appear in all copies. The copyright holders make no representation about the suitability of the interface for any purpose. It is provided "as is" without expressed or implied warranty.

Since:

JDK1.4

Version:

$Id: Facet.java,v 1.1 2003/11/26 05:40:48 altheim Exp $

Author:

Murray Altheim

See Also:

FacetImpl

Method Summary

org.tm4j.topicmap.Topic	getFacet() Return the facet Topic.
org.tm4j.topicmap.Occurrence	getFacetDefault() Return the facet Default as a Topic Occurrence.
org.tm4j.topicmap.Topic	getFaceted() Return the faceted Topic.
org.tm4j.topicmap.Association	getFacetLink() Return the facet Association.
org.tm4j.topicmap.Occurrence	getFacetMaxExcl() Return the facet maximum exclusive constraint as a Topic Occurrence.
org.tm4j.topicmap.Occurrence	getFacetMaxIncl() Return the facet maximum inclusive constraint as a Topic Occurrence.
org.tm4j.topicmap.Occurrence	getFacetMinExcl() Return the facet minimum exclusive constraint as a Topic Occurrence.
org.tm4j.topicmap.Occurrence	getFacetMinIncl() Return the facet minimum inclusive constraint as a Topic Occurrence.
org.tm4j.topicmap.BaseName	getFacetName() Return the facet Name as a String.
java.util.Collection	getFacetTypes(boolean includeMergedTopics) Return the types of this Facet, and optionally, of all merged Topics.
org.tm4j.topicmap.Occurrence	getFacetValue() Return the facet value as an Occurrence.
void	setFacetDefault(java.lang.Object facetDefault) Set the facet default value to the object facetDefault, which must be either a String or a Locator.
void	setFacetMaxExcl(java.lang.Object facetMaxExcl) Set the facet maximum exclusive constraint to the Object facetMaxExcl, which must be either a String or a Locator.
void	setFacetMaxIncl(java.lang.Object facetMaxIncl) Set the facet maximum inclusive constraint to the Object facetMaxIncl, which must be either a String or a Locator.
void	setFacetMinExcl(java.lang.Object facetMinExcl) Set the facet minimum exclusive constraint to the Object facetMinExcl, which must be either a String or a Locator.
void	setFacetMinIncl(java.lang.Object facetMinIncl) Set the facet minimum inclusive constraint to the Object facetMinIncl, which must be either a String or a Locator.
void	setFacetName(java.lang.String facetName) Set the facet Name to the String facetName.
void	setFacetType(org.tm4j.topicmap.Topic facetType) Add the Topic facetType as a type of this Facet.
void	setFacetValue(java.lang.Object facetValue) Set the facet Value to the Object facetValue, which must be either a String or a Locator.

Method Detail

getFaceted

public org.tm4j.topicmap.Topic getFaceted()

Return the faceted Topic.

getFacet

public org.tm4j.topicmap.Topic getFacet()

Return the facet Topic.

getFacetLink

public org.tm4j.topicmap.Association getFacetLink()

Return the facet Association.

setFacetType

public void setFacetType(org.tm4j.topicmap.Topic facetType)
                  throws TopicMapException

Add the Topic facetType as a type of this Facet.

TopicMapException

getFacetTypes

public java.util.Collection getFacetTypes(boolean includeMergedTopics)

Return the types of this Facet, and optionally, of all merged Topics.

setFacetValue

public void setFacetValue(java.lang.Object facetValue)
                   throws TopicMapException

Set the facet Value to the Object facetValue, which must be either a String or a Locator. This will overwrite any existing value.

TopicMapException

getFacetValue

public org.tm4j.topicmap.Occurrence getFacetValue()

Return the facet value as an Occurrence.

setFacetName

public void setFacetName(java.lang.String facetName)
                  throws TopicMapException

Set the facet Name to the String facetName.

TopicMapException

getFacetName

public org.tm4j.topicmap.BaseName getFacetName()

Return the facet Name as a String.

setFacetDefault

public void setFacetDefault(java.lang.Object facetDefault)
                     throws TopicMapException

Set the facet default value to the object facetDefault, which must be either a String or a Locator.

TopicMapException

getFacetDefault

public org.tm4j.topicmap.Occurrence getFacetDefault()

Return the facet Default as a Topic Occurrence.

setFacetMinIncl

public void setFacetMinIncl(java.lang.Object facetMinIncl)
                     throws TopicMapException

Set the facet minimum inclusive constraint to the Object facetMinIncl, which must be either a String or a Locator.

TopicMapException

getFacetMinIncl

public org.tm4j.topicmap.Occurrence getFacetMinIncl()

Return the facet minimum inclusive constraint as a Topic Occurrence.

setFacetMaxIncl

public void setFacetMaxIncl(java.lang.Object facetMaxIncl)
                     throws TopicMapException

Set the facet maximum inclusive constraint to the Object facetMaxIncl, which must be either a String or a Locator.

TopicMapException

getFacetMaxIncl

public org.tm4j.topicmap.Occurrence getFacetMaxIncl()

Return the facet maximum inclusive constraint as a Topic Occurrence.

setFacetMinExcl

public void setFacetMinExcl(java.lang.Object facetMinExcl)
                     throws TopicMapException

Set the facet minimum exclusive constraint to the Object facetMinExcl, which must be either a String or a Locator.

TopicMapException

getFacetMinExcl

public org.tm4j.topicmap.Occurrence getFacetMinExcl()

Return the facet minimum exclusive constraint as a Topic Occurrence.

setFacetMaxExcl

public void setFacetMaxExcl(java.lang.Object facetMaxExcl)
                     throws TopicMapException

Set the facet maximum exclusive constraint to the Object facetMaxExcl, which must be either a String or a Locator.

TopicMapException

getFacetMaxExcl

public org.tm4j.topicmap.Occurrence getFacetMaxExcl()

Return the facet maximum exclusive constraint as a Topic Occurrence.