Deprecated API

Contents

• Deprecated Interfaces
• Deprecated Classes
• Deprecated Methods
• Deprecated Constructors

Deprecated Interfaces

Interface and Description
com.sonar.sslr.api.AuditListener in 1.19, use com.sonar.sslr.squid.AstScannerExceptionHandler from the SSLR Squid Bridge (2.3)
org.sonar.sslr.text.Preprocessor in 1.20, use your own text API instead.
com.sonar.sslr.api.RecognitionExceptionListener in 1.19, use com.sonar.sslr.squid.AstScannerExceptionHandler from the SSLR Squid Bridge (2.3)
org.sonar.sslr.text.Text in 1.20, use your own text API instead.
org.sonar.sslr.text.TextCharSequence in 1.20, use your own text API instead.

Deprecated Classes

Class and Description
com.sonar.sslr.impl.events.ExtendedStackTrace in 1.19
com.sonar.sslr.impl.events.ExtendedStackTraceStream in 1.19
com.sonar.sslr.impl.matcher.GrammarFunctions in 1.19, use LexerfulGrammarBuilder instead.
org.sonar.sslr.parser.GrammarOperators in 1.19, use LexerlessGrammarBuilder instead.
com.sonar.sslr.impl.events.ParsingEventListener in 1.19
com.sonar.sslr.api.PreprocessingDirective in 1.20, use your own preprocessor API instead.
com.sonar.sslr.api.Preprocessor in 1.20, use your own preprocessor API instead.
com.sonar.sslr.api.PreprocessorAction in 1.20, use your own preprocessor API instead.
org.sonar.sslr.text.PreprocessorContext in 1.20, use your own text API instead.
org.sonar.sslr.text.PreprocessorsChain in 1.20, use your own text API instead.
org.sonar.sslr.text.TextBuilder in 1.20, use your own text API instead.
org.sonar.sslr.text.TextLocation in 1.20, use your own text API instead.
org.sonar.sslr.text.Texts in 1.20, use your own text API instead.

Deprecated Methods

Method and Description
com.sonar.sslr.impl.Parser.Builder.addParsingEventListeners(ParsingEventListener...) in 1.19
com.sonar.sslr.impl.Parser.Builder.addRecognictionExceptionListeners(RecognitionExceptionListener...) in 1.19
com.sonar.sslr.impl.matcher.GrammarFunctions.Advanced.adjacent(Object) in 1.19, use LexerfulGrammarBuilder.adjacent(Object) instead.
com.sonar.sslr.impl.matcher.GrammarFunctions.Standard.and(Object...) in 1.19, use GrammarBuilder.sequence(Object, Object) instead.
com.sonar.sslr.impl.matcher.GrammarFunctions.Advanced.anyToken() in 1.19, use LexerfulGrammarBuilder.anyToken() instead.
com.sonar.sslr.impl.matcher.GrammarFunctions.Advanced.anyTokenButNot(Object) in 1.19, use LexerfulGrammarBuilder.anyTokenButNot(Object) instead.
com.sonar.sslr.impl.matcher.GrammarFunctions.Advanced.bridge(TokenType, TokenType) in 1.19, use LexerfulGrammarBuilder.bridge(TokenType, TokenType) instead.
org.sonar.sslr.parser.GrammarOperators.commentTrivia(Object) in 1.19, use LexerlessGrammarBuilder.commentTrivia(Object) instead.
com.sonar.sslr.impl.matcher.GrammarFunctions.enableMemoizationOfMatchesForAllRules(Grammar) in 1.19, use LexerfulGrammarBuilder.buildWithMemoizationOfMatchesForAllRules() instead.
com.sonar.sslr.impl.Lexer2.endLexing(LexerOutput) use the parser event listeners instead
org.sonar.sslr.parser.GrammarOperators.endOfInput() in 1.19, use LexerlessGrammarBuilder.endOfInput() instead.
org.sonar.sslr.grammar.LexerfulGrammarBuilder.everything() in 1.19, use LexerfulGrammarBuilder.anyToken() instead.
com.sonar.sslr.impl.matcher.GrammarFunctions.Advanced.exclusiveTill(Object...) in 1.19, use LexerfulGrammarBuilder.exclusiveTill(Object) instead.
com.sonar.sslr.api.AstNode.findChildren(AstNodeType...) in 1.17, use AstNode.getDescendants(AstNodeType...) instead, but don't forget that those methods behave differently due to bug SSLR-249
com.sonar.sslr.api.AstNode.findDirectChildren(AstNodeType...) in 1.17, use AstNode.getChildren(AstNodeType...) instead
com.sonar.sslr.api.AstNode.findFirstChild(AstNodeType...) in 1.17, use AstNode.getFirstDescendant(AstNodeType...) instead
com.sonar.sslr.api.AstNode.findFirstDirectChild(AstNodeType...) in 1.17, use AstNode.getFirstChild(AstNodeType...) instead
com.sonar.sslr.api.AstNode.findFirstParent(AstNodeType) in 1.17, use AstNode.getFirstAncestor(AstNodeType) instead
org.sonar.sslr.parser.GrammarOperators.firstOf(Object...) in 1.19, use GrammarBuilder.firstOf(Object, Object) instead.
com.sonar.sslr.impl.matcher.GrammarFunctions.Standard.firstOf(Object...) in 1.19, use GrammarBuilder.firstOf(Object, Object) instead.
com.sonar.sslr.api.AstNode.getChild(int) in 1.19.2, use AstNode.getFirstChild(AstNodeType...) instead
com.sonar.sslr.api.Comments.getCommentAtLine(int) see Comments.getCommentTokensAtLine(int)
com.sonar.sslr.api.AstNode.hasChildren(AstNodeType...) in 1.17, use AstNode.hasDescendant(AstNodeType...) instead. Be careful the name of this method is misleading as the check is done on descendant nodes and not only on child nodes.
com.sonar.sslr.api.AstNode.hasParents(AstNodeType) in 1.17, use AstNode.hasAncestor(AstNodeType) instead
com.sonar.sslr.api.Rule.is(Object...) in 1.19, use GrammarRuleBuilder.is(Object) instead.
com.sonar.sslr.api.Comments.isBlankComment(int) see #isBlank(int)
com.sonar.sslr.api.Comments.isBlankComment(String) see Comments.isBlank(String)
com.sonar.sslr.impl.matcher.GrammarFunctions.Advanced.isFalse() in 1.19, use GrammarBuilder.nothing() instead.
com.sonar.sslr.api.RecognitionException.isFatal() in 1.19
com.sonar.sslr.impl.matcher.GrammarFunctions.Advanced.isOneOfThem(TokenType...) in 1.19, use LexerfulGrammarBuilder.isOneOfThem(TokenType, TokenType...) instead.
com.sonar.sslr.api.Comments.isThereCommentAtLine(int) see Comments.hasCommentTokensAtLine(int)
com.sonar.sslr.api.Comments.isThereCommentBeforeLine(int) since 1.13 use trivia instead
com.sonar.sslr.api.RecognitionException.isToRetryWithExtendStackTrace() in 1.19
com.sonar.sslr.impl.matcher.GrammarFunctions.Advanced.isTrue() in 1.19, use LexerfulGrammarBuilder.anyToken() instead.
com.sonar.sslr.api.Rule.mock() in 1.18, use Rule.override(Object...) instead.
org.sonar.sslr.parser.GrammarOperators.next(Object...) in 1.19, use GrammarBuilder.next(Object) instead.
com.sonar.sslr.impl.matcher.GrammarFunctions.Predicate.next(Object...) in 1.19, use GrammarBuilder.next(Object) instead.
com.sonar.sslr.api.AstNode.nextAstNode() in 1.17, use AstNode.getNextAstNode() instead
org.sonar.sslr.parser.GrammarOperators.nextNot(Object...) in 1.19, use GrammarBuilder.nextNot(Object) instead.
com.sonar.sslr.api.AstNode.nextSibling() in 1.17, use AstNode.getNextSibling() instead
com.sonar.sslr.impl.matcher.GrammarFunctions.Predicate.not(Object) in 1.19, use GrammarBuilder.nextNot(Object) instead.
org.sonar.sslr.parser.GrammarOperators.nothing() in 1.19, use GrammarBuilder.nothing() instead.
com.sonar.sslr.impl.matcher.GrammarFunctions.Standard.o2n(Object...) in 1.19, use GrammarBuilder.zeroOrMore(Object) instead.
com.sonar.sslr.impl.matcher.GrammarFunctions.Standard.one2n(Object...) in 1.19, use GrammarBuilder.oneOrMore(Object) instead.
org.sonar.sslr.parser.GrammarOperators.oneOrMore(Object...) in 1.19, use GrammarBuilder.oneOrMore(Object) instead.
com.sonar.sslr.impl.matcher.GrammarFunctions.Standard.opt(Object...) in 1.19, use GrammarBuilder.optional(Object) instead.
org.sonar.sslr.parser.GrammarOperators.optional(Object...) in 1.19, use GrammarBuilder.optional(Object) instead.
com.sonar.sslr.impl.matcher.GrammarFunctions.Standard.or(Object...) in 1.16, use GrammarFunctions.Standard.firstOf(Object...) instead
com.sonar.sslr.api.Rule.override(Object...) in 1.19, use GrammarRuleBuilder.override(Object) instead.
com.sonar.sslr.api.AstNode.previousAstNode() in 1.17, use AstNode.getPreviousAstNode() instead
com.sonar.sslr.api.AstNode.previousSibling() in 1.17, use AstNode.getPreviousSibling()
org.sonar.sslr.grammar.GrammarRuleBuilder.recoveryRule() in 1.19, no difference between usual grammar rule and "recovery rule" - both will be presented in AST and so can be handled via AST visitor.
com.sonar.sslr.api.Rule.recoveryRule() in 1.19, no difference between usual grammar rule and "recovery rule" - both will be presented in AST and so can be handled via AST visitor.
org.sonar.sslr.parser.GrammarOperators.regexp(String) in 1.19, use LexerlessGrammarBuilder.regexp(String) instead.
org.sonar.sslr.parser.GrammarOperators.sequence(Object...) in 1.19, use GrammarBuilder.sequence(Object, Object) instead.
com.sonar.sslr.impl.Lexer2.setConfiguration(CodeReaderConfiguration)
com.sonar.sslr.impl.Parser.Builder.setExtendedStackTrace(ExtendedStackTrace) in 1.19
com.sonar.sslr.impl.Parser.Builder.setParsingEventListeners(ParsingEventListener...) in 1.19
com.sonar.sslr.impl.Lexer2.setPreprocessors(Preprocessor2...)
com.sonar.sslr.impl.Parser.Builder.setRecognictionExceptionListener(RecognitionExceptionListener...) in 1.19
com.sonar.sslr.api.Token.Builder.setURI(URI) use Token.Builder.setFile(File) instead
com.sonar.sslr.api.Rule.skip() in 1.19, use GrammarRuleBuilder.skip() instead.
com.sonar.sslr.api.Rule.skipIf(AstNodeSkippingPolicy) in 1.19
com.sonar.sslr.api.Rule.skipIfOneChild() in 1.19, use GrammarRuleBuilder.skipIfOneChild() instead.
org.sonar.sslr.parser.GrammarOperators.skippedTrivia(Object) in 1.19, use LexerlessGrammarBuilder.skippedTrivia(Object) instead.
com.sonar.sslr.impl.Lexer2.startLexing() use the parser event listeners instead
com.sonar.sslr.impl.matcher.GrammarFunctions.Advanced.till(Object) in 1.19, use LexerfulGrammarBuilder.till(Object) instead.
com.sonar.sslr.impl.matcher.GrammarFunctions.Advanced.tillNewLine() in 1.19, use LexerfulGrammarBuilder.tillNewLine() instead.
org.sonar.sslr.parser.GrammarOperators.token(TokenType, Object) in 1.19, use LexerlessGrammarBuilder.token(TokenType, Object) instead.
com.sonar.sslr.impl.ast.AstWalker.walkVisitAndListen(AstNode, Object) in 1.18, use AstWalker.walkAndVisit(AstNode) instead
org.sonar.sslr.parser.GrammarOperators.zeroOrMore(Object...) in 1.19, use GrammarBuilder.zeroOrMore(Object) instead.

Deprecated Constructors

Constructor and Description
com.sonar.sslr.impl.Lexer2(Charset)
com.sonar.sslr.impl.channel.UnknownCharacterChannel(boolean) logging removed in 1.20, use UnknownCharacterChannel.UnknownCharacterChannel() or implement your own Channel with logging