| java.lang.Object
 sun.misc.RegexpPool
| RegexpPool | | public class RegexpPool (Code) | | A class to represent a pool of regular expressions. A string
can be matched against the whole pool all at once. It is much
faster than doing individual regular expression matches one-by-one.
See Also: java.misc.RegexpTarget
author:
James Gosling |
| Method Summary | |
| public void | add(String re, Object ret)
Add a regular expression to the pool of regular expressions.
Parameters:
re - The regular expression to add to the pool.For now, only handles strings that either begin or end witha '*'.
Parameters:
ret - The object to be returned when this regular expression ismatched. | | public Object | delete(String re)
Delete the regular expression and its target. | | public static void | main(String argv)
| | public Object | match(String s)
Search for a match to a string & return the object associated
with it with the match. | | public Object | matchNext(String s)
| | public void | print(PrintStream out)
| | public void | replace(String re, Object ret)
Replace the target for the regular expression with a different
target.
Parameters:
re - The regular expression to be replaced in the pool.For now, only handles strings that either begin or end witha '*'.
Parameters:
ret - The object to be returned when this regular expression ismatched. | | public void | reset()
Resets the pool so that the next call to matchNext looks
at all regular expressions in the pool. |
| RegexpPool | | public RegexpPool()(Code) | | |
| add | | public void add(String re, Object ret) throws REException(Code) | | Add a regular expression to the pool of regular expressions.
Parameters:
re - The regular expression to add to the pool.For now, only handles strings that either begin or end witha '*'.
Parameters:
ret - The object to be returned when this regular expression ismatched. If ret is an instance of the RegexpTarget class, ret.foundis called with the string fragment that matched the '*' as its parameter.
exception:
REException - error |
| delete | | public Object delete(String re)(Code) | | Delete the regular expression and its target.
Parameters:
re - The regular expression to be deleted from the pool.must begin or end with a '*' target - the old target. |
| match | | public Object match(String s)(Code) | | Search for a match to a string & return the object associated
with it with the match. When multiple regular expressions
would match the string, the best match is returned first.
The next best match is returned the next time matchNext is
called.
Parameters:
s - The string to match against the regular expressionsin the pool. null on failure, otherwise the object associated withthe regular expression when it was added to the pool.If the object is an instance of RegexpTarget, thenthe return value is the result from callingreturn.found(string_that_matched_wildcard). |
| matchNext | | public Object matchNext(String s)(Code) | | Identical to match except that it will only find matches to
regular expressions that were added to the pool after
the last regular expression that matched in the last call
to match() or matchNext()
|
| replace | | public void replace(String re, Object ret)(Code) | | Replace the target for the regular expression with a different
target.
Parameters:
re - The regular expression to be replaced in the pool.For now, only handles strings that either begin or end witha '*'.
Parameters:
ret - The object to be returned when this regular expression ismatched. If ret is an instance of the RegexpTarget class, ret.foundis called with the string fragment that matched the '*' as its parameter. |
| reset | | public void reset()(Code) | | Resets the pool so that the next call to matchNext looks
at all regular expressions in the pool. match(s); is equivalent
to reset(); matchNext(s);
Multithreading note: reset/nextMatch leave state in the
regular expression pool. If multiple threads could be using this
pool this way, they should be syncronized to avoid race hazards.
match() was done in such a way that there are no such race
hazards: multiple threads can be matching in the same pool
simultaneously.
|
|
|