15. Exercício [IMPOTS] com XML
Neste exercício, já estudado várias vezes, o servidor retorna os resultados ao cliente na forma de um fluxo XML:
- <reponse><erreur>msg</erreur></reponse> em caso de erro;
- <reponse><impot>valeur</impot></reponse> se o imposto puder ser calculado.
Utilizamos o que acabamos de aprender sobre a análise de um documento XML.
 |
15.1. O serviço web
O serviço web não difere do serviço web estudado anteriormente, exceto pelo fato de que a resposta XML enviada ao cliente é ligeiramente diferente. A arquitetura permanece a mesma:
 |
O serviço web (impots_web_02)
#!D:\Programas\ActivePython\Python2.7.2\python.exe
# -*- coding=Utf-8 -*-
# importação do módulo das classes Impostos*
from impots import *
import cgi,cgitb,re
# autoriza-se a exibição de informações de depuração
cgitb.enable()
# ------------------------------------------------
# o serviço web de impostos
# ------------------------------------------------
# os dados necessários para o cálculo do imposto foram inseridos na tabela mysqL TABLE
#, pertencente ao banco de dados BASE. A tabela possui a seguinte estrutura
# limites decimal(10,2), coeffR decimal(6,2), coeffN decimal(10,2)
# os parâmetros dos contribuintes (estado civil, número de filhos, salário anual)
# são enviados pelo cliente no formato params=estado civil, número de filhos, salário anual
# os resultados (estado civil, número de filhos, salário anual, imposto a pagar) são devolvidos ao cliente
# no formato <imposto>valor</imposto>
# ou no formato <erro>msg</erro>, caso os parâmetros sejam inválidos
# o servidor retorna ao cliente texto não formatado
print "Content-Type: text/plain\n"
# início da resposta
print "<reponse>"
# definição das constantes
USER="root"
PWD=""
HOTE="localhost"
BASE="dbimpots"
TABLE="impots"
# instanciação da camada [metier]
try:
metier=ImpotsMetier(ImpotsMySQL(HOTE,USER,PWD,BASE,TABLE))
except (IOError, ImpotsError) as infos:
print ("<erreur>Une erreur s'est produite : {0}</erreur>".format(infos))
sys.exit()
# recupera-se a linha enviada pelo cliente ao servidor
params=cgi.FieldStorage().getlist('params')
# se não houver parâmetros, ocorre um erro
if not params:
print "<erreur>Le parametre [params] est absent<erreur></reponse>"
sys.exit()
# processamos o parâmetro params
#print "parâmetros recebidos --> %s\n" %(params)
items=params[0].strip().lower().split(',')
# deve haver apenas 3 campos
if len(items)!=3:
print "<erreur>[%s] : nombre de parametres invalide</erreur></reponse>" % (params[0])
sys.exit()
# o primeiro parâmetro (estado civil) deve ser sim/não
marie=items[0].strip()
if marie!="oui" and marie != "non":
print "<erreur>[%s] : 1er parametre invalide</erreur></reponse>\n"% (params[0])
sys.exit()
# o segundo parâmetro (número de filhos) deve ser um número inteiro
match=re.match(r"^\s*(\d+)\s*$",items[1])
if not match:
print "<erreur>[%s] : 2ieme parametre invalide</erreur></reponse>\n"% (params[0])
sys.exit()
enfants=int(match.groups()[0])
# o terceiro parâmetro (salário) deve ser um número inteiro
match=re.match(r"^\s*(\d+)\s*$",items[2])
if not match:
print "<erreur>[%s] : 2ieme parametre invalide</erreur></reponse>\n"% (params[0])
sys.exit()
salaire=int(match.groups()[0])
# calcula-se o imposto
impot=metier.calculer(marie,enfants,salaire)
# retorna-se o resultado
print "<impot>%s</impot></reponse>\n" % (impot)
# fim
Observações:
Este serviço web difere do anterior apenas pela natureza de sua resposta:
<reponse><erreur>msg</erreur></reponse> em caso de erro, em vez de <erreur>msg</erreur>
<reponse><impot>valeur</impot></reponse> se o imposto puder ser calculado, em vez de <impot>valeur</impot>
15.2. O cliente programado
Nosso cliente deve analisar a resposta XML enviada pelo serviço web. Aplicamos o que foi visto na análise de um documento XML.
O programa (client_impots_web_02)
# -*- coding=utf-8 -*-
import httplib,urllib,re
import xml.sax, xml.sax.handler
# classe de gerenciamento XML
class XmlHandler(xml.sax.handler.ContentHandler):
# função chamada ao encontrar uma baliza de início
def startElement(self,name,attributs):
# registra-se o elemento atual
global elementcourant
elementcourant=name.strip().lower()
# a função chamada ao encontrar uma tag de fechamento
def endElement(self,name):
# não é realizada nenhuma ação
pass
# a função de gerenciamento de dados
def characters(self,data):
# dados
global elementcourant,elements
# os dados são recuperados
match=re.match(r"^\s*(.+?)\s*$",data)
if match:
elements[elementcourant]=match.groups()[0].lower()
def getResultatsXml(reponse):
# analisa-se a resposta XML
xml.sax.parseString(reponse,XmlHandler())
# os resultados são exibidos
if elements.has_key('erreur'):
return (elements['erreur'],"")
else:
return ("",elements['impot'])
# ------------------------------------------------------------ main
# constantes
HOST="localhost"
URL="/cgi-bin/impots_web_02b.py"
data=("oui,2,200000","non,2,200000","oui,3,200000","non,3,200000","x,y,z,t","x,2,200000", "oui,x,200000","oui,2,x");
# variáveis globais
elementcourant=""
elements={}
# conexão
connexion=httplib.HTTPConnection(HOST)
# acompanhamento
#connexion.set_debuglevel(1)
# é feito um loop sobre os dados a serem enviados ao servidor
for params in data:
# os parâmetros devem ser codificados antes de serem enviados ao servidor
parametres = urllib.urlencode({'params': params})
# envio da solicitação
connexion.request("POST",URL,parametres)
# processamento da resposta (fluxo XML)
reponse=connexion.getresponse().read()
# análise do arquivo XML
(erreur,impot)=getResultatsXml(reponse)
if not erreur:
print "impot[%s]=%s" % (params,impot)
else:
print "erreur[%s]=%s" % (params,erreur)
Observações:
- o fluxo XML do serviço web é processado pela função getResultatsXml (linha 60);
- linha 29: a função getResultatsXml;
- linha 31: a resposta XML do serviço web é analisada por uma instância da classe XmlHandler definida na linha 6;
- linha 6: a classe XmlHandler implementa os três métodos startElement, endElement e characters. Com esses três métodos, cria-se um dicionário. As chaves são os nomes das tags <erreur> e <impot>, e os valores são os dados associados a essas duas tags;
- linhas 33-36: a função getResultatsXml retorna uma tupla com 2 elementos:
- (erreur,"") se a análise do fluxo XML tiver indicado a existência da tag <erreur>. erreur representa, então, o conteúdo dessa tag;
- ("",impot) se a análise do fluxo XML tiver indicado a existência da tag <impot>. impot representa, então, o conteúdo dessa tag.
- linha 60: o resultado da função getResultatsXml é recuperado e, em seguida, processado nas linhas 61 a 64.