BilletSalg.SharedLegacy 0.6.0

SharedLegacy

Helper utilities for integrating legacy BilletSalg code with V2 APIs.

Purpose

This library provides reusable utilities for legacy integration work, including:

• ErrorResponse Helpers - Standardized error response formatting for legacy API endpoints
• DataRow Helpers - Safe access to DataRow columns with null/DBNull handling
• Data Converters - Convert legacy data types to V2 contract types
• Legacy Integration Utilities - Common patterns for working with legacy stored procedures and DataTables

Usage

Error Response Handling

using BilletSalgV2.SharedLegacy.Helpers;

// In App_Code/Legacy/Controllers/
public IHttpActionResult GetById(int clientId, int id)
{
    var venue = _venueService.GetById(clientId, id);
    
    if (venue == null)
        return Content(HttpStatusCode.NotFound, ErrorResponse.NotFound("Venue", id));
    
    return Ok(venue);
}

public IHttpActionResult Create(int clientId, [FromBody] CreateVenueDto createDto)
{
    if (createDto == null)
        return Content(HttpStatusCode.BadRequest, ErrorResponse.BadRequest("Request body is required"));
    
    if (createDto.ClientId != clientId)
        return Content(HttpStatusCode.BadRequest, 
            ErrorResponse.BadRequest("Client ID mismatch", "IDs do not match"));
    
    var exists = _venueService.VenueExists(clientId, createDto.Name);
    if (exists)
        return Content(HttpStatusCode.Conflict, 
            ErrorResponse.Conflict("Venue", "Venue already exists"));
    
    var created = _venueService.Create(createDto);
    return Created(new Uri(Request.RequestUri, created.Id.ToString()), created);
}

ErrorResponse Methods:

• Created(resourceType, id) — 201 Created
• NotFound(resourceType, id) — 404 Not Found
• NotFound(detail) — 404 with custom message
• BadRequest(title, detail) — 400 Bad Request
• BadRequest(detail) — 400 with simple message
• Conflict(resourceType, detail) — 409 Conflict (resource exists)
• UnprocessableEntity(detail) — 422 Unprocessable Entity (semantic validation)
• Unauthorized(detail) — 401 Unauthorized
• Forbidden(detail) — 403 Forbidden
• ServerError(detail) — 500 Internal Server Error

See step-8-error-handling.md for detailed guide and examples.

Safe DataRow Access

// Safe DataRow access
var name = DataRowHelpers.SafeGetString(row, "Name");
var id = DataRowHelpers.SafeGetInt(row, "Id");
var clientId = DataRowHelpers.SafeGetGuid(row, "ClientId");
var isActive = DataRowHelpers.SafeGetBool(row, "ActiveStatus");

Target Framework

• netstandard2.0 - Compatible with .NET Framework 4.6.1+ and .NET Core 2.0+

Internal Use Only

This package is for internal use within BilletSalg projects only. Not intended for public distribution.