lucene-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From hoss...@apache.org
Subject svn commit: r1210718 - in /lucene/dev/branches/branch_3x: ./ lucene/ solr/ solr/core/src/java/org/apache/solr/schema/
Date Tue, 06 Dec 2011 00:12:54 GMT
Author: hossman
Date: Tue Dec  6 00:12:53 2011
New Revision: 1210718

URL: http://svn.apache.org/viewvc?rev=1210718&view=rev
Log:
SOLR-2935: Better docs for numeric FieldTypes (merge r1210714 from trunk)

Modified:
    lucene/dev/branches/branch_3x/   (props changed)
    lucene/dev/branches/branch_3x/lucene/   (props changed)
    lucene/dev/branches/branch_3x/solr/   (props changed)
    lucene/dev/branches/branch_3x/solr/core/src/java/org/apache/solr/schema/ByteField.java
    lucene/dev/branches/branch_3x/solr/core/src/java/org/apache/solr/schema/DoubleField.java
    lucene/dev/branches/branch_3x/solr/core/src/java/org/apache/solr/schema/FloatField.java
    lucene/dev/branches/branch_3x/solr/core/src/java/org/apache/solr/schema/IntField.java
    lucene/dev/branches/branch_3x/solr/core/src/java/org/apache/solr/schema/LongField.java
    lucene/dev/branches/branch_3x/solr/core/src/java/org/apache/solr/schema/ShortField.java
    lucene/dev/branches/branch_3x/solr/core/src/java/org/apache/solr/schema/SortableDoubleField.java
    lucene/dev/branches/branch_3x/solr/core/src/java/org/apache/solr/schema/SortableFloatField.java
    lucene/dev/branches/branch_3x/solr/core/src/java/org/apache/solr/schema/SortableIntField.java
    lucene/dev/branches/branch_3x/solr/core/src/java/org/apache/solr/schema/SortableLongField.java
    lucene/dev/branches/branch_3x/solr/core/src/java/org/apache/solr/schema/TrieDoubleField.java
    lucene/dev/branches/branch_3x/solr/core/src/java/org/apache/solr/schema/TrieFloatField.java
    lucene/dev/branches/branch_3x/solr/core/src/java/org/apache/solr/schema/TrieIntField.java
    lucene/dev/branches/branch_3x/solr/core/src/java/org/apache/solr/schema/TrieLongField.java

Modified: lucene/dev/branches/branch_3x/solr/core/src/java/org/apache/solr/schema/ByteField.java
URL: http://svn.apache.org/viewvc/lucene/dev/branches/branch_3x/solr/core/src/java/org/apache/solr/schema/ByteField.java?rev=1210718&r1=1210717&r2=1210718&view=diff
==============================================================================
--- lucene/dev/branches/branch_3x/solr/core/src/java/org/apache/solr/schema/ByteField.java
(original)
+++ lucene/dev/branches/branch_3x/solr/core/src/java/org/apache/solr/schema/ByteField.java
Tue Dec  6 00:12:53 2011
@@ -29,7 +29,21 @@ import java.io.IOException;
 import java.util.Map;
 
 /**
- * @version $Id:$
+ * 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/branch_3x/solr/core/src/java/org/apache/solr/schema/DoubleField.java
URL: http://svn.apache.org/viewvc/lucene/dev/branches/branch_3x/solr/core/src/java/org/apache/solr/schema/DoubleField.java?rev=1210718&r1=1210717&r2=1210718&view=diff
==============================================================================
--- lucene/dev/branches/branch_3x/solr/core/src/java/org/apache/solr/schema/DoubleField.java
(original)
+++ lucene/dev/branches/branch_3x/solr/core/src/java/org/apache/solr/schema/DoubleField.java
Tue Dec  6 00:12:53 2011
@@ -29,7 +29,18 @@ import java.io.IOException;
 import java.util.Map;
 
 /**
- * @version $Id$
+ * 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/branch_3x/solr/core/src/java/org/apache/solr/schema/FloatField.java
URL: http://svn.apache.org/viewvc/lucene/dev/branches/branch_3x/solr/core/src/java/org/apache/solr/schema/FloatField.java?rev=1210718&r1=1210717&r2=1210718&view=diff
==============================================================================
--- lucene/dev/branches/branch_3x/solr/core/src/java/org/apache/solr/schema/FloatField.java
(original)
+++ lucene/dev/branches/branch_3x/solr/core/src/java/org/apache/solr/schema/FloatField.java
Tue Dec  6 00:12:53 2011
@@ -28,7 +28,18 @@ import org.apache.solr.response.XMLWrite
 import java.util.Map;
 import java.io.IOException;
 /**
- * @version $Id$
+ * 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/branch_3x/solr/core/src/java/org/apache/solr/schema/IntField.java
URL: http://svn.apache.org/viewvc/lucene/dev/branches/branch_3x/solr/core/src/java/org/apache/solr/schema/IntField.java?rev=1210718&r1=1210717&r2=1210718&view=diff
==============================================================================
--- lucene/dev/branches/branch_3x/solr/core/src/java/org/apache/solr/schema/IntField.java
(original)
+++ lucene/dev/branches/branch_3x/solr/core/src/java/org/apache/solr/schema/IntField.java
Tue Dec  6 00:12:53 2011
@@ -28,7 +28,18 @@ import org.apache.solr.response.XMLWrite
 import java.util.Map;
 import java.io.IOException;
 /**
- * @version $Id$
+ * 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/branch_3x/solr/core/src/java/org/apache/solr/schema/LongField.java
URL: http://svn.apache.org/viewvc/lucene/dev/branches/branch_3x/solr/core/src/java/org/apache/solr/schema/LongField.java?rev=1210718&r1=1210717&r2=1210718&view=diff
==============================================================================
--- lucene/dev/branches/branch_3x/solr/core/src/java/org/apache/solr/schema/LongField.java
(original)
+++ lucene/dev/branches/branch_3x/solr/core/src/java/org/apache/solr/schema/LongField.java
Tue Dec  6 00:12:53 2011
@@ -28,7 +28,18 @@ import org.apache.solr.search.QParser;
 import java.io.IOException;
 import java.util.Map;
 /**
- * @version $Id$
+ * 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/branch_3x/solr/core/src/java/org/apache/solr/schema/ShortField.java
URL: http://svn.apache.org/viewvc/lucene/dev/branches/branch_3x/solr/core/src/java/org/apache/solr/schema/ShortField.java?rev=1210718&r1=1210717&r2=1210718&view=diff
==============================================================================
--- lucene/dev/branches/branch_3x/solr/core/src/java/org/apache/solr/schema/ShortField.java
(original)
+++ lucene/dev/branches/branch_3x/solr/core/src/java/org/apache/solr/schema/ShortField.java
Tue Dec  6 00:12:53 2011
@@ -30,8 +30,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/branch_3x/solr/core/src/java/org/apache/solr/schema/SortableDoubleField.java
URL: http://svn.apache.org/viewvc/lucene/dev/branches/branch_3x/solr/core/src/java/org/apache/solr/schema/SortableDoubleField.java?rev=1210718&r1=1210717&r2=1210718&view=diff
==============================================================================
--- lucene/dev/branches/branch_3x/solr/core/src/java/org/apache/solr/schema/SortableDoubleField.java
(original)
+++ lucene/dev/branches/branch_3x/solr/core/src/java/org/apache/solr/schema/SortableDoubleField.java
Tue Dec  6 00:12:53 2011
@@ -32,7 +32,20 @@ import org.apache.solr.response.XMLWrite
 import java.util.Map;
 import java.io.IOException;
 /**
- * @version $Id$
+ * 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
  */
 public class SortableDoubleField extends FieldType {
   @Override

Modified: lucene/dev/branches/branch_3x/solr/core/src/java/org/apache/solr/schema/SortableFloatField.java
URL: http://svn.apache.org/viewvc/lucene/dev/branches/branch_3x/solr/core/src/java/org/apache/solr/schema/SortableFloatField.java?rev=1210718&r1=1210717&r2=1210718&view=diff
==============================================================================
--- lucene/dev/branches/branch_3x/solr/core/src/java/org/apache/solr/schema/SortableFloatField.java
(original)
+++ lucene/dev/branches/branch_3x/solr/core/src/java/org/apache/solr/schema/SortableFloatField.java
Tue Dec  6 00:12:53 2011
@@ -31,8 +31,22 @@ import org.apache.solr.response.XMLWrite
 
 import java.util.Map;
 import java.io.IOException;
+
 /**
- * @version $Id$
+ * 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
  */
 public class SortableFloatField extends FieldType {
   @Override

Modified: lucene/dev/branches/branch_3x/solr/core/src/java/org/apache/solr/schema/SortableIntField.java
URL: http://svn.apache.org/viewvc/lucene/dev/branches/branch_3x/solr/core/src/java/org/apache/solr/schema/SortableIntField.java?rev=1210718&r1=1210717&r2=1210718&view=diff
==============================================================================
--- lucene/dev/branches/branch_3x/solr/core/src/java/org/apache/solr/schema/SortableIntField.java
(original)
+++ lucene/dev/branches/branch_3x/solr/core/src/java/org/apache/solr/schema/SortableIntField.java
Tue Dec  6 00:12:53 2011
@@ -31,8 +31,22 @@ import org.apache.solr.response.XMLWrite
 
 import java.util.Map;
 import java.io.IOException;
+
 /**
- * @version $Id$
+ * 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
  */
 public class SortableIntField extends FieldType {
   @Override

Modified: lucene/dev/branches/branch_3x/solr/core/src/java/org/apache/solr/schema/SortableLongField.java
URL: http://svn.apache.org/viewvc/lucene/dev/branches/branch_3x/solr/core/src/java/org/apache/solr/schema/SortableLongField.java?rev=1210718&r1=1210717&r2=1210718&view=diff
==============================================================================
--- lucene/dev/branches/branch_3x/solr/core/src/java/org/apache/solr/schema/SortableLongField.java
(original)
+++ lucene/dev/branches/branch_3x/solr/core/src/java/org/apache/solr/schema/SortableLongField.java
Tue Dec  6 00:12:53 2011
@@ -32,7 +32,20 @@ import org.apache.solr.response.XMLWrite
 import java.util.Map;
 import java.io.IOException;
 /**
- * @version $Id$
+ * 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
  */
 public class SortableLongField extends FieldType {
   @Override

Modified: lucene/dev/branches/branch_3x/solr/core/src/java/org/apache/solr/schema/TrieDoubleField.java
URL: http://svn.apache.org/viewvc/lucene/dev/branches/branch_3x/solr/core/src/java/org/apache/solr/schema/TrieDoubleField.java?rev=1210718&r1=1210717&r2=1210718&view=diff
==============================================================================
--- lucene/dev/branches/branch_3x/solr/core/src/java/org/apache/solr/schema/TrieDoubleField.java
(original)
+++ lucene/dev/branches/branch_3x/solr/core/src/java/org/apache/solr/schema/TrieDoubleField.java
Tue Dec  6 00:12:53 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/branch_3x/solr/core/src/java/org/apache/solr/schema/TrieFloatField.java
URL: http://svn.apache.org/viewvc/lucene/dev/branches/branch_3x/solr/core/src/java/org/apache/solr/schema/TrieFloatField.java?rev=1210718&r1=1210717&r2=1210718&view=diff
==============================================================================
--- lucene/dev/branches/branch_3x/solr/core/src/java/org/apache/solr/schema/TrieFloatField.java
(original)
+++ lucene/dev/branches/branch_3x/solr/core/src/java/org/apache/solr/schema/TrieFloatField.java
Tue Dec  6 00:12:53 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/branch_3x/solr/core/src/java/org/apache/solr/schema/TrieIntField.java
URL: http://svn.apache.org/viewvc/lucene/dev/branches/branch_3x/solr/core/src/java/org/apache/solr/schema/TrieIntField.java?rev=1210718&r1=1210717&r2=1210718&view=diff
==============================================================================
--- lucene/dev/branches/branch_3x/solr/core/src/java/org/apache/solr/schema/TrieIntField.java
(original)
+++ lucene/dev/branches/branch_3x/solr/core/src/java/org/apache/solr/schema/TrieIntField.java
Tue Dec  6 00:12:53 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/branch_3x/solr/core/src/java/org/apache/solr/schema/TrieLongField.java
URL: http://svn.apache.org/viewvc/lucene/dev/branches/branch_3x/solr/core/src/java/org/apache/solr/schema/TrieLongField.java?rev=1210718&r1=1210717&r2=1210718&view=diff
==============================================================================
--- lucene/dev/branches/branch_3x/solr/core/src/java/org/apache/solr/schema/TrieLongField.java
(original)
+++ lucene/dev/branches/branch_3x/solr/core/src/java/org/apache/solr/schema/TrieLongField.java
Tue Dec  6 00:12:53 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;



Mime
View raw message