【Java】ストリームAPIのJavadocの見方について

Question

いつもお世話になっております。

CollectionsクラスのreverseOrderメソッドは引数にComparatorをとるようになっておりますが、以下のコードでは、引数にComparatorの記述はなく、Map.EntryインタフェースのcomparingByValueメソッドが使われております。

Map.EntryインタフェースのcomparingByValueメソッドとComparatorが何かしら関係しているのだろうと予想しておりますが、なぜMap.EntryインタフェースのcomparingByValueメソッドがComparatorとして扱われているのかが分かっておりません。

reverseOrderメソッドの引数には、Comparatorオブジェクトが来るはずなのに、なぜMap.Entryインタフェースが来ているのでしょうか。
(comparingByValueメソッドの戻り値がComparatorになるため、戻り値が引数であるComparatorとして扱われているという認識でしょうか？）

import java.util.Collections;
import java.util.HashMap;
import java.util.Map;

public class Test {

	public static void main(String[] args) {
		// TODO 自動生成されたメソッド・スタブ
		Map<Integer, String> map = new HashMap<>();
		map.put(1, "B");
		map.put(2, "A");
		map.entrySet()
		.stream()
		.sorted(Collections.reverseOrder(Map.Entry.comparingByValue()))
		.forEach(System.out::println);
	}

}

Answer 1

そのものを返してるのだがなにが疑問なのか?

Map.Entry#comparingByValue

Comments

[kazu0630]

要するに、comparingByValueメソッドの戻り値がreverseOrderメソッドの引数であるComparatorであるということでしょうか。

[退会済みユーザー]

ですが

[kazu0630]

ありがとうございます。
学習をしていて、自信がなくなってきてしまったので、質問をさせていただきました。

ご回答いただき、ありがとうございました。

Answer 2

map.entrySet()
.stream()
.sorted(Collections.reverseOrder(Map.Entry.comparingByValue()))
.forEach(System.out::println);

次のように書いているのと同じです。

Comparator<Map.Entry<Integer, String>> comp1 = Map.Entry.comparingByValue();
Comparator<Map.Entry<Integer, String>> comp2 = Collections.reverseOrder(comp1);

map.entrySet()
.stream()
.sorted(comp2)
.forEach(System.out::println);

Comments

[kazu0630]

ご丁寧にありがとうございます。
大変わかりやすく、理解できました。