Vzorová aplikácia reprezentuje webový portál fiktívneho IT bazáru a k nemu prislúchajúcu Android aplikáciu pre zobrazovanie obsahu web portálu.
Technológie:
- Django (python web framework)
- Android (OS pre mob.)
- REST (súbor architektonických princípov, umožňujúce návrh webových služieb)
- JSON (dátový formát, určený pre prenos dát)
Web portál – Django
V tejto prezentácii
sa nerieši UI webového portálu a teda URL web portálu vracia len
JSON bez „template“).
Poznámka na úvod:
Štandardný MVC model je v Django frameworku prezentovaný ako MTV model. (Model View Controller = Model Template View)
Štandardný MVC model je v Django frameworku prezentovaný ako MTV model. (Model View Controller = Model Template View)
Riešenie:
Web portál
pozostáva z jednoduchého modelu (models.py), view (views.py) a
admin rozhrania (admin.py) pre naplnenie dát, ktoré sú JSON
výstupom pre Android aplikáciu.
[views.py]
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 | # coding: UTF-8 from django.http import HttpResponse from django.utils import simplejson from django.core import serializers from json01App.models import Category, Product def index(request): ''' index.html ''' cat_type = 0 if 'cat_type' in request.GET and request.GET['cat_type']: cat_type = request.GET['cat_type'] category = Category.objects.all() json_category = serializers.serialize("json",category) products = Product.objects.filter(category_id = cat_type) json_products = serializers.serialize('json', products, ensure_ascii=False) json_products_encode = json_products.encode('ascii', 'ignore') json_string = "{\"product\":" + str(json_products_encode) + "}" return HttpResponse(json_string, content_type='application/javascript; charset=utf-8') |
URL je volaná s
parametrom „cat_type“, definujúcim kategóriu, ktorej obsah sa
má vrátiť (hodnota parametra predstavuje primárny kľúč entity
„Category“ v DB, viď. „models.py“).
[models.py]
Príklad URL: http://192.168.1.1:8000/?cat_type=1
Dôležité:
Ak je web portál spúšťaný na localhost-e, je potrebné ho spustiť pod IP adresou samotného PC, predstavujúceho web server a nie ako „localhost“, alebo „loopback“ (127.0.0.1), nakoľko za týmto istým účelom používa OS Android tieto adresy. To znamená že po nastavení URL v Android aplikácii (viď nasledovný odstavec) a jej následnom spustení by sa volal „localhost“ OS Androidu a nie požadovaný web portál.
[models.py]
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 | from django.db import models class Category(models.Model): name = models.CharField(max_length=30) def __unicode__(self): return self.name class Product(models.Model): ''' product id = implicit primary key ''' category_id = models.ForeignKey(Category) product_type = models.CharField(max_length=30) product_mob = models.CharField(max_length=30) product_mail = models.CharField(max_length=30) product_desc = models.CharField(max_length=160) product_price = models.CharField(max_length=30) def __unicode__(self): return self.product_type |
[admin.py]
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 | # Coding: UTF-8 from json01App.models import Category, Product #from heatmap.models import * from django.contrib import admin class CategoryAdmin(admin.ModelAdmin): list_display = ('id','name',) fields = ('name',) ordering = ('id',) class ProductAdmin(admin.ModelAdmin): list_display = ('id','category_id','product_type','product_mob','product_mail','product_price','product_desc',) fields = ('category_id','product_type','product_mob','product_mail','product_price','product_desc',) ordering = ('id',) admin.site.register(Category, CategoryAdmin) admin.site.register(Product, ProductAdmin) |
Admin UI - Category:
Admin UI - Product:
Návratová hodnota URL je JSON:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 | {
"product": [
{
"pk": 3,
"model": "json01App.product",
"fields": {
"product_mail": "PC01@pc.sk",
"product_mob": "0948 620 720",
"product_type": "Dell OptiPlex 755",
"product_desc": "Parametre: OptiPlex 755 DT: Intel Core 2 Duo E7200 (2.53GHz, 1066MHz, 3MB) Desktop Chassis Resource DVD: OptiPlex 755 Diagnostics & Drivers Vista/XP Documentati",
"product_price": "130 ",
"category_id": 1
}
}
]
}
|
Android aplikácia
Aplikácia obsahuje
na úvodnej obrazovke tri tlačítka a každé z nich reprezentuje
vstup do inzertného obsahu danej kategórie. Po stlačení tlačítka
sa zobrazia položky (inzeráty) danej kategórie a po následnom
kliknutí na konkrétny inzerát sa zobrazí jeho podrobný obsah.
Poznámka na úvod:
Minimálne
požiadavky na verziu OS je Android 3.0.x HONEYCOMB (API 11) z dôvodu
použitia dialógového okna „DialogFragment“, namiesto
zavrhovaného „AlertDialog“.
Riešenie:
- MainActivity.java - po spustení aplikácie sa na pozadí volá URL pre každú kategóriu zvlášť (inštancia „inner“ triedy [ReadJSONFeedTask]). Vrátená hodnota sa uloží ako JSONObject a rozparsovaný výsledok sa ukladá do HashMap premennej (ArrayList), pripravenej pre zobrazenie JSON obsahu, prezentovaného v UI ako zoznam položiek (ListActivity). Ak je návratová hodnota JSON prázdna, prípadne je URL neplatné, vyvolá sa dialógové okno (DialogFragmet) s informáciou o probléme.
- DisplayMessageActivity.java – kliknutím na ľubovoľné tlačítko predstavujúce jednu z kategórii sa volá aktivita, ktorá zostaví a zobrazí spomenutý zoznam položiek.
- SingleMenuItemActivity.java - následným kliknutím na niektorú z položiek zoznamu sa jej obsah zobrazí opäť ako nový zoznam položiek.
Dôležité:
Pred spustením (kompiláciou) Android aplikácie je potrebné upraviť nasledovné konštanty v hlavnej triede "MainActivity":
- JSON_URL = URL webového portálu, volaný pre získanie JSON dát,
- CATEGORY_TYPE_PC (NB,MOB) = číselný parameter definujúci kategóriu (hodnota parametra predstavuje primárny kľúč entity „Category“ v DB, viď. „models.py“).
Screenshot:
Sources:
Bazar_example.zip
Záver:
Ukážková aplikácia slúži ako
priblíženie a nie ako komplexné riešenie danej problematiky,
preto je potrebné brať v úvahu absenciu štandardných
funkcionalít pri podobných riešeniach v praxi, ako napríklad
ukladanie získaných dát v mobile pre neskoršiu prezentáciu –
offline a podobne.
