Deprecated API

Contents

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

Deprecated Interfaces

Interface and Description
hudson.remoting.CallableFilter Use CallableDecorator

Deprecated Classes

Class and Description
org.jenkinsci.remoting.util.Charsets Use StandardCharsets
org.jenkinsci.remoting.engine.EngineUtil JNLP3 protocol is deprecated
org.jenkinsci.remoting.engine.Jnlp3ConnectionState JNLP3 protocol is deprecated
org.jenkinsci.remoting.engine.JnlpProtocol1Handler Replaced by JNLP4
org.jenkinsci.remoting.engine.JnlpProtocol2Handler Replaced by JNLP4
org.jenkinsci.remoting.engine.JnlpProtocol3Handler Deprecated after the release of JNLP4, see JnlpProtocol4Handler

Deprecated Exceptions

Exceptions and Description
hudson.remoting.ClassFilter.ClassFilterException Only used by deprecated ClassFilter.appendDefaultFilter(java.util.regex.Pattern).

Deprecated Fields

Field and Description
hudson.remoting.ClassFilter.FILE_OVERRIDE_LOCATION_PROPERTY use ClassFilter.setDefault(hudson.remoting.ClassFilter) as needed
hudson.remoting.Engine.listener Use Engine.events.
org.jenkinsci.remoting.protocol.ProtocolLayer.UTF_8 Use StandardCharsets

Deprecated Methods

Method and Description
hudson.remoting.Channel.addLocalExecutionInterceptor(CallableFilter) use Channel.addLocalExecutionInterceptor(CallableDecorator)
hudson.remoting.ClassFilter.appendDefaultFilter(Pattern) use ClassFilter.setDefault(hudson.remoting.ClassFilter) as needed
org.jenkinsci.remoting.org.apache.commons.net.util.SubnetUtils.SubnetInfo.getAddressCount() (3.4) use SubnetUtils.SubnetInfo.getAddressCountLong() instead
org.jenkinsci.remoting.engine.LegacyJnlpConnectionState.getPrintWriter()
hudson.remoting.Channel.getUnderlyingOutput() Future version of the remoting module may add other modes of creating channel that doesn't involve stream pair. Therefore, we aren't committing to this method. This method isn't a part of the committed API of the channel class.
hudson.remoting.Capability.hasMimicException() no longer used
hudson.remoting.ChannelBuilder.isRestricted() Test individual features instead.
hudson.remoting.Channel.isRestricted() Use methods like Channel.isRemoteClassLoadingAllowed() and Channel.isArbitraryCallableAllowed() to test individual features.
hudson.remoting.Which.jarURL(Class) Use Which.classFileUrl(Class)
hudson.remoting.Launcher.main(InputStream, OutputStream, Channel.Mode, boolean) Use #main(InputStream, OutputStream, Mode, boolean, JarCache)
hudson.remoting.PingThread.onDead() as of 2.9 Override PingThread.onDead(Throwable) to receive the cause, but also override this method and provide a fallback behaviour to be backward compatible with earlier version of remoting library.
hudson.remoting.Channel.removeLocalExecutionInterceptor(CallableFilter) use Channel.removeLocalExecutionInterceptor(CallableDecorator)
hudson.remoting.Channel.setRestricted(boolean) Use methods like Channel.setRemoteClassLoadingAllowed(boolean) and Channel.setArbitraryCallableAllowed(boolean) to control individual features.
hudson.remoting.Channel.waitForRemoteProperty(ChannelProperty<T>) Because ChannelProperty is identity-equality, this method would never work. This is a design error.
hudson.remoting.ChannelBuilder.withRestricted(boolean) Control individual features.

Deprecated Constructors

Constructor and Description
hudson.remoting.Channel(String, ExecutorService, Channel.Mode, InputStream, OutputStream) as of 2.24 Use ChannelBuilder
hudson.remoting.Channel(String, ExecutorService, Channel.Mode, InputStream, OutputStream, OutputStream) as of 2.24 Use ChannelBuilder
hudson.remoting.Channel(String, ExecutorService, Channel.Mode, InputStream, OutputStream, OutputStream, boolean) as of 2.24 Use ChannelBuilder
hudson.remoting.Channel(String, ExecutorService, Channel.Mode, InputStream, OutputStream, OutputStream, boolean, ClassLoader) as of 2.24 Use ChannelBuilder
hudson.remoting.Channel(String, ExecutorService, CommandTransport, boolean, ClassLoader) as of 2.24 Use ChannelBuilder
hudson.remoting.Channel(String, ExecutorService, CommandTransport, boolean, ClassLoader, JarCache) as of 2.38
hudson.remoting.Channel(String, ExecutorService, InputStream, OutputStream) as of 2.24 Use ChannelBuilder
hudson.remoting.Channel(String, ExecutorService, InputStream, OutputStream, OutputStream) as of 2.24 Use ChannelBuilder
hudson.remoting.ChannelClosedException() Use ChannelClosedException.ChannelClosedException(Throwable) or ChannelClosedException.ChannelClosedException(java.lang.String, java.lang.Throwable). This constructor will not include cause of the termination.
hudson.remoting.ChannelClosedException(String, Throwable) Use ChannelClosedException.ChannelClosedException(Channel, String, Throwable)
hudson.remoting.ChannelClosedException(Throwable) Use ChannelClosedException.ChannelClosedException(Channel, Throwable)
hudson.remoting.FastPipedOutputStream(FastPipedInputStream, int) as of 1.350 bufferSize parameter is ignored.
org.jenkinsci.remoting.engine.JnlpAgentEndpoint(String, int, RSAPublicKey, Set<String>) Use JnlpAgentEndpoint.JnlpAgentEndpoint(java.lang.String, int, java.security.interfaces.RSAPublicKey, java.util.Set, java.net.URL)
hudson.remoting.ObjectInputStreamEx(InputStream, ClassLoader) as of 2.53
hudson.remoting.RemoteInputStream(InputStream) as of 2.35 Use RemoteInputStream.RemoteInputStream(InputStream, Flag) and specify either RemoteInputStream.Flag.GREEDY or RemoteInputStream.Flag.NOT_GREEDY.
hudson.remoting.RemoteInputStream(InputStream, boolean) as of 2.35 Use RemoteInputStream.RemoteInputStream(InputStream, Flag, Flag ) with RemoteInputStream.Flag.MANUAL_UNEXPORT. Also specify either RemoteInputStream.Flag.GREEDY or RemoteInputStream.Flag.NOT_GREEDY.
hudson.remoting.SocketInputStream(Socket) Use SocketChannelStream.in(Socket)
hudson.remoting.SocketOutputStream(Socket) Use SocketChannelStream.out(Socket)
hudson.remoting.UnexportCommand(int) Use UnexportCommand.UnexportCommand(int, Throwable)