¿Cuál es la elipsis (...) para la firma de este método?

Question

En el App Engine docs, ¿cuál es la elipsis (JID...) para este método de firma?

public MessageBuilder withRecipientJids(JID... recipientJids) 

¿Cuál es la función de esos tres puntos?

Answer 1

Esas son varargs de Java. Le permiten pasar cualquier cantidad de objetos de un tipo específico (en este caso son de tipo JID).

En su ejemplo, las siguientes llamadas a funciones serían válidas:

MessageBuilder msgBuilder; //There should probably be a call to a constructor here ;) 
MessageBuilder msgBuilder2; 
msgBuilder.withRecipientJids(jid1, jid2); 
msgBuilder2.withRecipientJids(jid1, jid2, jid78_a, someOtherJid); 

Ver más aquí: http://java.sun.com/j2se/1.5.0/docs/guide/language/varargs.html

Answer 2

Esto significa que el método acepta un variable number of arguments ("varargs") de tipo JID. Dentro del método, se presenta recipientJids.

Esto es útil para casos en los que tiene un método que puede manejar opcionalmente más de un argumento de forma natural, y le permite escribir llamadas que pueden pasar uno, dos o tres parámetros al mismo método, sin tener la fealdad de crear una matriz sobre la marcha.

También permite modismos como sprintf de C; ver String.format(), por ejemplo.

Answer 3

Esos son varargs se utilizan para crear un método que recibe cualquier número de argumentos.

Por ejemplo, el método PrintStream.printf lo usa, ya que no sabe cuántos argumentos usaría.

Solo se pueden usar como posición final de los argumentos.

varargs se se añadió en Java 1.5

Answer 4

La notación de tres puntos (...) es en realidad tomado de las matemáticas, y significa "... y así sucesivamente".

En cuanto a su uso en Java, significa varargs, lo que significa que se puede agregar cualquier cantidad de argumentos a la llamada al método. Las únicas limitaciones son que el varargs debe estar al final de la firma del método y solo puede haber uno por método.

Answer 5

La manera de utilizar los puntos suspensivos o varargs dentro del método es como si fuera una matriz:

public void PrintWithEllipsis(String...setOfStrings) { 
    for (String s : setOfStrings) 
     System.out.println(s); 
} 

Este método puede ser llamado como siguiente:

obj.PrintWithEllipsis(); // prints nothing 
obj.PrintWithEllipsis("first"); // prints "first" 
obj.PrintWithEllipsis("first", "second"); // prints "first\nsecond" 

Dentro PrintWithEllipsis, el tipo de setOfStrings es una matriz de Cadena. por lo que podría salvar el compilador algo de trabajo y pasar un array:

String[] argsVar = {"first", "second"}; 
obj.PrintWithEllipsis(argsVar); 

Para varargs métodos, un parámetro de secuencia se trata como si fuera una matriz del mismo tipo.Así que si dos firmas difieren solamente en que uno declara una secuencia y el otro una matriz, como en este ejemplo:

void process(String[] s){} 
void process(String...s){} 

entonces se produce un error de tiempo de compilación.

Fuente: The Java Programming Language especificación, donde el término técnico es variable arity parameter en lugar del término común varargs.

Answer 6

Puede definir un parámetro que pueda aceptar argumentos variables (varargs) en sus métodos. Lo que sigue es un ejemplo de clase Empleado, que define un daysOffWork método que acepta argumentos variables:

class Employee { 
    public int daysOffWork(int... days) { 
     int daysOff = 0; 
     for (int i = 0; i < days.length; i++) { 
      daysOff += days[i]; 
     } 
     return daysOff; 
    } 
} 

los puntos suspensivos (...) que sigue el tipo de datos indica que el parámetro método día pueden pasar una matriz o valores separados por comas múltiples.