Java - 理解方法签名

Question

应该向这个Java方法发送什么参数：

public void resume(Collection<TopicPartition> partitions)

更多详情here.

我可以看到<TopicPartition> 是一个带有这个签名的Java 类：
TopicPartition(String topic, int partition)
但是在那之后，在上面的Java 方法中有一个关键字partitions。

那么是 3 个参数还是 2 个或 1 个参数？

请有人描述我应该如何阅读这种签名。

谢谢。

Answer 1

让我们一步一步来：

首先，当然只有一个名为“分区”的参数

 public void resume(Collection<TopicPartition> partitions)

• public 是访问修饰符，这意味着该方法在任何地方都可见

• void是返回类型，表示没有返回值

• resume 是方法名称/标识符

Collection<TopicPartition> partitions 有点难以解释：

接口'Collection'后跟一个类型（TopicPartitions）意味着您可以将任何TopicPartition对象的集合输入到方法中。例如：

List<TopicPartition> list = new LinkedList<>();
resume(list);  // valid, sind List or more exact LinkedList are a Collection

Queue<TopicPartition> qq = new PriorityQueue<>();
resume(qq);  // valid, sind Que or more exact PriorityQueue are a Collection

语法Collection<Type> 是Java 泛型的一部分，您可以仔细查看this tutorial。

您在这里所说的关键字（“分区”）是根本没有关键字，而只是该输入参数的名称/标识符。您必须为每个参数指定一个明确的名称 - 这样您就可以在方法代码中识别它。

在此示例中，您可以将“分区”重命名为您想要的任何名称，我会担保类似“partCollection”的名称

void、return、public、private、static、class， ...这些都是关键字。

第二，TopicPartition 和你这里引用的方法是TopicPartition 类的构造函数，它需要2 个参数：String topic 和int partition，而不仅仅是一个方法。

构造函数是实例化类时调用的方法（例如使用new 关键字创建对象）。

所以给你一个更详细的例子：

List<TopicPartition> list = new LinkedList<>();
list.add(new TopicPartition("part1", 1));
list.add(new TopicPartition("part2", 2));
resume(list);  
// resume has now been called with argument of a list (which is a collection) 
// containing two TopicPartition objects whit part1, part2 and 1,2 as 
// construction arguments