com.helger.commons.regex

Class RegExCache

java.lang.Object

com.helger.commons.cache.Cache<RegExPattern,Pattern>

com.helger.commons.regex.RegExCache

All Implemented Interfaces:

ICache<RegExPattern,Pattern>, IMutableCache<RegExPattern,Pattern>, IHasSize, IHasName

@ThreadSafe
 @Singleton
public final class RegExCache
extends Cache<RegExPattern,Pattern>

This class provides a cached for compiled regular expressions. It caches up to a limited number of compiled Pattern objects.

Author:

Philip Helger

Field Summary

Fields

Modifier and Type	Field and Description
static int	MAX_CACHE_SIZE The default number of items to keep in the cache

Fields inherited from class com.helger.commons.cache.Cache

m_aRWLock, STATISTICS_PREFIX

Method Summary

Modifier and Type	Method and Description
static RegExCache	getInstance()
static Pattern	getPattern(String sRegEx) Get the cached regular expression pattern.
static Pattern	getPattern(String sRegEx, int nOptions) Get the cached regular expression pattern.
static boolean	isInstantiated()

Methods inherited from class com.helger.commons.cache.Cache

clearCache, createCache, getFromCache, getFromCacheNoStats, getFromCacheNoStatsNotLocked, getMaxSize, getName, hasMaxSize, isEmpty, isNotEmpty, putInCache, putInCacheNotLocked, removeFromCache, size, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.helger.commons.name.IHasName

getComparatorCollating, getComparatorName

Field Detail

MAX_CACHE_SIZE

public static final int MAX_CACHE_SIZE

The default number of items to keep in the cache

See Also:

Constant Field Values

Method Detail

isInstantiated

public static boolean isInstantiated()

getInstance

@Nonnull
public static RegExCache getInstance()

getPattern

@Nonnull
public static Pattern getPattern(@Nonnull @Nonempty @RegEx
                                           String sRegEx)

Get the cached regular expression pattern.

Parameters:

sRegEx - The regular expression to retrieve. May neither be null nor empty.

Returns:

The compiled regular expression pattern and never null .

Throws:

IllegalArgumentException - If the passed regular expression has an illegal syntax

getPattern

@Nonnull
public static Pattern getPattern(@Nonnull @Nonempty @RegEx
                                           String sRegEx,
                                           @Nonnegative
                                           int nOptions)

Get the cached regular expression pattern.

Parameters:

sRegEx - The regular expression to retrieve. May neither be null nor empty.

nOptions - The options used for Pattern.compile

Returns:

The compiled regular expression pattern and never null .

Throws:

IllegalArgumentException - If the passed regular expression has an illegal syntax

See Also:

Pattern.compile(String, int)