com.sun.identity.entitlement

Class ExactMatchResourceName

java.lang.Object

com.sun.identity.entitlement.ExactMatchResourceName

All Implemented Interfaces:

ResourceName, Comparator, BaseResourceName<ResourceMatch,EntitlementException>

public class ExactMatchResourceName
extends Object
implements Comparator, ResourceName

This plugin extends the functionality provided in PrefixResourceName to provide special handling to URL type prefix resource names in canonicalize method like validating port, assigning default port of 80, if port absent etc.

Constructor Summary

Constructors

Constructor and Description
ExactMatchResourceName()

Method Summary

Modifier and Type	Method and Description
String	append(String superResource, String subResource) Appends sub-resource to super-resource.
String	canonicalize(String str) Canonicalizes a string.
int	compare(Object o1, Object o2) This method is used to compare two url query parameter strings.
ResourceMatch	compare(String requestResource, String targetResource, boolean wildcardCompare) Compares two resources.
Set<String>	getServiceTypeNames() Returns the service type names for which the resource name object can be used.
String	getSubResource(String resource, String superResource) Gets sub-resource from an original resource minus a super resource.
void	initialize(Map configParams) Initializes the resource name with configuration information, usually set by the administrators.
boolean	matches(String s, String p)
String[]	split(String res) Method to split a resource into the smallest necessary sub resource units.

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

Constructor Detail

ExactMatchResourceName

public ExactMatchResourceName()

Method Detail

initialize

public void initialize(Map configParams)

Description copied from interface: BaseResourceName

Initializes the resource name with configuration information, usually set by the administrators.

Specified by:

initialize in interface BaseResourceName<ResourceMatch,EntitlementException>

Parameters:

configParams - configuration parameters as a map. The keys of the map are the configuration parameters. Each key is corresponding to one String value which specifies the configuration parameter value.

canonicalize

public String canonicalize(String str)
                    throws EntitlementException

Canonicalizes a string.

Specified by:

canonicalize in interface BaseResourceName<ResourceMatch,EntitlementException>

Parameters:

str - the url string to be canonicalized

Returns:

the url string in its canonicalized form.

Throws:

EntitlementException - if the url string is invalid

compare

public int compare(Object o1,
                   Object o2)

This method is used to compare two url query parameter strings. A query parameter string is in the form of variablename=value.

Specified by:

compare in interface Comparator

Parameters:

o1 - a url query parameter to be compared

o2 - a url query parameter to be compared

Returns:

-1 if o1 < o2; 0 if o1 = o2; 1 if o1 > o2

matches

public boolean matches(String s,
                       String p)

getSubResource

public String getSubResource(String resource,
                             String superResource)

Description copied from interface: BaseResourceName

Gets sub-resource from an original resource minus a super resource. This is the complementary method of append().

Specified by:

getSubResource in interface BaseResourceName<ResourceMatch,EntitlementException>

Parameters:

resource - name of the original resource consisting of the second parameter superRes and the returned value

superResource - name of the super-resource which the first parameter begins with.

Returns:

returns the sub-resource which the first parameter ends with. If the first parameter does not begin with the the first parameter, then the return value is null.

append

public String append(String superResource,
                     String subResource)

Description copied from interface: BaseResourceName

Appends sub-resource to super-resource.

Specified by:

append in interface BaseResourceName<ResourceMatch,EntitlementException>

Parameters:

superResource - name of the super-resource to be appended to.

subResource - name of the sub-resource to be appended.

Returns:

returns the combination resource.

compare

public ResourceMatch compare(String requestResource,
                             String targetResource,
                             boolean wildcardCompare)

Description copied from interface: BaseResourceName

Compares two resources.

Specified by:

compare in interface BaseResourceName<ResourceMatch,EntitlementException>

Parameters:

requestResource - name of the resource which will be compared

targetResource - name of the resource which will be compared with

wildcardCompare - flag for wildcard comparison

Returns:

returns ResourceMatch that specifies if the resources are exact match, or otherwise.

• ResourceMatch.NO_MATCH means two resources do not match
• ResourceMatch.EXACT_MATCH means two resources match
• ResourceMatch.SUB_RESOURCE_MATCH means compRes is the sub resource of the origRes
• ResourceMatch.SUPER_RESOURCE_MATCH means compRes is the super resource of the origRes
• ResourceMatch.WILDCARD_MATCH means two resources match with respect to the wildcard

getServiceTypeNames

public Set<String> getServiceTypeNames()

Description copied from interface: BaseResourceName

Returns the service type names for which the resource name object can be used.

Specified by:

getServiceTypeNames in interface BaseResourceName<ResourceMatch,EntitlementException>

Returns:

service type names for which the resource comparator can be used

split

public String[] split(String res)

Description copied from interface: BaseResourceName

Method to split a resource into the smallest necessary sub resource units.

Specified by:

split in interface BaseResourceName<ResourceMatch,EntitlementException>

Parameters:

res - name of the resource to be split

Returns:

returns the array of sub-resources, with the first element being what the original resource begins with, and the last one being what it ends with