/**
* Connect to searchd server and update given attributes on given documents in given indexes.
* Sample code that will set group_id=123 where id=1 and group_id=456 where id=3:
*
* <pre>
* String[] attrs = new String[1];
*
* attrs[0] = "group_id";
* long[][] values = new long[2][2];
*
* values[0] = new long[2]; values[0][0] = 1; values[0][1] = 123;
* values[1] = new long[2]; values[1][0] = 3; values[1][1] = 456;
*
* int res = cl.UpdateAttributes ( "test1", attrs, values );
* </pre>
*
* @param index index name(s) to update; might be distributed
* @param attrs array with the names of the attributes to update
* @param values array of updates; each long[] entry must contains document ID in the first
* element, and all new attribute values in the following ones
* @param ignorenonexistent the flag whether to silently ignore non existent columns up update
* request
* @return -1 on failure, amount of actually found and updated documents (might be 0) on success
* @throws SphinxException on invalid parameters
*/
public int UpdateAttributes(
String index, String[] attrs, long[][] values, boolean ignorenonexistent)
throws SphinxException {
/* check args */
myAssert(index != null && index.length() > 0, "no index name provided");
myAssert(attrs != null && attrs.length > 0, "no attribute names provided");
myAssert(values != null && values.length > 0, "no update entries provided");
for (int i = 0; i < values.length; i++) {
myAssert(values[i] != null, "update entry #" + i + " is null");
myAssert(values[i].length == 1 + attrs.length, "update entry #" + i + " has wrong length");
}
/* build and send request */
ByteArrayOutputStream reqBuf = new ByteArrayOutputStream();
DataOutputStream req = new DataOutputStream(reqBuf);
try {
writeNetUTF8(req, index);
req.writeInt(attrs.length);
req.writeInt(ignorenonexistent ? 1 : 0);
for (int i = 0; i < attrs.length; i++) {
writeNetUTF8(req, attrs[i]);
req.writeInt(0); // not MVA attr
}
req.writeInt(values.length);
for (int i = 0; i < values.length; i++) {
req.writeLong(values[i][0]); /* send docid as 64bit value */
for (int j = 1; j < values[i].length; j++)
req.writeInt(
(int)
values[i][
j]); /* send values as 32bit values; FIXME! what happens when they are over 2^31? */
}
req.flush();
} catch (Exception e) {
_error = "internal error: failed to build request: " + e;
return -1;
}
/* get and parse response */
DataInputStream in = _DoRequest(SEARCHD_COMMAND_UPDATE, VER_COMMAND_UPDATE, reqBuf);
if (in == null) return -1;
try {
return in.readInt();
} catch (Exception e) {
_error = "incomplete reply";
return -1;
}
}
/**
* Set integer range filter. Only match records if attribute value is beetwen min and max
* (inclusive).
*/
public void SetFilterRange(String attribute, long min, long max, boolean exclude)
throws SphinxException {
myAssert(min <= max, "min must be less or equal to max");
try {
writeNetUTF8(_filters, attribute);
_filters.writeInt(SPH_FILTER_RANGE);
_filters.writeLong(min);
_filters.writeLong(max);
_filters.writeInt(exclude ? 1 : 0);
} catch (Exception e) {
myAssert(false, "IOException: " + e.getMessage());
}
_filterCount++;
}
/** Set values filter. Only match records where attribute value is in given set. */
public void SetFilter(String attribute, long[] values, boolean exclude) throws SphinxException {
myAssert(values != null && values.length > 0, "values array must not be null or empty");
myAssert(
attribute != null && attribute.length() > 0, "attribute name must not be null or empty");
try {
writeNetUTF8(_filters, attribute);
_filters.writeInt(SPH_FILTER_VALUES);
_filters.writeInt(values.length);
for (int i = 0; i < values.length; i++) _filters.writeLong(values[i]);
_filters.writeInt(exclude ? 1 : 0);
} catch (Exception e) {
myAssert(false, "IOException: " + e.getMessage());
}
_filterCount++;
}
/** Add new query with current settings to current search request. */
public int AddQuery(String query, String index, String comment) throws SphinxException {
ByteArrayOutputStream req = new ByteArrayOutputStream();
/* build request */
try {
DataOutputStream out = new DataOutputStream(req);
out.writeInt(_offset);
out.writeInt(_limit);
out.writeInt(_mode);
out.writeInt(_ranker);
if (_ranker == SPH_RANK_EXPR) {
writeNetUTF8(out, _rankexpr);
}
out.writeInt(_sort);
writeNetUTF8(out, _sortby);
writeNetUTF8(out, query);
int weightLen = _weights != null ? _weights.length : 0;
out.writeInt(weightLen);
if (_weights != null) {
for (int i = 0; i < _weights.length; i++) out.writeInt(_weights[i]);
}
writeNetUTF8(out, index);
out.writeInt(0);
out.writeInt(_minId);
out.writeInt(_maxId);
/* filters */
out.writeInt(_filterCount);
out.write(_rawFilters.toByteArray());
/* group-by, max matches, sort-by-group flag */
out.writeInt(_groupFunc);
writeNetUTF8(out, _groupBy);
out.writeInt(_maxMatches);
writeNetUTF8(out, _groupSort);
out.writeInt(_cutoff);
out.writeInt(_retrycount);
out.writeInt(_retrydelay);
writeNetUTF8(out, _groupDistinct);
/* anchor point */
if (_latitudeAttr == null
|| _latitudeAttr.length() == 0
|| _longitudeAttr == null
|| _longitudeAttr.length() == 0) {
out.writeInt(0);
} else {
out.writeInt(1);
writeNetUTF8(out, _latitudeAttr);
writeNetUTF8(out, _longitudeAttr);
out.writeFloat(_latitude);
out.writeFloat(_longitude);
}
/* per-index weights */
out.writeInt(_indexWeights.size());
for (Iterator e = _indexWeights.keySet().iterator(); e.hasNext(); ) {
String indexName = (String) e.next();
Integer weight = (Integer) _indexWeights.get(indexName);
writeNetUTF8(out, indexName);
out.writeInt(weight.intValue());
}
/* max query time */
out.writeInt(_maxQueryTime);
/* per-field weights */
out.writeInt(_fieldWeights.size());
for (Iterator e = _fieldWeights.keySet().iterator(); e.hasNext(); ) {
String field = (String) e.next();
Integer weight = (Integer) _fieldWeights.get(field);
writeNetUTF8(out, field);
out.writeInt(weight.intValue());
}
/* comment */
writeNetUTF8(out, comment);
/* overrides */
out.writeInt(_overrideTypes.size());
for (Iterator e = _overrideTypes.keySet().iterator(); e.hasNext(); ) {
String attr = (String) e.next();
Integer type = (Integer) _overrideTypes.get(attr);
Map values = (Map) _overrideValues.get(attr);
writeNetUTF8(out, attr);
out.writeInt(type.intValue());
out.writeInt(values.size());
for (Iterator e2 = values.keySet().iterator(); e2.hasNext(); ) {
Long id = (Long) e2.next();
out.writeLong(id.longValue());
switch (type.intValue()) {
case SPH_ATTR_FLOAT:
out.writeFloat(((Float) values.get(id)).floatValue());
break;
case SPH_ATTR_BIGINT:
out.writeLong(((Long) values.get(id)).longValue());
break;
default:
out.writeInt(((Integer) values.get(id)).intValue());
break;
}
}
}
/* select-list */
writeNetUTF8(out, _select);
/* done! */
out.flush();
int qIndex = _reqs.size();
_reqs.add(qIndex, req.toByteArray());
return qIndex;
} catch (Exception e) {
myAssert(false, "error in AddQuery(): " + e + ": " + e.getMessage());
} finally {
try {
_filters.close();
_rawFilters.close();
} catch (IOException e) {
myAssert(false, "error in AddQuery(): " + e + ": " + e.getMessage());
}
}
return -1;
}