hudson

Class ProxyConfiguration

java.lang.Object

hudson.model.AbstractDescribableImpl<ProxyConfiguration>

hudson.ProxyConfiguration

All Implemented Interfaces:

Describable<ProxyConfiguration>, Saveable, Serializable

@StaplerAccessibleType
public final class ProxyConfiguration
extends AbstractDescribableImpl<ProxyConfiguration>
implements Saveable, Serializable

HTTP proxy configuration.

Use open(URL) to open a connection with the proxy setting.

Proxy authentication (including NTLM) is implemented by setting a default Authenticator which provides a PasswordAuthentication (as described in the Java 8 tech note Http Authentication).

See Also:

Jenkins.proxy, Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ProxyConfiguration.DescriptorImpl

Field Summary

Fields

Modifier and Type	Field and Description
String	name
String	noProxyHost List of host names that shouldn't use proxy, as typed by users.
int	port

Fields inherited from interface hudson.model.Saveable

NOOP

Constructor Summary

Constructors

Constructor and Description
ProxyConfiguration(String name, int port)
ProxyConfiguration(String name, int port, String userName, String password)
ProxyConfiguration(String name, int port, String userName, String password, String noProxyHost)
ProxyConfiguration(String name, int port, String userName, String password, String noProxyHost, String testUrl)

Method Summary

Modifier and Type	Method and Description
Proxy	createProxy() Deprecated. Use createProxy(String)
Proxy	createProxy(String host)
static Proxy	createProxy(String host, String name, int port, String noProxyHost)
String	getEncryptedPassword() Deprecated. Use getSecretPassword()
static InputStream	getInputStream(URL url)
String	getName()
String	getNoProxyHost()
List<Pattern>	getNoProxyHostPatterns() Returns the list of properly formatted no proxy host names.
static List<Pattern>	getNoProxyHostPatterns(String noProxyHost) Returns the list of properly formatted no proxy host names.
String	getPassword() Deprecated. Use getSecretPassword()
int	getPort()
Secret	getSecretPassword()
String	getTestUrl()
String	getUserName()
static XmlFile	getXmlFile()
static ProxyConfiguration	load()
static URLConnection	open(URL url) This method should be used wherever URL.openConnection() to internet URLs is invoked directly.
void	save() Persists the state of this object into XML.
void	setNoProxyHost(String noProxyHost)
void	setSecretPassword(Secret secretPassword)
void	setTestUrl(String testUrl)
void	setUserName(String userName)

Methods inherited from class hudson.model.AbstractDescribableImpl

getDescriptor

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

name

public final String name

port

public final int port

noProxyHost

@Restricted(value=org.kohsuke.accmod.restrictions.NoExternalUse.class)
public String noProxyHost

List of host names that shouldn't use proxy, as typed by users.

See Also:

getNoProxyHostPatterns()

Constructor Detail

ProxyConfiguration

@DataBoundConstructor
public ProxyConfiguration(String name,
                                                int port)

ProxyConfiguration

public ProxyConfiguration(String name,
                          int port,
                          String userName,
                          String password)

ProxyConfiguration

public ProxyConfiguration(String name,
                          int port,
                          String userName,
                          String password,
                          String noProxyHost)

ProxyConfiguration

public ProxyConfiguration(String name,
                          int port,
                          String userName,
                          String password,
                          String noProxyHost,
                          String testUrl)

Method Detail

getUserName

public String getUserName()

getSecretPassword

public Secret getSecretPassword()

getPassword

@Deprecated
public String getPassword()

Deprecated. Use getSecretPassword()

getEncryptedPassword

@Deprecated
public String getEncryptedPassword()

Deprecated. Use getSecretPassword()

Returns:

the encrypted proxy password

getTestUrl

public String getTestUrl()

getPort

public int getPort()

getName

public String getName()

getNoProxyHostPatterns

public List<Pattern> getNoProxyHostPatterns()

Returns the list of properly formatted no proxy host names.

getNoProxyHost

public String getNoProxyHost()

getNoProxyHostPatterns

public static List<Pattern> getNoProxyHostPatterns(String noProxyHost)

Returns the list of properly formatted no proxy host names.

setSecretPassword

@DataBoundSetter
public void setSecretPassword(Secret secretPassword)

setTestUrl

@DataBoundSetter
public void setTestUrl(String testUrl)

setUserName

@DataBoundSetter
public void setUserName(String userName)

setNoProxyHost

@DataBoundSetter
public void setNoProxyHost(String noProxyHost)

createProxy

@Deprecated
public Proxy createProxy()

Deprecated. Use createProxy(String)

createProxy

public Proxy createProxy(String host)

createProxy

public static Proxy createProxy(String host,
                                String name,
                                int port,
                                String noProxyHost)

save

public void save()
          throws IOException

Description copied from interface: Saveable

Persists the state of this object into XML.

For making a bulk change efficiently, see BulkChange.

To support listeners monitoring changes to this object, call SaveableListener.fireOnChange(hudson.model.Saveable, hudson.XmlFile)

Specified by:

save in interface Saveable

Throws:

IOException - if the persistence failed.

getXmlFile

public static XmlFile getXmlFile()

load

public static ProxyConfiguration load()
                               throws IOException

Throws:

IOException

open

public static URLConnection open(URL url)
                          throws IOException

This method should be used wherever URL.openConnection() to internet URLs is invoked directly.

Throws:

IOException

getInputStream

public static InputStream getInputStream(URL url)
                                  throws IOException

Throws:

IOException