Public/Get-BridgeStatus.ps1
|
<# .SYNOPSIS Ανακτά την τρέχουσα κατάσταση γεφυρών από διαδικτυακή σελίδα. .DESCRIPTION Η Get-BridgeStatus ανακτά HTML, αναλύει την κατάσταση και επιστρέφει λίστα καταστάσεων γεφυρών χρησιμοποιώντας τα utility functions New-BridgeResult και Test-BridgeResult για καλύτερο error handling και DRY compliance. .PARAMETER OutputFile (Προαιρετικό) Το αρχείο όπου θα αποθηκευτεί η τρέχουσα κατάσταση. .PARAMETER Configuration (Προαιρετικό) Αντικείμενο διαμόρφωσης. Αν δεν παρέχεται, δημιουργείται αυτόματα. .OUTPUTS [PSCustomObject] - Αντικείμενο αποτελέσματος με Success, Data, ErrorMessage, ErrorCode και Timestamp. .EXAMPLE Get-BridgeStatus -OutputFile 'C:\Logs\current-status.json' .EXAMPLE $result = Get-BridgeStatus if (Test-BridgeResult $result) { Write-Host "Success: $($result.Data.Count) bridges found" } else { Write-Warning "Error: $($result.ErrorMessage)" } .NOTES Χρησιμοποιεί pipeline approach με New-BridgeResult/Test-BridgeResult για καλύτερο error handling. #> function Get-BridgeStatus { [CmdletBinding()] [OutputType([PSCustomObject])] param( [Parameter()] [ValidateNotNullOrEmpty()] [string]$OutputFile, [Parameter(Mandatory)] [ValidateNotNull()] [PSCustomObject]$Configuration ) process { # Stage 1: Data Acquisition - Get HTML content $Uri = $Configuration.Urls.Source Write-BridgeLog -Configuration $Configuration -Stage $Configuration.LoggingConfig.InfoStage -Message "🌐 Λήψη περιεχομένου από: $Uri" $maxRetries = 3 $response = $null for ($i = 1; $i -le $maxRetries; $i++) { try { $response = Invoke-WebRequest -Uri $Uri -TimeoutSec $Configuration.Defaults.HttpRequestTimeout -UseBasicParsing -ErrorAction 'Stop' break } catch { if ($i -eq $maxRetries) { Write-BridgeLog -Configuration $Configuration -Stage $Configuration.LoggingConfig.ErrorStage -Message "❌ Σφάλμα κατά την ανάκτηση: $($_.Exception.Message)" -Level $Configuration.LoggingConfig.WarningLevel $PSCmdlet.ThrowTerminatingError([System.Management.Automation.ErrorRecord]::new( [System.Exception]::new($_.Exception.Message, $_.Exception), 'HTTP_ERROR', [System.Management.Automation.ErrorCategory]::ConnectionError, $null )) } $baseSleep = [Math]::Pow(2, $i) $jitter = Get-Random -Minimum 0 -Maximum 3 Start-Sleep -Seconds ($baseSleep + $jitter) } } $htmlData = $response.Content # Stage 2: Data Processing - Convert HTML to bridge status Write-BridgeLog -Configuration $Configuration -Stage $Configuration.LoggingConfig.InfoStage -Message '🔍 Ανάλυση HTML για εύρεση καταστάσεων γέφυρας' try { $bridgeStatuses = Get-BridgeStatusFromHtml -Configuration $Configuration -Html $htmlData -Timestamp (Get-Date -Format o) if (-not $bridgeStatuses -or $bridgeStatuses.Count -eq 0) { Write-BridgeLog -Configuration $Configuration -Stage $Configuration.LoggingConfig.ErrorStage -Message '⛔ Δεν βρέθηκαν γέφυρες στο HTML περιεχόμενο' -Level $Configuration.LoggingConfig.WarningLevel throw [System.Exception]::new('Δεν βρέθηκαν γέφυρες στο HTML περιεχόμενο') } Write-BridgeLog -Configuration $Configuration -Stage $Configuration.LoggingConfig.InfoStage -Message "✅ Βρέθηκαν $($bridgeStatuses.Count) γέφυρες" } catch { Write-BridgeLog -Configuration $Configuration -Stage $Configuration.LoggingConfig.ErrorStage -Message "❌ Σφάλμα κατά την ανάλυση HTML: $($_.Exception.Message)" -Level $Configuration.LoggingConfig.WarningLevel $PSCmdlet.ThrowTerminatingError([System.Management.Automation.ErrorRecord]::new( [System.Exception]::new($_.Exception.Message, $_.Exception), 'PARSING_ERROR', [System.Management.Automation.ErrorCategory]::ParserError, $null )) } # Stage 3: Data Persistence (optional) if ($OutputFile) { $exportResult = Export-BridgeStatusJson -Configuration $Configuration -Data $bridgeStatuses -Path $OutputFile if (-not $exportResult.Success) { $PSCmdlet.ThrowTerminatingError([System.Management.Automation.ErrorRecord]::new( [System.Exception]::new($exportResult.ErrorMessage), $exportResult.ErrorCode, [System.Management.Automation.ErrorCategory]::WriteError, $OutputFile )) } } # Return the actual data for backward compatibility $bridgeStatuses } } |