# Deprecated API

## Contents

- Deprecated Interfaces
- Deprecated Classes
- Deprecated Fields
- Deprecated Methods
- Deprecated Constructors
- Deprecated Enum Constants

Deprecated Interfaces
Interface and Description
org.apache.log.LogTarget Will be dropped in 3.3

Deprecated Classes
Class and Description
org.apache.jmeter.protocol.http.util.Base64Encoder as exists now in java.util.Base64, will be removed in next version 3.3
org.apache.jmeter.gui.CommentPanel `AbstractJMeterGuiComponent.createTitleLabel()` for better alignment of the fields
org.apache.log.ContextMap Will be dropped in 3.3
org.apache.jmeter.protocol.http.sampler.HttpClientDefaultParameters since 5.0
org.apache.log.LogEvent Will be dropped in 3.3
org.apache.log.Logger Will be dropped in 3.3
org.apache.jorphan.logging.LoggingManager since 3.2, use SLF4J for logger creation
org.apache.log.Priority Will be dropped in 3.3
org.apache.jmeter.protocol.smtp.sampler.protocol.TrustAllSSLSocketFactory Will be removed in next version, use `TrustAllSSLSocketFactory`
org.apache.jmeter.testelement.WorkBench since 4.0
org.apache.jmeter.control.gui.WorkBenchGui since 4.0 Non Test Elements are now children of Test Plan

Deprecated Fields
Field and Description
org.apache.log.Logger.CATEGORY_SEPARATOR Will be dropped in 3.3
org.apache.jmeter.protocol.http.sampler.HTTPHCAbstractImpl.CPS_HTTPS Not used
org.apache.jorphan.logging.LoggingManager.DEFAULT_PATTERN since 3.2, use SLF4J for logging
org.apache.jmeter.protocol.jms.sampler.JMSSampler.IS_ONE_WAY since 4.0 replaced by JMS_COMMUNICATION_STYLE
org.apache.jmeter.util.JSR223BeanInfoSupport.LANGUAGE_NAMES use `JSR223BeanInfoSupport.getLanguageNames()`
org.apache.jorphan.logging.LoggingManager.LOG_FILE since 3.2, use SLF4J for logging
org.apache.jorphan.logging.LoggingManager.LOG_PRIORITY since 3.2, use SLF4J for logging
org.apache.jmeter.gui.AbstractJMeterGuiComponent.namePanel use `AbstractJMeterGuiComponent.getName()` or `AbstractJMeterGuiComponent.createTitleLabel()` for better alignment of the fields
org.apache.jorphan.exec.SystemCommand.POLL_INTERVAL does not make sense anymore. Superseded by `Object.wait(long)`
org.apache.jmeter.protocol.http.sampler.HTTPHCAbstractImpl.USE_CACHED_SSL_CONTEXT use httpclient.reset_state_on_thread_group_iteration instead

Deprecated Methods
Method and Description
org.apache.jorphan.logging.LoggingManager.addLogTargetToRootLogger(LogTarget[]) since 3.2, use SLF4J for logging
org.apache.jorphan.reflect.Functor.checkMethod(Object) ** for use by Unit test code only **
org.apache.jorphan.reflect.Functor.checkMethod(Object, Class<?>) ** for use by Unit test code only **
org.apache.jmeter.JMeter.convertSubTree(HashTree) This method does not correctly handle a tree with Replaceable controllers that contain NoThreadClone element. Use `JMeter.convertSubTree(HashTree, boolean)`
org.apache.jmeter.timers.poissonarrivals.PreciseThroughputTimer.getAllowedThroughputSurplus()
org.apache.jmeter.samplers.SampleResult.getBodySize() replaced by getBodySizeAsLong()
org.apache.jmeter.samplers.SampleResult.getBytes() use getBytesAsLong
org.apache.log.Logger.getChildren() Will be dropped in 3.3
org.apache.jmeter.protocol.http.sampler.HTTPSamplerBase.getDoMultipartPost() use `HTTPSamplerBase.getDoMultipart()`
org.apache.jmeter.timers.poissonarrivals.PreciseThroughputTimer.getExactLimit()
org.apache.jmeter.gui.action.LookAndFeelCommand.getJMeterLaf() see #getPreferredLafCommand
org.apache.jorphan.logging.LoggingManager.getLoggerForShortName(String) since 3.2, use SLF4J for logging
org.apache.jmeter.protocol.http.sampler.HTTPSamplerBase.getMonitor() since 3.2 always returns false
org.apache.jmeter.gui.AbstractJMeterGuiComponent.getNamePanel() use `AbstractJMeterGuiComponent.getName()` or `AbstractJMeterGuiComponent.createTitleLabel()` for better alignment of the fields
org.apache.jmeter.util.JMeterUtils.getResString(String, String) Only intended for use in development; use getResString(String) normally
org.apache.jmeter.protocol.http.sampler.HTTPAbstractImpl.getUseMultipartForPost() Use `HTTPAbstractImpl.getUseMultipart()`
org.apache.jmeter.protocol.http.control.CacheManager.inCache(URL) use a version of `CacheManager.inCache(URL, Header[])` or `CacheManager.inCache(URL, org.apache.jmeter.protocol.http.control.Header[])`
org.apache.jorphan.logging.LoggingManager.initializeLogging(Properties) since 3.2, use SLF4J for logging
org.apache.jmeter.util.JMeterUtils.initLogging() does not do anything anymore
org.apache.jmeter.samplers.SampleResult.isMonitor() since 3.2 always return false
org.apache.jmeter.protocol.http.sampler.HTTPSamplerBase.isMonitor() since 3.2 always returns false
org.apache.jmeter.protocol.http.sampler.HTTPAbstractImpl.isMonitor() since 3.2 always return false
org.apache.jmeter.threads.JMeterContext.isRestartNextLoop() use `JMeterContext.isStartNextThreadLoop()`
org.apache.jmeter.samplers.SampleResult.isStartNextThreadLoop() use `SampleResult.getTestLogicalAction()`
org.apache.jmeter.threads.JMeterContext.isStartNextThreadLoop() use `JMeterContext.getTestLogicalAction()`
org.apache.jmeter.protocol.http.control.HeaderManager.merge(TestElement, boolean) since 3.2, use `HeaderManager.merge(TestElement)` as this method will be removed in a future version
org.apache.jmeter.protocol.http.sampler.HTTPAbstractImpl.notifySSLContextWasReset() ** unused since r1489189. **
org.apache.jmeter.protocol.tcp.sampler.BinaryTCPClientImpl.read(InputStream)
org.apache.jmeter.protocol.tcp.sampler.TCPClientImpl.read(InputStream)
org.apache.jmeter.protocol.tcp.sampler.TCPClient.read(InputStream) since 3.3, implement `TCPClient.read(InputStream, SampleResult)` instead, will be removed in future version
org.apache.jmeter.protocol.tcp.sampler.LengthPrefixedBinaryTCPClientImpl.read(InputStream)
org.apache.jmeter.protocol.http.sampler.HTTPAbstractImpl.readResponse(SampleResult, BufferedInputStream, int) use `HTTPAbstractImpl.readResponse(SampleResult, BufferedInputStream, long)`
org.apache.jorphan.logging.LoggingManager.removePrefix(String) since 3.2, use SLF4J for logging
org.apache.log.Logger.setAdditivity(boolean) Will be dropped in 3.3
org.apache.jmeter.timers.poissonarrivals.PreciseThroughputTimer.setAllowedThroughputSurplus(double)
org.apache.jmeter.samplers.SampleResult.setBodySize(int) use setBodySize(long)
org.apache.jmeter.samplers.SampleResult.setBytes(int) use setBytes(long)
org.apache.jmeter.visualizers.backend.SamplerMetric.setDefaultWindowMode(WindowMode) only used for internal testing
org.apache.jmeter.protocol.http.sampler.HTTPSamplerBase.setDoMultipartPost(boolean) use `HTTPSamplerBase.setDoMultipartPost(boolean)`
org.apache.jmeter.timers.poissonarrivals.PreciseThroughputTimer.setExactLimit(int)
org.apache.jorphan.logging.LoggingManager.setLoggingLevels(Properties) since 3.2, use SLF4J for logging
org.apache.log.Logger.setLogTargets(LogTarget[]) Will be dropped in 3.3
org.apache.jmeter.samplers.SampleResult.setMonitor(boolean) since 3.2 NOOP
org.apache.jorphan.logging.LoggingManager.setPriority(Priority) since 3.2, use SLF4J for logging
org.apache.log.Logger.setPriority(Priority) Will be dropped in 3.3
org.apache.jorphan.logging.LoggingManager.setPriority(Priority, String) since 3.2, use SLF4J for logging
org.apache.jorphan.logging.LoggingManager.setPriority(String) since 3.2, use SLF4J for logging
org.apache.jorphan.logging.LoggingManager.setPriority(String, String) since 3.2, use SLF4J for logging
org.apache.jorphan.logging.LoggingManager.setPriorityFullName(String, String) since 3.2, use SLF4J for logging
org.apache.jmeter.samplers.SampleResult.setResponseData(String) - only intended for use from BeanShell code
org.apache.jmeter.threads.JMeterContext.setRestartNextLoop(boolean) use `JMeterContext.setStartNextThreadLoop(boolean)`
org.apache.jmeter.samplers.SampleResult.setStartNextThreadLoop(boolean) use SampleResult#setTestLogicalAction(TestLogicalAction)
org.apache.jmeter.threads.JMeterContext.setStartNextThreadLoop(boolean) use `JMeterContext.setTestLogicalAction(TestLogicalAction)`
org.apache.jorphan.logging.LoggingManager.setTarget(LogTarget, String) since 3.2, use SLF4J for logging
org.apache.jmeter.gui.util.HeaderAsPropertyRendererWrapper.setupDefaultRenderer(JTable, Object[][]) don't use `columnsMsgParameters` as they are not moved when the columns of the corresponding tables object model are moved
org.apache.jmeter.visualizers.SummaryReport.testFunctors() - only for use in testing
org.apache.jmeter.visualizers.StatVisualizer.testFunctors() - only for use in testing
org.apache.log.Logger.unsetLogTargets() Will be dropped in 3.3
org.apache.log.Logger.unsetLogTargets(boolean) Will be dropped in 3.3
org.apache.log.Logger.unsetPriority() Will be dropped in 3.3
org.apache.log.Logger.unsetPriority(boolean) Will be dropped in 3.3
org.apache.jmeter.util.JMeterUtils.unsplit(Object[], Object) use `JOrphanUtils.unsplit(Object[], Object)`
org.apache.jmeter.visualizers.GraphVisualizer.updateGui(Sample) use `GraphVisualizer.add(SampleResult)` instead

Deprecated Constructors
Constructor and Description
org.apache.jmeter.assertions.AssertionResult() - use the named constructor
org.apache.jmeter.samplers.AsynchSampleSender() only for use by test code
org.apache.jmeter.samplers.BatchSampleSender() only for use by test code
org.apache.jmeter.assertions.CompareAssertionResult() Use the other ctor
org.apache.jmeter.report.core.ConvertException() UNIT TEST ONLY
org.apache.jmeter.protocol.http.parser.CSSParseExceptionCallback() - only for use from unit test code
org.apache.jmeter.report.core.CsvFile() UNIT TEST ONLY
org.apache.jmeter.samplers.DataStrippingSampleSender() only for use by test code
org.apache.jmeter.samplers.DiskStoreSampleSender() only for use by test code
org.apache.jmeter.testbeans.gui.FileEditor() Only for use by test cases
org.apache.jmeter.testbeans.gui.GenericTestBeanCustomizer() only for use by test code
org.apache.jmeter.gui.util.HeaderAsPropertyRenderer(Object[][]) don't use `columnsMsgParameters` as they are not moved around when rows of the corresponding table object model are moved.
org.apache.jmeter.gui.util.HeaderAsPropertyRendererWrapper(TableCellRenderer, Object[][]) don't use `columnsMsgParameters` as they are not moved, when the corresponding columns in the tables object model are moved
org.apache.jmeter.samplers.HoldSampleSender() only for use by test code
org.apache.jmeter.exceptions.IllegalUserActionException() - use IllegalUserActionException(String)
org.apache.jmeter.gui.util.JLabeledRadioI18N() - only for use in testing
org.apache.jmeter.gui.tree.JMeterTreeModel(Object) - only for use by JMeter class!
org.apache.jmeter.gui.tree.JMeterTreeModel(TestElement, TestElement) since 4.0
org.apache.jmeter.gui.util.JSyntaxTextArea()
org.apache.jmeter.gui.util.JSyntaxTextArea(int, int) use `JSyntaxTextArea.getInstance(int, int)` instead
org.apache.jmeter.gui.util.JSyntaxTextArea(int, int, boolean) use `JSyntaxTextArea.getInstance(int, int, boolean)` instead
org.apache.jmeter.gui.util.JTextScrollPane()
org.apache.jmeter.gui.util.JTextScrollPane(JSyntaxTextArea) use `JTextScrollPane.getInstance(JSyntaxTextArea)` instead
org.apache.jmeter.gui.util.JTextScrollPane(JSyntaxTextArea, boolean) use `JTextScrollPane.getInstance(JSyntaxTextArea, boolean)` instead
org.apache.jmeter.gui.MainFrame() Do not use - only needed for JUnit tests
org.apache.jmeter.protocol.http.config.MultipartUrlConfig() only for use by unit tests
org.apache.jmeter.protocol.tcp.sampler.ReadException() For use by test code only (serialisation tests)
org.apache.jmeter.gui.SavePropertyDialog() Constructor only intended for use in testing
org.apache.jmeter.visualizers.SearchTreePanel() only for use by test code
org.apache.jmeter.samplers.StandardSampleSender() only for use by test code
org.apache.jmeter.samplers.StatisticalSampleResult(long, long) Needs to be replaced when multiple sample results are sorted out
org.apache.jmeter.samplers.StatisticalSampleSender() only for use by test code
org.apache.jmeter.visualizers.TableSample() for unit test code only
org.apache.jmeter.testbeans.gui.TestBeanGUI() Dummy for JUnit test purposes only
org.apache.jmeter.control.TransactionSampler() only for use by test code
org.apache.jmeter.gui.UndoHistoryItem() DO NOT USE
org.apache.jmeter.visualizers.XMLDefaultMutableTreeNode() only for use by test code

Deprecated Enum Constants
Enum Constant and Description
org.apache.jmeter.protocol.http.control.AuthManager.Mechanism.BASIC_DIGEST (use `AuthManager.Mechanism.BASIC`)