Package org.apache.log4j.rule

Class InequalityRule

java.lang.Object

org.apache.log4j.rule.AbstractRule

org.apache.log4j.rule.InequalityRule

All Implemented Interfaces:

java.io.Serializable, Rule

public class InequalityRule
extends AbstractRule

A Rule class implementing inequality evaluation. expects to be able to convert two values to longs. If a specific inequality evaluation class has been provided for the event field, the appropriate rule is returned. (For example, if the expression is Level < DEBUG, a LevelInequalityRule is returned).

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
private java.lang.String	field	Field name.
private java.lang.String	inequalitySymbol	Inequality symbol.
private static LoggingEventFieldResolver	RESOLVER	field RESOLVER.
(package private) static long	serialVersionUID	Serialization ID.
private java.lang.String	value	Comparison value.

Constructor Summary

Constructors

Modifier	Constructor	Description
private	InequalityRule(java.lang.String inequalitySymbol, java.lang.String field, java.lang.String value)	Create new instance.

Method Summary

Modifier and Type	Method	Description
boolean	evaluate(org.apache.log4j.spi.LoggingEvent event, java.util.Map matches)	Returns true if this implementation of the rule accepts the LoggingEvent, or false if not.
static Rule	getRule(java.lang.String inequalitySymbol, java.lang.String field, java.lang.String value)	Create new instance from top two elements on stack.
static Rule	getRule(java.lang.String inequalitySymbol, java.util.Stack stack)	Create new instance from top two elements on stack.

Methods inherited from class org.apache.log4j.rule.AbstractRule

addPropertyChangeListener, firePropertyChange, firePropertyChange, removePropertyChangeListener

Methods inherited from class java.lang.Object

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

Field Detail

serialVersionUID

static final long serialVersionUID

Serialization ID.

See Also:

Constant Field Values

RESOLVER

private static final LoggingEventFieldResolver RESOLVER

field RESOLVER.

field

private final java.lang.String field

Field name.

value

private final java.lang.String value

Comparison value.

inequalitySymbol

private final java.lang.String inequalitySymbol

Inequality symbol.

Constructor Detail

InequalityRule

private InequalityRule(java.lang.String inequalitySymbol,
                       java.lang.String field,
                       java.lang.String value)

Create new instance.

Parameters:

inequalitySymbol - inequality symbol.

field - field

value - comparison value.

Method Detail

getRule

public static Rule getRule(java.lang.String inequalitySymbol,
                           java.util.Stack stack)

Create new instance from top two elements on stack.

Parameters:

inequalitySymbol - inequality symbol.

stack - stack.

Returns:

rule.

getRule

public static Rule getRule(java.lang.String inequalitySymbol,
                           java.lang.String field,
                           java.lang.String value)

Create new instance from top two elements on stack.

Parameters:

inequalitySymbol - inequality symbol.

field - field.

value - comparison value.

Returns:

rule.

evaluate

public boolean evaluate(org.apache.log4j.spi.LoggingEvent event,
                        java.util.Map matches)

Returns true if this implementation of the rule accepts the LoggingEvent, or false if not.

What True/False means can be client-specific.

Parameters:

event - LoggingEvent this instance will evaluate

matches - a Map of event field keys to Sets of matching strings (may be null) which will be updated during execution of this method to include field and string matches based on the rule evaluation results

Returns:

true if this Rule instance accepts the event, otherwise false.