net.myrrix.common

Class PartitionsUtils

java.lang.Object

net.myrrix.common.PartitionsUtils

public final class PartitionsUtils
extends Object

Utility methods for dealing with partitions in distributed mode.

Since:

1.0

Author:

Sean Owen

Method Summary

Methods

Modifier and Type	Method and Description
static List<List<com.google.common.net.HostAndPort>>	getDefaultLocalPartition(int port)
static List<List<com.google.common.net.HostAndPort>>	parseAllPartitions(CharSequence value)
static List<List<com.google.common.net.HostAndPort>>	parsePartitionsFromStatus(URL url) Reads partition information from an XML status document from the cluster, which includes information on partitions and their replicas.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

parseAllPartitions

public static List<List<com.google.common.net.HostAndPort>> parseAllPartitions(CharSequence value)

Parameters:

value - describes all partitions, when partitioning across Serving Layers by user. Each partition may have multiple replicas. Serving Layers are specified as "host:port". Replicas are specified as many Serving Layers, separated by commas, like "rep1:port1,rep2:port2,...". Finally, partitions are specified as multiple replicas separated by semicolon, like "part1rep1:port11,part1rep2:port12;part2rep1:port21,part2rep2:port22;...". Example: "foo:80,foo2:8080;bar:8080;baz2:80,baz3:80"

Returns:

List of partitions, where each partition is a List of replicas, where each replica is a host-port pair, as HostAndPort

getDefaultLocalPartition

public static List<List<com.google.common.net.HostAndPort>> getDefaultLocalPartition(int port)

Parameters:

port - port the instance is configured to run on

Returns:

a simple structure representing one partition, one replica: the local host and configured instance port

parsePartitionsFromStatus

public static List<List<com.google.common.net.HostAndPort>> parsePartitionsFromStatus(URL url)
                                                                               throws IOException

Reads partition information from an XML status document from the cluster, which includes information on partitions and their replicas.

Parameters:

url - URL holding cluster status as an XML document

Returns:

a List of partitions, each of which is a List of replicas in a partition, each represented as a HostAndPort

Throws:

IOException - if the URL can't be accessed or its XML content parsed