http.agent
Java System Property accepts a string to use as as prefix in the user agent of HTTP requests.Where x.y.z
is the Java version number.
Sets a prefix value to use as a User-Agent
http request header value to use When a HTTP or HTTPS request is made via an api provided by the Java SDK (HttpsURLConnection or URL.openStream()).
For example if your Java Version is 11.0.15, the default user agent would be:
User-Agent: Java/11.0.15
However if you set -Dhttp.agent=MyUserAgent
then the user agent value would be:
User-Agent: MyUserAgent Java/11.0.15
Here are some other networking Java system properties:
http.keepAlive
http.maxConnections
https.protocols
java.net.preferIPv4Stack
java.net.preferIPv6Addresses
java.net.useSystemProxies
javax.net.debug
javax.net.ssl.trustStore
jdk.net.hosts.file
jdk.tls.client.protocols
jdk.tls.disabledAlgorithms
networkaddress.cache.negative.ttl
networkaddress.cache.ttl
sun.net.client.defaultConnectTimeout
sun.net.client.defaultReadTimeout
sun.net.inetaddr.ttl
Java has supported the http.agent
system property since at least version 1.5, support may go back to even older versions of java.
http.agent
on StartupYou can set the http.agent
java system property during startup of the java runtime using the -D
command line argument:
java -Dhttp.agent=MyUserAgent MyAppMain
You may also be able to specify http.agent
via the JAVA_TOOL_OPTIONS
environment variable:
JAVA_TOOL_OPTIONS=-Dhttp.agent=MyUserAgent
http.agent
at RuntimeYou can set http.agent at runtime with the following Java code:
System.setProperty("http.agent", "MyUserAgent");
WARNING: Depending on the property and JVM version using
setProperty
may or may not work if the JDK Java class that uses this variable has already been loaded. The value of the http.agent system property may be cached within an internal private static variable of the implementing class.
To read the value of http.agent at runtime, you can use this Java code:
String propertyValue = System.getProperty("http.agent"); if (propertyValue != null) { System.out.println("http.agent = " + propertyValue); } else { System.out.println("http.agent was null"); }