org.hd.d.pg2k.svrCore.location
Enum GeoProximity

java.lang.Object
  java.lang.Enum<GeoProximity>
      org.hd.d.pg2k.svrCore.location.GeoProximity

All Implemented Interfaces:

java.io.Serializable, java.lang.Comparable<GeoProximity>

public enum GeoProximity
extends java.lang.Enum<GeoProximity>

Defines some broad-brush, ordered, geographical Internet proximity values. Defines strictly-positive value for two points "close" to one another, indicating likely relative connectivity (cf two random points in the Net) including notions of bandwidth, packet loss, RTT, reliability, cost, etc, ie a blended QoS/cost for end user and provider.

I assume that international transit costs roughly 50x intra-country bandwidth, and that cheap peering is not available for all intra-country traffic. I also assume the performance of a long route from a user's point of view is usually somewhat less bad than the cost would imply.

The enum tag is the most important; the numerical values are very approximate and only to be used if nothing better is available.

The tag "NONE" has a value of exactly 1 to indicate no closeness or unknown closeness.

VCLOSE

public static final GeoProximity VCLOSE

Typically MAN or LAN or closer; fast, reliable and almost free.

COUNTRY

public static final GeoProximity COUNTRY

Within one country; usually reasonably fast, reliable and cheap.

COUNTRYGROUP

public static final GeoProximity COUNTRYGROUP

Group of well-connected countries (eg uk and nl, or us and ca).

CONTINENT

public static final GeoProximity CONTINENT

Within one continent or (more-or-less equivalently) one address-registry's ambit (eg RIPE).

NONE

public static final GeoProximity NONE

No particular/known proximity, may well involve expensive/slow/unreliable transit.

closeness

private final int closeness

The "closeness" factor higher meaning closer; strictly positive.

values

public static GeoProximity[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

for (GeoProximity c : GeoProximity.values())
    System.out.println(c);

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static GeoProximity valueOf(java.lang.String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

java.lang.IllegalArgumentException - if this enum type has no constant with the specified name

java.lang.NullPointerException - if the argument is null

getCloseness

public final int getCloseness()

Get the "closeness" factor higher meaning closer; strictly positive.