Por favor, lembre-se que esta tradução da especificação é resultado de um projeto da comunidade java.net( https://jdk5-api-pt-br.dev.java.net/). A versão oficial da especificação é a versão na língua inglesa que pode ser encontrada em http://java.sun.com/j2se/1.5.0/docs/api/. Em caso de divergências, a versão predominante da especificação é a original em inglês.

Please note that this translation of the specification is the result of a java.net community project ( https://jdk5-api-pt-br.dev.java.net/ ). The official version of the specification is the US English language version which can be found at http://java.sun.com/j2se/1.5.0/docs/api/. In case of disputes, the authoritative version of the specification is the original, English document.


JavaTM 2 Platform
Standard Ed. 5.0

Package java.awt.im.spi

Fornece interfaces que permitem o desenvolvimento dos métodos de entrada que podem ser usados com qualquer ambiente do runtime de Java.

See:
          Description

Interface Summary
InputMethod Defines the interface for an input method that supports complex text input.
InputMethodContext Provê métodos que possar ser usados pelos métodos de entrada para comunicar-se com seus componentes clientes ou para requisitar outros serviços.
InputMethodDescriptor Define métodos que provêm informação suficiente sobre um método de entrada para habilitar a seleção e o carregamento do mesmo.
 

Package java.awt.im.spi Description

Fornece interfaces que permitem o desenvolvimento dos métodos de entrada que podem ser usados com qualquer ambiente do runtime de Java. Os métodos de entrada são os componentes de software que deixam o usuário inserir texto de maneiras diferentes do que simplesmente digitando. São usados geralmente para inserir caracteres em japonês, chinês ou coreano - línguas que usam milhares de caráteres diferentes - em teclados com poucas teclas. Entretanto, este pacote permite também o desenvolvimento de métodos de entrada para outras línguas e o uso de mecanismos inteiramente diferentes da entrada, tais como o reconhecimento de escrita manual.

Especificação do pacote

Enpacotando os métodos de entrada

Métodos de entrada são enpacotados como extensões instaladas, como especificado pelos Mecanismos de extensões. O arquivo JAR principal de um método de entrada deve conter o arquivo:

    META-INF/services/java.awt.im.spi.InputMethodDescriptor

O arquivo deve conter uma lista com os nomes das classes, uma por linha, que implementam a interface java.awt.im.spi.InputMethodDescriptor. Caracteres como espaços, tabulações, assim como linhas em branco serão ignorados. O caractere para comentários é '#' (\u0023); a cada linha iniciada com o caractere de comentário, todos os demais caracteres serão ignorados. O arquivo deve ser codificado em UTF-8.

Por exemplo, o nome da classe que implementar java.awt.im.spi.InputMethodDesciptor para o método de entrada Foo for com.sun.ime.FooInputMethodDescriptor, o arquivo META-INF/services/java.awt.im.spi.InputMethodDescriptor deverá conter a linha:

    com.sun.ime.FooInputMethodDescriptor

O método de entrada também fornece, ao menos, duas classes: uma classe implementando a interface java.awt.im.spi.InputMethodDescriptor e a outra implementando java.awt.im.spi.InputMethod. O método de entrada deve serparar a implementação dessas interfaces, assim o carregamento da classe que implementa InputMethod pode ser adiado até que seja necessário utilizá-la.

Carregamento dos métodos de entrada

O framework do método de entrada adiará o carregamento das classes até que sejam absolutamente necessárias. É carregado somente a implementação de InputMethodDescriptor durante a inicialização do AWT. E a implementação de InputMethod é carregada quando o método de entrada é selecionado.

Métodos de entrada Java e visualização de componentes de texto

O framework de métodos de entrada Java pretende oferecer suporte a todas as combinações de métodos de entrada e componentes. Entretanto, por causa das limitações das plataformas de base, pode não ser possível habilitar a comunicação entre os métodos de entrada Java e os componentes de visualização do AWT. Suporte para este tipo específico de combinação é então dependente de plataforma. No ambiente de execução da Sun para o Java 2, essa combinação é suportada no Windows, mas não no Solaris.

Documentação relacionada

Para visões gerais, tutoriais, exemplos, guias e documentação de ferramentas, por favor, veja:

Since:
JDK1.3

JavaTM 2 Platform
Standard Ed. 5.0

Submit a bug or feature
For further API reference and developer documentation, see Java 2 SDK SE Developer Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.

Copyright 2006 Sun Microsystems, Inc. Todos os direitos reservados. O uso está sujeito aos termos da licensa.