A máquina de sucos de Johannes

As classes são um conceito central na programação orientada a objetos. No Crystal, tudo é um objeto, todo objeto tem um tipo e pode responder a alguns métodos. As classes são moldes para criar objetos, fornecendo valores iniciais para o estado, como variáveis, e implementações de comportamento, como métodos. Os objetos são instâncias de classe que guardam todas as variáveis de instância e estados.

Definição de classe

Uma classe é definida com a palavra-chave class, seguida do nome da classe escrito em UpperCamelCase.

class Account
end

Criar uma instância

Para criar uma instância de uma classe, chame o nome da classe usando o método new.

class Account
end

account = Account.new

No exemplo acima, a variável account é uma instância da classe Account.

Ao criar uma instância, um método especial chamado initialize funciona como construtor. Ele é chamado quando uma instância é criada. O construtor permite definir o estado inicial da instância. O método initialize pode receber argumentos, que são passados ao criar uma instância.

class Account
  def initialize(number)
    5 + number # => 9
  end
end

Account.new(4)

class Account
  def initialize(number)
    5 + number
  end
end

Account.new(4)
# => #<Account:0x7f5dc33dcea0>

Métodos de instância

Um método de instância é um método disponível para uma instância de uma classe e que pode ser chamado nessa instância. Os métodos de instância são definidos com a palavra-chave def, seguida do nome do método. Eles são definidos dentro da definição da classe.

class Account
  def balance
    100
  end
end

account = Account.new
account.balance # => 100

Variáveis de instância

Variáveis de instância são variáveis disponíveis em todos os métodos da instância. Para acessar uma variável de instância, você precisa definir um método de instância. Elas podem ser inicializadas no método initialize. São definidas com o prefixo @.

class Account
  def initialize
    @balance = 100
  end

  def balance
    @balance
  end
end

account = Account.new
account.balance
# => 100

Variáveis de instância também podem ser definidas dentro da definição da classe.

class Account
  @age = 0
end

Variáveis de instância com inicialização

Variáveis de instância podem ser inicializadas com um argumento passado ao método initialize. Como o Crystal não consegue inferir o tipo do argumento usado na inicialização, é preciso especificá-lo. Se você quiser ler mais sobre isso, pode ler: inferência de tipos. Para especificar o tipo da variável, você pode usar o símbolo :, seguido do tipo. Por exemplo, se você quiser criar uma variável de instância chamada balance do tipo Int32, você pode fazer assim: @balance : Int32. Ou, se você quiser criar uma variável de instância chamada raining do tipo Bool, você pode fazer assim: @raining : Bool.

Há algumas formas de fazer isso: declarar o argumento com o tipo no método initialize e depois atribuir o argumento à variável de instância, como no exemplo a seguir:

class Account
  def initialize(balance : Int32)
    @balance = balance
  end

  def balance
    @balance
  end
end

account = Account.new(1)
account_2 = Account.new(5)

account.balance
# => 1

account_2.balance
# => 5

Outra forma é declarar o tipo da variável de instância na definição da classe no formato @<variable> : <Type>, como no exemplo a seguir:

class Weather

  @raining : Bool

  def initialize(raining)
    @raining = raining
  end

  def raining
    @raining
  end
end

weather = Weather.new(true)
weather.raining
# => true

Modificar variáveis de instância

Os métodos podem modificar variáveis de instância. Esses métodos podem ser chamados na instância da classe. Quando um método modifica uma variável de instância, essa mudança só fica disponível na instância da classe em que você o chamou.

class Account
  def initialize(balance : Int32)
    @balance = balance
  end

  def withdraw(amount)
    @balance -= amount
  end

  def balance
    @balance
  end
end

account = Account.new(10)
account_2 = Account.new(10)
account.balance
# => 10

account_2.balance
# => 10

account.withdraw(5)
account.balance
# => 5

account_2.balance
# => 10

Métodos de classe

Métodos de classe são métodos definidos para uma classe, mas não para as suas instâncias. Eles oferecem uma forma de criar métodos que não dependem do estado da instância. São definidos com a palavra-chave def, seguida de self.<method name>. self é uma referência ao namespace a partir do qual self está sendo chamado. Neste caso, refere-se à classe, Account. Seria o mesmo que escrever Account., mas self. é a forma preferida.

class Account
  def self.balance
    100
  end
end

Account.balance
# => 100