Scalaj-collection 库使用详解

1. 安装指南

sbt 安装方式

如果您使用 sbt 作为构建工具，只需在您的项目文件中添加以下依赖：

libraryDependencies += "org.scalaj" %% "scalaj-collection" % "1.6"

Maven 安装方式

如果您的项目使用 Maven，请在 pom.xml 文件中加入以下内容：

<dependency>
  <groupId>org.scalaj</groupId>
  <artifactId>scalaj-collection_${scala.version}</artifactId>
  <version>1.6</version>
</dependency>

JAR 包下载

您可以从 sonatype.org 下载相应的 JAR 包。

源码安装

从 Github 克隆仓库：

git clone git://github.com/scalaj/scalaj-collection.git

进入仓库目录，使用 sbt 构建：

cd scalaj-collection
sbt package

确保您的 sbt 版本为 0.12.4 或更高。

2. 使用说明

scalaj-collection 库主要用于在 Java 和 Scala 集合之间进行转换。以下是一些基本用法的示例：

• 将 Scala 集合转换为 Java 集合：

import scalaj.collection.Imports._

List(1, 2, 3).asJava
// 返回 java.util.List[java.lang.Integer]

Map(1 -> "a", 2 -> "b", 3 -> "c").asJava
// 返回 java.util.Map[java.lang.Integer, java.lang.String]

Set(1, 2, 3).asJava
// 返回 java.util.Set[java.lang.Integer]

• 将 Java 集合转换为 Scala 集合：

val list = new java.util.ArrayList[java.lang.Integer]
list.add(1)
list.add(2)
list.add(3)
list.asScala
// 返回 scala.Seq[Int]

• 在 Java 集合上使用 foreach 方法：

list.foreach(print)
// 输出 "123"

目前，map、filter 和 flatMap 方法还在开发中。

3. 项目 API 使用文档

以下方法通过 Swag My Library 模式添加：

• Java 到 Scala 转换：

  • java.lang.Comparable[A] -> #asScala: scala.math.Ordered[A]
  • java.util.Comparator[A] -> #asScala: scala.math.Ordering[A]
  • java.util.Enumeration[A] -> #asScala: scala.collection.Iterator[A]
    • #foreach(A => Unit): Unit
  • java.util.Iterator[A] -> #asScala: scala.collection.Iterator[A]
    • #foreach(A => Unit): Unit
  • java.lang.Iterable[A] -> #asScala: scala.collection.Iterable[A]
    • #foreach(A => Unit): Unit
  • java.util.List[A] -> #asScala: scala.collection.Seq[A]
    • #asScalaMutable: scala.collection.mutable.Seq[A]
  • java.util.Set[A] -> #asScala: scala.collection.Set[A]
    • #asScalaMutable: scala.collection.mutable.Set[A]
  • java.util.Map[A, B] -> #asScala: scala.collection.Map[A, B]
    • #asScalaMutable: scala.collection.mutable.Map[A, B]
    • #foreach(((A, B)) => Unit): Unit
  • java.util.Dictionary[A, B] -> #asScala: scala.collection.mutable.Map[A, B]
    • #foreach(((A, B)) => Unit): Unit

• Scala 到 Java 转换：

  • scala.math.Ordered[A] -> #asJava: java.util.Comparable[A]
  • scala.math.Ordering[A] -> #asJava: java.util.Comparator[A]
  • scala.collection.Iterator[A] -> #asJava: java.util.Iterator[A]
    • #asJavaEnumeration: java.util.Enumeration[A]
  • scala.collection.Iterable[A] -> #asJava: java.lang.Iterable[A]
  • scala.collection.Seq[A] -> #asJava: java.util.List[A]
  • scala.collection.mutable.Seq[A] -> #asJava: java.util.List[A]
  • scala.collection.mutable.Buffer[A] -> #asJava: java.util.List[A]
  • scala.collection.Set[A] -> #asJava: java.util.Set[A]
  • scala.collection.mutable.Set[A] -> #asJava: java.util.Set[A]
  • scala.collection.Map[A, B] -> #asJava: java.util.Map[A, B]
  • scala.collection.mutable.Map[A, B] -> #asJava: java.util.Map[A, B]
    • #asJavaDictionary: java.util.Dictionary[A, B]