Kuler API für SWX

Insgesamt muss gesagt werden, dass man sich schnell in SWX einarbeiten kann. Die Entwicklerwerkzeuge (SWX Service Explorer und der SWX Data Analyzer) sind nützliche Hilfsmittel beim Erstellen von Anwendungen mit SWX.

Kuler API für SWX

Die Methoden der Kuler-Klasse lauten:

• loadMostPopularFeed()
  Lädt die 20 populärsten Farbschemen.
• loadHighestRatedFeed()
  Lädst die 20 Farbschemen mit der besten Bewertung
• loadNewestColorFeed()
  Lädt die 20 neuesten Farbschemen
• loadFilteredFeed ($filter, $searchQuery)
  Mit dieser Methode lässt sich eine Suche durchführen. Gesucht werden kann nach einem Ausdruck (=$searchQuery) in folgenden Eigenschaften: themeID, userID, email, tag, hex, title (=$filter)
• loadKulerFeedByURL ($feedURL)
  Diese Funktion ist der eigentliche Kern der Klasse und wird von allen vorigen Methoden aufgerufen. Sie lädt den Feed und parst die XML-Datei. Als Ergebnis liefert sie ein Array. Wer möchte, kann diese Funktion auch direkt mit einer Kuler-URL aufrufen.

Verwenden der Kuler-Klasse für SWX

Hinweise: Für das Kennenlernen der generellen Arbeitsweise von SWX empfiehlt sich der Screencast von Aral Balkan. (siehe Archiv)

[as]
swx.gateway = „http://localhost:8888/php/swx.php“;
[/as]

Eine wichtige Anpassung für die Beispiele (.fla) ist die Adresse des SWX-Gateway im ActionScript-Code. In einer lokalen Entwicklungsumgebung (z.B. MAMP) ist dies üblicherweise der localhost. Auf dem Livesystem gibt man die URL des Webspace an.

serviceClass und method

[as]
// Set call details.
var callDetails:Object =
{
serviceClass: „Kuler“,
method: „loadMostPopularFeed“,
args: [„“],
result: [this, resultHandler],
timeout: [this, timeoutHandler],
debug: true
}
[/as]

Als serviceClass trägt man Kuler ein, bei method die gewünschte Methode (siehe oben), args nimmt evtl. nötige Argumente auf (für die Suchfunktion werden Filter und der Suchausdruck benötigt).

resultHandler

Die Antwort von SWX wird über Funktion resultHandler erhalten.

[as]
function resultHandler(event:Object)
{
// Load is complete.
isLoading(false);

// result from service class
myKulerFeed = event.result;
…

[/as]

Als Ergebnis der Anfrage bekommt man von SWX ein Array zurückgeliefert, dass die angeforderten Daten enthält. Da es sich bei SWX um ein natives Datenformat für Flash handelt, kann man nun einfach über die Punktschreibweise die einzelnen Eigenschaften aufrufen. In der eckigen Klammer gibt man für yourItemNumber die Nummer des Datensatzes an, also z.B. 13 für das 14. Kuler-Theme (Zählung beginnt bei 0) .

Das Attribut swatchHexColor ist Array, weshalb man für die fünf Farbwerte einfach ein zusätzliche eckige Klammer hinten anfügt.

[as]
myKulerFeed.themeTitle[yourItemNumber]
myKulerFeed.themeID[yourItemNumber]
myKulerFeed.themeImage[yourItemNumber]
myKulerFeed.link[yourItemNumber]
myKulerFeed.themeTags[yourItemNumber]
myKulerFeed.themeAuthor.authorLabel[yourItemNumber]
myKulerFeed.themeAuthor.authorID[yourItemNumber]
myKulerFeed.themeEditedAt[yourItemNumber]
myKulerFeed.themeCreatedAt[yourItemNumber]
myKulerFeed.themeRating[yourItemNumber]
myKulerFeed.themeDownloadCount[yourItemNumber]
myKulerFeed.themeSwatches.swatch.swatchHexColor[yourItemNumber][0]
myKulerFeed.themeSwatches.swatch.swatchHexColor[yourItemNumber][1]
myKulerFeed.themeSwatches.swatch.swatchHexColor[yourItemNumber][2]
myKulerFeed.themeSwatches.swatch.swatchHexColor[yourItemNumber][3]
myKulerFeed.themeSwatches.swatch.swatchHexColor[yourItemNumber][4]
[/as]

Wie viele Elemente in dem Feed enthalten sind (meist 20), kann man z.B. über myKulerFeed.themeTitle.length abfragen.

Installation

Die Datei Kuler.php muss in das Verzeichnis „php/services“ der SWX Installation kopiert werden. Dort liegen alle Klassen/Services, die über SWX ansprechbar sein sollen.

Beispiele und Download

Anschauen: SWX Kuler Demonstration
Anschauen: SWX Kuler Simple Demo
Download: SWX Kuler Klasse und Beispiele (Flash 8 )

Links

Link: swxformat.org
Link: Kuler API

[ad]