jenkins.model

Class IdStrategy.CaseSensitiveEmailAddress

java.lang.Object

hudson.model.AbstractDescribableImpl<IdStrategy>

jenkins.model.IdStrategy

jenkins.model.IdStrategy.CaseSensitive

jenkins.model.IdStrategy.CaseSensitiveEmailAddress

All Implemented Interfaces:

ExtensionPoint, Describable<IdStrategy>, Comparator<String>

Enclosing class:

IdStrategy

public static class IdStrategy.CaseSensitiveEmailAddress
extends IdStrategy.CaseSensitive

A case sensitive email address IdStrategy. Providing this implementation among the set of default implementations as given the history of misunderstanding in the Jenkins code base around ID case sensitivity, if not provided people will get this wrong.

Note: Not all email addresses are case sensitive. It is knowledge that belongs to the server that holds the mailbox. Most sane system administrators do not configure their accounts using case sensitive mailboxes but the RFC does allow them the option to configure that way. Domain names are always case insensitive per RFC.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	IdStrategy.CaseSensitiveEmailAddress.DescriptorImpl

Nested classes/interfaces inherited from class jenkins.model.IdStrategy

IdStrategy.CaseInsensitive, IdStrategy.CaseSensitive, IdStrategy.CaseSensitiveEmailAddress

Nested classes/interfaces inherited from interface hudson.ExtensionPoint

ExtensionPoint.LegacyInstancesAreScopedToHudson

Field Summary

Fields inherited from class jenkins.model.IdStrategy

CASE_INSENSITIVE

Constructor Summary

Constructors

Constructor and Description
CaseSensitiveEmailAddress()

Method Summary

Modifier and Type	Method and Description
int	compare(String id1, String id2) Compare two IDs and return their sorting order.
boolean	equals(String id1, String id2) Compare two IDs and return true IFF the two ids are the same.
String	keyFor(String id) Converts an ID into a key for use in a Java Map or similar.

Methods inherited from class jenkins.model.IdStrategy.CaseSensitive

idFromFilename

Methods inherited from class jenkins.model.IdStrategy

all, equals, filenameOf, getDescriptor, hashCode, legacyFilenameOf, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.util.Comparator

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

Constructor Detail

CaseSensitiveEmailAddress

@DataBoundConstructor
public CaseSensitiveEmailAddress()

Method Detail

equals

public boolean equals(@Nonnull
                      String id1,
                      @Nonnull
                      String id2)

Compare two IDs and return true IFF the two ids are the same. Normally we expect that this should be the same as IdStrategy.compare(String, String) being equal to 0, however there may be a specific reason for going beyond that, such as sorting id's case insensitively while treating them as case sensitive.

Overrides:

equals in class IdStrategy.CaseSensitive

Parameters:

id1 - the first id.

id2 - the second id.

Returns:

true if and only if the two ids are the same.

keyFor

@Nonnull
public String keyFor(@Nonnull
                              String id)

Converts an ID into a key for use in a Java Map or similar. This controls uniqueness of ids and how multiple different ids may map to the same id. For example, all different capitalizations of "Foo" may map to the same value "foo".

Overrides:

keyFor in class IdStrategy

Parameters:

id - the id.

Returns:

the key.

compare

public int compare(@Nonnull
                   String id1,
                   @Nonnull
                   String id2)

Compare two IDs and return their sorting order. If IdStrategy.equals(String, String) is true then this must return 0 but IdStrategy.compare(String, String) returning 0 need not imply that IdStrategy.equals(String, String) is true.

Specified by:

compare in interface Comparator<String>

Overrides:

compare in class IdStrategy.CaseSensitive

Parameters:

id1 - the first id.

id2 - the second id.

Returns:

the sorting order of the two IDs.