Deprecated API

Contents

• Deprecated Classes
• Deprecated Fields
• Deprecated Methods
• Deprecated Constructors

Deprecated Classes

Class and Description
com.google.template.soy.exprparse.ExprParseUtils Use ExpressionParser methods directly. TODO(user): remove this class.
com.google.template.soy.shared.restricted.SoyJavaRuntimeFunctionUtils Simply use *Data.forValue() directly.
com.google.template.soy.tofu.restricted.SoyTofuFunctionUtils Simply use *Data.forValue() directly.
com.google.template.soy.soyparse.TransitionalThrowingErrorReporter

Deprecated Fields

Field and Description
com.google.template.soy.base.SourceLocation.UNKNOWN There is no reason to use this other than laziness. Soy has complete source location information.

Deprecated Methods

Method and Description
com.google.template.soy.SoyFileSet.compileToJavaObj() Use SoyFileSet.compileToTofu().
com.google.template.soy.base.SoySyntaxException.createCausedWithoutMetaInfo(String, Throwable) Prefer #createCausedWithMetaInfo. There's no good reason for not knowing where an error came from.
com.google.template.soy.base.SoySyntaxException.createWithoutMetaInfo(String) Prefer SoySyntaxException.createWithMetaInfo(java.lang.String, com.google.template.soy.base.SourceLocation). There's no good reason for not knowing where an error comes from.
com.google.template.soy.parsepasses.contextautoesc.Context.equals(Object) Prefer comparing states or predicates like isValidEndContext
com.google.template.soy.exprparse.SimpleCharStream.getColumn()
com.google.template.soy.soyparse.SimpleCharStream.getColumn()
com.google.template.soy.types.parse.SimpleCharStream.getColumn()
com.google.template.soy.exprparse.SimpleCharStream.getLine()
com.google.template.soy.soyparse.SimpleCharStream.getLine()
com.google.template.soy.types.parse.SimpleCharStream.getLine()
com.google.template.soy.base.SourceLocation.isKnown() For the same reason that SourceLocation.UNKNOWN is.
com.google.template.soy.exprparse.ExprParseUtils.parseExprElseNull(String) Use ExpressionParser.parseExpression() directly.
com.google.template.soy.tofu.SoyTofu.render(SoyTemplateInfo, SoyRecord, SoyMsgBundle) Use SoyTofu.newRenderer(SoyTemplateInfo).
com.google.template.soy.tofu.internal.BaseTofu.render(SoyTemplateInfo, SoyRecord, SoyMsgBundle)
com.google.template.soy.tofu.SoyTofu.render(String, Map<String, ?>, SoyMsgBundle) Use SoyTofu.newRenderer(String).
com.google.template.soy.tofu.internal.BaseTofu.render(String, Map<String, ?>, SoyMsgBundle)
com.google.template.soy.tofu.SoyTofu.render(String, SoyRecord, SoyMsgBundle) Use SoyTofu.newRenderer(String).
com.google.template.soy.tofu.internal.BaseTofu.render(String, SoyRecord, SoyMsgBundle)
com.google.template.soy.jssrc.SoyJsSrcOptions.shouldAllowDeprecatedSyntax() Use SoyGeneralOptions.getDeclaredSyntaxVersion().
com.google.template.soy.data.SoyData.toBoolean()
com.google.template.soy.data.SoyMapData.toBoolean()
com.google.template.soy.data.SoyListData.toBoolean()
com.google.template.soy.data.SanitizedContent.toBoolean()
com.google.template.soy.data.restricted.BooleanData.toBoolean()
com.google.template.soy.data.restricted.FloatData.toBoolean()
com.google.template.soy.data.restricted.IntegerData.toBoolean()
com.google.template.soy.data.restricted.NullData.toBoolean()
com.google.template.soy.data.restricted.UndefinedData.toBoolean()
com.google.template.soy.data.restricted.StringData.toBoolean()

Deprecated Constructors

Constructor and Description
com.google.template.soy.data.restricted.BooleanData(boolean) Use BooleanData.TRUE, BooleanData.FALSE, or BooleanData.forValue(boolean).
com.google.template.soy.SoyFileSet.Builder() Use the static SoyFileSet.builder() method, or inject SoyFileSet.Builder using Guice with SoyModule installed. The behavior of this builder is unpredictable and will use the Soy configuration from the most recently configured Injector containing a SoyModule, because it relies on Guice's static injection.
com.google.template.soy.data.restricted.FloatData(double) Use FloatData.forValue(double).
com.google.template.soy.base.SoySyntaxException(String) Do not use outside of Soy code (treat as superpackage-private).
com.google.template.soy.parseinfo.SoyTemplateInfo(String, ImmutableMap<String, SoyTemplateInfo.ParamRequisiteness>) Users should not be creating SoyTemplateInfo objects. If you're constructing SoyTemplateInfo objects from non-Soy-internal code, your code will be broken by future Soy changes.
com.google.template.soy.data.restricted.UndefinedData() Use UndefinedData.INSTANCE.