Deprecated API

Contents

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

Deprecated Interfaces

Interface and Description
org.apache.velocity.runtime.log.LogSystem Use LogChute instead!
org.apache.velocity.runtime.RuntimeLogger This functionality has been taken over by the Log class

Deprecated Classes

Class and Description
org.apache.velocity.context.EvaluateContext Will be removed in 2.0
org.apache.velocity.runtime.directive.Literal Use the #[[unparsed content]]# syntax instead.
org.apache.velocity.runtime.log.Log4JLogSystem Use Log4JLogChute instead.
org.apache.velocity.runtime.log.NullLogSystem Use NullLogChute.
org.apache.velocity.runtime.log.PrimordialLogSystem Use HoldingLogChute instead!
org.apache.velocity.runtime.Runtime Use RuntimeInstance or RuntimeSingleton instead.
org.apache.velocity.runtime.log.RuntimeLoggerLog This will be removed along with the RuntimeLogger interface.
org.apache.velocity.runtime.log.SimpleLog4JLogSystem Use Log4JLogChute instead.
org.apache.velocity.app.tools.VelocityFormatter This class has been replaced by NumberTool, DateTool, DisplayTool, and AlternatorTool available from the Velocity-Tools sub-project. VelocityFormatter will be removed in a future version of Velocity.
org.apache.velocity.servlet.VelocityServlet This servlet has been replaced by VelocityViewServlet, available from the Velocity-Tools sub-project. VelocityViewServlet provides support for quick, clean MVC web development. VelocityServlet will be removed in a future version of Velocity.
org.apache.velocity.convert.WebMacro Obsolete and outdated.

Deprecated Fields

Field and Description
org.apache.velocity.runtime.log.LogSystem.DEBUG_ON This is unused and meaningless
org.apache.velocity.runtime.RuntimeConstants.DEBUG_PREFIX Use LogChute.DEBUG_PREFIX instead
org.apache.velocity.runtime.RuntimeConstants.ERROR_PREFIX Use LogChute.ERROR_PREFIX instead
org.apache.velocity.runtime.RuntimeConstants.INFO_PREFIX Use LogChute.INFO_PREFIX instead
org.apache.velocity.runtime.RuntimeConstants.RUNTIME_LOG_ERROR_STACKTRACE This appears to have always been meaningless.
org.apache.velocity.runtime.RuntimeConstants.RUNTIME_LOG_INFO_STACKTRACE This appears to have always been meaningless.
org.apache.velocity.runtime.RuntimeConstants.RUNTIME_LOG_WARN_STACKTRACE The functionality this controlled is confusing and no longer necessary.
org.apache.velocity.runtime.RuntimeConstants.TRACE_PREFIX Use LogChute.TRACE_PREFIX instead
org.apache.velocity.runtime.RuntimeConstants.UNKNOWN_PREFIX This will be removed in a future version
org.apache.velocity.runtime.RuntimeConstants.WARN_PREFIX Use LogChute.WARN_PREFIX instead

Deprecated Methods

Method and Description
org.apache.velocity.runtime.RuntimeServices.addVelocimacro(String, String, String[], String) Use addVelocimacro(String, Node, String[], String) instead
org.apache.velocity.runtime.RuntimeSingleton.addVelocimacro(String, String, String[], String) Use addVelocimacro(String, Node, String[], String) instead
org.apache.velocity.runtime.RuntimeInstance.addVelocimacro(String, String, String[], String) Use addVelocimacro(String, Node, String[], String) instead
org.apache.velocity.runtime.Runtime.addVelocimacro(String, String, String[], String) Just like the whole class....
org.apache.velocity.runtime.RuntimeSingleton.debug(Object) Use getLog() and call debug() on it.
org.apache.velocity.runtime.RuntimeInstance.debug(Object) Use getLog() and call debug() on it.
org.apache.velocity.runtime.RuntimeLogger.debug(Object) Use Log.debug(Object)
org.apache.velocity.app.Velocity.debug(Object) Use getLog() and call debug() on it.
org.apache.velocity.app.VelocityEngine.debug(Object) Use getLog() and call warn() on it.
org.apache.velocity.runtime.log.PrimordialLogSystem.dumpLogMessages(LogSystem) use transferTo(LogChute newChute)
org.apache.velocity.runtime.RuntimeSingleton.error(Object) Use getLog() and call error() on it.
org.apache.velocity.runtime.RuntimeInstance.error(Object) Use getLog() and call error() on it.
org.apache.velocity.runtime.RuntimeLogger.error(Object) Use Log.error(Object)
org.apache.velocity.app.Velocity.error(Object) Use getLog() and call error() on it.
org.apache.velocity.app.VelocityEngine.error(Object) Use getLog() and call warn() on it.
org.apache.velocity.app.Velocity.evaluate(Context, Writer, String, InputStream) Use Velocity.evaluate( Context context, Writer writer, String logTag, Reader reader )
org.apache.velocity.app.VelocityEngine.evaluate(Context, Writer, String, InputStream) Use VelocityEngine.evaluate( Context context, Writer writer, String logTag, Reader reader )
org.apache.velocity.runtime.parser.CharStream.getColumn()
org.apache.velocity.runtime.parser.VelocityCharStream.getColumn()
org.apache.velocity.runtime.parser.CharStream.getLine()
org.apache.velocity.runtime.parser.VelocityCharStream.getLine()
org.apache.velocity.runtime.resource.ResourceManagerImpl.getResource(String, int) Use ResourceManagerImpl.getResource(String resourceName, int resourceType, String encoding )
org.apache.velocity.runtime.RuntimeSingleton.getRuntimeInstance() Use getRuntimeServices() instead.
org.apache.velocity.servlet.VelocityServlet.handleRequest(Context) Use VelocityServlet.handleRequest( HttpServletRequest request, HttpServletResponse response, Context ctx )
org.apache.velocity.runtime.RuntimeSingleton.info(Object) Use getLog() and call info() on it.
org.apache.velocity.runtime.RuntimeInstance.info(Object) Use getLog() and call info() on it.
org.apache.velocity.runtime.RuntimeLogger.info(Object) Use Log.info(Object)
org.apache.velocity.app.Velocity.info(Object) Use getLog() and call info() on it.
org.apache.velocity.app.VelocityEngine.info(Object) Use getLog() and call warn() on it.
org.apache.velocity.runtime.log.AvalonLogChute.init(String) This method should not be used. It is here only to provide backwards compatibility for the deprecated AvalonLogSystem class, in case anyone used it and this method directly.
org.apache.velocity.runtime.parser.node.NodeUtils.interpolate(String, Context) this method isn't called by any class
org.apache.velocity.servlet.VelocityServlet.loadConfiguration(ServletConfig) Use VelocityViewServlet from the Velocity Tools library instead.
org.apache.velocity.runtime.log.NullLogSystem.logVelocityMessage(int, String) Use log(level, message).
org.apache.velocity.runtime.log.Log4JLogSystem.logVelocityMessage(int, String) Use log(level, message).
org.apache.velocity.runtime.log.AvalonLogSystem.logVelocityMessage(int, String) Use log(level, message).
org.apache.velocity.runtime.log.PrimordialLogSystem.logVelocityMessage(int, String) Use log(level, message).
org.apache.velocity.runtime.log.LogSystem.logVelocityMessage(int, String) Use log(level, message).
org.apache.velocity.app.Velocity.mergeTemplate(String, Context, Writer) Use Velocity.mergeTemplate( String templateName, String encoding, Context context, Writer writer )
org.apache.velocity.app.VelocityEngine.mergeTemplate(String, Context, Writer) Use VelocityEngine.mergeTemplate( String templateName, String encoding, Context context, Writer writer )
org.apache.velocity.util.StringUtils.removeUnderScores(String) Use the org.apache.commons.util.StringUtils class instead. Using its firstLetterCaps() method in conjunction with a StringTokenizer will achieve the same result.
org.apache.velocity.util.introspection.UberspectLoggable.setRuntimeLogger(RuntimeLogger) Use setLog(Log log) instead.
org.apache.velocity.util.introspection.UberspectImpl.setRuntimeLogger(RuntimeLogger) Use setLog(Log log) instead.
org.apache.velocity.runtime.parser.node.NodeUtils.specialText(Token) use getSpecialText(Token t)
org.apache.velocity.app.Velocity.templateExists(String) Use resourceExists(String) instead.
org.apache.velocity.app.VelocityEngine.templateExists(String) Use resourceExists(String) instead.
org.apache.velocity.runtime.RuntimeSingleton.warn(Object) Use getLog() and call warn() on it.
org.apache.velocity.runtime.RuntimeInstance.warn(Object) Use getLog() and call warn() on it.
org.apache.velocity.runtime.RuntimeLogger.warn(Object) Use Log.warn(Object).
org.apache.velocity.app.Velocity.warn(Object) Use getLog() and call warn() on it.
org.apache.velocity.app.VelocityEngine.warn(Object) Use getLog() and call warn() on it.

Deprecated Constructors

Constructor and Description
org.apache.velocity.runtime.parser.node.BooleanPropertyExecutor(RuntimeLogger, Introspector, Class, String) RuntimeLogger is deprecated. Use the other constructor.
org.apache.velocity.runtime.parser.node.GetExecutor(RuntimeLogger, Introspector, Class, String) RuntimeLogger is deprecated. Use the other constructor.
org.apache.velocity.util.introspection.Introspector(RuntimeLogger) RuntimeLogger is deprecated. Use Introspector(Log log).
org.apache.velocity.runtime.parser.node.PropertyExecutor(RuntimeLogger, Introspector, Class, String) RuntimeLogger is deprecated. Use the other constructor.