ProxyResult (win-proxy-java 0.1.0-beta.4 API)

java.lang.Object
- com.aresstack.winproxy.ProxyResult

```
public final class ProxyResult
extends Object
```
Immutable result of a proxy resolution.
A result is exactly one of four kinds:
- ProxyResult.Kind.PROXY — a concrete host:port proxy.
- ProxyResult.Kind.DIRECT — the selected mode genuinely yields DIRECT (e.g. ProxyMode.DISABLED or a PAC script returning DIRECT).
- ProxyResult.Kind.ERROR — the selected mode failed; getReason() carries the technical cause (e.g. pac-url-not-found, pac-download-failed, pac-evaluation-failed). This is not DIRECT.
- ProxyResult.Kind.NOT_IMPLEMENTED — the selected mode is reserved/not implemented.
Errors are never reported as DIRECT, so callers can distinguish "no proxy needed" from "resolution failed".

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

static class ProxyResult.Kind
The kind of a ProxyResult.

Nested Classes
Modifier and Type	Class and Description
`static class`	`ProxyResult.Kind` The kind of a `ProxyResult`.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`static ProxyResult`	`direct()` Creates a DIRECT result with a generic reason.
`static ProxyResult`	`direct(String reason)` Creates a DIRECT result (no proxy needed).
`static ProxyResult`	`error(String reason)` Creates an ERROR result carrying the technical cause.
`String`	`getHost()` Returns the proxy host, or `null` for non-PROXY results.
`ProxyResult.Kind`	`getKind()` Returns the `ProxyResult.Kind` of this result.
`int`	`getPort()` Returns the proxy port, or `0` for non-PROXY results.
`String`	`getReason()` Returns a machine-readable diagnostic reason for this result.
`boolean`	`isDirect()` Returns `true` only if the mode genuinely yields DIRECT (not on error).
`boolean`	`isError()` Returns `true` if resolution failed; see `getReason()`.
`boolean`	`isNotImplemented()` Returns `true` if the selected mode is reserved/not implemented.
`boolean`	`isProxy()` Returns `true` for a concrete `host:port` proxy.
`static ProxyResult`	`notImplemented(String reason)` Creates a NOT_IMPLEMENTED result.
`static ProxyResult`	`of(String host, int port)` Creates a PROXY result with a generic reason.
`static ProxyResult`	`proxy(String host, int port, String reason)` Creates a PROXY result.
`Proxy`	`toJavaProxy()` Converts to `Proxy`, honouring the `ProxyResult.Kind`: `ProxyResult.Kind.PROXY` → an HTTP `Proxy` for `host:port`, `ProxyResult.Kind.DIRECT` → `Proxy.NO_PROXY`, `ProxyResult.Kind.ERROR` / `ProxyResult.Kind.NOT_IMPLEMENTED` → `IllegalStateException`. Errors and not-implemented results deliberately throw instead of silently degrading to `Proxy.NO_PROXY`, so a failed resolution can never be mistaken for a genuine DIRECT route.
`Proxy`	`toJavaProxyOrNoProxy()` Best-effort variant of `toJavaProxy()` that never throws: `ProxyResult.Kind.PROXY` → an HTTP `Proxy` for `host:port`, `ProxyResult.Kind.DIRECT`, `ProxyResult.Kind.ERROR`, `ProxyResult.Kind.NOT_IMPLEMENTED` → `Proxy.NO_PROXY`. Only use this when the caller has explicitly decided that a failed or not-implemented resolution should fall back to a direct connection.
`String`	`toString()`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Method Detail
  - direct
```
public static ProxyResult direct(String reason)
```
    Creates a DIRECT result (no proxy needed).
  - direct
```
public static ProxyResult direct()
```
    Creates a DIRECT result with a generic reason.
  - proxy
```
public static ProxyResult proxy(String host,
                                int port,
                                String reason)
```
    Creates a PROXY result.
  - of
```
public static ProxyResult of(String host,
                             int port)
```
    Creates a PROXY result with a generic reason.
  - error
```
public static ProxyResult error(String reason)
```
    Creates an ERROR result carrying the technical cause. Never DIRECT.
  - notImplemented
```
public static ProxyResult notImplemented(String reason)
```
    Creates a NOT_IMPLEMENTED result. Never DIRECT, never a fallback.
  - getKind
```
public ProxyResult.Kind getKind()
```
    Returns the ProxyResult.Kind of this result.
  - isProxy
```
public boolean isProxy()
```
    Returns true for a concrete host:port proxy.
  - isDirect
```
public boolean isDirect()
```
    Returns true only if the mode genuinely yields DIRECT (not on error).
  - isError
```
public boolean isError()
```
    Returns true if resolution failed; see getReason().
  - isNotImplemented
```
public boolean isNotImplemented()
```
    Returns true if the selected mode is reserved/not implemented.
  - getHost
```
public String getHost()
```
    Returns the proxy host, or null for non-PROXY results.
  - getPort
```
public int getPort()
```
    Returns the proxy port, or 0 for non-PROXY results.
  - getReason
```
public String getReason()
```
    Returns a machine-readable diagnostic reason for this result.
  - toJavaProxy
```
public Proxy toJavaProxy()
```
    Converts to Proxy, honouring the ProxyResult.Kind:
    - ProxyResult.Kind.PROXY → an HTTP Proxy for host:port,
    - ProxyResult.Kind.DIRECT → Proxy.NO_PROXY,
    - ProxyResult.Kind.ERROR / ProxyResult.Kind.NOT_IMPLEMENTED → IllegalStateException.
    Errors and not-implemented results deliberately throw instead of silently degrading to Proxy.NO_PROXY, so a failed resolution can never be mistaken for a genuine DIRECT route. Callers that explicitly want a best-effort NO_PROXY for those kinds must use toJavaProxyOrNoProxy().
    Throws:
    
    IllegalStateException - if this result is an ProxyResult.Kind.ERROR or ProxyResult.Kind.NOT_IMPLEMENTED.
  - toJavaProxyOrNoProxy
```
public Proxy toJavaProxyOrNoProxy()
```
    Best-effort variant of toJavaProxy() that never throws:
    - ProxyResult.Kind.PROXY → an HTTP Proxy for host:port,
    - ProxyResult.Kind.DIRECT, ProxyResult.Kind.ERROR, ProxyResult.Kind.NOT_IMPLEMENTED → Proxy.NO_PROXY.
    Only use this when the caller has explicitly decided that a failed or not-implemented resolution should fall back to a direct connection. Diagnostics must keep using the original ProxyResult (and toJavaProxy()), so an ProxyResult.Kind.ERROR is never masked as a successful DIRECT.
  - toString
```
public String toString()
```
    Overrides:
    
    toString in class Object

Class ProxyResult

Nested Class Summary

Method Summary

Methods inherited from class java.lang.Object

Method Detail

direct

direct

proxy

of

error

notImplemented

getKind

isProxy

isDirect

isError

isNotImplemented

getHost

getPort

getReason

toJavaProxy

toJavaProxyOrNoProxy

toString