You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@lucene.apache.org by rm...@apache.org on 2011/12/06 23:04:57 UTC
svn commit: r1211200 - in /lucene/dev/branches/lucene3606: ./
dev-tools/eclipse/ lucene/
lucene/contrib/misc/src/java/org/apache/lucene/index/codecs/
lucene/contrib/misc/src/resources/
lucene/contrib/misc/src/test/org/apache/lucene/index/codecs/ lucene...
Author: rmuir
Date: Tue Dec 6 22:04:55 2011
New Revision: 1211200
URL: http://svn.apache.org/viewvc?rev=1211200&view=rev
Log:
LUCENE-3606: merge trunk to r1211182
Added:
lucene/dev/branches/lucene3606/lucene/src/java/org/apache/lucene/index/codecs/appending/
- copied from r1211182, lucene/dev/trunk/lucene/src/java/org/apache/lucene/index/codecs/appending/
lucene/dev/branches/lucene3606/lucene/src/test/org/apache/lucene/index/codecs/appending/
- copied from r1211182, lucene/dev/trunk/lucene/src/test/org/apache/lucene/index/codecs/appending/
Removed:
lucene/dev/branches/lucene3606/lucene/contrib/misc/src/java/org/apache/lucene/index/codecs/
lucene/dev/branches/lucene3606/lucene/contrib/misc/src/resources/
lucene/dev/branches/lucene3606/lucene/contrib/misc/src/test/org/apache/lucene/index/codecs/
Modified:
lucene/dev/branches/lucene3606/ (props changed)
lucene/dev/branches/lucene3606/dev-tools/eclipse/dot.classpath
lucene/dev/branches/lucene3606/lucene/ (props changed)
lucene/dev/branches/lucene3606/lucene/src/java/org/apache/lucene/index/IndexReader.java
lucene/dev/branches/lucene3606/lucene/src/java/org/apache/lucene/index/codecs/appending/AppendingCodec.java
lucene/dev/branches/lucene3606/lucene/src/resources/META-INF/services/org.apache.lucene.index.codecs.Codec
lucene/dev/branches/lucene3606/lucene/src/test-framework/java/org/apache/lucene/util/LuceneTestCase.java
lucene/dev/branches/lucene3606/lucene/src/test/org/apache/lucene/index/codecs/appending/TestAppendingCodec.java
lucene/dev/branches/lucene3606/solr/ (props changed)
lucene/dev/branches/lucene3606/solr/core/ (props changed)
lucene/dev/branches/lucene3606/solr/core/src/java/ (props changed)
lucene/dev/branches/lucene3606/solr/core/src/java/org/apache/solr/schema/ByteField.java
lucene/dev/branches/lucene3606/solr/core/src/java/org/apache/solr/schema/DoubleField.java
lucene/dev/branches/lucene3606/solr/core/src/java/org/apache/solr/schema/FloatField.java
lucene/dev/branches/lucene3606/solr/core/src/java/org/apache/solr/schema/IntField.java
lucene/dev/branches/lucene3606/solr/core/src/java/org/apache/solr/schema/LongField.java
lucene/dev/branches/lucene3606/solr/core/src/java/org/apache/solr/schema/ShortField.java
lucene/dev/branches/lucene3606/solr/core/src/java/org/apache/solr/schema/SortableDoubleField.java
lucene/dev/branches/lucene3606/solr/core/src/java/org/apache/solr/schema/SortableFloatField.java
lucene/dev/branches/lucene3606/solr/core/src/java/org/apache/solr/schema/SortableIntField.java
lucene/dev/branches/lucene3606/solr/core/src/java/org/apache/solr/schema/SortableLongField.java
lucene/dev/branches/lucene3606/solr/core/src/java/org/apache/solr/schema/TrieDoubleField.java
lucene/dev/branches/lucene3606/solr/core/src/java/org/apache/solr/schema/TrieFloatField.java
lucene/dev/branches/lucene3606/solr/core/src/java/org/apache/solr/schema/TrieIntField.java
lucene/dev/branches/lucene3606/solr/core/src/java/org/apache/solr/schema/TrieLongField.java
Modified: lucene/dev/branches/lucene3606/dev-tools/eclipse/dot.classpath
URL: http://svn.apache.org/viewvc/lucene/dev/branches/lucene3606/dev-tools/eclipse/dot.classpath?rev=1211200&r1=1211199&r2=1211200&view=diff
==============================================================================
--- lucene/dev/branches/lucene3606/dev-tools/eclipse/dot.classpath (original)
+++ lucene/dev/branches/lucene3606/dev-tools/eclipse/dot.classpath Tue Dec 6 22:04:55 2011
@@ -13,7 +13,6 @@
<classpathentry kind="src" path="lucene/contrib/memory/src/java"/>
<classpathentry kind="src" path="lucene/contrib/memory/src/test"/>
<classpathentry kind="src" path="lucene/contrib/misc/src/java"/>
- <classpathentry kind="src" output="bin.misc" path="lucene/contrib/misc/src/resources"/>
<classpathentry kind="src" path="lucene/contrib/misc/src/test"/>
<classpathentry kind="src" path="lucene/contrib/sandbox/src/java"/>
<classpathentry kind="src" path="lucene/contrib/sandbox/src/test"/>
Modified: lucene/dev/branches/lucene3606/lucene/src/java/org/apache/lucene/index/IndexReader.java
URL: http://svn.apache.org/viewvc/lucene/dev/branches/lucene3606/lucene/src/java/org/apache/lucene/index/IndexReader.java?rev=1211200&r1=1211199&r2=1211200&view=diff
==============================================================================
--- lucene/dev/branches/lucene3606/lucene/src/java/org/apache/lucene/index/IndexReader.java (original)
+++ lucene/dev/branches/lucene3606/lucene/src/java/org/apache/lucene/index/IndexReader.java Tue Dec 6 22:04:55 2011
@@ -31,6 +31,7 @@ import org.apache.lucene.document.Docume
import org.apache.lucene.index.codecs.PerDocValues;
import org.apache.lucene.index.values.IndexDocValues;
import org.apache.lucene.search.FieldCache; // javadocs
+import org.apache.lucene.search.SearcherManager; // javadocs
import org.apache.lucene.store.*;
import org.apache.lucene.util.ArrayUtil;
import org.apache.lucene.util.Bits;
@@ -372,8 +373,7 @@ public abstract class IndexReader implem
* for doing so); if a new reader is returned you also
* must eventually close it. Be sure to never close a
* reader while other threads are still using it; see
- * <code>SearcherManager</code> in
- * <code>contrib/misc</code> to simplify managing this.
+ * {@link SearcherManager} to simplify managing this.
*
* @throws CorruptIndexException if the index is corrupt
* @throws IOException if there is a low-level IO error
Modified: lucene/dev/branches/lucene3606/lucene/src/java/org/apache/lucene/index/codecs/appending/AppendingCodec.java
URL: http://svn.apache.org/viewvc/lucene/dev/branches/lucene3606/lucene/src/java/org/apache/lucene/index/codecs/appending/AppendingCodec.java?rev=1211200&r1=1211182&r2=1211200&view=diff
==============================================================================
--- lucene/dev/branches/lucene3606/lucene/src/java/org/apache/lucene/index/codecs/appending/AppendingCodec.java (original)
+++ lucene/dev/branches/lucene3606/lucene/src/java/org/apache/lucene/index/codecs/appending/AppendingCodec.java Tue Dec 6 22:04:55 2011
@@ -20,6 +20,7 @@ package org.apache.lucene.index.codecs.a
import org.apache.lucene.index.codecs.Codec;
import org.apache.lucene.index.codecs.DocValuesFormat;
import org.apache.lucene.index.codecs.FieldInfosFormat;
+import org.apache.lucene.index.codecs.NormsFormat;
import org.apache.lucene.index.codecs.StoredFieldsFormat;
import org.apache.lucene.index.codecs.PostingsFormat;
import org.apache.lucene.index.codecs.SegmentInfosFormat;
@@ -27,6 +28,7 @@ import org.apache.lucene.index.codecs.Te
import org.apache.lucene.index.codecs.lucene40.Lucene40Codec;
import org.apache.lucene.index.codecs.lucene40.Lucene40FieldInfosFormat;
import org.apache.lucene.index.codecs.lucene40.Lucene40DocValuesFormat;
+import org.apache.lucene.index.codecs.lucene40.Lucene40NormsFormat;
import org.apache.lucene.index.codecs.lucene40.Lucene40StoredFieldsFormat;
import org.apache.lucene.index.codecs.lucene40.Lucene40TermVectorsFormat;
@@ -47,6 +49,7 @@ public class AppendingCodec extends Code
private final FieldInfosFormat fieldInfos = new Lucene40FieldInfosFormat();
private final TermVectorsFormat vectors = new Lucene40TermVectorsFormat();
private final DocValuesFormat docValues = new Lucene40DocValuesFormat();
+ private final NormsFormat norms = new Lucene40NormsFormat();
@Override
public PostingsFormat postingsFormat() {
@@ -77,4 +80,9 @@ public class AppendingCodec extends Code
public FieldInfosFormat fieldInfosFormat() {
return fieldInfos;
}
+
+ @Override
+ public NormsFormat normsFormat() {
+ return norms;
+ }
}
Modified: lucene/dev/branches/lucene3606/lucene/src/resources/META-INF/services/org.apache.lucene.index.codecs.Codec
URL: http://svn.apache.org/viewvc/lucene/dev/branches/lucene3606/lucene/src/resources/META-INF/services/org.apache.lucene.index.codecs.Codec?rev=1211200&r1=1211199&r2=1211200&view=diff
==============================================================================
--- lucene/dev/branches/lucene3606/lucene/src/resources/META-INF/services/org.apache.lucene.index.codecs.Codec (original)
+++ lucene/dev/branches/lucene3606/lucene/src/resources/META-INF/services/org.apache.lucene.index.codecs.Codec Tue Dec 6 22:04:55 2011
@@ -16,3 +16,4 @@
org.apache.lucene.index.codecs.lucene40.Lucene40Codec
org.apache.lucene.index.codecs.lucene3x.Lucene3xCodec
org.apache.lucene.index.codecs.simpletext.SimpleTextCodec
+org.apache.lucene.index.codecs.appending.AppendingCodec
Modified: lucene/dev/branches/lucene3606/lucene/src/test-framework/java/org/apache/lucene/util/LuceneTestCase.java
URL: http://svn.apache.org/viewvc/lucene/dev/branches/lucene3606/lucene/src/test-framework/java/org/apache/lucene/util/LuceneTestCase.java?rev=1211200&r1=1211199&r2=1211200&view=diff
==============================================================================
--- lucene/dev/branches/lucene3606/lucene/src/test-framework/java/org/apache/lucene/util/LuceneTestCase.java (original)
+++ lucene/dev/branches/lucene3606/lucene/src/test-framework/java/org/apache/lucene/util/LuceneTestCase.java Tue Dec 6 22:04:55 2011
@@ -40,6 +40,7 @@ import org.apache.lucene.document.FieldT
import org.apache.lucene.index.*;
import org.apache.lucene.index.codecs.Codec;
import org.apache.lucene.index.codecs.PostingsFormat;
+import org.apache.lucene.index.codecs.appending.AppendingCodec;
import org.apache.lucene.index.codecs.lucene40.Lucene40Codec;
import org.apache.lucene.index.codecs.preflexrw.PreFlexRWCodec;
import org.apache.lucene.index.codecs.simpletext.SimpleTextCodec;
@@ -286,6 +287,8 @@ public abstract class LuceneTestCase ext
PREFLEX_IMPERSONATION_IS_ACTIVE = true;
} else if ("SimpleText".equals(TEST_CODEC) || ("random".equals(TEST_CODEC) && randomVal == 9)) {
codec = new SimpleTextCodec();
+ } else if ("Appending".equals(TEST_CODEC) || ("random".equals(TEST_CODEC) && randomVal == 8)) {
+ codec = new AppendingCodec();
} else if (!"random".equals(TEST_CODEC)) {
codec = Codec.forName(TEST_CODEC);
} else if ("random".equals(TEST_POSTINGSFORMAT)) {
Modified: lucene/dev/branches/lucene3606/lucene/src/test/org/apache/lucene/index/codecs/appending/TestAppendingCodec.java
URL: http://svn.apache.org/viewvc/lucene/dev/branches/lucene3606/lucene/src/test/org/apache/lucene/index/codecs/appending/TestAppendingCodec.java?rev=1211200&r1=1211182&r2=1211200&view=diff
==============================================================================
--- lucene/dev/branches/lucene3606/lucene/src/test/org/apache/lucene/index/codecs/appending/TestAppendingCodec.java (original)
+++ lucene/dev/branches/lucene3606/lucene/src/test/org/apache/lucene/index/codecs/appending/TestAppendingCodec.java Tue Dec 6 22:04:55 2011
@@ -123,7 +123,7 @@ public class TestAppendingCodec extends
writer.addDocument(doc);
writer.forceMerge(1);
writer.close();
- IndexReader reader = IndexReader.open(dir, null, true, 1);
+ IndexReader reader = IndexReader.open(dir, 1);
assertEquals(2, reader.numDocs());
Document doc2 = reader.document(0);
assertEquals(text, doc2.get("f"));
Modified: lucene/dev/branches/lucene3606/solr/core/src/java/org/apache/solr/schema/ByteField.java
URL: http://svn.apache.org/viewvc/lucene/dev/branches/lucene3606/solr/core/src/java/org/apache/solr/schema/ByteField.java?rev=1211200&r1=1211199&r2=1211200&view=diff
==============================================================================
--- lucene/dev/branches/lucene3606/solr/core/src/java/org/apache/solr/schema/ByteField.java (original)
+++ lucene/dev/branches/lucene3606/solr/core/src/java/org/apache/solr/schema/ByteField.java Tue Dec 6 22:04:55 2011
@@ -28,7 +28,21 @@ import java.io.IOException;
import java.util.Map;
/**
+ * A numeric field that can contain 8-bit signed two's complement integer
+ * values, encoded as simple Strings.
*
+ * <p>
+ * Field values will sort numerically, but Range Queries (and other features
+ * that rely on numeric ranges) will not work as expected: values will be
+ * evaluated in unicode String order, not numeric order.
+ * </p>
+ *
+ * <ul>
+ * <li>Min Value Allowed: -128</li>
+ * <li>Max Value Allowed: 127</li>
+ * </ul>
+ *
+ * @see Byte
*/
public class ByteField extends FieldType {
@Override
Modified: lucene/dev/branches/lucene3606/solr/core/src/java/org/apache/solr/schema/DoubleField.java
URL: http://svn.apache.org/viewvc/lucene/dev/branches/lucene3606/solr/core/src/java/org/apache/solr/schema/DoubleField.java?rev=1211200&r1=1211199&r2=1211200&view=diff
==============================================================================
--- lucene/dev/branches/lucene3606/solr/core/src/java/org/apache/solr/schema/DoubleField.java (original)
+++ lucene/dev/branches/lucene3606/solr/core/src/java/org/apache/solr/schema/DoubleField.java Tue Dec 6 22:04:55 2011
@@ -28,7 +28,18 @@ import java.io.IOException;
import java.util.Map;
/**
+ * A legacy numeric field type that encodes "Double" values as simple Strings.
+ * This class should not be used except by people with existing indexes that
+ * contain numeric values indexed as Strings.
+ * New schemas should use {@link TrieDoubleField}.
*
+ * <p>
+ * Field values will sort numerically, but Range Queries (and other features
+ * that rely on numeric ranges) will not work as expected: values will be
+ * evaluated in unicode String order, not numeric order.
+ * </p>
+ *
+ * @see TrieDoubleField
*/
public class DoubleField extends FieldType {
@Override
Modified: lucene/dev/branches/lucene3606/solr/core/src/java/org/apache/solr/schema/FloatField.java
URL: http://svn.apache.org/viewvc/lucene/dev/branches/lucene3606/solr/core/src/java/org/apache/solr/schema/FloatField.java?rev=1211200&r1=1211199&r2=1211200&view=diff
==============================================================================
--- lucene/dev/branches/lucene3606/solr/core/src/java/org/apache/solr/schema/FloatField.java (original)
+++ lucene/dev/branches/lucene3606/solr/core/src/java/org/apache/solr/schema/FloatField.java Tue Dec 6 22:04:55 2011
@@ -27,7 +27,18 @@ import org.apache.solr.response.TextResp
import java.util.Map;
import java.io.IOException;
/**
+ * A legacy numeric field type that encodes "Float" values as simple Strings.
+ * This class should not be used except by people with existing indexes that
+ * contain numeric values indexed as Strings.
+ * New schemas should use {@link TrieFloatField}.
*
+ * <p>
+ * Field values will sort numerically, but Range Queries (and other features
+ * that rely on numeric ranges) will not work as expected: values will be
+ * evaluated in unicode String order, not numeric order.
+ * </p>
+ *
+ * @see TrieFloatField
*/
public class FloatField extends FieldType {
@Override
Modified: lucene/dev/branches/lucene3606/solr/core/src/java/org/apache/solr/schema/IntField.java
URL: http://svn.apache.org/viewvc/lucene/dev/branches/lucene3606/solr/core/src/java/org/apache/solr/schema/IntField.java?rev=1211200&r1=1211199&r2=1211200&view=diff
==============================================================================
--- lucene/dev/branches/lucene3606/solr/core/src/java/org/apache/solr/schema/IntField.java (original)
+++ lucene/dev/branches/lucene3606/solr/core/src/java/org/apache/solr/schema/IntField.java Tue Dec 6 22:04:55 2011
@@ -27,7 +27,18 @@ import org.apache.solr.response.TextResp
import java.util.Map;
import java.io.IOException;
/**
+ * A legacy numeric field type that encodes "Integer" values as simple Strings.
+ * This class should not be used except by people with existing indexes that
+ * contain numeric values indexed as Strings.
+ * New schemas should use {@link TrieIntField}.
*
+ * <p>
+ * Field values will sort numerically, but Range Queries (and other features
+ * that rely on numeric ranges) will not work as expected: values will be
+ * evaluated in unicode String order, not numeric order.
+ * </p>
+ *
+ * @see TrieIntField
*/
public class IntField extends FieldType {
@Override
Modified: lucene/dev/branches/lucene3606/solr/core/src/java/org/apache/solr/schema/LongField.java
URL: http://svn.apache.org/viewvc/lucene/dev/branches/lucene3606/solr/core/src/java/org/apache/solr/schema/LongField.java?rev=1211200&r1=1211199&r2=1211200&view=diff
==============================================================================
--- lucene/dev/branches/lucene3606/solr/core/src/java/org/apache/solr/schema/LongField.java (original)
+++ lucene/dev/branches/lucene3606/solr/core/src/java/org/apache/solr/schema/LongField.java Tue Dec 6 22:04:55 2011
@@ -27,7 +27,18 @@ import org.apache.solr.search.QParser;
import java.io.IOException;
import java.util.Map;
/**
+ * A legacy numeric field type that encodes "Long" values as simple Strings.
+ * This class should not be used except by people with existing indexes that
+ * contain numeric values indexed as Strings.
+ * New schemas should use {@link TrieLongField}.
*
+ * <p>
+ * Field values will sort numerically, but Range Queries (and other features
+ * that rely on numeric ranges) will not work as expected: values will be
+ * evaluated in unicode String order, not numeric order.
+ * </p>
+ *
+ * @see TrieLongField
*/
public class LongField extends FieldType {
@Override
Modified: lucene/dev/branches/lucene3606/solr/core/src/java/org/apache/solr/schema/ShortField.java
URL: http://svn.apache.org/viewvc/lucene/dev/branches/lucene3606/solr/core/src/java/org/apache/solr/schema/ShortField.java?rev=1211200&r1=1211199&r2=1211200&view=diff
==============================================================================
--- lucene/dev/branches/lucene3606/solr/core/src/java/org/apache/solr/schema/ShortField.java (original)
+++ lucene/dev/branches/lucene3606/solr/core/src/java/org/apache/solr/schema/ShortField.java Tue Dec 6 22:04:55 2011
@@ -29,8 +29,21 @@ import java.util.Map;
/**
+ * A numeric field that can contain 16-bit signed two's complement integer
+ * values, encoded as simple Strings.
*
+ * <p>
+ * Field values will sort numerically, but Range Queries (and other features
+ * that rely on numeric ranges) will not work as expected: values will be
+ * evaluated in unicode String order, not numeric order.
+ * </p>
*
+ * <ul>
+ * <li>Min Value Allowed: -32768</li>
+ * <li>Max Value Allowed: 32767</li>
+ * </ul>
+ *
+ * @see Short
**/
public class ShortField extends FieldType {
@Override
Modified: lucene/dev/branches/lucene3606/solr/core/src/java/org/apache/solr/schema/SortableDoubleField.java
URL: http://svn.apache.org/viewvc/lucene/dev/branches/lucene3606/solr/core/src/java/org/apache/solr/schema/SortableDoubleField.java?rev=1211200&r1=1211199&r2=1211200&view=diff
==============================================================================
--- lucene/dev/branches/lucene3606/solr/core/src/java/org/apache/solr/schema/SortableDoubleField.java (original)
+++ lucene/dev/branches/lucene3606/solr/core/src/java/org/apache/solr/schema/SortableDoubleField.java Tue Dec 6 22:04:55 2011
@@ -36,8 +36,19 @@ import org.apache.solr.response.TextResp
import java.util.Map;
import java.io.IOException;
/**
+ * A legacy numeric field type that encodes "Double" values as Strings such
+ * that Term enumeration order matches the natural numeric order. This class
+ * should not be used except by people with existing indexes that already
+ * contain fields of this type. New schemas should use {@link TrieDoubleField}.
*
+ * <p>
+ * The naming convention "Sortable" comes from the fact that both the numeric
+ * values and encoded String representations Sort identically (as opposed to
+ * a direct String representation where values such as "11" sort before values
+ * such as "2").
+ * </p>
*
+ * @see TrieDoubleField
* @deprecated use {@link DoubleField} or {@link TrieDoubleField} - will be removed in 5.x
*/
@Deprecated
Modified: lucene/dev/branches/lucene3606/solr/core/src/java/org/apache/solr/schema/SortableFloatField.java
URL: http://svn.apache.org/viewvc/lucene/dev/branches/lucene3606/solr/core/src/java/org/apache/solr/schema/SortableFloatField.java?rev=1211200&r1=1211199&r2=1211200&view=diff
==============================================================================
--- lucene/dev/branches/lucene3606/solr/core/src/java/org/apache/solr/schema/SortableFloatField.java (original)
+++ lucene/dev/branches/lucene3606/solr/core/src/java/org/apache/solr/schema/SortableFloatField.java Tue Dec 6 22:04:55 2011
@@ -35,9 +35,21 @@ import org.apache.solr.response.TextResp
import java.util.Map;
import java.io.IOException;
+
/**
+ * A legacy numeric field type that encodes "Float" values as Strings such
+ * that Term enumeration order matches the natural numeric order. This class
+ * should not be used except by people with existing indexes that already
+ * contain fields of this type. New schemas should use {@link TrieFloatField}.
+ *
+ * <p>
+ * The naming convention "Sortable" comes from the fact that both the numeric
+ * values and encoded String representations Sort identically (as opposed to
+ * a direct String representation where values such as "11" sort before values
+ * such as "2").
+ * </p>
*
- *
+ * @see TrieFloatField
* @deprecated use {@link FloatField} or {@link TrieFloatField} - will be removed in 5.x
*/
@Deprecated
Modified: lucene/dev/branches/lucene3606/solr/core/src/java/org/apache/solr/schema/SortableIntField.java
URL: http://svn.apache.org/viewvc/lucene/dev/branches/lucene3606/solr/core/src/java/org/apache/solr/schema/SortableIntField.java?rev=1211200&r1=1211199&r2=1211200&view=diff
==============================================================================
--- lucene/dev/branches/lucene3606/solr/core/src/java/org/apache/solr/schema/SortableIntField.java (original)
+++ lucene/dev/branches/lucene3606/solr/core/src/java/org/apache/solr/schema/SortableIntField.java Tue Dec 6 22:04:55 2011
@@ -35,9 +35,21 @@ import org.apache.solr.response.TextResp
import java.util.Map;
import java.io.IOException;
+
/**
+ * A legacy numeric field type that encodes "Integer" values as Strings such
+ * that Term enumeration order matches the natural numeric order. This class
+ * should not be used except by people with existing indexes that already
+ * contain fields of this type. New schemas should use {@link TrieIntField}.
*
+ * <p>
+ * The naming convention "Sortable" comes from the fact that both the numeric
+ * values and encoded String representations Sort identically (as opposed to
+ * a direct String representation where values such as "11" sort before values
+ * such as "2").
+ * </p>
*
+ * @see TrieIntField
* @deprecated use {@link IntField} or {@link TrieIntField} - will be removed in 5.x
*/
@Deprecated
Modified: lucene/dev/branches/lucene3606/solr/core/src/java/org/apache/solr/schema/SortableLongField.java
URL: http://svn.apache.org/viewvc/lucene/dev/branches/lucene3606/solr/core/src/java/org/apache/solr/schema/SortableLongField.java?rev=1211200&r1=1211199&r2=1211200&view=diff
==============================================================================
--- lucene/dev/branches/lucene3606/solr/core/src/java/org/apache/solr/schema/SortableLongField.java (original)
+++ lucene/dev/branches/lucene3606/solr/core/src/java/org/apache/solr/schema/SortableLongField.java Tue Dec 6 22:04:55 2011
@@ -36,8 +36,19 @@ import org.apache.solr.response.TextResp
import java.util.Map;
import java.io.IOException;
/**
+ * A legacy numeric field type that encodes "Long" values as Strings such
+ * that Term enumeration order matches the natural numeric order. This class
+ * should not be used except by people with existing indexes that already
+ * contain fields of this type. New schemas should use {@link TrieLongField}.
*
+ * <p>
+ * The naming convention "Sortable" comes from the fact that both the numeric
+ * values and encoded String representations Sort identically (as opposed to
+ * a direct String representation where values such as "11" sort before values
+ * such as "2").
+ * </p>
*
+ * @see TrieLongField
* @deprecated use {@link LongField} or {@link TrieLongField} - will be removed in 5.x
*/
@Deprecated
Modified: lucene/dev/branches/lucene3606/solr/core/src/java/org/apache/solr/schema/TrieDoubleField.java
URL: http://svn.apache.org/viewvc/lucene/dev/branches/lucene3606/solr/core/src/java/org/apache/solr/schema/TrieDoubleField.java?rev=1211200&r1=1211199&r2=1211200&view=diff
==============================================================================
--- lucene/dev/branches/lucene3606/solr/core/src/java/org/apache/solr/schema/TrieDoubleField.java (original)
+++ lucene/dev/branches/lucene3606/solr/core/src/java/org/apache/solr/schema/TrieDoubleField.java Tue Dec 6 22:04:55 2011
@@ -17,6 +17,22 @@
package org.apache.solr.schema;
+/**
+ * A numeric field that can contain double-precision 64-bit IEEE 754 floating
+ * point values.
+ *
+ * <ul>
+ * <li>Min Value Allowed: 4.9E-324</li>
+ * <li>Max Value Allowed: 1.7976931348623157E308</li>
+ * </ul>
+ *
+ * <b>NOTE:</b> The behavior of this class when given values of
+ * {@link Double#NaN}, {@link Double#NEGATIVE_INFINITY}, or
+ * {@link Double#POSITIVE_INFINITY} is undefined.
+ *
+ * @see Double
+ * @see <a href="http://java.sun.com/docs/books/jls/third_edition/html/typesValues.html#4.2.3">Java Language Specification, s4.2.3</a>
+ */
public class TrieDoubleField extends TrieField {
{
type=TrieTypes.DOUBLE;
Modified: lucene/dev/branches/lucene3606/solr/core/src/java/org/apache/solr/schema/TrieFloatField.java
URL: http://svn.apache.org/viewvc/lucene/dev/branches/lucene3606/solr/core/src/java/org/apache/solr/schema/TrieFloatField.java?rev=1211200&r1=1211199&r2=1211200&view=diff
==============================================================================
--- lucene/dev/branches/lucene3606/solr/core/src/java/org/apache/solr/schema/TrieFloatField.java (original)
+++ lucene/dev/branches/lucene3606/solr/core/src/java/org/apache/solr/schema/TrieFloatField.java Tue Dec 6 22:04:55 2011
@@ -17,6 +17,22 @@
package org.apache.solr.schema;
+/**
+ * A numeric field that can contain single-precision 32-bit IEEE 754
+ * floating point values.
+ *
+ * <ul>
+ * <li>Min Value Allowed: 1.401298464324817E-45</li>
+ * <li>Max Value Allowed: 3.4028234663852886E38</li>
+ * </ul>
+ *
+ * <b>NOTE:</b> The behavior of this class when given values of
+ * {@link Float#NaN}, {@link Float#NEGATIVE_INFINITY}, or
+ * {@link Float#POSITIVE_INFINITY} is undefined.
+ *
+ * @see Float
+ * @see <a href="http://java.sun.com/docs/books/jls/third_edition/html/typesValues.html#4.2.3">Java Language Specification, s4.2.3</a>
+ */
public class TrieFloatField extends TrieField {
{
type=TrieTypes.FLOAT;
Modified: lucene/dev/branches/lucene3606/solr/core/src/java/org/apache/solr/schema/TrieIntField.java
URL: http://svn.apache.org/viewvc/lucene/dev/branches/lucene3606/solr/core/src/java/org/apache/solr/schema/TrieIntField.java?rev=1211200&r1=1211199&r2=1211200&view=diff
==============================================================================
--- lucene/dev/branches/lucene3606/solr/core/src/java/org/apache/solr/schema/TrieIntField.java (original)
+++ lucene/dev/branches/lucene3606/solr/core/src/java/org/apache/solr/schema/TrieIntField.java Tue Dec 6 22:04:55 2011
@@ -17,6 +17,16 @@
package org.apache.solr.schema;
+/**
+ * A numeric field that can contain 32-bit signed two's complement integer values.
+ *
+ * <ul>
+ * <li>Min Value Allowed: -2147483648</li>
+ * <li>Max Value Allowed: 2147483647</li>
+ * </ul>
+ *
+ * @see Integer
+ */
public class TrieIntField extends TrieField {
{
type=TrieTypes.INTEGER;
Modified: lucene/dev/branches/lucene3606/solr/core/src/java/org/apache/solr/schema/TrieLongField.java
URL: http://svn.apache.org/viewvc/lucene/dev/branches/lucene3606/solr/core/src/java/org/apache/solr/schema/TrieLongField.java?rev=1211200&r1=1211199&r2=1211200&view=diff
==============================================================================
--- lucene/dev/branches/lucene3606/solr/core/src/java/org/apache/solr/schema/TrieLongField.java (original)
+++ lucene/dev/branches/lucene3606/solr/core/src/java/org/apache/solr/schema/TrieLongField.java Tue Dec 6 22:04:55 2011
@@ -17,6 +17,16 @@
package org.apache.solr.schema;
+/**
+ * A numeric field that can contain 64-bit signed two's complement integer values.
+ *
+ * <ul>
+ * <li>Min Value Allowed: -9223372036854775808</li>
+ * <li>Max Value Allowed: 9223372036854775807</li>
+ * </ul>
+ *
+ * @see Long
+ */
public class TrieLongField extends TrieField {
{
type=TrieTypes.LONG;