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

Class ComputerSystemProductService

java.lang.Object

io.github.eggy03.ferrumx.windows.service.product.ComputerSystemProductService

All Implemented Interfaces:

OptionalCommonServiceInterface<ComputerSystemProduct>

public class ComputerSystemProductService
extends Object
implements OptionalCommonServiceInterface<ComputerSystemProduct>

Service class for fetching the system product information.

This class executes the CimQuery.COMPUTER_SYSTEM_PRODUCT PowerShell command and maps the resulting JSON into an Optional ComputerSystemProduct object.

Thread safety

Methods of class are not thread safe.

Usage examples

 // Convenience API (creates its own short-lived session)
 ComputerSystemProductService productService = new ComputerSystemProductService();
 Optional<ComputerSystemProduct> product = productService.get();

 // API with re-usable session (caller manages session lifecycle)
 try (PowerShell session = PowerShell.openSession()) {
     ComputerSystemProductService productService = new ComputerSystemProductService();
     Optional<ComputerSystemProduct> product = productService.get(session);
 }
 

Since:

2.0.0

Author:

Egg-03

Constructor Summary

Constructors

Constructor	Description
ComputerSystemProductService()

Method Summary

Modifier and Type	Method	Description
Optional<ComputerSystemProduct>	get()	Retrieves an Optional containing the computer system product information.
Optional<ComputerSystemProduct>	get(com.profesorfalken.jpowershell.PowerShell powerShell)	Retrieves an Optional containing the computer system product information 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

ComputerSystemProductService

public ComputerSystemProductService()

Method Details

get

public Optional<ComputerSystemProduct> get()

Retrieves an Optional containing the computer system product information.

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

Specified by:

get in interface OptionalCommonServiceInterface<ComputerSystemProduct>

Returns:

an Optional of ComputerSystemProduct representing the computer system as a product. Returns Optional.empty() if no product information is detected.

get

public Optional<ComputerSystemProduct> get(com.profesorfalken.jpowershell.PowerShell powerShell)

Retrieves an Optional containing the computer system product information using the caller's PowerShell session.

Specified by:

get in interface OptionalCommonServiceInterface<ComputerSystemProduct>

Parameters:

powerShell - an existing PowerShell session managed by the caller

Returns:

an Optional of ComputerSystemProduct representing the computer system as a product. Returns Optional.empty() if no product information is detected.