com.apelon.dts.client.concept
Class BaseLocalConceptQuery

java.lang.Object
  com.apelon.apelonserver.client.BasicQuery
      com.apelon.dts.client.attribute.QualifierTypeQuery
          com.apelon.dts.client.attribute.PropertyTypeQuery
              com.apelon.dts.client.concept.BaseConceptQuery
                  com.apelon.dts.client.concept.BaseLocalConceptQuery

Direct Known Subclasses:

OntylogExtConceptQuery, ThesaurusConceptQuery

public abstract class BaseLocalConceptQuery
extends BaseConceptQuery

Base class for creating or deleting concepts in a local namespace.

The following events are fired in this class:

• ConceptEvent is fired for adding/modifying/deleting DTSConcept

Copyright: Copyright (c) 2004

Company: Apelon, Inc.

Since:

DTS 3.0.0

Version:

DTS 3.3.0

Author:

Apelon, Inc.

Field Summary

Fields inherited from class com.apelon.dts.client.concept.BaseConceptQuery

conceptListener

Fields inherited from class com.apelon.dts.client.attribute.QualifierTypeQuery

kbtypeListener

Fields inherited from class com.apelon.apelonserver.client.BasicQuery

ADMIN, queryHeader

Constructor Summary

protected

BaseLocalConceptQuery(ServerConnection sc, boolean isValidating)

Method Summary

DTSConcept	addConcept(DTSConcept concept) Adds a concept to a namespace by passing a DTSConcept object.
DTSConcept	addConcept(DTSConcept concept, ConceptAttributeSetDescriptor asd) Adds a concept to a namespace by passing a DTSConcept object.
boolean	deleteConcept(DTSConcept concept) Deletes a concept from the knowledgebase.
DTSConcept	updateConcept(DTSConcept oldConcept, DTSConcept newConcept) Updates only the concept name and/or code.
DTSConcept	updateConcept(DTSConcept oldConcept, DTSConcept newConcept, ConceptAttributeSetDescriptor asd) Updates only the concept name and/or code.

Methods inherited from class com.apelon.dts.client.concept.BaseConceptQuery

addConceptListener, addProperty, addSynonym, deleteProperty, deleteSynonym, findConceptByCode, findConceptById, findConceptByName, findConceptsByCode, findConceptsById, findConceptsByName, fireConceptAction, getAllConceptPropertyTypes, getConceptListener, getConceptPropertyTypes, getNamespaceQuery, removeConceptListener, updateProperty, updateSynonym

Methods inherited from class com.apelon.dts.client.attribute.PropertyTypeQuery

addPropertyType, buildPropertyTypes, deletePropertyType, findPropertyTypeByCode, findPropertyTypeById, findPropertyTypeByName, isPropertyTypeUsed, updatePropertyType

Methods inherited from class com.apelon.dts.client.attribute.QualifierTypeQuery

addKBTypeListener, addQualifierType, deleteQualifierType, findQualifierTypeByCode, findQualifierTypeById, findQualifierTypeByName, fireKBTypeAction, getAllConceptAssociationQualifierTypes, getAllConceptPropertyQualifierTypes, getAllQualifierTypes, getAllTermAssociationQualifierTypes, getAllTermPropertyQualifierTypes, getConceptAssociationQualifierTypes, getConceptPropertyQualifierTypes, getKBTypeListener, getTermAssociationQualifierTypes, getTermPropertyQualifierTypes, removeKBTypeListener, updateQualifierType

Methods inherited from class com.apelon.apelonserver.client.BasicQuery

executeQuery, executeQueryNoParse, getServerConnection, initializeDtds, initializeDtds, ping, setVersion

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

BaseLocalConceptQuery

protected BaseLocalConceptQuery(ServerConnection sc,
                                boolean isValidating)

Method Detail

addConcept

public DTSConcept addConcept(DTSConcept concept)
                      throws DTSException

Adds a concept to a namespace by passing a DTSConcept object. This method only adds the core concept and not any attributes that may be attached to the DTSConcept, such as synonyms, properties, or qualifiers. To add attributes to a concept, use BaseConceptQuery.addProperty(com.apelon.dts.client.concept.DTSConcept, com.apelon.dts.client.attribute.DTSProperty) and BaseConceptQuery.addSynonym(com.apelon.dts.client.association.Synonym).

Parameters:

concept - a concept to be added

Returns:

The fully populated DTSConcept; if the code and id were not assigned to the concept at instantiation, the code and id values will be generated and returned.

Throws:

DTSException - if any error occurs in the method

addConcept

public DTSConcept addConcept(DTSConcept concept,
                             ConceptAttributeSetDescriptor asd)
                      throws DTSException

Adds a concept to a namespace by passing a DTSConcept object. This method only adds the core concept and not any attributes that may be attached to the DTSConcept, such as synonyms, properties, or qualifiers. To add attributes to a concept, use BaseConceptQuery.addProperty(com.apelon.dts.client.concept.DTSConcept, com.apelon.dts.client.attribute.DTSProperty) and BaseConceptQuery.addSynonym(com.apelon.dts.client.association.Synonym).

Parameters:

concept - a concept to be added

asd - ConceptAttributeSetDescriptor specifying which attributes to return with the added concept

Returns:

The DTSConcept populated with the requested attributes; if the code and id were not assigned to the concept at instantiation, the code and id values will be generated and returned.

Throws:

DTSException - if a ontylog extension concept name is same as any concept name in its linked namespace or if any other error occurs in the method

Since:

DTS 3.3.0

updateConcept

public DTSConcept updateConcept(DTSConcept oldConcept,
                                DTSConcept newConcept)
                         throws DTSException

Updates only the concept name and/or code. No other aspect of the concept is updated with this method. To update attributes of a concept, use methods in BaseConceptQuery.

Parameters:

oldConcept - DTSConcept containing old concept name and code

newConcept - DTSConcept containing new concept name and code

Returns:

The fully populated DTSConcept with the new values of the updated concept.

Throws:

DTSException - if any error occurs in the method.

updateConcept

public DTSConcept updateConcept(DTSConcept oldConcept,
                                DTSConcept newConcept,
                                ConceptAttributeSetDescriptor asd)
                         throws DTSException

Updates only the concept name and/or code. No other aspect of the concept is updated with this method. To update attributes of a concept, use methods in BaseConceptQuery.

Parameters:

oldConcept - DTSConcept containing old concept name and code

newConcept - DTSConcept containing new concept name and code

asd - ConceptAttributeSetDescriptor specifying which attributes to return with the updated concept

Returns:

The fully populated DTSConcept with the new values of the updated concept.

Throws:

DTSException - if a ontylog extension concept name is same as any concept name in its linked namespace or if any other error occurs in the method

Since:

DTS 3.3.0

deleteConcept

public boolean deleteConcept(DTSConcept concept)
                      throws DTSException

Deletes a concept from the knowledgebase.

Parameters:

concept - the concept to be deleted

Returns:

true if concept succesfully deleted; false otherwise.

Throws:

DTSException - if any error occurs in the method