Deprecated List (Apache JMeter dist API)
Description: deprecated elements

# Deprecated API

## Contents

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

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

- Deprecated Classes
  Class
  Description
  org.apache.jmeter.control.gui.WorkBenchGui
  since 4.0 Non Test Elements are now children of Test Plan
  org.apache.jmeter.gui.CommentPanel
  `AbstractJMeterGuiComponent.createTitleLabel()` for better alignment of the fields
  org.apache.jmeter.protocol.http.sampler.HttpClientDefaultParameters
  since 5.0
  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.protocol.smtp.sampler.protocol.TrustAllSSLSocketFactory
  Will be removed in next version, use `TrustAllSSLSocketFactory`
  org.apache.jmeter.testelement.WorkBench
  since 4.0
  org.apache.jorphan.logging.LoggingManager
  since 3.2, use SLF4J for logger creation
  org.apache.log.ContextMap
  Will be dropped in 3.3
  org.apache.log.LogEvent
  Will be dropped in 3.3
  org.apache.log.Logger
  Will be dropped in 3.3
  org.apache.log.Priority
  Will be dropped in 3.3

- Deprecated Fields
  Field
  Description
  org.apache.jmeter.gui.AbstractJMeterGuiComponent.namePanel
  use `AbstractJMeterGuiComponent.getName()` or `AbstractJMeterGuiComponent.createTitleLabel()` for better alignment of the fields
  org.apache.jmeter.protocol.http.sampler.HTTPHCAbstractImpl.CPS_HTTPS
  Not used
  org.apache.jmeter.protocol.http.sampler.HTTPHCAbstractImpl.USE_CACHED_SSL_CONTEXT
  use httpclient.reset_state_on_thread_group_iteration instead
  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.exec.SystemCommand.POLL_INTERVAL
  does not make sense anymore. Superseded by `Object.wait(long)`
  org.apache.jorphan.logging.LoggingManager.DEFAULT_PATTERN
  since 3.2, use SLF4J for logging
  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.log.Logger.CATEGORY_SEPARATOR
  Will be dropped in 3.3

- Deprecated Methods
  Method
  Description
  org.apache.jmeter.gui.AbstractJMeterGuiComponent.getNamePanel()
  use `AbstractJMeterGuiComponent.getName()` or `AbstractJMeterGuiComponent.createTitleLabel()` for better alignment of the fields
  org.apache.jmeter.gui.action.LookAndFeelCommand.getJMeterLaf()
  see #getPreferredLafCommand
  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.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.protocol.http.config.gui.UrlConfigDefaults.getDefaultMethod()
  org.apache.jmeter.protocol.http.config.gui.UrlConfigDefaults.isAutoRedirects()
  org.apache.jmeter.protocol.http.config.gui.UrlConfigDefaults.isFollowRedirects()
  org.apache.jmeter.protocol.http.config.gui.UrlConfigDefaults.isUseBrowserCompatibleMultipartMode()
  org.apache.jmeter.protocol.http.config.gui.UrlConfigDefaults.isUseKeepAlive()
  org.apache.jmeter.protocol.http.config.gui.UrlConfigDefaults.isUseMultipart()
  org.apache.jmeter.protocol.http.config.gui.UrlConfigDefaults.setAutoRedirects(boolean)
  org.apache.jmeter.protocol.http.config.gui.UrlConfigDefaults.setDefaultMethod(String)
  org.apache.jmeter.protocol.http.config.gui.UrlConfigDefaults.setFollowRedirects(boolean)
  org.apache.jmeter.protocol.http.config.gui.UrlConfigDefaults.setUseBrowserCompatibleMultipartMode(boolean)
  org.apache.jmeter.protocol.http.config.gui.UrlConfigDefaults.setUseKeepAlive(boolean)
  org.apache.jmeter.protocol.http.config.gui.UrlConfigDefaults.setUseMultipart(boolean)
  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.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.getUseMultipartForPost()
  Use `HTTPAbstractImpl.getUseMultipart()`
  org.apache.jmeter.protocol.http.sampler.HTTPAbstractImpl.isMonitor()
  since 3.2 always return false
  org.apache.jmeter.protocol.http.sampler.HTTPAbstractImpl.notifySSLContextWasReset()
  ** unused since r1489189. **
  org.apache.jmeter.protocol.http.sampler.HTTPAbstractImpl.readResponse(SampleResult, BufferedInputStream, int)
  use `HTTPAbstractImpl.readResponse(SampleResult, BufferedInputStream, long)`
  org.apache.jmeter.protocol.http.sampler.HTTPSamplerBase.getDoMultipartPost()
  use `HTTPSamplerBase.getDoMultipart()`
  org.apache.jmeter.protocol.http.sampler.HTTPSamplerBase.getMonitor()
  since 3.2 always returns false
  org.apache.jmeter.protocol.http.sampler.HTTPSamplerBase.isMonitor()
  since 3.2 always returns false
  org.apache.jmeter.protocol.http.sampler.HTTPSamplerBase.setDoMultipartPost(boolean)
  use `HTTPSamplerBase.setDoMultipartPost(boolean)`
  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.samplers.SampleResult.getBodySize()
  replaced by getBodySizeAsLong()
  org.apache.jmeter.samplers.SampleResult.getBytes()
  use getBytesAsLong
  org.apache.jmeter.samplers.SampleResult.isMonitor()
  since 3.2 always return false
  org.apache.jmeter.samplers.SampleResult.isStartNextThreadLoop()
  use `SampleResult.getTestLogicalAction()`
  org.apache.jmeter.samplers.SampleResult.setBodySize(int)
  use setBodySize(long)
  org.apache.jmeter.samplers.SampleResult.setBytes(int)
  use setBytes(long)
  org.apache.jmeter.samplers.SampleResult.setMonitor(boolean)
  since 3.2 NOOP
  org.apache.jmeter.samplers.SampleResult.setResponseData(String)
  - only intended for use from BeanShell code
  org.apache.jmeter.samplers.SampleResult.setStartNextThreadLoop(boolean)
  use SampleResult#setTestLogicalAction(TestLogicalAction)
  org.apache.jmeter.threads.gui.AbstractThreadGroupGui.configureTestElement(TestElement)
  Override `AbstractThreadGroupGui.modifyTestElement(TestElement)` instead
  org.apache.jmeter.threads.JMeterContext.isRestartNextLoop()
  use `JMeterContext.isStartNextThreadLoop()`
  org.apache.jmeter.threads.JMeterContext.isStartNextThreadLoop()
  use `JMeterContext.getTestLogicalAction()`
  org.apache.jmeter.threads.JMeterContext.setRestartNextLoop(boolean)
  use `JMeterContext.setStartNextThreadLoop(boolean)`
  org.apache.jmeter.threads.JMeterContext.setStartNextThreadLoop(boolean)
  use `JMeterContext.setTestLogicalAction(TestLogicalAction)`
  org.apache.jmeter.threads.JMeterThread.setInitialContext(JMeterContext)
  org.apache.jmeter.timers.poissonarrivals.PreciseThroughputTimer.getAllowedThroughputSurplus()
  org.apache.jmeter.timers.poissonarrivals.PreciseThroughputTimer.getExactLimit()
  org.apache.jmeter.timers.poissonarrivals.PreciseThroughputTimer.setAllowedThroughputSurplus(double)
  org.apache.jmeter.timers.poissonarrivals.PreciseThroughputTimer.setExactLimit(int)
  org.apache.jmeter.util.JMeterUtils.findClassesThatExtend(Class<?>)
  use `JMeterUtils.loadServicesAndScanJars(Class, ServiceLoader, ClassLoader, ServiceLoadExceptionHandler)` instead
  org.apache.jmeter.util.JMeterUtils.getResString(String, String)
  Only intended for use in development; use getResString(String) normally
  org.apache.jmeter.util.JMeterUtils.initLogging()
  does not do anything anymore
  org.apache.jmeter.util.JMeterUtils.unsplit(Object[], Object)
  use `JOrphanUtils.unsplit(Object[], Object)`
  org.apache.jmeter.visualizers.backend.SamplerMetric.setDefaultWindowMode(WindowMode)
  only used for internal testing
  org.apache.jmeter.visualizers.GraphVisualizer.updateGui(Sample)
  use `GraphVisualizer.add(SampleResult)` instead
  org.apache.jmeter.visualizers.StatVisualizer.testFunctors()
  - only for use in testing
  org.apache.jmeter.visualizers.SummaryReport.testFunctors()
  - only for use in testing
  org.apache.jorphan.logging.LoggingManager.addLogTargetToRootLogger(LogTarget[])
  since 3.2, use SLF4J for logging
  org.apache.jorphan.logging.LoggingManager.getLoggerForShortName(String)
  since 3.2, use SLF4J for logging
  org.apache.jorphan.logging.LoggingManager.initializeLogging(Properties)
  since 3.2, use SLF4J for logging
  org.apache.jorphan.logging.LoggingManager.removePrefix(String)
  since 3.2, use SLF4J for logging
  org.apache.jorphan.logging.LoggingManager.setLoggingLevels(Properties)
  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.setPriority(Priority)
  since 3.2, use SLF4J for logging
  org.apache.jorphan.logging.LoggingManager.setPriority(Priority, 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.jorphan.logging.LoggingManager.setTarget(LogTarget, String)
  since 3.2, use SLF4J for logging
  org.apache.jorphan.reflect.ClassFinder.findAnnotatedClasses(String[], Class<? extends Annotation>[])
  use `ClassFinder.loadServices(Class, ServiceLoader, ServiceLoadExceptionHandler)` or `JMeterUtils#loadServicesAndScanJars`
  org.apache.jorphan.reflect.ClassFinder.findAnnotatedClasses(String[], Class<? extends Annotation>[], boolean)
  use `ClassFinder.loadServices(Class, ServiceLoader, ServiceLoadExceptionHandler)` or `JMeterUtils#loadServicesAndScanJars`
  org.apache.jorphan.reflect.ClassFinder.findClasses(String[], ClassFilter)
  use `ClassFinder.loadServices(Class, ServiceLoader, ServiceLoadExceptionHandler)` or `JMeterUtils#loadServicesAndScanJars`
  org.apache.jorphan.reflect.ClassFinder.findClassesThatExtend(String[], Class<?>[])
  use `ClassFinder.loadServices(Class, ServiceLoader, ServiceLoadExceptionHandler)` or `JMeterUtils#loadServicesAndScanJars`
  org.apache.jorphan.reflect.ClassFinder.findClassesThatExtend(String[], Class<?>[], boolean)
  use `ClassFinder.loadServices(Class, ServiceLoader, ServiceLoadExceptionHandler)` or `JMeterUtils#loadServicesAndScanJars`
  org.apache.jorphan.reflect.ClassFinder.findClassesThatExtend(String[], Class<?>[], boolean, String, String)
  use `ClassFinder.loadServices(Class, ServiceLoader, ServiceLoadExceptionHandler)` or `JMeterUtils#loadServicesAndScanJars`
  org.apache.jorphan.reflect.ClassFinder.findClassesThatExtend(String[], Class<?>[], boolean, String, String, boolean)
  use `ClassFinder.loadServices(Class, ServiceLoader, ServiceLoadExceptionHandler)` or `JMeterUtils#loadServicesAndScanJars`
  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.log.Logger.getChildren()
  Will be dropped in 3.3
  org.apache.log.Logger.setAdditivity(boolean)
  Will be dropped in 3.3
  org.apache.log.Logger.setLogTargets(LogTarget[])
  Will be dropped in 3.3
  org.apache.log.Logger.setPriority(Priority)
  Will be dropped in 3.3
  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

- Deprecated Constructors
  Constructor
  Description
  org.apache.jmeter.assertions.AssertionResult()
  - use the named constructor
  org.apache.jmeter.assertions.CompareAssertionResult()
  Use the other ctor
  org.apache.jmeter.control.TransactionSampler()
  only for use by test code
  org.apache.jmeter.exceptions.IllegalUserActionException()
  - use IllegalUserActionException(String)
  org.apache.jmeter.gui.MainFrame()
  Do not use - only needed for JUnit tests
  org.apache.jmeter.gui.SavePropertyDialog()
  Constructor only intended 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.UndoHistoryItem()
  DO NOT USE
  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.gui.util.JLabeledRadioI18N()
  - only for use in testing
  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.protocol.http.config.MultipartUrlConfig()
  only for use by unit tests
  org.apache.jmeter.protocol.http.parser.CSSParseExceptionCallback()
  - only for use from unit test code
  org.apache.jmeter.protocol.tcp.sampler.ReadException()
  For use by test code only (serialisation tests)
  org.apache.jmeter.report.core.ConvertException()
  UNIT TEST ONLY
  org.apache.jmeter.report.core.CsvFile()
  UNIT TEST ONLY
  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.samplers.DataStrippingSampleSender()
  only for use by test code
  org.apache.jmeter.samplers.DiskStoreSampleSender()
  only for use by test code
  org.apache.jmeter.samplers.HoldSampleSender()
  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.testbeans.gui.FileEditor()
  Only for use by test cases
  org.apache.jmeter.testbeans.gui.GenericTestBeanCustomizer()
  only for use by test code
  org.apache.jmeter.testbeans.gui.TestBeanGUI()
  Dummy for JUnit test purposes only
  org.apache.jmeter.visualizers.SearchTreePanel()
  only for use by test code
  org.apache.jmeter.visualizers.TableSample()
  for unit test code only
  org.apache.jmeter.visualizers.XMLDefaultMutableTreeNode()
  only for use by test code

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