scala.collection

JavaConversions

object JavaConversions extends AnyRef

A collection of implicit conversions supporting interoperability between Scala and Java collections.

The following conversions are supported:

In all cases, converting from a source type to a target type and back again will return the original source object, eg. 

   import scala.collection.JavaConversions._
   val sl = new scala.collection.mutable.ListBuffer[Int]
   val jl : java.util.List[Int] = sl
   val sl2 : scala.collection.mutable.Buffer[Int] = jl
   assert(sl eq sl2)g

Note that no conversion is provided from scala.collection.immutable.List to java.util.List. Instead it is convertible to an immutable java.util.Collection which provides size and interation capabilities, but not access by index as would be provided by java.util.List.
This is intentional: in combination the implementation of scala.collection.immutable.List and the typical usage patterns of java.util.List would perform extremely poorly.

Inherits

  1. AnyRef
  2. Any

Type Members

  1. class ConcurrentMapWrapper[A, B](underlying: ConcurrentMap[A, B])(m: ClassManifest[A], mv: ClassManifest[B]) extends MutableMapWrapperLike[A, B] with ConcurrentMap[A, B] with Product

  2. class IterableWrapper[A](underlying: Iterable[A]) extends AbstractCollection[A] with Product

  3. class IteratorWrapper[A](underlying: Iterator[A]) extends Iterator[A] with Enumeration[A] with Product

  4. class JCollectionWrapper[A](underlying: Collection[A]) extends Iterable[A] with Product

  5. class JConcurrentMapWrapper[A, B](underlying: ConcurrentMap[A, B]) extends JMapWrapperLike[A, B, JConcurrentMapWrapper[A, B]] with ConcurrentMap[A, B] with Product

  6. class JEnumerationWrapper[A](underlying: Enumeration[A]) extends Iterator[A] with Product

  7. class JIterableWrapper[A](underlying: Iterable[A]) extends Iterable[A] with Product

  8. class JIteratorWrapper[A](underlying: Iterator[A]) extends Iterator[A] with Product

  9. class JListWrapper[A](underlying: List[A]) extends Buffer[A] with Product

  10. class JMapWrapper[A, B](underlying: Map[A, B]) extends JMapWrapperLike[A, B, JMapWrapper[A, B]] with Product

  11. class JMapWrapperLike[A, B, +Repr <: MapLike[A, B, Repr] with Map[A, B]] extends Map[A, B] with MapLike[A, B, Repr]

  12. class JPropertiesWrapper(underlying: Properties) extends Map[String, String] with MapLike[String, String, JPropertiesWrapper] with Product

  13. class JSetWrapper[A](underlying: Set[A]) extends Set[A] with SetLike[A, JSetWrapper[A]] with Product

  14. class MutableBufferWrapper[A](underlying: Buffer[A]) extends AbstractList[A] with Product

  15. class MutableMapWrapper[A, B](underlying: Map[A, B])(m: ClassManifest[A]) extends MutableMapWrapperLike[A, B] with Product

  16. class MutableMapWrapperLike[A, B] extends AbstractMap[A, B]

  17. class MutableSetWrapper[A](underlying: Set[A])(m: ClassManifest[A]) extends AbstractSet[A] with Product

Value Members

  1. def asBuffer[A](l: List[A]): Buffer[A]

    Implicitly converts a Java List to a Scala mutable Buffer

    Implicitly converts a Java List to a Scala mutable Buffer. The returned Scala Buffer is backed by the provided Java List and any side-effects of using it via the Scala interface will be visible via the Java interface and vice versa.

    If the Java List was previously obtained from an implicit or explicit call of asList(scala.collection.mutable.Buffer) then the original Scala Buffer will be returned.

    l

    The List to be converted.

    returns

    A Scala mutable Buffer view of the argument.

    attributes: implicit

  2. def asCollection[A](i: Iterable[A]): Collection[A]

    Implicitly converts a Scala Iterable to an immutable Java Collection

    Implicitly converts a Scala Iterable to an immutable Java Collection.

    If the Scala Iterable was previously obtained from an implicit or explicit call of asSizedIterable(java.util.Collection) then the original Java Collection will be returned.

    i

    The SizedIterable to be converted.

    returns

    A Java Collection view of the argument.

    attributes: implicit

  3. def asConcurrentMap[A, B](m: ConcurrentMap[A, B]): ConcurrentMap[A, B]

    Implicitly converts a Java ConcurrentMap to a Scala mutable ConcurrentMap

    Implicitly converts a Java ConcurrentMap to a Scala mutable ConcurrentMap. The returned Scala ConcurrentMap is backed by the provided Java ConcurrentMap and any side-effects of using it via the Scala interface will be visible via the Java interface and vice versa.

    If the Java ConcurrentMap was previously obtained from an implicit or explicit call of asConcurrentMap(scala.collection.mutable.ConcurrentMap) then the original Scala ConcurrentMap will be returned.

    m

    The ConcurrentMap to be converted.

    returns

    A Scala mutable ConcurrrentMap view of the argument.

    attributes: implicit

  4. def asConcurrentMap[A, B](m: ConcurrentMap[A, B])(ma: ClassManifest[A], mb: ClassManifest[B]): ConcurrentMap[A, B]

  5. def asEnumeration[A](i: Iterator[A]): Enumeration[A]

    Implicitly converts a Scala Iterator to a Java Enumeration

    Implicitly converts a Scala Iterator to a Java Enumeration. The returned Java Enumeration is backed by the provided Scala Iterator and any side-effects of using it via the Java interface will be visible via the Scala interface and vice versa.

    If the Scala Iterator was previously obtained from an implicit or explicit call of asIterator(java.util.Enumeration) then the original Java Enumeration will be returned.

    i

    The Iterator to be converted.

    returns

    A Java Enumeration view of the argument.

    attributes: implicit

  6. def asIterable[A](i: Collection[A]): Iterable[A]

    Implicitly converts a Java Collection to an Scala Iterable

    Implicitly converts a Java Collection to an Scala Iterable.

    If the Java Collection was previously obtained from an implicit or explicit call of asCollection(scala.collection.SizedIterable) then the original Scala SizedIterable will be returned.

    i

    The Collection to be converted.

    returns

    A Scala SizedIterable view of the argument.

    attributes: implicit

  7. def asIterable[A](i: Iterable[A]): Iterable[A]

    Implicitly converts a Java Iterable to a Scala Iterable

    Implicitly converts a Java Iterable to a Scala Iterable. The returned Scala Iterable is backed by the provided Java Iterable and any side-effects of using it via the Scala interface will be visible via the Java interface and vice versa.

    If the Java Iterable was previously obtained from an implicit or explicit call of asIterable(scala.collection.Iterable) then the original Scala Iterable will be returned.

    i

    The Iterable to be converted.

    returns

    A Scala Iterable view of the argument.

    attributes: implicit

  8. def asIterable[A](i: Iterable[A]): Iterable[A]

    Implicitly converts a Scala Iterable to a Java Iterable

    Implicitly converts a Scala Iterable to a Java Iterable. The returned Java Iterable is backed by the provided Scala Iterable and any side-effects of using it via the Java interface will be visible via the Scala interface and vice versa.

    If the Scala Iterable was previously obtained from an implicit or explicit call of asIterable(java.lang.Iterable) then the original Java Iterable will be returned.

    i

    The Iterable to be converted.

    returns

    A Java Iterable view of the argument.

    attributes: implicit

  9. def asIterator[A](i: Enumeration[A]): Iterator[A]

    Implicitly converts a Java Enumeration to a Scala Iterator

    Implicitly converts a Java Enumeration to a Scala Iterator. The returned Scala Iterator is backed by the provided Java Enumeration and any side-effects of using it via the Scala interface will be visible via the Java interface and vice versa.

    If the Java Enumeration was previously obtained from an implicit or explicit call of asEnumeration(scala.collection.Iterator) then the original Scala Iterator will be returned.

    i

    The Enumeration to be converted.

    returns

    A Scala Iterator view of the argument.

    attributes: implicit

  10. def asIterator[A](i: Iterator[A]): Iterator[A]

    Implicitly converts a Java Iterator to a Scala Iterator

    Implicitly converts a Java Iterator to a Scala Iterator. The returned Scala Iterator is backed by the provided Java Iterator and any side-effects of using it via the Scala interface will be visible via the Java interface and vice versa.

    If the Java Iterator was previously obtained from an implicit or explicit call of asIterator(scala.collection.Iterator) then the original Scala Iterator will be returned.

    i

    The Iterator to be converted.

    returns

    A Scala Iterator view of the argument.

    attributes: implicit

  11. def asIterator[A](i: Iterator[A]): Iterator[A]

    Implicitly converts a Scala Iterator to a Java Iterator

    Implicitly converts a Scala Iterator to a Java Iterator. The returned Java Iterator is backed by the provided Scala Iterator and any side-effects of using it via the Java interface will be visible via the Scala interface and vice versa.

    If the Scala Iterator was previously obtained from an implicit or explicit call of asIterator(java.util.Iterator) then the original Java Iterator will be returned.

    i

    The Iterator to be converted.

    returns

    A Java Iterator view of the argument.

    attributes: implicit

  12. def asList[A](b: Buffer[A]): List[A]

    Implicitly converts a Scala mutable Buffer to a Java List

    Implicitly converts a Scala mutable Buffer to a Java List. The returned Java List is backed by the provided Scala Buffer and any side-effects of using it via the Java interface will be visible via the Scala interface and vice versa.

    If the Scala Buffer was previously obtained from an implicit or explicit call of asBuffer(java.util.List) then the original Java List will be returned.

    b

    The Buffer to be converted.

    returns

    A Java List view of the argument.

    attributes: implicit

  13. def asMap(p: Properties): Map[String, String]

  14. def asMap[A, B](m: Map[A, B]): Map[A, B]

    Implicitly converts a Java Map to a Scala mutable Map

    Implicitly converts a Java Map to a Scala mutable Map. The returned Scala Map is backed by the provided Java Map and any side-effects of using it via the Scala interface will be visible via the Java interface and vice versa.

    If the Java Map was previously obtained from an implicit or explicit call of asMap(scala.collection.mutable.Map) then the original Scala Map will be returned.

    m

    The Map to be converted.

    returns

    A Scala mutable Map view of the argument.

    attributes: implicit

  15. def asMap[A, B](m: Map[A, B])(ma: ClassManifest[A]): Map[A, B]

    Implicitly converts a Scala mutable Map to a Java Map

    Implicitly converts a Scala mutable Map to a Java Map. The returned Java Map is backed by the provided Scala Map and any side-effects of using it via the Java interface will be visible via the Scala interface and vice versa.

    If the Scala Map was previously obtained from an implicit or explicit call of asMap(java.util.Map) then the original Java Map will be returned.

    m

    The Map to be converted.

    returns

    A Java Map view of the argument.

    attributes: implicit

  16. def asSet[A](s: Set[A]): Set[A]

    Implicitly converts a Java Set to a Scala mutable Set

    Implicitly converts a Java Set to a Scala mutable Set. The returned Scala Set is backed by the provided Java Set and any side-effects of using it via the Scala interface will be visible via the Java interface and vice versa.

    If the Java Set was previously obtained from an implicit or explicit call of asSet(scala.collection.mutable.Set) then the original Scala Set will be returned.

    s

    The Set to be converted.

    returns

    A Scala mutable Set view of the argument.

    attributes: implicit

  17. def asSet[A](s: Set[A])(m: ClassManifest[A]): Set[A]

    Implicitly converts a Scala mutable Set to a Java Set

    Implicitly converts a Scala mutable Set to a Java Set. The returned Java Set is backed by the provided Scala Set and any side-effects of using it via the Java interface will be visible via the Scala interface and vice versa.

    If the Scala Set was previously obtained from an implicit or explicit call of asSet(java.util.Set) then the original Java Set will be returned.

    s

    The Set to be converted.

    returns

    A Java Set view of the argument.

    attributes: implicit

  18. def equals(arg0: Any): Boolean

    This method is used to compare the receiver object (this) with the argument object (arg0) for equivalence

    This method is used to compare the receiver object (this) with the argument object (arg0) for equivalence.

    The default implementations of this method is an equivalence relation:

    • It is reflexive: for any instance x of type Any, x.equals(x) should return true.
    • It is symmetric: for any instances x and y of type Any, x.equals(y) should return true if and only if y.equals(x) returns true.
    • It is transitive: for any instances x, y, and z of type AnyRef if x.equals(y) returns true and y.equals(z) returns true, then x.equals(z) should return true.

    If you override this method, you should verify that your implementation remains an equivalence relation. Additionally, when overriding this method it is often necessary to override hashCode to ensure that objects that are "equal" (o1.equals(o2) returns true) hash to the same Int (o1.hashCode.equals(o2.hashCode)).

    arg0

    the object to compare against this object for equality.

    returns

    true if the receiver object is equivalent to the argument; false otherwise.

    definition classes: AnyRef ⇐ Any

  19. def hashCode(): Int

    Returns a hash code value for the object

    Returns a hash code value for the object.

    The default hashing algorithm is platform dependent.

    Note that it is allowed for two objects to have identical hash codes (o1.hashCode.equals(o2.hashCode)) yet not be equal (o1.equals(o2) returns false). A degenerate implementation could always return 0. However, it is required that if two objects are equal (o1.equals(o2) returns true) that they have identical hash codes (o1.hashCode.equals(o2.hashCode)). Therefore, when overriding this method, be sure to verify that the behavior is consistent with the equals method.

    definition classes: AnyRef ⇐ Any

  20. def toString(): String

    Returns a string representation of the object

    Returns a string representation of the object.

    The default representation is platform dependent.

    definition classes: AnyRef ⇐ Any