rocks.xmpp.precis

Class PrecisProfiles

java.lang.Object

rocks.xmpp.precis.PrecisProfiles

public final class PrecisProfiles
extends java.lang.Object

This class provides common PRECIS profiles, mainly specified by Preparation, Enforcement, and Comparison of Internationalized Strings Representing Usernames and Passwords (RFC 8265). Each profile offers methods for preparation, enforcement and comparison of Unicode strings.

Preparation

Preparation ensures, that a string contains only valid characters, but usually does not apply any mapping rules.

 
 PrecisProfiles.USERNAME_CASE_MAPPED.prepare("UpperCaseUsername");
 
 

If the passed string contains any invalid characters, an InvalidCodePointException is thrown:

 
 PrecisProfiles.USERNAME_CASE_MAPPED.prepare("Username♚"); // Contains symbol, throws exception.
 
 

Enforcement

Enforcement applies specific rules (e.g. case mapping) to the string for the purpose of determining if the string can be used in a given protocol slot.

 
 String enforced = PrecisProfiles.USERNAME_CASE_MAPPED.enforce("UpperCaseUsername"); // uppercaseusername
 
 

Comparison

You can just use PrecisProfile.toComparableString(CharSequence) to check, if two strings compare to each other, e.g.:

 
 PrecisProfile profile = PrecisProfiles.USERNAME_CASE_MAPPED;
 if (profile.toComparableString("foobar").equals(profile.toComparableString("FooBar"))) {
     // username already exists.
 }
 
 

Or you can use PrecisProfile as a Comparator:

 
 if (profile.compare("foobar", "FooBar") == 0) {
     // username already exists.
 }
 
 

Note that a profile may use different rules during comparison than during enforcement (as the Nickname profile, RFC 8266).

See Also:

PrecisProfile

Field Summary

Fields

Modifier and Type	Field and Description
static PrecisProfile	IDN A profile for preparing and enforcing international domain names.
static PrecisProfile	NICKNAME The "Nickname Profile" specified in "Preparation, Enforcement, and Comparison of Internationalized Strings Representing Nicknames", RFC 8266.
static PrecisProfile	OPAQUE_STRING The "OpaqueString Profile" specified in "Preparation, Enforcement, and Comparison of Internationalized Strings Representing Usernames and Passwords", RFC 8265.
static PrecisProfile	USERNAME_CASE_MAPPED The "UsernameCaseMapped Profile" specified in "Preparation, Enforcement, and Comparison of Internationalized Strings Representing Usernames and Passwords", RFC 8265.
static PrecisProfile	USERNAME_CASE_PRESERVED The "UsernameCasePreserved Profile" specified in "Preparation, Enforcement, and Comparison of Internationalized Strings Representing Usernames and Passwords", RFC 8265.

Method Summary

Methods inherited from class java.lang.Object

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

Field Detail

USERNAME_CASE_MAPPED

public static final PrecisProfile USERNAME_CASE_MAPPED

The "UsernameCaseMapped Profile" specified in "Preparation, Enforcement, and Comparison of Internationalized Strings Representing Usernames and Passwords", RFC 8265.

See Also:

3.3. UsernameCaseMapped Profile

USERNAME_CASE_PRESERVED

public static final PrecisProfile USERNAME_CASE_PRESERVED

The "UsernameCasePreserved Profile" specified in "Preparation, Enforcement, and Comparison of Internationalized Strings Representing Usernames and Passwords", RFC 8265.

See Also:

3.4. UsernameCasePreserved Profile

OPAQUE_STRING

public static final PrecisProfile OPAQUE_STRING

The "OpaqueString Profile" specified in "Preparation, Enforcement, and Comparison of Internationalized Strings Representing Usernames and Passwords", RFC 8265.

See Also:

4.2. OpaqueString Profile

NICKNAME

public static final PrecisProfile NICKNAME

The "Nickname Profile" specified in "Preparation, Enforcement, and Comparison of Internationalized Strings Representing Nicknames", RFC 8266.

See Also:

Preparation, Enforcement, and Comparison of Internationalized Strings Representing Nicknames

IDN

public static final PrecisProfile IDN

A profile for preparing and enforcing international domain names. While not an official PRECIS profile, this profiles applies the mapping rules described in RFC 5895 2. The General Procedure to a domain name.

See Also:

RFC 5895 2. The General Procedure