com.googlecode.jmxtrans.model.naming

Class JexlNamingStrategy

java.lang.Object

com.googlecode.jmxtrans.model.naming.JexlNamingStrategy

All Implemented Interfaces:

NamingStrategy

public class JexlNamingStrategy
extends java.lang.Object
implements NamingStrategy

Naming strategy which uses an JEXL expression to format the name from the result, its class name, attribute name, and more. Note the resulting name can be used for any of a number of purposes. For example, with OpenTSDB it could be the metric name or a tag name.

In the expression, all of the following may be used: Variables

alias

the classname alias of the MBean.

attribute

the name of the attribute of the MBean queried.

class

the effective classname of the MBean (uses #alias is not null, otherwise uses #realclass).

realclass

the class name of the MBean.

result

the full Result object.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	DEFAULT_EXPRESSION
protected org.apache.commons.jexl2.JexlEngine	jexl
protected org.apache.commons.jexl2.Expression	parsedExpr
static java.lang.String	VAR_ATTRIBUTE_NAME
static java.lang.String	VAR_CLASSNAME
static java.lang.String	VAR_CLASSNAME_ALIAS
static java.lang.String	VAR_EFFECTIVE_CLASSNAME
static java.lang.String	VAR_RESULT
static java.lang.String	VAR_TYPENAME

Constructor Summary

Constructors

Constructor and Description
JexlNamingStrategy() Create a new naming strategy using an JEXL expression and the default expression.
JexlNamingStrategy(java.lang.String expr) Create a new naming strategy using an JEXL expression and the given expression.

Method Summary

Modifier and Type	Method and Description
java.lang.String	formatName(Result result) Format the name for the given result.
protected void	populateContext(org.apache.commons.jexl2.JexlContext context, Result result) Populate the context with values from the result.
void	setExpression(java.lang.String expr)

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_EXPRESSION

public static final java.lang.String DEFAULT_EXPRESSION

See Also:

Constant Field Values

VAR_CLASSNAME

public static final java.lang.String VAR_CLASSNAME

See Also:

Constant Field Values

VAR_ATTRIBUTE_NAME

public static final java.lang.String VAR_ATTRIBUTE_NAME

See Also:

Constant Field Values

VAR_CLASSNAME_ALIAS

public static final java.lang.String VAR_CLASSNAME_ALIAS

See Also:

Constant Field Values

VAR_EFFECTIVE_CLASSNAME

public static final java.lang.String VAR_EFFECTIVE_CLASSNAME

See Also:

Constant Field Values

VAR_TYPENAME

public static final java.lang.String VAR_TYPENAME

See Also:

Constant Field Values

VAR_RESULT

public static final java.lang.String VAR_RESULT

See Also:

Constant Field Values

jexl

protected org.apache.commons.jexl2.JexlEngine jexl

parsedExpr

protected org.apache.commons.jexl2.Expression parsedExpr

Constructor Detail

JexlNamingStrategy

public JexlNamingStrategy()
                   throws org.apache.commons.jexl2.JexlException

Create a new naming strategy using an JEXL expression and the default expression.

Throws:

org.apache.commons.jexl2.JexlException

JexlNamingStrategy

public JexlNamingStrategy(java.lang.String expr)
                   throws org.apache.commons.jexl2.JexlException

Create a new naming strategy using an JEXL expression and the given expression.

Parameters:

expr - - the JEXL expression to use to create names.

Throws:

org.apache.commons.jexl2.JexlException

Method Detail

formatName

public java.lang.String formatName(Result result)

Format the name for the given result.

Specified by:

formatName in interface NamingStrategy

Parameters:

result - - the result of a JMX query.

Returns:

String - the formatted string resulting from the expression, or null if the formatting fails.

setExpression

public void setExpression(java.lang.String expr)
                   throws org.apache.commons.jexl2.JexlException

Throws:

org.apache.commons.jexl2.JexlException

populateContext

protected void populateContext(org.apache.commons.jexl2.JexlContext context,
                               Result result)

Populate the context with values from the result.

Parameters:

context - - the expression context used when evaluating JEXL expressions.

result - - the result of a JMX query.