com.inductiveautomation.ignition.common.expressions.parsing

Class StringParser

java.lang.Object

com.inductiveautomation.ignition.common.expressions.parsing.StringParser

All Implemented Interfaces:

Parser

public class StringParser
extends java.lang.Object
implements Parser

This parser handles a literal string which contains references. The resulting expression will produce the string values

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static class	StringParser.StringOrPath

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	CLOSE_DELIM
static java.lang.String	ESCAPE
static java.lang.String	OPEN_DELIM

Constructor Summary

Constructors

Modifier	Constructor and Description
	StringParser()
protected	StringParser(java.lang.Class<? extends AbstractExpression> exprType) This constructor specifies what type of expression should be created.

Method Summary

Modifier and Type	Method and Description
protected void	addPart(java.util.List<StringParser.StringOrPath> parts, StringParser.StringOrPath newPart)
boolean	getAllowsReferenceEscape()
static StringParser	newQueryParser() Returns a parser that expects to parse sql queries for references
static StringParser	newStandardParser_Localized() Returns a parser who creates expressions that simply toString sub-expressions, adjusting the values for the locale.
static StringParser	newStandardParser_NonLocalized() Returns a parser who creates an expression that is the toString of all of the sub-expressions, but with no consideration of the locale.
Expression	parse(java.lang.String expr, ExpressionParseContext binder)
protected StringParser.StringOrPath[]	parseQueryWithBoundPaths(java.lang.String query)
protected StringParser.StringOrPath[]	parseQueryWithEscapedBoundPaths(java.lang.String query) Chops up a query, returning the string segments and path segments separately
void	setAllowsReferenceEscape(boolean value) If true, allows item reference syntax, such as "{blah}" to be escaped with "\", to avoid expansion.

Methods inherited from class java.lang.Object

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

Field Detail

ESCAPE

public static final java.lang.String ESCAPE

See Also:

Constant Field Values

OPEN_DELIM

public static final java.lang.String OPEN_DELIM

See Also:

Constant Field Values

CLOSE_DELIM

public static final java.lang.String CLOSE_DELIM

See Also:

Constant Field Values

Constructor Detail

StringParser

public StringParser()

StringParser

protected StringParser(java.lang.Class<? extends AbstractExpression> exprType)

This constructor specifies what type of expression should be created. Different expressions will behave differently.

Method Detail

newStandardParser_Localized

public static StringParser newStandardParser_Localized()

Returns a parser who creates expressions that simply toString sub-expressions, adjusting the values for the locale.

newStandardParser_NonLocalized

public static StringParser newStandardParser_NonLocalized()

Returns a parser who creates an expression that is the toString of all of the sub-expressions, but with no consideration of the locale.

newQueryParser

public static StringParser newQueryParser()

Returns a parser that expects to parse sql queries for references

setAllowsReferenceEscape

public void setAllowsReferenceEscape(boolean value)

If true, allows item reference syntax, such as "{blah}" to be escaped with "\", to avoid expansion.

getAllowsReferenceEscape

public boolean getAllowsReferenceEscape()

parse

public Expression parse(java.lang.String expr,
                        ExpressionParseContext binder)
                 throws java.lang.Exception

Specified by:

parse in interface Parser

Throws:

java.lang.Exception

addPart

protected void addPart(java.util.List<StringParser.StringOrPath> parts,
                       StringParser.StringOrPath newPart)

parseQueryWithBoundPaths

protected StringParser.StringOrPath[] parseQueryWithBoundPaths(java.lang.String query)
                                                        throws java.lang.Exception

Throws:

java.lang.Exception

parseQueryWithEscapedBoundPaths

protected StringParser.StringOrPath[] parseQueryWithEscapedBoundPaths(java.lang.String query)
                                                               throws java.lang.Exception

Chops up a query, returning the string segments and path segments separately

Throws:

java.lang.Exception