com.aresstack.winproxy

Enum ProxyMode

java.lang.Object

java.lang.Enum<ProxyMode>

com.aresstack.winproxy.ProxyMode

All Implemented Interfaces:

Serializable, Comparable<ProxyMode>

public enum ProxyMode
extends Enum<ProxyMode>

Selects the proxy resolution strategy.

Central axis: PAC_URL_* modes only differ in how the PAC URL is discovered. All PAC_URL_* modes then download the PAC file and evaluate FindProxyForURL through the JavaScript (GraalVM) PAC evaluator. The discovery step never determines the final route by itself.

The modes are cut along clear functional lines. In particular, the way the PAC URL is discovered (PowerShell vs. Windows settings vs. manual) is an explicit choice and is never silently mixed with static-proxy or registry reading. No PAC_URL_* mode ever falls back to WINDOWS_STATIC_PROXY, MANUAL_PROXY or DISABLED.

Enum Constant Summary

Enum Constants

Enum Constant and Description
DISABLED Forces DIRECT.
MANUAL_PROXY Uses a manually configured proxy host:port.
PAC_URL_MANUAL Uses a PAC URL that the user configured explicitly, downloads the PAC file and evaluates FindProxyForURL via GraalVM/JavaScript.
PAC_URL_POWERSHELL Discovers the PAC URL exclusively through PowerShell (the AutoConfigURL one-liner, executed inline via -Command).
PAC_URL_WINDOWS_SETTINGS Discovers the PAC URL from Windows settings without PowerShell, via WindowsPacUrlResolver (reg.exe across all relevant hives/policies, the DefaultConnectionSettings blob and the WPAD auto-detect flag).
POWERSHELL_ROUTE_RESOLVER_LEGACY Deprecated. Use a PAC_URL_* mode (GraalVM PAC evaluation) instead.
WINDOWS_NATIVE_PROXY_SETTINGS Reserved future Java 21 / FFM mode that will read proxy settings / AutoConfigURL / auto-detect through native Windows APIs and then use the Java/GraalVM PAC evaluation.
WINDOWS_NATIVE_ROUTE_RESOLVER Reserved future Java 21 / FFM mode that will determine the final route for a concrete URL through WinHTTP / native Windows APIs (the native successor of POWERSHELL_ROUTE_RESOLVER_LEGACY).
WINDOWS_STATIC_PROXY Reads the classic static Windows proxy from ProxyEnable / ProxyServer / ProxyOverride.

Method Summary

Modifier and Type	Method and Description
static ProxyMode	valueOf(String name) Returns the enum constant of this type with the specified name.
static ProxyMode[]	values() Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

DISABLED

public static final ProxyMode DISABLED

Forces DIRECT.

• No Windows discovery.
• No PAC evaluation.
• No fallback.

MANUAL_PROXY

public static final ProxyMode MANUAL_PROXY

Uses a manually configured proxy host:port.

• No PAC URL.
• No Windows discovery.
• No PAC evaluation.

WINDOWS_STATIC_PROXY

public static final ProxyMode WINDOWS_STATIC_PROXY

Reads the classic static Windows proxy from ProxyEnable / ProxyServer / ProxyOverride.

This is the former REGISTRY mode. It is no PAC mode, reads no AutoConfigURL, and never determines a route via PowerShell. It is only ever used when explicitly selected and must not be a silent fallback of any PAC mode.

PAC_URL_MANUAL

public static final ProxyMode PAC_URL_MANUAL

Uses a PAC URL that the user configured explicitly, downloads the PAC file and evaluates FindProxyForURL via GraalVM/JavaScript.

Pipeline: configured pacUrl -> download -> GraalVM FindProxyForURL -> parse. It performs no automatic discovery:

• No PowerShell.
• No WindowsPacUrlResolver (no reg.exe/registry).
• No StaticProxySettingsResolver.
• No static-proxy or DIRECT fallback — a missing/blank PAC URL is an ERROR.

PAC_URL_POWERSHELL

public static final ProxyMode PAC_URL_POWERSHELL

Discovers the PAC URL exclusively through PowerShell (the AutoConfigURL one-liner, executed inline via -Command). PowerShell may only deliver the PAC URL here, never the final route. Afterwards the PAC file is downloaded and evaluated via GraalVM/JavaScript.

This is the important test path on hardened machines.

PAC_URL_WINDOWS_SETTINGS

public static final ProxyMode PAC_URL_WINDOWS_SETTINGS

Discovers the PAC URL from Windows settings without PowerShell, via WindowsPacUrlResolver (reg.exe across all relevant hives/policies, the DefaultConnectionSettings blob and the WPAD auto-detect flag). Afterwards the PAC file is downloaded and evaluated via GraalVM/JavaScript.

POWERSHELL_ROUTE_RESOLVER_LEGACY

@Deprecated
public static final ProxyMode POWERSHELL_ROUTE_RESOLVER_LEGACY

Deprecated. Use a PAC_URL_* mode (GraalVM PAC evaluation) instead.

Legacy mode: runs a PowerShell/.NET script that uses System.Net.WebRequest.GetSystemWebProxy() to determine the final route directly. No GraalVM, no own PAC evaluation. Kept only for diagnostics/backward compatibility and not offered in normal UIs.

WINDOWS_NATIVE_PROXY_SETTINGS

public static final ProxyMode WINDOWS_NATIVE_PROXY_SETTINGS

Reserved future Java 21 / FFM mode that will read proxy settings / AutoConfigURL / auto-detect through native Windows APIs and then use the Java/GraalVM PAC evaluation. Currently returns a NOT_IMPLEMENTED result — never DIRECT or a fallback.

WINDOWS_NATIVE_ROUTE_RESOLVER

public static final ProxyMode WINDOWS_NATIVE_ROUTE_RESOLVER

Reserved future Java 21 / FFM mode that will determine the final route for a concrete URL through WinHTTP / native Windows APIs (the native successor of POWERSHELL_ROUTE_RESOLVER_LEGACY). Currently returns a NOT_IMPLEMENTED result — never DIRECT or a fallback.

Method Detail

values

public static ProxyMode[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

for (ProxyMode c : ProxyMode.values())
    System.out.println(c);

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static ProxyMode valueOf(String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

IllegalArgumentException - if this enum type has no constant with the specified name

NullPointerException - if the argument is null