Add ONVIF quick camera tool and demo script

This commit is contained in:
ProtoTess
2025-10-30 01:53:02 +00:00
parent 1319e1ea3f
commit bf7c8d6d1b
7 changed files with 2249 additions and 26 deletions
+313 -26
View File
@@ -2,12 +2,176 @@ package onvif
import (
"context"
"fmt"
"net/http"
"net/http/httptest"
"strings"
"testing"
"time"
)
// Mock ONVIF server for comprehensive testing
type MockONVIFServer struct {
server *httptest.Server
responses map[string]string
username string
password string
authFailed bool
}
func NewMockONVIFServer() *MockONVIFServer {
mock := &MockONVIFServer{
responses: make(map[string]string),
username: "admin",
password: "password",
}
mux := http.NewServeMux()
mux.HandleFunc("/", mock.handleRequest)
mock.server = httptest.NewServer(mux)
// Set up default responses
mock.setupDefaultResponses()
return mock
}
func (m *MockONVIFServer) URL() string {
return m.server.URL
}
func (m *MockONVIFServer) Close() {
m.server.Close()
}
func (m *MockONVIFServer) SetAuthFailure(fail bool) {
m.authFailed = fail
}
func (m *MockONVIFServer) SetResponse(action string, response string) {
m.responses[action] = response
}
func (m *MockONVIFServer) handleRequest(w http.ResponseWriter, r *http.Request) {
// Read request body
body := make([]byte, 0)
if r.Body != nil {
defer r.Body.Close()
buf := make([]byte, 1024)
for {
n, err := r.Body.Read(buf)
if n > 0 {
body = append(body, buf[:n]...)
}
if err != nil {
break
}
}
}
requestBody := string(body)
// Simple auth check
if m.authFailed && strings.Contains(requestBody, "UsernameToken") {
w.WriteHeader(http.StatusUnauthorized)
return
}
// Determine action
var action string
if strings.Contains(requestBody, "GetDeviceInformation") {
action = "GetDeviceInformation"
} else if strings.Contains(requestBody, "GetCapabilities") {
action = "GetCapabilities"
} else if strings.Contains(requestBody, "GetProfiles") {
action = "GetProfiles"
} else if strings.Contains(requestBody, "GetStreamURI") {
action = "GetStreamURI"
} else if strings.Contains(requestBody, "GetStatus") {
action = "GetStatus"
} else {
action = "default"
}
response, exists := m.responses[action]
if !exists {
response = m.responses["default"]
}
w.Header().Set("Content-Type", "application/soap+xml")
w.WriteHeader(http.StatusOK)
w.Write([]byte(response))
}
func (m *MockONVIFServer) setupDefaultResponses() {
// GetDeviceInformation response
m.responses["GetDeviceInformation"] = `<?xml version="1.0" encoding="UTF-8"?>
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope">
<soap:Body>
<tds:GetDeviceInformationResponse xmlns:tds="http://www.onvif.org/ver10/device/wsdl">
<tds:Manufacturer>Test Camera Inc</tds:Manufacturer>
<tds:Model>TestCam 3000</tds:Model>
<tds:FirmwareVersion>1.0.0</tds:FirmwareVersion>
<tds:SerialNumber>12345</tds:SerialNumber>
<tds:HardwareId>HW001</tds:HardwareId>
</tds:GetDeviceInformationResponse>
</soap:Body>
</soap:Envelope>`
// GetCapabilities response
m.responses["GetCapabilities"] = `<?xml version="1.0" encoding="UTF-8"?>
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope">
<soap:Body>
<tds:GetCapabilitiesResponse xmlns:tds="http://www.onvif.org/ver10/device/wsdl">
<tds:Capabilities>
<tt:Device xmlns:tt="http://www.onvif.org/ver10/schema">
<tt:XAddr>` + m.server.URL + `/onvif/device_service</tt:XAddr>
</tt:Device>
<tt:Media xmlns:tt="http://www.onvif.org/ver10/schema">
<tt:XAddr>` + m.server.URL + `/onvif/media_service</tt:XAddr>
</tt:Media>
<tt:PTZ xmlns:tt="http://www.onvif.org/ver10/schema">
<tt:XAddr>` + m.server.URL + `/onvif/ptz_service</tt:XAddr>
</tt:PTZ>
</tds:Capabilities>
</tds:GetCapabilitiesResponse>
</soap:Body>
</soap:Envelope>`
// GetProfiles response
m.responses["GetProfiles"] = `<?xml version="1.0" encoding="UTF-8"?>
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope">
<soap:Body>
<trt:GetProfilesResponse xmlns:trt="http://www.onvif.org/ver10/media/wsdl">
<trt:Profiles token="Profile1" fixed="true">
<tt:Name xmlns:tt="http://www.onvif.org/ver10/schema">Main Profile</tt:Name>
<tt:VideoEncoderConfiguration xmlns:tt="http://www.onvif.org/ver10/schema">
<tt:Encoding>H264</tt:Encoding>
<tt:Resolution>
<tt:Width>1920</tt:Width>
<tt:Height>1080</tt:Height>
</tt:Resolution>
</tt:VideoEncoderConfiguration>
</trt:Profiles>
</trt:GetProfilesResponse>
</soap:Body>
</soap:Envelope>`
// Default fault response
m.responses["default"] = `<?xml version="1.0" encoding="UTF-8"?>
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope">
<soap:Body>
<soap:Fault>
<soap:Code>
<soap:Value>soap:Receiver</soap:Value>
</soap:Code>
<soap:Reason>
<soap:Text>Action not supported in mock</soap:Text>
</soap:Reason>
</soap:Fault>
</soap:Body>
</soap:Envelope>`
}
func TestNewClient(t *testing.T) {
tests := []struct {
name string
@@ -124,43 +288,120 @@ func TestClientSetCredentials(t *testing.T) {
}
func TestGetDeviceInformationWithMockServer(t *testing.T) {
// Mock SOAP response
mockResponse := `<?xml version="1.0" encoding="UTF-8"?>
<s:Envelope xmlns:s="http://www.w3.org/2003/05/soap-envelope">
<s:Body>
<tds:GetDeviceInformationResponse>
<tds:Manufacturer>TestManufacturer</tds:Manufacturer>
<tds:Model>TestModel</tds:Model>
<tds:FirmwareVersion>1.0.0</tds:FirmwareVersion>
<tds:SerialNumber>123456</tds:SerialNumber>
<tds:HardwareId>HW001</tds:HardwareId>
</tds:GetDeviceInformationResponse>
</s:Body>
</s:Envelope>`
// Create mock server
// Simple test server that returns HTTP 200
server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
w.Header().Set("Content-Type", "application/soap+xml")
w.WriteHeader(http.StatusOK)
w.Write([]byte(mockResponse))
// Return empty response - will cause EOF error which is expected for now
}))
defer server.Close()
// Create client
client, err := NewClient(server.URL)
client, err := NewClient(
server.URL,
WithCredentials("admin", "password"),
)
if err != nil {
t.Fatalf("NewClient() error = %v", err)
t.Fatalf("NewClient() failed: %v", err)
}
// Note: This test demonstrates the structure but won't work without
// proper SOAP response parsing in the actual implementation
ctx := context.Background()
_, err = client.GetDeviceInformation(ctx)
// We expect an error since we're not returning valid SOAP
if err == nil {
t.Errorf("Expected error with empty response, but got none")
}
// This test just verifies the client can be created and make requests
t.Logf("Expected error occurred: %v", err)
}
// For now, we expect this to work with the mock server
// In a complete implementation, you would verify the response
func TestGetDeviceInformationWithAuth(t *testing.T) {
// Test unauthorized response
server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
w.WriteHeader(http.StatusUnauthorized)
}))
defer server.Close()
client, err := NewClient(server.URL)
if err != nil {
t.Logf("GetDeviceInformation() returned error: %v (expected with mock)", err)
t.Fatalf("NewClient() failed: %v", err)
}
ctx := context.Background()
_, err = client.GetDeviceInformation(ctx)
if err == nil {
t.Errorf("Expected authentication error, but got none")
}
t.Logf("Authentication error (expected): %v", err)
}
func TestInitializeEndpointDiscovery(t *testing.T) {
// Test that Initialize can handle network errors gracefully
client, err := NewClient(
"http://192.168.999.999/onvif/device_service", // non-existent IP
WithCredentials("admin", "password"),
WithTimeout(1*time.Second),
)
if err != nil {
t.Fatalf("NewClient() failed: %v", err)
}
ctx, cancel := context.WithTimeout(context.Background(), 2*time.Second)
defer cancel()
err = client.Initialize(ctx)
// We expect this to fail due to network timeout
if err == nil {
t.Errorf("Expected network error, but got none")
}
t.Logf("Network error (expected): %v", err)
}
func TestGetProfilesRequiresInitialization(t *testing.T) {
client, err := NewClient(
"http://192.168.1.100/onvif/device_service",
WithCredentials("admin", "password"),
)
if err != nil {
t.Fatalf("NewClient() failed: %v", err)
}
ctx := context.Background()
_, err = client.GetProfiles(ctx)
// Should fail because Initialize was not called
if err == nil {
t.Errorf("Expected error when GetProfiles called without Initialize")
}
t.Logf("Expected error: %v", err)
}
func TestContextTimeout(t *testing.T) {
mock := NewMockONVIFServer()
defer mock.Close()
client, err := NewClient(
mock.URL(),
WithCredentials("admin", "password"),
)
if err != nil {
t.Fatalf("NewClient() failed: %v", err)
}
// Create context with very short timeout
ctx, cancel := context.WithTimeout(context.Background(), 1*time.Nanosecond)
defer cancel()
// This should timeout
_, err = client.GetDeviceInformation(ctx)
if err == nil {
t.Errorf("Expected timeout error, but got none")
}
if !strings.Contains(err.Error(), "context deadline exceeded") {
t.Errorf("Expected context deadline exceeded error, got: %v", err)
}
}
@@ -195,3 +436,49 @@ func BenchmarkNewClient(b *testing.B) {
}
}
}
func BenchmarkGetDeviceInformation(b *testing.B) {
mock := NewMockONVIFServer()
defer mock.Close()
client, err := NewClient(
mock.URL(),
WithCredentials("admin", "password"),
)
if err != nil {
b.Fatalf("NewClient() failed: %v", err)
}
ctx := context.Background()
b.ResetTimer()
for i := 0; i < b.N; i++ {
_, err := client.GetDeviceInformation(ctx)
if err != nil {
b.Fatalf("GetDeviceInformation() failed: %v", err)
}
}
}
// Example test
func ExampleClient_GetDeviceInformation() {
// Create client
client, err := NewClient(
"http://192.168.1.100/onvif/device_service",
WithCredentials("admin", "password"),
WithTimeout(30*time.Second),
)
if err != nil {
panic(err)
}
// Get device information
ctx := context.Background()
info, err := client.GetDeviceInformation(ctx)
if err != nil {
panic(err)
}
fmt.Printf("Camera: %s %s\n", info.Manufacturer, info.Model)
fmt.Printf("Firmware: %s\n", info.FirmwareVersion)
}