/// <summary>
/// Executes JSONPath and returns matching elements.
/// <br/><br/>
/// In case when same jsonPathExpression needs
/// to be used multiple times it's faster to call <see cref="ExpressionList.TokenizeAndParse(string)"/>
/// and reuse <see cref="ExpressionList"/> returned by <see cref="ExpressionList.TokenizeAndParse(string)"/>.
/// </summary>
/// <param name="jsonPathExpression">JsonPath expression</param>
/// <param name="doc">Parsed JSON document</param>
/// <returns>Matching JsonElements</returns>
public static IReadOnlyList <JsonElement> ExecutePath(string jsonPathExpression, JsonDocument doc)
{
IReadOnlyList <Token> tokens = Tokenizer.Tokenize(jsonPathExpression);
ExpressionList exprList = ExpressionList.Parse(tokens);
return(ExecutePath(exprList, doc).Select(x => x.Clone()).ToList());
}
/// <summary>
/// Checks if parameter jsonPathExpression is valid JSONPath, returns true if it's valid
/// </summary>
/// <param name="jsonPathExpression">Expression string to check</param>
/// <param name="error">Error message if any</param>
/// <returns>True if provided string is valid JSONPath</returns>
public static bool IsPathValid(string jsonPathExpression, out string error)
{
error = null;
try
{
IReadOnlyList <Token> tokens = Tokenizer.Tokenize(jsonPathExpression);
ExpressionList.Parse(tokens);
}
catch (JsonPathwayException ex)
{
error = ex.Message;
return(false);
}
catch (Exception ex)
{
throw new InternalJsonPathwayException("Unexpected internal exception", ex);
}
return(true);
}
