# 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.getDoMultipartPost()`
  org.apache.jmeter.timers.poissonarrivals.PreciseThroughputTimer.getExactLimit()
  org.apache.jmeter.gui.action.LookAndFeelCommand.getJMeterLaf() see #getPreferredLafCommand
  org.apache.jmeter.visualizers.backend.AbstractBackendListenerClient.getLogger() Will be removed in 3.3, use `AbstractBackendListenerClient.getNewLogger()`
  org.apache.jmeter.protocol.java.sampler.AbstractJavaSamplerClient.getLogger() Will be removed in 3.3, use `AbstractJavaSamplerClient.getNewLogger()`
  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.HTTPAbstractImpl.isMonitor() since 3.2 always return false
  org.apache.jmeter.protocol.http.sampler.HTTPSamplerBase.isMonitor() since 3.2 always returns 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.LengthPrefixedBinaryTCPClientImpl.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.TCPClientImpl.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.StatVisualizer.testFunctors() - only for use in testing
  org.apache.jmeter.visualizers.SummaryReport.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 `columnsMgsParameters` 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`)

Copyright © 1998-2019 Apache Software Foundation. All Rights Reserved.