X-Git-Url: http://jsfdemo.indexdata.com/?a=blobdiff_plain;f=src%2Forg%2Fz3950%2Fzing%2Fcql%2FCQLRelation.java;h=c34f67ba1a491af3811fd6e234749f1249f37f4a;hb=b53fe47e0bd5f0825b0d8ceeb33538e714bf9e7e;hp=6d7e138fe70c18165dd8429ad5fdf23a6f5a5d19;hpb=df372083094087da8590a526e0222c81c9ae7fc0;p=cql-java-moved-to-github.git

diff --git a/src/org/z3950/zing/cql/CQLRelation.java b/src/org/z3950/zing/cql/CQLRelation.java
index 6d7e138..c34f67b 100644
--- a/src/org/z3950/zing/cql/CQLRelation.java
+++ b/src/org/z3950/zing/cql/CQLRelation.java
@@ -1,33 +1,61 @@
-// $Id: CQLRelation.java,v 1.3 2002-11-06 00:05:58 mike Exp $
+// $Id: CQLRelation.java,v 1.17 2007-06-29 10:23:02 mike Exp $
 
 package org.z3950.zing.cql;
 import java.util.Vector;
+import java.util.Properties;
 import java.lang.StringBuffer;
 
 /**
- * Represents a relation between a CQL qualifier and term.
- * ##
+ * Represents a relation between a CQL index and term.
  *
- * @version	$Id: CQLRelation.java,v 1.3 2002-11-06 00:05:58 mike Exp $
+ * @version	$Id: CQLRelation.java,v 1.17 2007-06-29 10:23:02 mike Exp $
  */
 public class CQLRelation extends CQLNode {
     ModifierSet ms;
 
+    /**
+     * Creates a new CQLRelation with the specified base relation.
+     * Typical base relations include the usual six ordering relations
+     * (<TT>&lt;=</TT>, <TT>&gt</TT>, <I>etc.</I>), the text
+     * relations <TT>any</TT>, <TT>all</TT> and <TT>exact</TT>, the
+     * server-choice relation <TT>scr</TT> and profiled relations of
+     * the form <TT><I>prefix</I>.<I>name</I></TT>.
+     */
+    // ### Seems wrong: a modifier set should not have a base, a
+    // relation should
     public CQLRelation(String base) {
 	ms = new ModifierSet(base);
     }
 
+    /**
+     * Returns the base relation with which the CQLRelation was
+     * originally created.
+     */
     public String getBase() {
 	return ms.getBase();
     }
 
-    public void addModifier(String modifier) {
-	ms.addModifier(null, modifier);
+    /**
+     * Sets the modifiers of the specified CQLRelation.
+     * Typical relation modifiers include <TT>relevant</TT>,
+     * <TT>fuzzy</TT>, <TT>stem</TT> and <TT>phonetic</TT>.  On the
+     * whole, these modifiers have a meaningful interpretation only
+     * for the text relations.
+     */
+    public void setModifiers(ModifierSet ms) {
+	this.ms = ms;
     }
 
-    // ### should have a public method to retrieve all modifiers
+    /**
+     * Returns an array of the modifiers associated with a CQLRelation.
+     * @return
+     *	An array of Modifier objects.
+     */
+    public Vector<Modifier> getModifiers() {
+	return ms.getModifiers();
+    }
 
-    public String toXCQL(int level) {
+    public String toXCQL(int level, Vector prefixes) {
 	return ms.toXCQL(level, "relation");
     }
 
@@ -35,8 +63,11 @@ public class CQLRelation extends CQLNode {
 	return ms.toCQL();
     }
 
-    public String toPQF(Properties config)
-	throws UnknownQualifierException, UnknownRelationException {
-	throw Error("CQLRelation.toPQF() can never be called");
+    public String toPQF(Properties config) throws PQFTranslationException {
+	throw new Error("CQLRelation.toPQF() can never be called");
+    }
+
+    public byte[] toType1BER(Properties config) {
+	throw new Error("CQLRelation.toType1BER() can never be called");
     }
 }