Package org.jenkins.plugins.lockableresources.remote

Class RemoteLockRouting

java.lang.Object

org.jenkins.plugins.lockableresources.remote.RemoteLockRouting

@Restricted(org.kohsuke.accmod.restrictions.NoExternalUse.class)
public final class RemoteLockRouting
extends Object

Client-side routing helpers for lock(): decides whether a step targets a remote server and to which RemoteConnection, and derives the human-readable target.

• Peer mode - lock(..., serverId: 'X') targets server X explicitly.
• Delegated mode - a configured forcedServerId routes every lock to that server (and overrides any DSL serverId, logging an INFO when they differ).

Method Summary

Modifier and Type	Method	Description
static String	displayTarget(LockStep step)	Human-readable lock target (resource name / label:X / step description) for logs and UI.
static String	effectiveServerId(LockStep step, LockableResourcesManager lrm, PrintStream logger)	Resolves the server to target: forcedServerId wins over the DSL serverId (delegated mode).
static RemoteConnection	findConnection(LockableResourcesManager lrm, String serverId)	Looks up the configured RemoteConnection for serverId, or fails the build.
static boolean	isRemoteRequest(LockStep step, LockableResourcesManager lrm)	A step is a remote request iff it names a serverId or a forcedServerId is configured.

Methods inherited from class java.lang.Object

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

Method Details

isRemoteRequest

public static boolean isRemoteRequest(LockStep step,
 LockableResourcesManager lrm)

A step is a remote request iff it names a serverId or a forcedServerId is configured.

effectiveServerId

public static String effectiveServerId(LockStep step,
 LockableResourcesManager lrm,
 PrintStream logger)

Resolves the server to target: forcedServerId wins over the DSL serverId (delegated mode).

findConnection

public static RemoteConnection findConnection(LockableResourcesManager lrm,
 String serverId)
                                       throws AbortException

Looks up the configured RemoteConnection for serverId, or fails the build.

Throws:

AbortException

displayTarget

public static String displayTarget(LockStep step)
                            throws AbortException

Human-readable lock target (resource name / label:X / step description) for logs and UI.

Throws:

AbortException