Métodos Getters e Setters

Parte da seção Programação Orientada a Objetos do Journey de GO da Coddy. Lição 49 de 107.

Como os campos não exportados não podem ser acessados diretamente de fora de um pacote, você precisa fornecer métodos que permitam um acesso controlado. Eles são comumente chamados de getters e setters.

Em Go, a convenção para getters é simples: use o nome do campo com a primeira letra em maiúscula. Não adicione o prefixo "Get"; use apenas Balance(), e não GetBalance():

type BankAccount struct {
    balance int  // não exportado
}

// Getter - retorna o valor
func (b *BankAccount) Balance() int {
    return b.balance
}

// Setter - modifica o valor com validação
func (b *BankAccount) SetBalance(amount int) {
    if amount >= 0 {
        b.balance = amount
    }
}

O verdadeiro poder dos setters é adicionar validação ou lógica de negócio. Em vez de permitir que o código externo defina qualquer valor diretamente, você controla o que é permitido:

func (b *BankAccount) Deposit(amount int) bool {
    if amount <= 0 {
        return false
    }
    b.balance += amount
    return true
}

Este método Deposit atua como um setter especializado que impõe regras: não são permitidos depósitos negativos. O código externo deve passar pelos seus métodos, garantindo que a struct permaneça sempre em um estado válido. Isso é encapsulamento em ação: ocultar os dados enquanto expõe um comportamento controlado.

Desafio

Fácil

Vamos criar um conversor de temperatura que demonstra o encapsulamento adequado usando métodos getter e setter. Você criará uma struct que armazena internamente a temperatura em Celsius, mas fornece acesso controlado por meio de métodos com validação.

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

temperature.go: Crie uma struct Temperature com um campo celsius não exportado (float64). Implemente os seguintes métodos:
- Celsius() - um getter que retorna a temperatura atual em Celsius
- SetCelsius(value float64) - um setter que aceita apenas valores iguais ou superiores ao zero absoluto (-273.15). Se o valor estiver abaixo desse limite, a temperatura deverá permanecer inalterada.
- Fahrenheit() - retorna a temperatura convertida para Fahrenheit usando a fórmula: (celsius * 9/5) + 32
- SetFahrenheit(value float64) - converte a entrada de Fahrenheit para Celsius e a armazena, mas somente se o valor resultante em Celsius for igual ou superior a -273.15
Adicione também um construtor NewTemperature(celsius float64) *Temperature que cria uma temperatura inicializada com o valor fornecido (considere que a entrada do construtor é válida).
main.go: Leia os valores de temperatura da entrada e demonstre os métodos getter/setter. Crie uma temperatura, exiba seus valores em ambas as unidades, depois tente definir novos valores e mostre os resultados.

As seguintes entradas serão fornecidas:

Linha 1: Valor inicial em Celsius
Linha 2: Novo valor em Celsius a ser definido
Linha 3: Novo valor em Fahrenheit a ser definido

Formate todas as saídas de temperatura com duas casas decimais. Imprima a seguinte sequência:

Após a criação: C: [celsius] F: [fahrenheit]
Após definir Celsius: C: [celsius] F: [fahrenheit]
Após definir Fahrenheit: C: [celsius] F: [fahrenheit]

Por exemplo, considerando 25, -300 e 212, sua saída deverá ser:

C: 25.00 F: 77.00
C: 25.00 F: 77.00
C: 100.00 F: 212.00

Observe que a segunda linha mostra valores inalterados porque -300 está abaixo do zero absoluto, então o setter o rejeitou. A terceira linha mostra a temperatura após definir 212°F com sucesso (que é convertido para 100°C). Esse é o poder dos setters. Eles impõem regras que mantêm seus dados válidos.

Experimente você mesmo

package main

import (
	"fmt"
)

func main() {
	// Ler valores de entrada
	var initialCelsius float64
	var newCelsius float64
	var newFahrenheit float64
	fmt.Scanln(&initialCelsius)
	fmt.Scanln(&newCelsius)
	fmt.Scanln(&newFahrenheit)

	// TODO: Crie uma nova Temperature usando o construtor

	// TODO: Imprima os valores iniciais no formato "C: [celsius] F: [fahrenheit]" com 2 casas decimais

	// TODO: Tente definir o novo valor de Celsius e imprima o resultado

	// TODO: Tente definir o novo valor de Fahrenheit e imprima o resultado
}