Skip to content

Javaとの相互運用

OnionはJavaとシームレスに連携できます。あらゆるJavaライブラリをOnionから直接使用できます。

Javaクラスのインポート

import { } でJavaクラスをインポートします。エイリアスも使えます：

import {
  java.util.ArrayList;
  java.util.HashMap;
  java.io.File;
  java.lang.Long as JLong;
}

val list: ArrayList[String] = new ArrayList[String]()
val map: HashMap[String, String] = new HashMap[String, String]()
val file: File = new File("data.txt")
val str: String = JLong::toString(42L)

インポートなしで完全修飾名を使うこともできます：

val list: java.util.ArrayList[String] = new java.util.ArrayList[String]()

これはstaticメンバーやメソッドにも使えます。ドット区切りのクラス名に対して :: で直接呼び出せ、インポートは不要です：

val m: Int = java.lang.Math::max(3, 7)             // 7
val s: String = java.lang.Integer::toString(255)   // "255"
val mx: Int = java.lang.Integer::MAX_VALUE         // 2147483647

基本型のキーワード（Long・Int・Double など）も static レシーバとして使えます。対応するボックス型クラスにマップされます：

val s: String = Long::toString(42L)     // "42"（java.lang.Long）
val n: Int = Int::parseInt("7")         // 7    （java.lang.Integer）
val mx: Long = Long::MAX_VALUE          // 9223372036854775807

注意： これは単純なキーワード形式のみで動きます。キーワードで終わる完全修飾パス java.lang.Long::toString(42L) は構文エラーになります（Long セグメントが識別子ではなくキーワードのため）。上記の単純な Long:: 形式を使うか、エイリアスでインポートしてください：

import { java.lang.Long as JLong; }

val s: String = JLong::toString(42L)  // "42"

Javaオブジェクトの生成とメソッド呼び出し

new でオブジェクトを生成し、メソッドを通常どおり呼び出せます：

import { java.lang.StringBuilder; }

val result: String = new StringBuilder("Hello")
  .append(" ")
  .append("World")
  .append("!")
  .toString()

println(result)  // "Hello World!"

staticメソッドには :: を使います：

val random: Double = Math::random()
val sqrt: Double = Math::sqrt(16.0)
val time: Long = System::currentTimeMillis()
val number: Int = JInteger::parseInt("42")

staticメソッドのインポート

Class::method で特定のstaticメソッドをインポートし、修飾なしで呼べます：

import { java.lang.Math::max; }

println(max(10, 20))  // 20

クラス全体のstaticメンバーをインポートすることもできます：

import { java.lang.Math }

println(max(10, 20))
println(min(10, 20))
println(abs(-7))

型インポートと単一メソッドのstaticインポートを同じブロックで混在させられます：

import {
  java.util.ArrayList;
  java.lang.Math::abs;
}

val xs = new ArrayList[Int]()
xs.add(abs(-5))

Javaインターフェースの実装

<: でJavaインターフェースを実装します：

import { java.lang.Runnable; }

class MyTask <: Runnable {
  val name: String

  public:
    def this(n: String) {
      this.name = n
    }

    def run {
      println("Task " + this.name + " is running")
    }
}

val task: MyTask = new MyTask("Background Task")
val thread: Thread = new Thread(task)
thread.start()

Javaクラスの拡張

: でJavaクラスを継承できます：

import {
  javax.swing.JFrame;
  javax.swing.JButton;
  java.awt.FlowLayout;
}

class MyWindow : JFrame {
  public:
    def this {
      setTitle("My Window")
      setSize(400, 300)
      setLayout(new FlowLayout())

      val button: JButton = new JButton("Click me")
      add(button)

      setDefaultCloseOperation(JFrame::EXIT_ON_CLOSE)
      setVisible(true)
    }
}

val window: MyWindow = new MyWindow

型キャスト

as 演算子でJavaオブジェクトをキャストします：

val obj: Object = "Hello"
val str: String = (obj as String)

val list: ArrayList[String] = new ArrayList[String]()
list.add("Item")
val item: String = list.get(0) as String

val random: Double = Math::random()
val randomInt: Int = (random * 100) as Int

よく使うJavaクラス

String

val text: String = "Hello, World!"
val upper: String = text.toUpperCase()
val lower: String = text.toLowerCase()
val length: Int = text.length()
val sub: String = text.substring(0, 5)
val contains: Boolean = text.contains("World")

数値ユーティリティ

val i: Int = JInteger::parseInt("42")
val l: Long = JLong::parseLong("1234567890")
val max: Int = JInteger::MAX_VALUE

Math

val abs: Int = Math::abs(-10)
val ceil: Double = Math::ceil(3.14)
val pow: Double = Math::pow(2.0, 3.0)

ファイルI/O

import {
  java.io.File;
  java.io.FileReader;
  java.io.BufferedReader;
  java.io.IOException;
}

def readFile(filename: String) {
  try {
    val reader: BufferedReader = new BufferedReader(
      new FileReader(filename)
    )

    var line: String = null
    while (line = reader.readLine()) != null {
      println(line)
    }

    reader.close()
  } catch e: IOException {
    println("Error reading file: " + e.getMessage())
  }
}

なお、Onionには file"path" リテラルを使った簡潔なファイル操作もあります：

val text: String = file"data.txt".text()
val lines: List[String] = file"data.txt".lines()

次のステップ