org.openqa.selenium.remote.server

Class CapabilitiesComparator

java.lang.Object

org.openqa.selenium.remote.server.CapabilitiesComparator

All Implemented Interfaces:

java.util.Comparator<org.openqa.selenium.Capabilities>

class CapabilitiesComparator
extends java.lang.Object
implements java.util.Comparator<org.openqa.selenium.Capabilities>

Compares two sets of Capabilities against a desired standard. Capabilities are compared by...

1. browser name,
2. browser version,
3. whether JavaScript is enabled,
4. and platform

For all comparisons, if the capability is missing, that particular criteria shall not factor into the comparison.

When comparing platforms, preference will be given to an exact platform match over a fuzzy match (e.g. Platform.WINDOWS will match Platform.WINDOWS before it matches Platform.XP). Furthermore, configurations matching the current system's platform will be given preference. For example, when Platform.getCurrent() == Platform.WINDOWS, a set of Capabilities with Platform.WINDOWS will score higher than one with Platform.ANY.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private static class	CapabilitiesComparator.CapabilityScorer<T>
private static class	CapabilitiesComparator.CurrentPlatformScorer
private static class	CapabilitiesComparator.FuzzyPlatformScorer
private static class	CapabilitiesComparator.VersionScorer

Field Summary

Fields

Modifier and Type	Field and Description
private java.util.Comparator<org.openqa.selenium.Capabilities>	compareWith

Constructor Summary

Constructors

Constructor and Description
CapabilitiesComparator(org.openqa.selenium.Capabilities desiredCapabilities, org.openqa.selenium.Platform currentPlatform)

Method Summary

Modifier and Type	Method and Description
int	compare(org.openqa.selenium.Capabilities a, org.openqa.selenium.Capabilities b)
static <T extends org.openqa.selenium.Capabilities> T	getBestMatch(org.openqa.selenium.Capabilities against, java.util.Collection<T> toCompare)
(package private) static <T extends org.openqa.selenium.Capabilities> T	getBestMatch(org.openqa.selenium.Capabilities against, java.util.Collection<T> toCompare, org.openqa.selenium.Platform currentPlatform)
private static boolean	isNullOrAny(org.openqa.selenium.Platform platform)

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.Comparator

comparing, comparing, comparingDouble, comparingInt, comparingLong, equals, naturalOrder, nullsFirst, nullsLast, reversed, reverseOrder, thenComparing, thenComparing, thenComparing, thenComparingDouble, thenComparingInt, thenComparingLong

Field Detail

compareWith

private final java.util.Comparator<org.openqa.selenium.Capabilities> compareWith

Constructor Detail

CapabilitiesComparator

public CapabilitiesComparator(org.openqa.selenium.Capabilities desiredCapabilities,
                              org.openqa.selenium.Platform currentPlatform)

Method Detail

getBestMatch

public static <T extends org.openqa.selenium.Capabilities> T getBestMatch(org.openqa.selenium.Capabilities against,
                                                                          java.util.Collection<T> toCompare)

getBestMatch

static <T extends org.openqa.selenium.Capabilities> T getBestMatch(org.openqa.selenium.Capabilities against,
                                                                   java.util.Collection<T> toCompare,
                                                                   org.openqa.selenium.Platform currentPlatform)

compare

public int compare(org.openqa.selenium.Capabilities a,
                   org.openqa.selenium.Capabilities b)

Specified by:

compare in interface java.util.Comparator<org.openqa.selenium.Capabilities>

isNullOrAny

private static boolean isNullOrAny(org.openqa.selenium.Platform platform)