Package io.github.eggy03.ferrumx.windows.service.network

Class NetworkAdapterConfigurationService

java.lang.Object

io.github.eggy03.ferrumx.windows.service.network.NetworkAdapterConfigurationService

All Implemented Interfaces:

CommonServiceInterface<NetworkAdapterConfiguration>

public class NetworkAdapterConfigurationService
extends Object
implements CommonServiceInterface<NetworkAdapterConfiguration>

Service class for fetching network adapter configuration information from the system.

This class executes the CimQuery.NETWORK_ADAPTER_CONFIGURATION_QUERY PowerShell command and maps the resulting JSON into a list of NetworkAdapterConfiguration objects.

Thread safety

Methods of class are not thread safe.

Usage examples

 // Convenience API (creates its own short-lived session)
 NetworkAdapterConfigurationService configService = new NetworkAdapterConfigurationService();
 List<NetworkAdapterConfiguration> configs = configService.get();

 // API with re-usable session (caller manages session lifecycle)
 try (PowerShell session = PowerShell.openSession()) {
     NetworkAdapterConfigurationService configService = new NetworkAdapterConfigurationService();
     List<NetworkAdapterConfiguration> configs = configService.get(session);
 }
 

Since:

2.0.0

Author:

Egg-03

Constructor Summary

Constructors

Constructor	Description
NetworkAdapterConfigurationService()

Method Summary

Modifier and Type	Method	Description
@NotNull List<NetworkAdapterConfiguration>	get()	Retrieves a list of network adapter configurations present in the system.
@NotNull List<NetworkAdapterConfiguration>	get(com.profesorfalken.jpowershell.PowerShell powerShell)	Retrieves a list of network adapter configurations using the caller's PowerShell session.

Methods inherited from class java.lang.Object

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

Constructor Details

NetworkAdapterConfigurationService

public NetworkAdapterConfigurationService()

Method Details

get

@NotNull
public @NotNull List<NetworkAdapterConfiguration> get()

Retrieves a list of network adapter configurations present in the system.

Each invocation creates and uses a short-lived PowerShell session internally.

Specified by:

get in interface CommonServiceInterface<NetworkAdapterConfiguration>

Returns:

a list of NetworkAdapterConfiguration objects representing the system's network adapters. Returns an empty list if no configurations are detected.

get

@NotNull
public @NotNull List<NetworkAdapterConfiguration> get(com.profesorfalken.jpowershell.PowerShell powerShell)

Retrieves a list of network adapter configurations using the caller's PowerShell session.

Specified by:

get in interface CommonServiceInterface<NetworkAdapterConfiguration>

Parameters:

powerShell - an existing PowerShell session managed by the caller

Returns:

a list of NetworkAdapterConfiguration objects representing the system's network adapters. Returns an empty list if no configurations are detected.