Plataforma do Aplicativo JBoss Enterprise 5.0 JBoss Cache Tutorial. para uso com a Plataforma do Aplicativo JBoss Enterprise 5.0 Edição 2.

Transcrição

1 Plataforma do Aplicativo JBoss Enterprise 5.0 JBoss Cache Tutorial para uso com a Plataforma do Aplicativo JBoss Enterprise 5.0 Edição 2.0 Manik Surtani Galder Zamarreño

2 Plataforma do Aplicativo JBoss Enterprise 5.0 JBoss Cache Tutorial para uso com a Plataforma do Aplicativo JBoss Enterprise 5.0 Edição 2.0 Manik Surtani Galder Zamarreño

3 Nota Legal Copyright 2009 Red Hat, Inc. T his document is licensed by Red Hat under the Creative Commons Attribution-ShareAlike 3.0 Unported License. If you distribute this document, or a modified version of it, you must provide attribution to Red Hat, Inc. and provide a link to the original. If the document is modified, all Red Hat trademarks must be removed. Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law. Red Hat, Red Hat Enterprise Linux, the Shadowman logo, JBoss, MetaMatrix, Fedora, the Infinity Logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries. Linux is the registered trademark of Linus Torvalds in the United States and other countries. Java is a registered trademark of Oracle and/or its affiliates. XFS is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries. MySQL is a registered trademark of MySQL AB in the United States, the European Union and other countries. Node.js is an official trademark of Joyent. Red Hat Software Collections is not formally related to or endorsed by the official Joyent Node.js open source or commercial project. T he OpenStack Word Mark and OpenStack Logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community. All other trademarks are the property of their respective owners. Resumo Este livro é um T reecache e um JBossCache T utorial.

4 Índice Índice. Capítulo Introdução O que iremos aprender 3. Capítulo Configuração Capítulo Script Capítulo Rodando o.. Tutorial GUI Capítulo T.. utoriais Caches e Nós Replicação T ransações 8. Histórico de... Revisão

5 2 Plataforma do Aplicativo JBoss Enterprise 5.0 JBoss Cache Tutorial

6 Capítulo 1. Introdução Capítulo 1. Introdução O JBoss Cache é um cache fine-grained, transacional e replicado em memória. Este tutorial centralizase na parte principal do Cache API. Por favor refira-se ao tutorial vinculado ao POJO Cache, caso seu interesse seja o Cache API. Para maiores informações a respeito da configuração, uso e APIs, por favor refira-se ao Guia do Usuário do JBoss Cache da Plataforma do Aplicativo JBoss Enterprise, disponível a partir do O que iremos aprender Criação e modificação de Cache Replicação de estado Transações 3

7 Plataforma do Aplicativo JBoss Enterprise 5.0 JBoss Cache Tutorial Capítulo 2. Configuração Primeiramente, realize o download da distribuição do JBoss Cache 3.x a partir do the download page. Você precisará da distribuição all (jbosscache-core-3.x.y.ga-all.zip). Depois, descomprime-a (unzip) e você obterá um diretório contendo a distribuição, tal como jbosscache-core-3.x.y. Para melhor entendimento, isto é referido como ${JBOSSCACHE_HOME}. Os arquivos de configuração estão localizados no ${JBOSSCACHE_HOME}/etc. Você pode modificar o comportamento do cache através da edição de diversos arquivos de configuração. log4j.xml: conexão de resultado. Você pode acionar o nível de conexão ou modificar o diretório do arquivo log. config-sam ples/total-replication.xm l: arquivo de configuração do cache usado para este tutorial. 4

8 Capítulo 3. Script Capítulo 3. Script O único script necessário para este tutorial é o ${JBOSSCACHE_HOME}/tutorial/build.xm l ant script. Você precisará também possuir o Apache Ant instalado para rodagem do tutorial GUI. 5

9 Plataforma do Aplicativo JBoss Enterprise 5.0 JBoss Cache Tutorial Capítulo 4. Rodando o Tutorial GUI O GUI é executado pela: Alteração do diretório ${JBOSSCACHE_HOME}/tutorial (ex.: cd ${JBOSSCACHE_HOME}/tutorial) E a rodagem do ant script (ex.: ant run) Este será o motivo pelo qual uma janela do GUI aparecerá, fornecendo-o uma visualização do tree do cache na parte superior do painel e uma visualização BeanShell do JVM, num painel inferior. A visualização BeanShell é pré-determinado com as seguintes variáveis: cache: uma referência à interface org.jboss.cache.cache, usada pela instância do GUI. root: uma referência à instância org.jboss.cache.node da raiz para o cache acima. transactionmanager: uma referência à instância javax.transaction.t ransactionmanager registrada. As referências disponibilizadas à janela BeanShell direcionam à mesma instância do cache usada pela visualização do tree no GUI acima. Recomendamos iniciar outra janela de linha de comando e rodar novamente o script, conforme acima, para rodar o GUI como um tutorial replicado. Desta maneira, você terá duas instâncias de cache rodando em dois GUIs separados, replicando o estado entre si. 6

10 Capítulo 5. Tutoriais Capítulo 5. Tutoriais Importante Recomenda-se o encerramento e re-inicialização do GUI para cada um dos tutoriais, para garantir sempre caches limpos Caches e Nós Para este tutorial, inicialize uma instância única do GUI. Iremos realizar o seguinte neste tutorial: Criar nós sob nós da raiz. Remover nós sob o nó da raiz, ambos individuais e recursivos. Adicionar e remover dados dos nós. 1. Determinar os Fqns necessários. Num painel BeanShell, crie 3 variáveis Fqn: childfqn1 = Fqn.fromString("/child1"); childfqn2 = Fqn.fromString("/child2"); childfqn3 = Fqn.fromString("/child2/child3"); 2. Criar nós filhos sob o nó da raiz. child1 = root.addchild(childfqn1); child2 = root.addchild(childfqn2); child3 = root.addchild(childfqn3); 3. Consultar os nós. root.haschild(childfqn1); // should return true child2.haschild(childfqn3.getlastelement()); // should return true child3.getparent(); // should return child2 child2.getparent(); // should return root 4. Adicionar alguns dados nos nós. Você deverá ver os conteúdos de cada nó, pela seleção dos nós na visualização do tree. child1.put("key1", "value1"); child1.put("key2", "value2"); child2.put("key3", "value3"); child2.put("key4", "value4"); child3.put("key5", "value5"); child3.put("key6", "value6"); 5. Consultar alguns dos dados. child1.getkeys(); child2.getdata(); 6. Remover alguns dos dados nos nós. 7

11 Plataforma do Aplicativo JBoss Enterprise 5.0 JBoss Cache Tutorial child1.remove("key1"); child2.remove("key3"); child3.cleardata(); 7. Deletar os nós root.removechild(childfqn1); // will also remove any data held under child1 root.removechild(childfqn2); // will recursively remove child3 as well 5.2. Replicação Para este tutorial, inicialize duas instâncias do GUI. Repita os exercícios do tutorial anterior, apenas alternando entre duas janelas do GUI quando criando/removendo os nós ou adicionando/removendo dados. Isto demonstra como as duas instâncias do cache nos dois GUIs são mantidas em sync Transações Apenas neste tutorial, inicialize duas instâncias do GUI. Repita os exercícios no tutorial anterior, apenas inicializando as transações antes da criação/remoção dos nós ou adição/remoção dos dados. Isto descreverá como a replicação apenas acontece nos limites da transação. T ente reverter algumas transações também, e verá que nada é replicado nestas condições. Segue abaixo um código de amostra para gerenciamento das transações: tm = cache.gettransactionmanager(); tm.begin(); // do operations here tm.commit(); // or tm.rollback(); 8

12 Histórico de Revisão Histórico de Revisão Revisão Fri Oct Rüdiger Landmann Rebuild with Publican Revisão Misty Stanley-Jones Rebuild for updated legal template Revisão Anthony T owns Rebuild for Publican 3.0 Revisão T hu Oct Laura Bailey Rascunho inicial. 9