Injeção de dependência

O Sponge usa injeção de dependência para fornecer instâncias da API para os plugins. A injeção de dependência permite os plugins definirem alguns tipos da API para serem injetados após a construção.

Lista temporária dos tipos injetados

ConfigDir (anotação em um Path ou File): Usado para injetar o diretório de configuração do plugin: ./config/ OU ./config/<Plugin#id>/ dependendo da opção ConfigDir#sharedRoot()
ConfigurationLoader<CommentedConfigurationNode>: Precisa ser anotado com @DefaultConfig. Usado para injetar um ConfigurationLoader pré-elaborado para o File da mesma anotação.
DefaultConfig (anotação em um Path, ConfigurationLoader ou File): Usado para injetar o arquivo de configuração especifico para o plugin: <Plugin#id>.conf
EventManager: Gerencia o registro dos gerenciadores de evento e a chamada de eventos.
File (Arquivo): Precisa ser anotado com @DefaultConfig ou @ConfigDir. Dependendo da anotação informada isto irá conter a referencia para o arquivo de configuração padrão dos plugins ou o diretório usado para armazenar os arquivos de configuração. Porém, Path (veja abaixo) pode ser usado.
Game: O objeto Game é o núcleo de acesso da SpongeAPI.
GameRegistry: Fornece uma forma fácil de obter os tipos a partir do Game.
GuiceObjectMapperFactory: Uma ferramenta fornecida pelo Configurate para mapear facilmente os objetos para as “configuration nodes” (entradas de valores da configuração). Veja Serializing Objects para ter uma base de seu uso.
Injector (Injetor): com.google.inject.Injector é fornecido pelo Guice, este é o injetor usado para injetar as dependências do seu plugin. Você pode usar isto para criar um injetor filho com seus módulos para injetar suas classes com as dependências fornecidas pelo Sponge listadas nesta pagina, ou definir suas próprias classes
Logger (Agente de registros): Usado para identificar qual o plugin está enviando mensagens de registro.
Path: Precisa ser anotado com @DefaultConfig ou @ConfigDir. Dependendo da anotação informada isto irá conter a referencia para o arquivo de configuração padrão dos plugins ou o diretório usado para armazenar os arquivos de configuração.
PluginContainer: Um wrapper de uma classe de Plugin, usado para obter informações da anotação com fácil uso.
PluginManager: Gerencia os plugins carregados pela implementação. Pode obter o PluginContainer de outros plugins.

Exemplos de injeção

Estas são algumas referencias que são difíceis de obter - ou, em alguns casos, impossíveis - sem injeção. Elas não são absolutamente vitais para todos plugins, elas são usadas frequentemente.

Nota

Lembre-se esta é quase sempre a melhor forma de injetar objetos dentro da classe principal, já que são instanciadas com o injetor Guice quando o plugin é carregado.

Logger (Agente de registros)

Dica

Veja Logging and Debugging para um guia completo, especialmente para o Logger.

Game (Jogo)

O objeto Game é a abertura para várias funções internas da SpongeAPI, do EventManager ao Server e até mesmo o Scheduler síncrono/assíncrono.

Embora seja perfeitamente possível recuperar o objeto Game através de Sponge.getGame(), ele é comumente obtido através de uma injeção.

Exemplo - Variável

import com.google.inject.Inject;
import org.spongepowered.api.Game;

@Inject
private Game game;

Exemplo - Método

private Game game;

@Inject
private void setGame(Game game) {
    this.game = game;
}

Exemplo - Construtor

Para propósito deste tutorial, “Apple” é o nome da classe.

private Game game;

@Inject
public Apple(Game game) {
    this.game = game;
}

Diretório de configuração

A forma recomendada de obter seu arquivo de configuração é por meio do Guice, juntamente com a anotação :javadoc:`ConfigFile`.

Dica

Se você definir o parâmetro sharedRoot para true será o mesmo diretório que - potencialmente - guarda as configurações de outros plugins. Em muitos casos quando obter o ConfigDir for necessário, isto deve ser false.

Exemplo - Variável

import org.spongepowered.api.config.ConfigDir;

import java.nio.file.Path;

@Inject
@ConfigDir(sharedRoot = false)
private Path configDir;

Exemplo - Método

private Path configDir;

@Inject
@ConfigDir(sharedRoot = false)
private void setConfigDir(Path configDir) {
    this.configDir = configDir;
}

Exemplo - Construtor

Para propósito deste tutorial, “Orange” é o nome da classe.

private Path configDir;

@Inject
public Orange(@ConfigDir(sharedRoot = false) Path configDir) {
    this.configDir = configDir;
}

DefaultConfig (Configuração padrão)

O @DefaultConfig funciona de forma semelhante ao @ConfigDir. A grande diferença é obviamente que @DefaultConfig se refere a um arquivo especifico, enquanto @ConfigDir se refere a um diretório.

Dica

Veja Configuring Plugins para um guia completo, especialmente para @DefaultConfig.