MoCA Proxy Framework Manual de utilização - PUC-Rio
Contents
1. importante salientar que a publica o para clientes tamb m feita para um t pico e n o clientes espec ficos e o framework respons vel por identificar quais os clientes interessados no t pico e enviar a mensagem a eles efetuando adapta es caso necess rio Mensagens postadas por clientes para um t pico s o recebidas pela aplica o Proxy atrav s do m todo onReceiveMessage da interface MessageListener como explicado anteriormente Se a mensagem for de um t pico cadastrado no servidor fun o da aplica o proxy publicar esta mensagem ao servidor e demais clientes se desejar 3 Extens o de a es O ProxyFramework permite que determinadas a es sejam executadas de acordo com o estado corrente do cliente Por serem espec ficas para cada aplica o as a es devem ser implementadas pelo desenvolvedor do proxy que deve criar seus pr prios mecanismos de adapta o As a es s o definidas pela classe base Action do pacote proxy actions Esta classe fornece m todos comuns como por exemplo o de recupera o de par metros getParameter Existem dois tipos de a es as de adapta o de mensagens chamadas adapters e as de mudan a de estado chamadas listeners As a es do tipo adapter s o a es acionadas no momento do envio de uma mensagem a um cliente dependendo de seu contexto corrente Para criar uma a o deste tipo deve se estender a classe abstrata proxy actions adpter Adapter Esta cla2. mai sculas de min sculas portanto o nome do par metro no XML deve ser id ntico ao definido em cada classe listada a seguir Classe Color ToGray Adapter Converte uma imagem colorida para preto e branca escala de cinza mantendo o tipo de imagem original Exemplo de configura o no XML est a seguir lt Action class moca core proxy actions adapters Color ToGray Adapter gt Classe ConvertToJPEGAdapter Converte uma imagem qualquer para o formato JPEG com uma qualidade de compress o pr definida no XML O par metro compressionQuality deve ser especificado O valor da qualidade de compress o controla a qualidade da imagem e tamb m a taxa de compress o da mesma Seu valor deve ser entre O e 1 por exemplo 11 Maior qualidade nenhuma compress o 0 75 Qualidade alta m dia taxa de compress o Qualidade m dia boa taxa de compress o Qualidade baixa alta taxa de compress o Exemplo de configura o no XML lt Action class moca core proxy actions adapters ConvertToJPEGAdapter gt lt Parameter name compressionQuality gt 0 4 lt Parameter gt lt Action gt O Classe CropCenter Adapter A imagem recortada gerando se uma nova imagem que cont m a regi o retangular central de tamanho igual altura x largura definidos como par metros da classe Os par metros width e height definem as bordas da imagem recortada Um exemplo pode ser visto abaixo lt Action cl
3. Pontif cia Universidade Cat lica do Rio de Janeiro Departamento de Inform tica RIO INF 2060 Estudo Orientado MoCA Proxy Framework Manual de utiliza o Hana Karina Rubinsztejn Prof Markus Endler ndice 1 MoCA Proxyiramemork unas casapadiaa ar iacsas ad casca gata iodinea i ucis 1 2 Comunica o com servidor e clientes sseoseesseossesseoscessecoeooseoseossessesoeoo 3 gt Extens o de A ES asesinan onna das ASEE Oa 5 4 Configura o de contextos e a es cccccececssereresererocserecssecencsceresssereaso 6 41 GDE L 24 jo APDO RNP NR GO RR APARTE RS DNA DSP APIA IN ANA RR PR O RR 8 Sd MACIO e E EE E N E E ali asia Dad osaais 10 6 Adapt ac o de Imagens assis dp sl e 11 7 Manuten o dos clientes atendidos pelo proxy ssscssssecccsseecosseossssesoo 14 o Conectividade de chentes susana dale qa 15 9 Libera o de recursos assassino GarasGu mist edad de sta asda caa so iea aptas data dados 15 10 Arquivos de configura o sssssecccssecccossseccossssecoosssesoossseseossseecosssssesooo 16 TE DISQEDUIC O soca isasates sesta ea Grcsda pa dds cais sis pon ao EEEE 17 1 MoCA ProxyFramework A arquitetura MoCA Mobile Collaboration Architecture uma arquitetura de middleware para aplica es colaborativas para usu rios m veis A arquitetura MoCA oferece um conjunto de servi os que coletam e distribuem informa es do contexto de execu o de cada dispositivo Aplica es bas
4. Subject Assunto da notifica o a ser publicada A especifica o de um elemento de filtragem no arquivo XML feita atrav s das tags FieldValue e Literal FieldValue indica que o pr ximo item representar um campo do filtro ou elemento de filtragem Literal indica um valor de texto absoluto ou seja todos os caracteres s o considerados inclusive espa os em branco Por exemplo para definir o campo dataType como um campo do filtro faz se lt FieldValue gt lt Literal gt datatype lt Literal gt lt FieldValue gt Existem dois operadores para especificar o filtro e Equals Operador bin rio que recebe duas strings como operandos Assume valor true se os operandos s o iguais e falso caso contr rio Obs Esta opera o case insensitive e StartWith Operador bin rio que recebe duas strings como operandos Verifica se o segundo operando prefixo do primeiro operando Obs Esta opera o case insensitive Os elementos de filtragem tamb m podem ser combinados utilizando se os seguintes operadores e Or Operador bin rio que recebe dois valores booleanos como operandos Assume valor true se e somente se pelo menos um dos operandos true e And Operador bin rio que recebe dois valores booleanos como operandos Assume valor true se e somente se ambos os operandos s o true e Not Operador un rio que recebe um valor booleano como operando Nega o operando Se ele for true o resultado ser fal
5. a para a correta manuten o da lista cada cliente deve ser explicitamente cadastrado no Proxy e removido quando desejado Para isso o desenvolvedor deve usar os m todos addClient e removeclient da classe ProxyFramework Al m disso necess rio registrar no servi o CIS da MoCA aqueles clientes que a aplica o deseje que o contexto seja monitorado Para este prop sito deve se usar o m todo registerClientAtcIS ou tamb m j setar esta op o no momento da inser o do cliente adaclient Para a remo o de clientes apenas do servi o CIS pode se usar removeClientFromCIS OU removeAllClientsFromCIS Uma observa o que remover clientes do CIS n o os remove da lista do Proxy e portanto este continua aceitando suas mensagens Mas a remo o de um cliente do proxy implica na autom tica remo o do mesmo no MoCA CIS Ao receber a mensagem de um cliente n o cadastrado o proxyFramework a repassa para a aplica o proxy para que esta decida se o cliente deve ou n o ser cadastrado no framework Apesar de receber mensagens de qualquer cliente se este n o for cadastrado o proxy n o ter como responder 1 e enviar mensagens a ele 14 8 Conectividade de clientes O Proxy Framework oferece a op o da aplica o proxy ter conhecimento sobre a conectividade de clientes Isso pode ser usado por exemplo para calcular por quanto tempo os clientes est o desconectados e ent o decidir se um cliente deve ser removido do prox
6. a clientes m veis e o endere o p blico IP do proxy na sua interface com o servidor da aplica o pap l de cliente Abaixo est um exemplo deste arquivo com as tags que devem ser definidas proxy server ip address 0 0 0 0 proxy sync server port 55100 proxy event server port 55110 proxy public local ip address 139 82 24 232 A configura o dos endere os dos servi os MoCA usados pelo proxy s o definidos no arquivo moca properties A seguir h um exemplo deste arquivo No momento os servi os CIS e DS s o usados e devem ser definidos de acordo com as tags definidas abaixo cis server host cis lac inf puc rio br cis server port 55001 cis publisher port 55000 ds host ds lac inf puc rio br 16 11 Distribui o Em conjunto com o c digo fonte disponibilizado um script ant para compila o gera o de documenta o javadoc execu o de teste autom tico Junit e cria o do diret rio de distribui o A ultima tarefa executada pelo target dist cria um diret rio hom nimo com todos arquivos necess rios em uma distribui o bin ria do framework Na Figura 3 mostrada a estrutura de diret rios abaixo de dist EI 5 dist 5 config EI E doc E E api 5 moca 5 resources Ei o lib CD junit E logs 5 xerces Figura 3 Estrutura de Diret rios de Distribui o Como pode ser visto na figura acima o diret rio de distribui o composto basicamente por 3 subdiret r
7. ass moca core proxy actions adapters CropCenterAdapter gt lt Parameter name width gt 60 lt Parameter gt lt Parameter name height gt 50 lt Parameter gt lt Action gt 12 Classe ScaleImageA dapter Escala a imagem por um fator pr definido Se o fator de escala for maior que 1 a imagem ampliada por outro lado se o fator for entre O e 1 a imagem reduzida Note que se o valor do fator for negativo ele ser convertido para 0 01 O par metro factor indica o fator de escala que deve ser definido como par metro da classe no XML como no exemplo lt Action class moca core proxy actions adapters ScaleImageA dapter gt lt Parameter name factor gt 0 5 lt Parameter gt lt Action gt 13 7 Manuten o dos clientes atendidos pelo proxy O ProxyFramework mant m uma lista de clientes para os quais ele intermedeia a comunica o e executa adapta es se necess rio Entretanto ele apenas intermedeia a comunica o de clientes que estejam cadastrados no mesmo A ger ncia de clientes fica ent o a cargo da aplica o para uma maior flexibilidade e possibilitar que por exemplo a aplica o Proxy autentique o usu rio e s depois passe a aceitar suas mensagens Outro exemplo seria poder remover um usu rio n o apenas baseado em dados t cnicos f sicos como estar desconectado a um certo tempo mas tamb m por quest es de neg cio por exemplo o cliente n o pagou pelo servi o Desta form
8. e cacheClassName gt moca core proxy cache FIFOCacher lt Parameter gt lt Action gt lt State gt lt State gt lt Expression gt lt I CDATA CPU gt 60 AND FreeMemory lt 10000 gt lt Expression gt lt Rule priority 1 gt lt Filter gt lt And gt lt l tipo de dados da mensagem gt lt StartWith gt lt FieldValue gt lt Literal gt datatype lt Literal gt lt FieldValue gt lt Literal gt image lt Literal gt lt StartWith gt lt l protocolo gt lt Equals gt lt FieldValue gt lt Literal gt protocol lt Literal gt lt FieldValue gt lt Literal gt TCP lt Literal gt lt Equals gt lt And gt lt Filter gt lt Action class moca core proxy actions adapters ConvertToJPEGAdapter gt lt Parameter name compressionQuality gt 0 3 lt Parameter gt lt Action gt lt Rule gt lt State gt lt ProxyConf gt Figura 2 Exemplo de arquivo de configura o Observa o 1 necess ria a utiliza o de uma se o CDATA na especifica o da express o de contexto para indicar ao XML parser que a regi o pode conter qualquer string Ex lt I CDATA CPU gt 60 AND FreeMemory lt 10000 gt Isto necess rio porque a express o de contexto cont m caracteres que fazem parte da sintaxe XML como por exemplo lt e gt Observa o 2 Na denomina o dos par metros elemento Parameter das a es as diferen as entre letras mai sculas
9. e min sculas s o levadas em considera o case sensitive Observa o 3 As regras Rule s podem possuir a es do tipo Adapter o que significa tamb m que n o se pode aplicar filtros nas a es do tipo Listener Outro detalhe que n o poss vel a cria o de uma mesma a o listener com par metros diferentes no mesmo estado Entretanto uma mesma a o adapter pode ser utilizada com par metros diferentes dentro de um mesmo estado mas em regras diferentes Observa o 4 N o h nenhuma restri o s condi es do cliente se casarem com mais de um estado ou seja todas as a es de adapta o de todos os estados ser o executadas se passarem pelos filtros e a ordem de execu o dos estados ser provavelmente a mesma do XML mas n o garantida 4 1 Filtros Os filtros s o utilizados para selecionar as mensagens nas quais devem ser aplicadas as adapta es indicadas ao contexto corrente Os tipos de elementos que podem ser filtrados dizem respeito mensagem e seu tipo de conte do e ou ao cliente a que se destina a mensagem Os elementos de filtragem dispon veis no momento s o communicationMode Modo de comunica o do SYNCHRONOUS cliente comunica o s ncrona ASYNCHRONOUS comunica o ass ncrona protocol Protocolo de comunica o utilizado pelo cliente dataType Tipo de dado da mensagem Ex image jpeg em formato MIME em geral identificador do destinat rio
10. eadas na MoCA s o aplica es compostas por tr s partes servidor proxy e cliente m vel O proxy na MoCA tem o papel de intermediar a comunica o entre servidor e clientes executando adapta es se necess rio de acordo com o estado do cliente O proxy framework tem o objetivo de facilitar o desenvolvimento da aplica o proxy sendo respons vel por interagir com a MoCA escondendo detalhes desta intera o e inscrevendo se como interessado por notifica es sobre os contextos de interesse da aplica o para cada cliente cadastrado pela aplica o O proxy framework oferece facilidades para a configura o de contextos de interesse e associa o das a es que devem ser tomadas quando da ocorr ncia de tais contextos ou estados A Figura 1 mostra um esquema geral da atua o do Proxy MoCA Fra AY Framework CISRTERcrEaacecraaasecaceacneeracarananeacnanasaaeecaneacneoracancnscesenasaacancascesenocnacanoascesenecnecancecceeconseceneoencennensences Moca Interface lo Del Event Processing Clent Communication z E a m D a Im qi E mo Na Figura 1 Vis o geral do Proxy O Framework composto por componentes de comunica o com clientes e servidor e pelo n cleo respons vel pela comunica o com o CIS e pelo mecanismo de aplica o de adapta es al m de uma interface de intera o entre o framework e a implementa o proxy A interface ProxyFacade do pacote proxy develop
11. ios e config cont m os arquivos de configura o externa aqueles arquivos pass veis de modifica o por usu rios da distribui o bin ria do framework Um exemplo deste tipo de arquivo o ProxyConf xml que estabelece diversas regras de adapta o para o Proxy e doc documenta o JavaDoc da API do framework e 1lib cont m todos os arquivos jars necess rios para a execu o do framework Os jars do framework estar o logo abaixo do diret rio lib As demais depend ncias depend ncias externas estar o subdivididas em diret rios cujos nomes descrevem sua proced ncia importante lembrar que estas depend ncias ou vers es compat veis destas dever o constar no classpath de qualquer aplica o baseada sobre o framework 17
12. licadas em cada estado devem ser definidos no arquivo XML ProxyConfig xml Neste arquivo cada estado definido por uma express o de interesse Cada estado pode possuir uma a o do tipo listener e um n mero n o determinado de regras para adapta o de mensagens Cada regra composta por um filtro e a es de adapta o O filtro serve pra validar as mensagens que podem ser adaptadas por determinado adaptador As a es dentro da regra s o aplicadas na ordem em que aparecerem no arquivo XML Al m disso cada regra possui uma prioridade que se n o for definida ser considerada como de menor prioridade Se diferentes regras tiverem a mesma prioridade ser o aplicadas na mesma ordem em que foram definas Na Figura 2 apresentado um exemplo de um arquivo de configura o Neste exemplo podemos ver o elemento State Este elemento representa um estado monitorado Todo elemento State possui um nico elemento Expression O elemento Expression corresponde express o de monitoramento que ser cadastrada no CIS da MoCA para verifica o peri dica da situa o dos clientes No momento em que o estado de um cliente transiciona de ON para OFF ou vice versa o usu rio do framework pode customizar a es listeners a ser executadas Estas a es ser o implementadas estendendo se a classe StateListener e sua configura o ser atrav s do elemento Action Cada estado pode ter um n mero ilimitado de elementos Rule Os element
13. ment apresenta todos os m todos para a Intera o com o framework Para utilizar as funcionalidades do framework deve se utilizar a classe ProxyFramework para acessar as fun es dispon veis para a intera o entre as classes da aplica o e o framework A classe ProxyFramework oferece m todos para inicializa o e configura o do proxy ger ncia de usu rios envio e recebimento de mensagens para clientes e servidor recebimento de notifica es de conectividade e libera o de recursos Deve se notar que para usar o framework deve se obter a inst ncia da classe ProxyFramework e em seguida configurar o endere o da aplica o servidora Para iniciar o proxy deve se utilizar o m todo init Este m todo deve ser o primeiro m todo a ser invocado pois al m da comunica o com o servidor ele cria servidores de comunica o com clientes e configura as regras que definem as adapta es a serem aplicadas de acordo com o contexto do cliente Esta configura o feita a partir do arquivo ProxyConfig xml cujo formato definido na se o 4 Deste ponto em diante considere usu rio do framework como sendo o desenvolvedor da aplica o que instancia o framework e utiliza suas funcionalidades e considere cliente como o cliente m vel da aplica o Al m disso aplica o proxy a parte espec fica do proxy desenvolvida pelo usu rio do proxyFramework 2 Comunica o com servidor e clientes O proxy intermedeia toda a com
14. os Rule correspondem as regras Regras s o agrupamentos de adaptadores que ser o aplicados caso o estado para o qual foram cadastradas esteja ON e uma determinada condi o da mensagem e ou do seu destinat rio seja satisfeita A condi o determinada atrav s do elemento Filter O usu rio pode configurar um filtro utilizando se de uma s rie de operadores e elementos dispon veis que s o mais bem explicados na pr xima sub se o Uma vez que o filtro tenha aceitado a mensagem a s rie de adapters cadastrados para a regra ser executada Adaptadores tamb m devem ser cadastrados uma regra usando se o elemento Action com a nica diferen a de que a classe cadastrada deve estender Adapter poss vel fornecer par metros tanto para os listeners quanto para os adapters Estes par metros s o passados utilizando se o elemento Parameter veja exemplo Cada par metro possui um nome e um valor Os par metros s o exclusivos de cada classe e seus valores podem ser recuperados atrav s do nome ou seja o nome utilizado como chave e por isso ele case sensitive Para a defini o das express es de contexto consulte www lac inf puc rio br moca CIS lt xml version 1 0 encoding ISO 8859 1 gt lt ProxyConf gt lt State gt lt Expression gt lt I CDATA OnLine false AND DeltaT gt 3000 gt lt Expression gt lt Action class moca core proxy actions listeners DefaultCacheListener gt lt Parameter nam
15. r realizar convers es de protocolos se necess rio para o envio de mensagens aos clientes m veis A utiliza o destes dois tipos de comunica o explicada a seguir Observa o Todos os m todos utilizados na troca de mensagens mostrados a diante s o definidos na classe proxy ProxyFramework Comunica o Sincrona A comunica o s ncrona entre a aplica o proxy e os clientes ou servidor realizada atrav s dos m todos sendMsgToClient e sendMsgToServer respectivamente A aplica o deve apenas informar o destinat rio e o framework se encarrega de entregar a mensagem utilizando o protocolo de comunica o adequado ao cliente Comunica o Ass ncrona A comunica o assincrona publish subscribe do framework baseada no servi o de 1 z E ad eventos da MoCA com algumas altera es Neste tipo de comunica o o framework atua 1 z Maiores informa es consulte www lac infpuc rio br moca ECI como um servidor de eventos na comunica o com os clientes m veis e como subscriber na comunica o com o servidor da aplica o Permite se apenas publica o por t picos e a aplica o proxy respons vel por solicitar ao framework para se inscrever ou desinscrever subscribe unsubscribe no servidor da aplica o para cada t pico de interesse Al m disso ela tamb m respons vel por publicar no servidor mensagens vindas de um cliente para um t pico espec fico e vice versa Pa
16. ra que a aplica o proxy receba notifica es de pedidos de subscri es vindas dos clientes preciso implementar a interface SubscribeListener encontrada no pacote proxy development Implementando o m todo onreceiveSubscription toda vez que um cliente inscrito como interessado em um evento ou quando ele se desregistrar a aplica o Proxy ser informada Para isso necess rio tamb m cadastrar no framework este SubscribeListener atrav s do m todo addsubscriptionListener da classe proxy ProxyFramework Estas notifica es podem ser usadas pela aplica o Proxy para manter uma lista de interessados para cada t pico e decidir quando subscrever em um t pico no servidor e quando se desinscrever Por exemplo na primeira subscri o por um t pico a aplica o Proxy pode se subscrever no servidor Se outros clientes tiverem interesse pelo mesmo t pico n o necess rio fazer este pedido de novo ao servidor Quando o ltimo cliente interessado em um t pico se desregistrar unsubscribe a aplica o Proxy tamb m pode desinscrever este t pico no servidor Para o registro de interesse em um t pico no servidor a aplica o Proxy deve utilizar o m todo subscribeToserver Para o cancelar o interesse use unsubscribeFromServer A publica o de mensagens de um t pico para o servidor ou para os clientes interessados deve ser feita utilizando os m todos publishMsgToserver publishMsgToClients respectivamente
17. se e vice versa 5 Cache O framework fornece uma a o listener especial para a implementa o de caching Esta a o feita pela classe DefaultCacheListener do pacote proxy actions listeners que apenas ativa ou desativa uma determinada pol tica de cache O importante que esta classe recebe como par metro o tipo de pol tica de cache que dever ser implantada Esse par metro chamado cacheClassName indica uma classe no arquivo de configura o XML Portanto a pol tica de cache uma classe que pode ser definida pelo desenvolvedor de acordo com as necessidades da aplica o A pol tica de cache deve obedecer interface definida em proxy cache Cacher Esta interface requisita que dois m todos sejam implementados uma para o armazenamento de uma mensagem e o outro para recupera o de todas as mensagens armazenadas no cache Desta forma poss vel definir diferentes pol ticas de cache para serem aplicadas em contextos diferentes por exemplo pode se adotar um tipo de cach em desconex es tempor rias e outro tipo em desconex es permanentes Note por m que a defini o de desconex o tempor ria ou permanente espec fico por aplica o e deve ser definida na express o de contexto O framework fornece duas implementa es de pol ticas de cache b sicas FIFOCacher e NoCacher A primeira apenas armazena as mensagens em uma ordem FIFO sem um limite espec fico de mensagens A segunda na verdade n o faz cache e
18. simplesmente descarta as mensagens num momento de desconex o por exemplo Abaixo segue um exemplo de defini o de cache no XML na ocorr ncia de uma desconex es O cache para desconex es tempor rias por ex desconex es por menos de 20 segundos do tipo FIFO ou seja armazena as mensagens e as retorna da mesma ordem de chegada n o descartando nada E para desconex es permanentes maiores de 20s n o h cache lt State gt lt Desconex o Tempor ria gt lt Expression gt lt I CDATA OnLine false AND DeltaT lt 20000 gt lt Expression gt lt Action class moca core proxy actions listeners DefaultCacheListener gt lt Parameter name cacheClassName gt moca core proxy cache FIFOCacher lt Parameter gt lt Action gt lt State gt lt State gt lt Desconex o Permanente gt lt Expression gt lt I CDATA OnLine false AND DeltaT gt 20000 gt lt Expression gt lt Action class moca core proxy actions listeners DefaultCacheListener gt lt Parameter name cacheClassName gt moca core proxy cache NoCacher lt Parameter gt lt Action gt lt State gt 10 6 Adapta o de Imagens O proxy framework prov algumas classes para adapta o de imagens Estas classes se encontram no pacote proxy actions adapters Abaixo est o listadas as classes suas funcionalidades e par metros Uma observa o importante que a defini o dos par metros da classe distingue letras
19. sse possui o m todo execute que recebe informa es sobre o destinat rio da mensagem e a pr pria mensagem a ser adaptada O retorno deste m todo a mensagem processada pelo adapter ou seja a mensagem alterada atrav s da aplica o da estrat gia implementada Note que se o retorno de um adapter for Null o fluxo de adapta es interrompido j que a mensagem foi descartada As a es do tipo listeners reagem s mudan as no estado de clientes Para implementar um listener basta estender a classe abstrata StateListener do pacote proxy actions listener Esta classe possui dois m todos matches e unmatches O primeiro executado sempre que o estado muda de OFF para ON e o segundo de ON para OFF Em ambos os casos s o fornecidas as informa es do cliente que sofreu a mudan a de estado e uma refer ncia para o dispatcher permitindo que o listener possa mandar mensagens para outros receivers Uma observa o caso a a o criada possua par metros configur veis no XML estes n o podem ser recuperados no construtor da classe estendida apenas depois do m todo init de Action Outro detalhe que as inst ncias das a es s o reaproveitadas em todas as execu es dentro do proxy Assim recomenda se que as implementa es n o armazenem nenhum tipo de estado atrav s de vari veis de inst ncia 4 Configura o de contextos e a es Os estados ou contextos a serem monitorados bem como as a es que devem ser ap
20. unica o entre clientes m veis e o servidor da aplica o Para a troca de mensagens ele utiliza de uma interface comum definida em proxy message Message O framework disponibiliza uma implementa o padr o para as mensagens em proxy message DefaultMessage que deve ser utilizada pelo desenvolvedor Esta classe pode ser estendida se desejar Um detalhe que a classe deve ser clon vel portanto deve se na nova classe sobrescrever o m todo clone se necess rio Toda mensagem recebida pelo framework repassada para a aplica o proxy que deve decidir se a mensagem deve ou n o ser retransmitida Isso implementado atrav s de callbacks Assim no desenvolvimento da aplica o Proxy deve se implementar uma interface listener MessageListener para o recebimento das mensagens implementar onReceiveMessage Esta Interface encontrada no pacote proxy development Para que a aplica o proxy receba mensagens vindas dos clientes deve se cadastrar no framework um MessageListener atrav s do m todo addclientMsgListener da classe ProxyFramework Para recebimento de mensagens vindas do servidor deve se cadastrar um MessageListener atrav s do m todo addServerMsgListener O framework permite dois tipos de comunica o s ncrono e ass ncrono com ambas as partes A aplica o Proxy respons vel por definir o tipo de comunica o a ser utilizada e pela decis o de quais mensagens devem ser retransmitidas O framework respons vel po
21. y caso exceda um determinado tempo de desconex o A aplica o pode receber notifica es quando clientes se conectam e se desconectam Na notifica o informado a identifica o do cliente e seu estado conectado ou n o Para que a aplica o proxy seja notificada o cliente deve ter sido cadastrado no CIS como explicado na se o anterior Al m disso a aplica o deve implementar a interface ConnectionListener encontrada no pacote proxy development m todo onReceiveConnectionNotification e cadastrar este listener no framework atrav s do m todo addClientConnectedListener da classe proxy ProxyFramwork 9 Libera o de recursos E importante salientar que o desenvolvedor deve invocar o m todo freeResources da classe ProxyFramework ao final de sua aplica o para uma correta libera o dos recursos alocados Isto serve para dentre outras coisas finalizar itera es com servi os da MoCA 15 10 Arquivos de configura o O diret rio config cont m os arquivos de configura o externa ou seja aqueles arquivos pass veis de modifica o por usu rios do framework Um exemplo deste tipo de arquivo o ProxyConf xml exemplificado na se o 3 que estabelece diversas regras de adapta o para o Proxy Outros arquivos importantes dizem respeito configura o do proxy e de servi os da MoCA O arquivo proxy properties cont m as informa es sobre endere o IP e portas para do proxy atuando como servidor par
Download Pdf Manuals
Related Search