Java/Scala 相互運用性の実践 1: 基本操作-java类库-php.cn

Java Bean

Java Bean の特徴は、変更可能なプロパティに対応する getter メソッドと setter メソッドがあることです (最終プロパティには getter メソッドのみが存在します)。 Java で定義されたオブジェクトは、Scala でも同様に直接使用できます。 Scala での Java Bean の定義は少し異なります。

実際、Java Beans は Java と同じように Scala で定義できます。

// Scala中默认为public访问权限，包括属性和方法class Person {
  // 下划线在这里是一个占位符，它代码相应属性对应类型的默认值
  private var id: Int = _ 
  private var name: String = _;  def getId: Int = id;  def setId(id: Int) {    this.id = id
  }  def getName: String = name;  def setName(name: String) {    this.name = name;
  }
}

ログイン後にコピー

このように書くと、Java との構文の一部の違いを除いて、定義方法は実際には同じです。しかし、実際には、Scala にはゲッター関数とセッター関数を自動的に生成するためのアノテーションが用意されています:

import scala.beans.BeanPropertyclass Person {  @BeanProperty
  var id: Int = _  @BeanProperty
  var name: String = _  @BeanProperty
  val createdAt: LocalDateTime = _
}

ログイン後にコピー

従来のクラスの使用に加えて、case クラスを使用して Scala で POJO を定義することもできます:

case class SignRequest(@BeanProperty
                       account: String = null,                       @BeanProperty
                       password: String = null,                       @BeanProperty
                       captcha: String = null,                       @BeanProperty
                       var smsCode: String = null)

ログイン後にコピー

case クラスのメインコンストラクターによって宣言されたパラメーターこれは SignRequest のパフォーマンスであり、val (Java の public Final と同様) です。ここでは、アカウント、パスワード、キャプチャはゲッター関数のみを生成します。また、smsCode は var で装飾されているため、ゲッター関数とセッター関数を生成します。

これは Java では利用できない機能です: パラメーターのデフォルト値 C++、Python、ES6+ と同様に、Scala パラメーターはデフォルト値に設定できます。 Java Bean 仕様では、クラスには空のパラメータを持つデフォルトコンストラクタが必要であるため、ケースクラスのメインコンストラクタのすべてのパラメータがデフォルト値に設定されている場合、このクラスをインスタンス化するときに空のデフォルトコンストラクタを持つことと同じになります。。

Java で case クラスを呼び出し、com/hualongdata/springstarter/data/repository/UserRepositoryImpl.java を参照してください。

アノテーションベースの依存性注入

Spring 開発では、依存性注入は非常に一般的に使用される機能です。プロパティベースのアノテーション注入は、Java と Scala の両方で同じです。ただし、コンストラクターベースの依存関係の注入は、Scala ではやや特殊です。コードは次のとおりです:

class SignController @Autowired()(userService: UserService,
                                  webUtils: WebUtils,
                                  hlTokenComponent: HlTokenComponent) {
  ......
}

ログイン後にコピー

Scala では、単一のアノテーションがコンストラクターに作用するとき、メソッド呼び出しのような形式: @Autowired() が必要です。また、Scala では、メインコンストラクターはクラス名の後の括弧内で定義する必要があるため、アノテーションはクラス名の後ろ、メインコンストラクターの左括弧の前に配置する必要があります。

Scala では、注入されたコンポーネントをメインコンストラクターで使用することをお勧めします。メインコンストラクターには、注入されたコンポーネントへのプライベートな最終アクセス権もあります。同じ効果を得るには、より多くの Java コードが必要です:

public SignController {
    private final UserService userService;
    private final WebUtils webUtils;
    private final HlTokenComponent hlTokenComponent;

    public SignController(UserService userService, WebUtils webUtils, HlTokenComponent hlTokenComponent) {
        this.userService = userService;
        this.webUtils = webUtils;
        this.hlTokenComponent = hlTokenComponent;
    }
}

ログイン後にコピー

ご覧のとおり、Scala バージョンのコードは少なく、より簡潔に見えます。

アノテーションパラメータ

配列パラメータ

@RestController
@RequestMapping(Array("/sign"))
class SignController @Autowired()(userService: UserService,
  ......

ログイン後にコピー

Scalaでは、アノテーション付き配列パラメータに要素を1つだけ設定する場合、Javaのように文字列にすることはできず、配列を明示的に定義する必要があります。

パラメータ値は定数である必要があります

Scala では、アノテーションの特定のパラメータが低い値である場合、次のような形式で定数を使用する必要があります: @RequestMapping(Array(Constants.API_BASE + "/sign"))は違法です。 @RequestMapping(Array("/aip/sign"))

可変長パラメーター

Scala では、可変長パラメーターはアスタリスク (*) で定義され、コードは次のとおりです:

def log(format: String, value: String*)

ログイン後にコピー

ただし、Scala のデフォルト実装の値の型は Seq[Any] であり、Java の変数パラメーターの型は実際には配列 (String[]) であるため、定義された変数パラメーターは Java ではアクセスできません。この問題を解決するのは非常に簡単です。関数定義の前に scala.annotation.varargs アノテーションを追加して、Scala に Java 実装を使用して可変長パラメーターを実装するように強制します。

コレクションライブラリ

Scala有自己的一套集合库实现： scala.collection，分为不可变集合scala.collection.immutable和可变集合scala.collection.mutable。两者都实现了很多高阶函数，可以简化日常编程，同时Scala中推荐使用不可变集合。

Java集合到Scala集合

Scala提供了scala.collection.JavaConverters来转换Java集合到Scala集合：

import scala.collection.JavaConverters._  /**
    * 根据sheet名获取sheet所有单元格
    *
    * @param workbook  Excel [[Workbook]]对象
    * @param sheetName sheet 名
    * @return 返回所有有效单元格可迭代二维列表
    */
  def getSheetCells(workbook: Workbook, sheetName: String): Iterable[Iterable[RichCell]] = {
      workbook.getSheet(sheetName)
        .asScala
        .map(row => row.asScala.map(cell => new RichCell(cell)))
  }

ログイン後にコピー

workbook.getSheet方法返回的Sheet类型是实现了java.lang.Iterable接口的可迭代类型。为了使用Scala集合上提供的map高阶函数，我们需要把Java集合转换成Scala集合。可以通过在Java集合上调用.asScala函数来将其转换成Scala集合，这里运用了Scala里的隐式转换特性来实现。

Scala集合到Java集合

接下来我们看另外一个函数：

  @varargs
  def getSheets(workbook: Workbook, sheetNames: String*): java.util.List[Sheet] = {
    sheets(workbook, sheetNames: _ *).asJava
  }

ログイン後にコピー

这个函数实现的功能是根据传入的一个或多个Sheet名字从Excel里获取Sheet列表。sheets函数返回的是一个Scala集合：Seq[Sheet]，通过getSheets代理函数将其转换成Java集合，通过在Seq[Sheet]上调用.asJava方法来实现自动转换。同样的，这里也运用了Scala的隐式转换特性。

Java代码中做集合转换

之前的例子都是在Scala代码中实现的，通过隐式转换这一特性我们发现做Java/Scala集合的相互转换是非常方便的。但在Java代码中做两者的转换就不那么直观了，因为Java没有隐式转换这一特性，我们需要显示的调用代码来先生成包装类，再调用.asScala或.asJava方法来转换集合类型：

import scala.collection.JavaConverters$;import scala.collection.mutable.Buffer;    public static void demo() {
        List<String> list = Arrays.asList("dd", "dd");        // Java List 到 Scala Buffer
        Buffer<String> scalaBuffer = JavaConverters$.MODULE$.asScalaBufferConverter(list).asScala();        // Scala Buffer 到 Java List
        List<String> javaList = JavaConverters$.MODULE$.bufferAsJavaListConverter(scalaBuffer).asJava();
    }

ログイン後にコピー

为Java和Scala同时提供API

当在项目中混用Java和Scala语言时，有个问题不得不重视。提供的API是用Java还是Scala来实现？实现的API是优先考虑兼容Java还是Scala？

对于API的实现，用Java或Scala均可。若使用Java实现，在Scala中调用是基本无压力的。而使用Scala实现时，为了兼容Java你可能不得不作一些折中。一个常用的方式是：使用Scala或Java来实现API，而再用Java或Scala来实现一个封装层（代理）作兼容。比如：Spark、Akka……，它们使用Scala来实现API，但提供了包装的Java API层。

一个好的实践是把Scala API放到scalaapi包路径（或者反之把Java API放到javaapi包路径）。

若我们只提供一个API，那就要尽量同时支持Java和Scala方便的调用。比如使用@varargs注解来修饰变长参数。

对于参数需要集合类型，或返回值为集合类型的函数。我们除了使用上一节提供的JavaConverters来做自动/手动转换以外，也可以通过装饰器形式来提供Java或Scala专有的API。这里，我推荐Scala API函数名直接使用代表操作的名词/动词实现，而Java API在之前加上：get、set、create等前缀进行修饰。

def sheets(workbook: Workbook, sheetNames: String*): Seq[Sheet] = {
    sheetNames.map(sheetName => workbook.getSheet(sheetName))
  }  @varargs
  def getSheets(workbook: Workbook, sheetNames: String*): java.util.List[Sheet] = {
    sheets(workbook, sheetNames: _ *).asJava
  }

ログイン後にコピー

这里sheets和getSheets实现相同的功能，区别是第一个是Scala API，第二个是Java API。

结语

本文较详细的介绍了Java/Scala的互操作性，以上示例都来自作者及团队的实际工作。

这篇文章简单介绍了一些基础的Java/Scala互操作方法，接下来的文章将介绍些高级的互操作：Future、Optional/Option、lamdba函数、类与接口等。