cz.ues.platform.commons.uri

Class UESURIHelper

java.lang.Object

cz.ues.platform.commons.uri.UESURIHelper

Direct Known Subclasses:

UESURIHelper

public class UESURIHelper
extends java.lang.Object

UESURIHelper - this class provides helper methods for working with UESURI.

Since:

UES6-04

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	UESURIHelper() Creates a new instance of UESURIHelper.

Method Summary

Methods

Modifier and Type	Method and Description
private static boolean	areEqual(java.util.List<UESURIPart> aFirst, java.util.List<UESURIPart> aSecond) Tests for equality two UESURIPart lists.
private static boolean	areEqual(java.lang.String aFirst, java.lang.String aSecond) Compares two Strings.
private static boolean	areEqual(UESURIPart aFirst, UESURIPart aSecond) Test for equality two UESURI parts.
static boolean	isInvariable(UESURI aUri) Invariable UESURI is such an UESURI that clearly and permanently identifies one particular object.
static boolean	isSame(UESURI aFirst, UESURI aSecond) Compares two UESURI in all their parts.
static boolean	isSameEntity(UESURI aFirst, UESURI aSecond) Compares two UESURI according their territory and entity part.

Methods inherited from class java.lang.Object

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

Constructor Detail

UESURIHelper

protected UESURIHelper()

Creates a new instance of UESURIHelper.

Since:

UES6-04

Method Detail

isInvariable

public static boolean isInvariable(UESURI aUri)

Invariable UESURI is such an UESURI that clearly and permanently identifies one particular object. Such UESURI must have ID specified for territory and for all UESURI parts which forms UESURI entity part (artifact and object when there is an object part in the UESURI).

When UESURI is invariable, the UESURI can be used as a key in cache or Hash-like collections (e.g. HashMap).

Parameters:

aUri - Tested UESURI.

Returns:

True, when UESURI is invariable, otherwise false.

Since:

UES6-04

isSame

public static boolean isSame(UESURI aFirst,
UESURI aSecond)
throws InsufficientUESURIRTException

Compares two UESURI in all their parts. Both UESURI are the same as the corresponding parts contains either the same Id or the same code. UESURI parts aren't comparable when one UESURIPart contain only code and the other only Id. When incomparable UESURI parts are compared, exception is thrown.

Parameters:

aFirst - First compared UESURI.

aSecond - Second compared UESURI.

Returns:

True, when both UESURI contains the same UESURIParts at corresponding places, otherwise false.

Throws:

InsufficientUESURIRTException - When UESURI contains some incomparable UESURIPart.

Since:

UES6-04

isSameEntity

public static boolean isSameEntity(UESURI aFirst,
UESURI aSecond)
throws InsufficientUESURIRTException

Compares two UESURI according their territory and entity part. Both UESURI are the same as the corresponding parts contains either the same Id or the same code. UESURI parts aren't comparable when one UESURIPart contain only code and the other only Id. When incomparable UESURI parts are compared, exception is thrown.

Parameters:

aFirst - First compared UESURI.

aSecond - Second compared UESURI.

Returns:

True, when both UESURI contains the same territory and entity parts, otherwise false.

Throws:

InsufficientUESURIRTException - When UESURI contains some incomparable UESURIPart.

Since:

UES6-04

areEqual

private static boolean areEqual(java.util.List<UESURIPart> aFirst,
java.util.List<UESURIPart> aSecond)

Tests for equality two UESURIPart lists.

Parameters:

aFirst - First compared UESURI part list.

aSecond - Second compared UESURI part list.

Returns:

True, when both entity parts refers to the same entity, otherwise false.

Since:

UES6-04

areEqual

private static boolean areEqual(UESURIPart aFirst,
UESURIPart aSecond)
throws InsufficientUESURIRTException

Test for equality two UESURI parts.

Parameters:

aFirst - First UESURI part.

aSecond - Second UESURI part.

Returns:

True, when both UESURI part is null or empty or their Id are the same or their Code are the same. When one part contains only code and the other contains only Id, exception is thrown.

Throws:

InsufficientUESURIRTException - When UESURI parts aren't comparable.

Since:

UES6-04

areEqual

private static boolean areEqual(java.lang.String aFirst,
java.lang.String aSecond)

Compares two Strings. Parameters can be null or not null.

Parameters:

aFirst - First compared String.

aSecond - Second compared String.

Returns:

True, when both parameters are equal (are both null or are equal).

Since:

UES6-04