Sobre as bibliotecas de componente JSF

Consulte também

Uma biblioteca de componentes é um conjunto de componentes JavaServer Faces relacionados que podem ser empacotados e distribuídos juntos em um único arquivo, chamado de complib e importados para uso em um projeto com suporte para Visual Web JSF. Um arquivo complib é um tipo de arquivo JAR com uma extensão .complib em vez de .jar. O arquivo contém os próprios componentes e seus objetos JavaBeans de tempo de design empacotados em arquivos JAR, assim como outros itens como arquivos ZIP de código-fonte, arquivos ZIP Javadoc e outros arquivos JAR usados em tempo de execução e de design. Um arquivo complib também possui um conteúdo lógico que é dividido fisicamente em vários arquivos e fornece informações sobre a biblioteca de componentes e lista seu conteúdo. Um arquivo complib é similar a um arquivo WAR pois ele contém outros arquivos JAR, arquivos de conteúdo e metadados sobre seu conteúdo.

Cada biblioteca de componentes possui uma URI de namespace e um número de versão de três dígitos que identifica o conjunto de componentes. Além disso, um complib especifica com qual versão da tecnologia J2EE seus componentes são compatíveis, no momento J2EE 1.4 ou Java EE 5, sendo que J2EE 1.4 é o padrão se nenhuma estiver especificada. Um desenvolvedor de componente pode lançar componentes usando um conjunto de pacotes Java e associá-los a um número de versão e namespace da biblioteca de componentes. Cada lançamento subseqüente dos componentes pode então usar o mesmo namespace mas um número de versão diferente para identificar o lançamento. Este design permite que o IDE impeça que duas versões diferentes do código de componente no mesmo pacote Java sejam usadas no mesmo projeto e, adicionalmente, oferece suporte aos recursos Atualizar e Substituir de projetos com suporte ao Visual Web JSF.

Um arquivo complib pode ser importado no IDE no Gerenciador de biblioteca de componentes. Ao importar um arquivo complib, seu conteúdo é expandido para o diretório .netbeans do IDE no diretório base do usuário. Você pode então adicionar a biblioteca de componentes aos projetos, conforme descrito em Importando componentes. Depois que a biblioteca for adicionada a um projeto, o conteúdo da biblioteca de componente é copiado para o diretório desse projeto e o IDE adiciona arquivos JAR da biblioteca de componentes recém-copiada para o classpath do projeto. Quando o conteúdo da biblioteca de componentes é copiado para um projeto, ele torna-se independente e pode ser empacotado e fornecido a outro desenvolvedor.

Quando o IDE incorpora uma biblioteca de componentes em um projeto, o conteúdo é armazenado em um subdiretório lib/complibs do projeto e uma lista de todas as bibliotecas de componentes do projeto é mantida em um arquivo index.xml. As bibliotecas de componentes do projeto são implementadas sobre os primitivos de biblioteca do IDE. No IDE, as definições de biblioteca são gerenciadas pelo gerenciador de bibliotecas e são recursos globais armazenados no diretório .netbeans. As referências de biblioteca são gerenciadas pela caixa de diálogo Propriedades do projeto do e são recursos por projeto que apontam para definições de biblioteca. O IDE automaticamente gerencia as definições e as referências de biblioteca quando as bibliotecas de componentes são usadas em um projeto. Se você desejar remover a biblioteca do IDE, deverá remover a biblioteca no Gerenciador de biblioteca de componentes. Se você não desejar mais usar os componentes em um projeto, deverá remover separadamente a biblioteca do nó Biblioteca de componentes do projeto e depois remover quaisquer componentes que permaneçam no projeto.

Consulte também
Importando componentes
Removendo uma biblioteca de componentes
Gerenciador da biblioteca de componentes
Caixa de diálogo Importar bibliotecas de componentes
Sobre componentes
Configurando as propriedades do componente
Tarefas de componente: referência rápida

Notificações legais