com.apelon.dts.client.concept
Class DTSConceptQuery

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.DTSConceptQuery

public abstract class DTSConceptQuery
extends BaseConceptQuery

DTSConceptQuery is a subclass of BaseConceptQuery. It can be instantiated to invoke the methods in BaseConceptQuery, which are common to both Ontylog and thesaurus concepts, by using methods createInstance(ServerConnection sc) or createInstance(ServerConnection sc, boolean isValidating). If you have two instances of DTSConceptQuery and you would like to share the listeners between them, then you can code something like this.

 DTSConceptQuery cq1 = null;
 DTSConceptQuery cq2 = null;

 // Initialization code for cq1 and cq2

 cq2.addConceptListener(cq1.getConceptListener());
 cq2.addKBTypeListener(cq1.getKBTypeListener());
 // Now any event from cq2 will be available to cq1 listeners
 

Copyright: Copyright (c) 2003

Company: Apelon, Inc.

Since:

DTS 3.0.0

Version:

DTS 3.0.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

Method Summary

static DTSConceptQuery	createInstance(ServerConnection sc) Creates an instance of DTSConceptQuery.
static DTSConceptQuery	createInstance(ServerConnection sc, boolean isValidating) Creates an instance of DTSConceptQuery.

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

Method Detail

createInstance

public static DTSConceptQuery createInstance(ServerConnection sc)
                                      throws IllegalArgumentException

Creates an instance of DTSConceptQuery. Depending on the type of ServerConnection object passed in the argument, the server may be local (JDBC), socket, or another implementation. When using a socket connection, the Apelon DTS server must be configured with the following query servers to support DTSConceptQuery:

• com.apelon.dts.server.DTSConceptServer
• com.apelon.dts.server.NamespaceServer

If you're using a JDBC connection, you'll need to add something like the following lines:

  ServerConnectionJDBC scJDBC = new ServerConnectionJDBC(user, password,
    host, port, instance);
  DTSConceptQuery dtsConceptQuery = DTSConceptQuery.createInstance(scJDBC);
  scJDBC.setQueryServer(com.apelon.dts.server.DTSConceptServer.class,
    DTSHeader.DTSCONCEPTSERVER_HEADER);
  scJDBC.setQueryServer(com.apelon.dts.server.NamespaceServer.class,
    DTSHeader.NAMESPACESERVER_HEADER);
 

Parameters:

sc - the server connection

Returns:

the created DTSConceptQuery

Throws:

IllegalArgumentException - if a null server connection is passed

See Also:

ServerConnectionJDBC, ServerConnectionSocket, ServerConnectionSecureSocket

createInstance

public static DTSConceptQuery createInstance(ServerConnection sc,
                                             boolean isValidating)
                                      throws IllegalArgumentException

Creates an instance of DTSConceptQuery. Depending on the type of ServerConnection object passed in the first argument, the server may be local (JDBC), socket, or another implementation. The second argument is a boolean value for XML validation. When using a socket connection, the Apelon DTS server must be configured with the following query servers to support DTSConceptQuery:

• com.apelon.dts.server.DTSConceptServer
• com.apelon.dts.server.NamespaceServer

If you're using a JDBC connection, you'll need to add something like the following lines:

  ServerConnectionJDBC scJDBC = new ServerConnectionJDBC(user, password,
    host, port, instance);
  DTSConceptQuery dtsConceptQuery = DTSConceptQuery.createInstance(scJDBC,
    true);
  scJDBC.setQueryServer(com.apelon.dts.server.DTSConceptServer.class,
    DTSHeader.DTSCONCEPTSERVER_HEADER);
  scJDBC.setQueryServer(com.apelon.dts.server.NamespaceServer.class,
    DTSHeader.NAMESPACESERVER_HEADER);
 

Parameters:

sc - the server connection

isValidating - true if XML needs to be validated, false otherwise.

Returns:

the created DTSConceptQuery

Throws:

IllegalArgumentException - if a null server connection is passed

See Also:

ServerConnectionJDBC, ServerConnectionSocket, ServerConnectionSecureSocket