В чем разница между JavaConverters и JavaConversion в Scala?

Question

В scala.collection есть два очень похожих объекта JavaConversions и JavaConverters.

• В чем разница между этими двумя объектами?
• Почему они оба существуют?
• Когда я хочу использовать одно против другого?

Answer 1

JavaConversions предоставляют серию неявных методов, которые преобразуют между коллекцией Java и ближайшей соответствующей коллекцией Scala, и наоборот. Это делается путем создания оболочек, которые реализуют либо интерфейс Scala и перенаправляют вызовы в базовую коллекцию Java, либо в интерфейс Java, перенаправляя вызовы в базовую коллекцию Scala.

JavaConverters использует шаблон pimp-my-library для «добавления» метода asScala к коллекциям Java и метода asJava к коллекциям Scala, которые возвращают соответствующие оболочки, обсужденные выше. Он новее (начиная с версии 2.8.1), чем JavaConversions (начиная с версии 2.8), и делает преобразование между Scala и коллекцией Java явным. Вопреки тому, что Дэвид пишет в своем ответе, я бы порекомендовал вам использовать привычку использовать JavaConverters, так как у вас будет гораздо меньше шансов написать код, который выполняет много неявных преобразований, поскольку вы можете контролировать единственное место, где это произойдет: где вы пишете .asScala или .asJava.

Вот методы преобразования, которые JavaConverters предоставляют:

Pimped Type                            | Conversion Method   | Returned Type
=================================================================================================
scala.collection.Iterator              | asJava              | java.util.Iterator
scala.collection.Iterator              | asJavaEnumeration   | java.util.Enumeration
scala.collection.Iterable              | asJava              | java.lang.Iterable
scala.collection.Iterable              | asJavaCollection    | java.util.Collection
scala.collection.mutable.Buffer        | asJava              | java.util.List
scala.collection.mutable.Seq           | asJava              | java.util.List
scala.collection.Seq                   | asJava              | java.util.List
scala.collection.mutable.Set           | asJava              | java.util.Set
scala.collection.Set                   | asJava              | java.util.Set
scala.collection.mutable.Map           | asJava              | java.util.Map
scala.collection.Map                   | asJava              | java.util.Map
scala.collection.mutable.Map           | asJavaDictionary    | java.util.Dictionary
scala.collection.mutable.ConcurrentMap | asJavaConcurrentMap | java.util.concurrent.ConcurrentMap
—————————————————————————————————————————————————————————————————————————————————————————————————
java.util.Iterator                     | asScala             | scala.collection.Iterator
java.util.Enumeration                  | asScala             | scala.collection.Iterator
java.lang.Iterable                     | asScala             | scala.collection.Iterable
java.util.Collection                   | asScala             | scala.collection.Iterable
java.util.List                         | asScala             | scala.collection.mutable.Buffer
java.util.Set                          | asScala             | scala.collection.mutable.Set
java.util.Map                          | asScala             | scala.collection.mutable.Map
java.util.concurrent.ConcurrentMap     | asScala             | scala.collection.mutable.ConcurrentMap
java.util.Dictionary                   | asScala             | scala.collection.mutable.Map
java.util.Properties                   | asScala             | scala.collection.mutable.Map[String, String]

Чтобы использовать преобразования напрямую из Java, лучше вызывать методы непосредственно из JavaConversions; e.g.:

List<String> javaList = new ArrayList<String>(Arrays.asList("a", "b", "c"));
System.out.println(javaList); // [a, b, c]
Buffer<String> scalaBuffer = JavaConversions.asScalaBuffer(javaList);
System.out.println(scalaBuffer); // Buffer(a, b, c)
List<String> javaListAgain = JavaConversions.bufferAsJavaList(scalaBuffer);
System.out.println(javaList == javaListAgain); // true

Answer 2

Для всех, кто интересуется этим вопросом, поскольку Scala 2.12.x, JavaConversions устарел, и JavaConverters является предпочтительным методом.

Answer 3

Как объяснено в API, JavaConversions - это набор неявных преобразований, которые преобразуют Java-коллекции в связанную Scala-коллекцию.

Вы можете использовать его с import collection.JavaConversions._. При необходимости компилятор автоматически преобразует коллекцию java в правильный тип scala.

JavaConverters - это набор декораторов, который помогает преобразовывать коллекции java или scala в коллекции scala или java, используя методы asScala или asJava, которые будут неявно добавляться в коллекцию, которую вы хотите преобразования. Чтобы использовать эти конвертеры, вам необходимо импортировать:

import collection.JavaConverters._

Вы должны предпочесть JavaConversions, так как обычно его проще использовать (не нужно использовать asScala или asJava).

Answer 4

В Scala 2.13 JavaConverters были устарели в пользу scala.jdk.CollectionConverters:

... новый пакет scala.jdk с объектами CollectionConverters (классикаКоллекции Java, аналогичные collection.JavaConverters в 2.12), StreamConverters, FunctionConverters и OptionConverters ...