Follow Techotopia on Twitter

On-line Guides
All Guides
eBook Store
iOS / Android
Linux for Beginners
Office Productivity
Linux Installation
Linux Security
Linux Utilities
Linux Virtualization
Linux Kernel
System/Network Admin
Programming
Scripting Languages
Development Tools
Web Development
GUI Toolkits/Desktop
Databases
Mail Systems
openSolaris
Eclipse Documentation
Techotopia.com
Virtuatopia.com

How To Guides
Virtualization
General System Admin
Linux Security
Linux Filesystems
Web Servers
Graphics & Desktop
PC Hardware
Windows
Problem Solutions
Privacy Policy

  




 

 


Eclipse Platform
Release 3.5

org.eclipse.ui.console
Interface IPatternMatchListener

All Superinterfaces:
IPatternMatchListenerDelegate

public interface IPatternMatchListener
extends IPatternMatchListenerDelegate

A pattern match listener is registered with a TextConsole, and is notified when its pattern has been matched to contents in that console. A pattern match listener can be registered with a console programmatically or via the consolePatternMatchListeners extension point.

Following is an example console pattern match listener extension definition. <extension point="org.eclipse.ui.console.consolePatternMatchListeners"> <consolePatternMatchListener id="com.example.ConsolePatternMatcher" regex=".*foo.*" class="com.example.ConsolePatternMatcher"> </consolePatternMatchListener> </extension> Attributes are specified as follows:

  • id - a unique identifier for the pattern match listener
  • regex - regular expression to match
  • class - fully qualified name of the Java class implementing org.eclipse.ui.console.IPatternMatchListenerDelegate

Optionally a qualifier attribute may be specified to improve performance of regular expression matching. A qualifier specifies a simple regular expression used to qualify lines for the search. Lines that do not contain the qualifier are not considered.

Optionally an enablement expression may be provided to specify which console(s) a pattern matcher should be contributed to.

Clients may implement this interface directly if registering a pattern match listener with a text console programmatically. Clients contributing a pattern match listener via an extension implement IPatternMatchListenerDelegate instead.

Since:
3.1
See Also:
TextConsole

Method Summary
 int getCompilerFlags ()
          Returns the flags to use when compiling this pattern match listener's regular expression, as defined by by Pattern.compile(String regex, int flags)
  String getLineQualifier ()
          Returns a simple regular expression used to identify lines that may match this pattern matcher's complete pattern, or null.
  String getPattern ()
          Returns the pattern to be used for matching.
 
Methods inherited from interface org.eclipse.ui.console. IPatternMatchListenerDelegate
connect, disconnect, matchFound
 

Method Detail

getPattern

String getPattern()
Returns the pattern to be used for matching. The pattern is a string representing a regular expression.

Returns:
the regular expression to be used for matching

getCompilerFlags

int getCompilerFlags()
Returns the flags to use when compiling this pattern match listener's regular expression, as defined by by Pattern.compile(String regex, int flags)

Returns:
the flags to use when compiling this pattern match listener's regular expression
See Also:
Pattern.compile(java.lang.String, int)

getLineQualifier

String getLineQualifier()
Returns a simple regular expression used to identify lines that may match this pattern matcher's complete pattern, or null. Use of this attribute can improve performance by disqualifying lines from the search. When a line is found containing a match for this expression, the line is searched from the beginning for this pattern matcher's complete pattern. Lines not containing this pattern are discarded.

Returns:
a simple regular expression used to identify lines that may match this pattern matcher's complete pattern, or null

Eclipse Platform
Release 3.5

Guidelines for using Eclipse APIs.

Copyright (c) Eclipse contributors and others 2000, 2008. All rights reserved.


 
 
  Published under the terms of the Eclipse Public License Version 1.0 ("EPL") Design by Interspire