com.aresstack.winproxy

Enum PacUrlSource

java.lang.Object

java.lang.Enum<PacUrlSource>

com.aresstack.winproxy.PacUrlSource

All Implemented Interfaces:

Serializable, Comparable<PacUrlSource>

public enum PacUrlSource
extends Enum<PacUrlSource>

Defines how the PAC (Proxy Auto-Config) URL is obtained.

The PAC file itself is always evaluated via GraalJS — this enum only controls how the URL to that PAC file is discovered.

 // User provides the PAC URL directly:
 ProxyResult r = WindowsProxyResolver.resolve(target, PacUrlSource.DIRECT,
                     "http://wpad.corp.local/wpad.dat");

 // PAC URL discovered from Windows Registry (all four hives):
 ProxyResult r = WindowsProxyResolver.resolve(target, PacUrlSource.REGISTRY, null);

 // PAC URL obtained by running a PowerShell command:
 ProxyResult r = WindowsProxyResolver.resolve(target, PacUrlSource.POWERSHELL,
                     WindowsProxyResolver.DEFAULT_PAC_DISCOVERY_SCRIPT);
 

See Also:

WindowsProxyResolver.resolve(String, PacUrlSource, String)

Enum Constant Summary

Enum Constants

Enum Constant and Description
DIRECT The PAC URL is provided directly by the caller.
POWERSHELL The PAC URL is obtained by running a PowerShell command.
REGISTRY The PAC URL is discovered from the Windows Registry.

Method Summary

Modifier and Type	Method and Description
static PacUrlSource	valueOf(String name) Returns the enum constant of this type with the specified name.
static PacUrlSource[]	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

DIRECT

public static final PacUrlSource DIRECT

The PAC URL is provided directly by the caller. The pacUrlOrScript parameter is the full HTTP URL to the PAC file.

REGISTRY

public static final PacUrlSource REGISTRY

The PAC URL is discovered from the Windows Registry. Searches all four registry hives (GPO first, then user, then machine) for AutoConfigURL. Falls back to static proxy settings and WPAD if no PAC URL is found.

The pacUrlOrScript parameter is ignored (may be null).

POWERSHELL

public static final PacUrlSource POWERSHELL

The PAC URL is obtained by running a PowerShell command. The pacUrlOrScript parameter contains the PowerShell command whose stdout output is the PAC URL.

If null or empty, the WindowsProxyResolver.DEFAULT_PAC_DISCOVERY_SCRIPT is used as fallback.

See Also:

WindowsProxyResolver.DEFAULT_PAC_DISCOVERY_SCRIPT

Method Detail

values

public static PacUrlSource[] 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 (PacUrlSource c : PacUrlSource.values())
    System.out.println(c);

Returns:

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

valueOf

public static PacUrlSource 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