-// $Id: CQLRelation.java,v 1.1 2002-10-30 09:19:26 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.1 2002-10-30 09:19:26 mike Exp $
+ * @version $Id: CQLRelation.java,v 1.17 2007-06-29 10:23:02 mike Exp $
*/
public class CQLRelation extends CQLNode {
- String base;
- Vector modifiers;
+ ModifierSet ms;
+ /**
+ * Creates a new CQLRelation with the specified base relation.
+ * Typical base relations include the usual six ordering relations
+ * (<TT><=</TT>, <TT>></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) {
- this.base = base;
- modifiers = new Vector();
+ ms = new ModifierSet(base);
}
- public void addModifier(String modifier) {
- modifiers.add(modifier);
+ /**
+ * Returns the base relation with which the CQLRelation was
+ * originally created.
+ */
+ public String getBase() {
+ return ms.getBase();
}
- public String[] getModifiers() {
- int n = modifiers.size();
- String[] res = new String[n];
- for (int i = 0; i < n; i++) {
- res[i] = (String) modifiers.get(i);
- }
+ /**
+ * 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;
+ }
- return res;
+ /**
+ * 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) {
- StringBuffer buf = new StringBuffer();
- buf.append (indent(level) + "<relation>\n" +
- indent(level+1) + "<value>" + xq(base) + "</value>\n");
- String[] mods = getModifiers();
- if (mods.length > 0) {
- buf.append(indent(level+1) + "<modifiers>\n");
- for (int i = 0; i < mods.length; i++)
- buf.append(indent(level+2)).
- append("<modifier><value>"). append(mods[i]).
- append("</value></modifier>\n");
- buf.append(indent(level+1) + "</modifiers>\n");
- }
- buf.append(indent(level) + "</relation>\n");
- return buf.toString();
+ public String toXCQL(int level, Vector prefixes) {
+ return ms.toXCQL(level, "relation");
}
public String toCQL() {
- StringBuffer buf = new StringBuffer(base);
- String[] mods = getModifiers();
- for (int i = 0; i < mods.length; i++) {
- buf.append("/").append(mods[i]);
- }
-
- return buf.toString();
+ return ms.toCQL();
}
- public static void main(String[] args) {
- if (args.length < 1) {
- System.err.println("Usage: CQLRelation <base> <modifier>...");
- System.exit(1);
- }
-
- CQLRelation res = new CQLRelation(args[0]);
- for (int i = 1; i < args.length; i++) {
- res.addModifier(args[i]);
- }
+ public String toPQF(Properties config) throws PQFTranslationException {
+ throw new Error("CQLRelation.toPQF() can never be called");
+ }
- System.out.println(res.toCQL());
+ public byte[] toType1BER(Properties config) {
+ throw new Error("CQLRelation.toType1BER() can never be called");
}
}