deadlime.project » XML http://deadlime.hu squeezed out Tue, 24 Jan 2012 21:54:45 +0000 en hourly 1 http://wordpress.org/?v=3.3.1 Kliens oldali XSLT http://deadlime.hu/2008/04/03/kliens-oldali-xslt/ http://deadlime.hu/2008/04/03/kliens-oldali-xslt/#comments Thu, 03 Apr 2008 08:48:12 +0000 kriz http://deadlime.hu/?p=111 Avagy az oldal összerakásával terheljük inkább a látogató böngészőjét a szerver helyett.

Néha egész érdekes dolgokat lehet látni, ha az ember - szakmai ártalomból, vagy csak egyszerű kíváncsiságból - beleles egyes oldalak forrásába. Az ilyen oldalak közé tartozik a The World of Warcraft Armory is. Az első pillantásra elég bonyolultnak tűnő oldal mögött meglepően kicsi (5 soros) XML fájl van. Legalábbis látszólag. Természetesen az XSLT áll a dolog mögött, aminek a szerver oldali alkalmazásáról már réges-régen ejtettem pár szót. Nézzük akkor most meg, hogy kliens oldalon mit művelhetünk vele:

Az alapok

Amire szükségünk lesz az egy XML és egy XSL fájl. A rendszerben valószínűleg az XSL fájlok statikusak lesznek, az XML-ek pedig szerver oldalon fognak generálódni. Nézzünk egy egyszerű blog példát kezdésnek:

<?xml version="1.0" encoding="utf-8"?>
<?xml-stylesheet type="text/xsl" href="index.xsl"?>
<page>
    <post url="http://example.com/">
        <name>A bejegyzés címe #1</name>
        <content>
            <p>A bejegyzés tartalma #1</p>
        </content>
        <author url="http://example.com/">író #1</author>
        <tags>
            <tag url="http://example.com/">tag #1</tag>
            <tag url="http://example.com/">tag #2</tag>
        </tags>
    </post>
    <post url="http://example.com/">
        <name>A bejegyzés címe #2</name>
        <content>
            <p>A bejegyzés tartalma #2</p>
        </content>
        <author url="http://example.com/">író #1</author>
        <tags>
            <tag url="http://example.com/">tag #3</tag>
            <tag url="http://example.com/">tag #4</tag>
            <tag url="http://example.com/">tag #5</tag>
        </tags>
    </post>
</page>

Gyakorlatilag bármilyen XML-t használhatunk, az oldal akár lehetne egy RSS feed is, amit a megfelelő XSL fájllal formálunk weboldal alakúvá. Esetünkben ez a fájl valahogyan így néz ki:

<?xml version="1.0" encoding="utf-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
    <xsl:output method="html" doctype-system="http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd" doctype-public="-//W3C//DTD XHTML 1.0 Strict//EN"/>
    <xsl:template match="page">
        <html xmlns="http://www.w3.org/1999/xhtml">
            <head>
                <title>XSL teszt</title>
            </head>
            <body>
                <div id="container">
                    <xsl:apply-templates/>
                </div>
            </body>
        </html>
    </xsl:template>
    <xsl:template match="post">
        <div class="post">
            <h2><a href="{@url}"><xsl:value-of select="name/text()"/></a></h2>
            <ul class="post-tags">
                <xsl:for-each select="tags/tag">
                    <li><a href="{@url}"><xsl:value-of select="text()"/></a></li>
                </xsl:for-each>
            </ul>
            <div class="post-content"><xsl:copy-of select="content"/></div>
        </div>
    </xsl:template>
</xsl:stylesheet>

A transzformáció az első illeszkedő <xsl:template> blokk végrehajtása után leáll (esetünkben ez az <xsl:template match="page"> kezdetű blokk). Ahhoz, hogy további template blokkokat hajthassunk végre a jelenlegi elemen (esetünkben ez az XML <page> tagje), vagy annak gyerekein, az <xsl:apply-templates/> taget kell használni (ennek van egy select="" tulajdonsága, amivel még szűkíthetjük a node-okat, amin szeretnénk végrehajtani transzformációt).

A <post> tagre illeszkedő template-ben látható példa arra, hogy hogyan tudunk egy tulajdonságnak értéket adni ({@url}), hogyan lehet sima szöveget kinyerni az eredeti XML-ből (<xsl:value-of select="name/text()"/>) valamint arra, hogyan lehet egy XML részt egy az egyben átmásolni az eredeti XML-ből (<xsl:copy-of select="content"/>). Hosszasan lehetne magyarázni, hogy akkor most ez hogy is van és egyébként is milyen eszközök állnak még a rendelkezésre, de mivel már születtek erről leírások erre és erre (meg még sok egyéb helyen is biztos), ezért ugorjuk át az unalmas részleteket, és nézzünk valami izgalmasabb dolgot, nevezetesen azt, hogy mire is lehet ezt az XSLT dolgot használni?

Többnyelvűsítés

Hogyan is többnyelvűsítünk olyan adatokat a weboldalon, amik statikusan bele vannak írva a sablonba? Például ez a dolog valahogy úgy történhet meg, hogy van egy (optimális esetben minél rövidebb nevű) függvényünk, ami megkapja paraméterként a szöveget és ha van hozzá az adott nyelven fordítás, akkor megjelenítni, ha nincs, akkor pedig kiírja az eredetileg kapott szöveget (vagy bármi más feltűnő szöveget, hogy szegény fordító lássa, hogy ott még hiány van). A függvény maga meg valószínűleg adatbázisból dolgozik, esetleg az adatbázisból generálódik egy PHP, XML vagy egyéb szöveges formátumú fájl cache-elési szándékkal.

Ha már mindenképpen generálunk mondjuk egy XML fájlt ezekből az adatokból, akkor miért ne lehetne azt csinálni, hogy az XSLT-t segítségül hívva rakjuk be a megfelelő helyre a megfelelő nyelvű szöveget? Nézzük is az új XML fájlunkat:

<?xml version="1.0" encoding="utf-8"?>
<?xml-stylesheet type="text/xsl" href="multilang.xsl"?>
<page lang="hu"/>

A felesleget kiszórtam belőle, mivel valószínűleg az XML-be csak dinamikus adatok kerülnek már a megfelelő nyelven, úgyhogy az a része minket most nem érdekel. Emellett kapott egy extra tulajdonságot a <page> tag (lang="hu"). Szükségünk lesz még egy második XML fájlra, ami az oldal megjelenítéséhez szükséges statikus szövegeket tartalmazza:

<?xml version="1.0" encoding="utf-8"?>
<strings>
    <string id="text-1">Valami szöveg</string>
    <string id="text-2">Valami másik szöveg</string>
</strings>

...és természetesen egy XSL fájlra, a megfelelő kimenet érdekében:

<?xml version="1.0" encoding="utf-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
    <xsl:output method="html" doctype-system="http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd" doctype-public="-//W3C//DTD XHTML 1.0 Strict//EN"/>
    <xsl:variable name="lang" select="/page/@lang"/>
    <xsl:variable name="data" select="document(concat('data_',$lang,'.xml'))"/>
    <xsl:template match="page">
        <html xmlns="http://www.w3.org/1999/xhtml">
            <head>
                <title>XSL teszt</title>
            </head>
            <body>
                <h1><xsl:value-of select="$data/strings/string[@id='text-1']"/></h1>
                <p><xsl:value-of select="$data/strings/string[@id='text-2']"/></p>
            </body>
        </html>
    </xsl:template>
</xsl:stylesheet>

Az előző kódhoz képest lett pár új dolog. Az <xsl:variable> segítségével adhatunk változóknak értéket, amiket később a $változónév formában érhetünk el. Ezen kívül megjelent pár XSL függvény is, a document() és a concat(). A concat() egyszerű string összefűzés, a document() segítségével pedig egy külső XML-t tölthetünk be (így a változón keresztül elérhetjük a benne lévő adatokat).

És a SEO?

Persze, szép dolog szétválasztani a nyers adatokat, a statikus, többnyelvű szöveget a megjelenítéstől, és mintezt kliens oldalon össszerakni, de mit sem ér, ha a keresők nem tudnak vele mit kezdeni. Nem látok bele a keresőrobotok lelki világába, de abból kiindulva, hogy az "armory" szóra a bevezetőben említett oldal amerikai párja jön fel a Google-ben első találatként, arra lehet következtetni, hogy különösebben nem viseli meg őket a dolog. Ha az oldal tárolt változatát is megnézzük, észre lehet venni, hogy a forrásban már az XSL transzformáció utáni állapotot mutatja (és mellesleg a Yahoo!-val és a Live Search-el kapcsolatban is hasonló a helyzet), azaz szerintem az XML+XSLT oldalak (amiknek a kimenete HTML) ugyanúgy viselkednek kereső-optimalizációs szempontból nézve, mint a sima HTML oldalak.

Ennyit mára. Folyt. köv.

]]> http://deadlime.hu/2008/04/03/kliens-oldali-xslt/feed/ 6 A SOAP osztály kiváltása http://deadlime.hu/2006/07/26/a-soap-osztaly-kivaltasa/ http://deadlime.hu/2006/07/26/a-soap-osztaly-kivaltasa/#comments Tue, 25 Jul 2006 22:11:06 +0000 kriz http://deadlime.hu/2006/07/26/a-soap-osztaly-kivaltasa/ Kisebb-nagyobb kihagyás után ismét itt vagyok (vagy talán vagyunk). Egy munka során felmerült problémát, és a hozzá tartozó megoldásomat szeretném most megosztani. Arról már korábban volt szó, hogy hogyan használhatjuk a PHP 5 beépített SOAP osztályát, ha SOAP klienst vagy szervert szeretnénk üzemeltetni. Azonban mi van akkor, ha nem áll rendelkezésre PHP 5? Persze, ott a PEAR, de mivel nekem egyrészről nem volt szükségem a SOAP kliens által nyújtott minden szolgáltatásra és egyébként is inkább előnyben részesítem a saját kódot, ezért elő is bányásztam már porosodó cURL tudásomat, mivel a cURL kiterjesztés nagyban megkönnyíti a HTTP kérések küldését és a válaszok fogadását valamint a PHP 4-es verziójában is elérhető.

A feladat tehát, hogy az MNB SOAP alapú webszolgáltatását használva lekérjük az éppen aktuális árfolyamokat a PHP egy 4.4 feletti verziója segítségével. Az MNB-nél elég programozó-barátak ilyen téren, a http://www.mnb.hu/arfolyamok.asmx címen tulajdonképpen mindent megtudhatunk a szolgáltatás működéséről, kezdve attól, hogy milyen formátumú XML-t várnak tőlünk, addig, hogy milyen formátumút fogunk mi azért cserébe kapni. Természetesen a dolog nem ennyire szép, mivel csak a szabványos SOAP kérés-válasz van leírva, hogy az adatokat magukat milyen formátumban kapjuk, az nincs. Részletkérdés, úgyis látni fogjuk... :)

Mint az a fentebb említett címen kitűnően látható, három függvény áll a rendelkezésünkre, ebből mi csak a középsőt fogjuk használni, mivel az adja vissza az aktuális árfolyamokat. Ha vagyunk olyan bátrak és rá is kattintunk, láthatjuk a kérés és válasz szabványos formáját. Kezdjük is el a kódolást:

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "http://www.mnb.hu/arfolyamok.asmx");
curl_setopt($ch, CURLOPT_HEADER, 0);

Létrehozunk egy cURL kapcsolatot, majd megadjuk neki az URL-t, megmondjuk, hogy nem kérünk header-eket, a könnyebb feldolgozhatóság érdekében. A példa XML header-jében látszik, hogy POST-olnunk kell az adatokat a rendszernek, ezért a következő beállításra is szükségünk lesz:

curl_setopt($ch, CURLOPT_POST, true);

Ennek viszont megvan az a hátránya, hogy az alapértelmezett Content-Type application/x-www-form-urlencoded lesz, a szolgáltatás viszont text/xml-t vár el tőlünk (és ezt nem is felejti el megjegyezni egy hiba formájában ha mégis az előbbivel küldjük neki az adatokat). Így ezt át kell állítanunk, valamint egy saját header-re is szükségünk van (SOAPAction):

curl_setopt($ch, CURLOPT_HTTPHEADER, array(
	'Content-Type: text/xml; charset=utf-8',
	'SOAPAction: "http://www.mnb.hu/webservices/GetCurrentExchangeRates"'
));

Nincs más hátra, mint a megfelelő curl_setopt segítségével a POST adatot hozzácsapni a kérés végére:

curl_setopt($ch, CURLOPT_POSTFIELDS, "<?xml version=\"1.0\" encoding=\"utf-8\"?>
<soap:Envelope xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" xmlns:xsd=\"http://www.w3.org/2001/XMLSchema\" xmlns:soap=\"http://schemas.xmlsoap.org/soap/envelope/\">
	<soap:Body>
		<GetCurrentExchangeRates xmlns=\"http://www.mnb.hu/webservices/\"/>
	</soap:Body>
</soap:Envelope>");

Már csak egy utolsó beállítás, hogy ne rögtön kiírja az eredményt, hanem visszaadja, majd végrehajtjuk a lekérést és lezárjuk a kapcsolatot:

curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$soap_response = curl_exec($ch);
curl_close($ch);

Meg is volnánk. Bár tény, hogy a SOAP osztályt használva fele ennyi kóddal megúsztuk volna és abban már az eredmény kinyerése a SOAP válaszból is meglett volna, de ez legalább működik PHP 4-es környezetben is. Klimatizált szerverszobában gazdag további nyarat Mindenkinek.

]]> http://deadlime.hu/2006/07/26/a-soap-osztaly-kivaltasa/feed/ 0 Yahoo! Search API http://deadlime.hu/2006/05/14/yahoo-search-api/ http://deadlime.hu/2006/05/14/yahoo-search-api/#comments Sun, 14 May 2006 12:42:16 +0000 kriz http://deadlime.hu/2006/05/14/yahoo-search-api/ Miután Polaa belevetette magát a Google API rejtelmeibe, gondoltam megnézem, hogy a konkurens keresővállalatnál mi a helyzet ilyen téren. Természetesen létezik Yahoo! API is. Természetesen arra ne is gondoljunk, hogy a Google által használt megoldást valósították meg Ők is. Miért is tették volna? Tehát az előzőekben átnézett, megszeretett SOAP kódunkat a Yahoo! esetében dobhatjuk a kukába. No de nézzük mire is lesz szükségünk.

Először is, vadásznunk kell magunknak egy application id-t, amit majd minden kéréshez hozzá kell csatolnunk. Ehhez szükségünk lesz egy Yahoo! ID-re is, mert akkor már ugye növeljük a Yahoo! felhasználók táborát. Ha minden megvan, akkor igazából készen is vagyunk és kezdhetünk kódot írni. A kódoláshoz használtam a cURL kiterjesztést, mivel ez nagyban megkönnyíti a dolgunkat, de használhatnánk file_get_contents() függvényt, ha engedélyezve van a php.ini-ben az allow_url_fopen vagy pedig használhatjuk az fsockopen() függvényt is, ha lehetőségünk van rá.

No, csapjunk a lecsóba, nézzünk egy kis kódot, amivel megkaphatjuk egy keresés eredményét XML formátumban:

header('Content-Type: text/xml');

$app_id = 'ide jön az application id';

$service = array(
	'image' => 'http://api.search.yahoo.com/ImageSearchService/V1/imageSearch',
	'local' => 'http://api.local.yahoo.com/LocalSearchService/V1/localSearch',
	'news' => 'http://api.search.yahoo.com/NewsSearchService/V1/newsSearch',
	'video' => 'http://api.search.yahoo.com/VideoSearchService/V1/videoSearch',
	'web' => 'http://api.search.yahoo.com/WebSearchService/V1/webSearch'
);

$conn = curl_init($service['web'].'?appid='.$app_id.'&query=deadlime');
curl_setopt($conn, CURLOPT_HEADER, false);
curl_setopt($conn, CURLOPT_RETURNTRANSFER, true);
$xml = curl_exec($conn);
curl_close($conn);
 
echo $xml;

Mint az látszik, van egy $service tömb, amiben tároljuk a Yahoo! egyes API-jainak az elérési útját. Tulajdonképpen mindenféle PHP nélkül a böngészőben is játszhatnánk ezzel, hogy beírjuk címnek az egyik szolgáltatást és a következő GET paraméterekkel bővítjük a lekérdezést:

appid
Az application id, amit kaptál.
query
A lekérés szövege, érdemes lefuttatni rajta egy urlencode() vagy rawurlencode() függvényt.
zip
Zipcode, csak a Local Search szolgáltatásnál használható.
start
Ezzel lehet megadni, hogy hányadik elemtől mutassa a találatokat.

Nincs más hátra, mint kinyerni az adatokat a kapott XML fájlból, aminek a formátuma a $service['web'] esetén (ezt használtuk a fentebbi PHP példában) a következő:

<ResultSet xsi:schemaLocation="urn:yahoo:srch http://api.search.yahoo.com/WebSearchService/V1/WebSearchResponse.xsd" totalResultsAvailable="" totalResultsReturned="" firstResultPosition="">
	<Result>
		<Title></Title>
		<Summary></Summary>
		<Url></Url>
		<ClickUrl></ClickUrl>
		<ModificationDate></ModificationDate>
		<MimeType></MimeType>
		<Cache>
			<Url></Url>
			<Size></Size>
		</Cache>
	</Result>
</ResultSet>

Nagyjából ennyi lenne a dolog. Mint az jól látszik, nem annyira testreszabható, mint a Google által kínált felület, viszont próbára tehetjük vele az XML értelmezési tudásunkat... :)

]]> http://deadlime.hu/2006/05/14/yahoo-search-api/feed/ 0