Implementação de Ocultação de Dados

Parte da seção Programação Orientada a Objetos do Journey de C# da Coddy. Lição 33 de 70.

A ocultação de dados vai além de apenas usar campos private. Trata-se de projetar sua classe de modo que os detalhes de implementação interna sejam completamente invisíveis para o código externo, expondo apenas o que é necessário por meio de uma interface pública limpa.

Considere uma classe que rastreia a senha de um usuário. Você não quer que ninguém acesse a senha bruta - nem mesmo para lê-la:

public class UserAccount
{
    private string passwordHash;
    
    public void SetPassword(string password)
    {
        passwordHash = HashPassword(password);
    }
    
    public bool VerifyPassword(string password)
    {
        return HashPassword(password) == passwordHash;
    }
    
    private string HashPassword(string password)
    {
        return password.GetHashCode().ToString();
    }
}

Observe que não há como recuperar a senha ou mesmo o hash. O código externo só pode definir uma senha ou verificar uma - o mecanismo de armazenamento interno está completamente oculto. O método HashPassword também é privado porque é um detalhe de implementação que pode mudar sem afetar como a classe é usada.

Essa abordagem protege sua classe contra o uso indevido e oferece a liberdade de alterar os componentes internos posteriormente. Se você decidir usar um algoritmo de hashing diferente, nenhum código externo será quebrado, pois nada dependia de como a senha era armazenada.

Desafio

Fácil

Vamos criar um sistema de carteira segura que demonstra o verdadeiro ocultamento de dados. Você criará uma carteira digital cujo saldo é completamente protegido contra acesso direto — o código externo só pode depositar, sacar e verificar se as transações são possíveis, mas nunca visualizar ou manipular o saldo real diretamente.

Você organizará seu código em dois arquivos:

Wallet.cs: crie uma classe Wallet no namespace Finance que mantenha seu saldo completamente oculto. A carteira deve ter:
- Um campo privado para armazenar o saldo (decimal)
- Um método privado FormatBalance() que retorna o saldo formatado como uma string de moeda, como "$123.45" — este é um auxiliar interno que não deve ser exposto
- Um método público Deposit(decimal amount) que adiciona ao saldo somente se o valor for positivo, retornando true em caso de sucesso e false caso contrário
- Um método público Withdraw(decimal amount) que subtrai do saldo somente se o valor for positivo e não exceder o saldo atual, retornando true em caso de sucesso e false caso contrário
- Um método público CanAfford(decimal amount) que retorna true se o saldo for maior ou igual ao valor, e false caso contrário
- Um método público GetStatement() que usa internamente o método privado FormatBalance() e retorna "Current balance: {formatted balance}"
Observe que não há como ler ou definir diretamente o saldo — você só pode interagir com ele por meio de métodos controlados!
Program.cs: no seu arquivo principal, crie uma Wallet e execute uma série de transações usando valores de entrada. Mostre como a carteira protege seu estado interno e ainda oferece funcionalidades úteis por meio de sua interface pública.

Você receberá três entradas:

Valor do depósito inicial (decimal)
Valor do saque a ser tentado (decimal)
Valor para verificar se pode ser pago (decimal)

Imprima a saída neste formato:

Deposit {amount}: {True/False}
{GetStatement() result}
Withdraw {amount}: {True/False}
{GetStatement() result}
Can afford {amount}: {True/False}

Por exemplo, se as entradas forem 100.50, 30.25 e 80.00, a saída deverá ser:

Deposit 100.50: True
Current balance: $100.50
Withdraw 30.25: True
Current balance: $70.25
Can afford 80.00: False

A principal ideia aqui é que o código externo nunca acessa diretamente o campo de saldo. Até mesmo a string de saldo formatado é obtida por meio de um método público que usa internamente um auxiliar privado. Isso é ocultamento de dados — os detalhes da implementação ficam completamente invisíveis, e você pode alterar livremente a forma como o saldo é armazenado ou formatado sem quebrar nenhum código que use sua carteira!

Experimente você mesmo

using System;
using Finance;

class Program
{
    public static void Main(string[] args)
    {
        // Lê os valores de entrada
        decimal depositAmount = Convert.ToDecimal(Console.ReadLine());
        decimal withdrawAmount = Convert.ToDecimal(Console.ReadLine());
        decimal checkAmount = Convert.ToDecimal(Console.ReadLine());

        // TODO: Criar uma instância de Wallet
        
        // TODO: Realizar o depósito e imprimir o resultado no formato: "Deposit {amount}: {True/False}"
        
        // TODO: Imprimir o extrato usando GetStatement()
        
        // TODO: Realizar o saque e imprimir o resultado no formato: "Withdraw {amount}: {True/False}"
        
        // TODO: Imprimir o extrato usando GetStatement()
        
        // TODO: Verificar a acessibilidade financeira e imprimir o resultado no formato: "Can afford {amount}: {True/False}"
    }
}