- All Implemented Interfaces:
- Enclosing class:
public static class IdStrategy.CaseSensitiveEmailAddress extends IdStrategy.CaseSensitive implements SerializableA 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.
- See Also:
- Serialized Form
Nested Class Summary
Nested Classes Modifier and Type Class Description
Nested classes/interfaces inherited from class jenkins.model.IdStrategy
IdStrategy.CaseInsensitive, IdStrategy.CaseSensitive, IdStrategy.CaseSensitiveEmailAddress
Constructors Constructor Description
All Methods Instance Methods Concrete Methods Modifier and Type Method Description
compare(String id1, String id2)Compare two IDs and return their sorting order.
equals(String id1, String id2)Compare two IDs and return
trueIFF the two ids are the same.
keyFor(String id)Converts an ID into a key for use in a Java Map or similar.
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
equalsCompare two IDs and return
trueIFF 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. Subclasses may want to override this naïve implementation that calls
compare(id1, id2) == 0for a more performant implementation.
keyForConverts 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".
compareCompare two IDs and return their sorting order. If
truethen this must return
0need not imply that