InvocaçãoLocal
public class InvocationLocal
extends Object
java.lang.Object | |
↳ | com.android.tradefed.invoker.logger.InvocationLocal<T> |
Esta classe fornece variáveis de escopo de invocação.
O mecanismo funciona de forma semelhante ao ThreadLocal
. Essas variáveis diferem de suas contrapartes normais porque o código em uma invocação que acessa uma delas (por meio de seu método get
) possui sua própria cópia da variável inicializada de forma independente. As instâncias InvocationLocal
são normalmente campos estáticos privados em classes que desejam associar o estado a uma invocação.
Cada invocação está associada a uma cópia de uma variável com escopo de invocação, desde que a invocação esteja em andamento e a instância InvocationLocal
esteja acessível. Após a conclusão de uma invocação, todas as suas cópias de instâncias locais de invocação estarão sujeitas à coleta de lixo (a menos que existam outras referências a essas cópias).
Observe que, diferentemente das instâncias ThreadLocal
que não são mais referenciadas enquanto a invocação ainda está em andamento, não são coletadas como lixo. Portanto, a criação de instâncias locais ou não estáticas não é recomendada, pois elas podem crescer sem limites.
Aviso: Use esta classe com moderação, pois os locais de invocação são variáveis globais glorificadas com muitas das mesmas armadilhas.
Resumo
Construtores públicos | |
---|---|
InvocationLocal () |
Métodos públicos | |
---|---|
final T | get () Retorna a cópia da invocação atualmente em execução desta variável local de invocação. |
Métodos protegidos | |
---|---|
T | initialValue () Retorna o "valor inicial" da invocação atual para esta variável local de invocação. |
Construtores públicos
InvocaçãoLocal
public InvocationLocal ()
Métodos públicos
pegar
public final T get ()
Retorna a cópia da invocação atualmente em execução desta variável local de invocação. Se a variável não tiver valor para a invocação atual, ela será inicializada primeiro com o valor retornado por uma chamada ao método initialValue()
.
Devoluções | |
---|---|
T | a cópia da invocação atualmente em execução deste local de invocação. |
Métodos protegidos
valor inicial
protected T initialValue ()
Retorna o "valor inicial" da invocação atual para esta variável local de invocação. Este método será invocado na primeira vez que o código em execução no contexto da invocação acessar a variável com o método get()
. É garantido que este método seja invocado no máximo uma vez por invocação.
Esta implementação simplesmente retorna null
, mas pode ser alterada subclassificando InvocationLocal
e substituindo este método.
Devoluções | |
---|---|
T | o valor inicial para esta variável com escopo de invocação |