Zend_Service_StrikeIronZend_Service_StrikeIron bietet einen PHP 5 Clienten zu den Web Services von StrikeIron. Siehe die folgenden Sektionen:
Übersicht» StrikeIron bietet hunderte von kommerziellen Daten Services ("Daten als Service") wie z.B. Online Steuer, Wärungsraten, Aktienwerte, Geocodes, Globale Adresen Prüfung, Yallow/White Pages, MapQuest Fahranleitungen, Dun & Bradstreet Business Credit Prüfungen, und viele, viele mehr. Jedes StrikeIron Web Service bietet eine standard SOAP (und REST) API, welche die Integration und Handhabung mehrerer Services sehr einfach macht. StrikeIron managt auch die Kundenverrechnung für alle Services in einem einzelnen Account, was es für Lösungsanbieter perfekt macht. Man kann mit freien WebServices unter » http://www.strikeiron.com/sdp starten. Die Services von StrikeIron können schon alleine durch die » PHP 5 SOAP Erweiterung verwendet werden. Trotzdem bietet die Verwendung von StrikeIron auf diesem Weg kein ideales PHP-artiges Interface. Die Zend_Service_StrikeIron Componente bietet einen leichtgewichtigen Layer aufbauend auf der SOAP Erweiterung für die Arbeit mit den Services von StrikeIron auf einem bequemeren und PHP-artigeren Weg.
Die Zend_Service_StrikeIron Komponente bietet:
Registrieren mit StrikeIronBevor man mit Zend_Service_StrikeIron beginnen kann, muß man sich zuerst für einen StrikeIron Entwickler Zugang » registrieren. Nach der Registrierung erhält man einen StrikeIron Benutzernamen und ein Passwort. Diese werden Verwendet wenn man sich auf StrikeIron verbindet indem man Zend_Service_StrikeIron verwendet. Man muß sich auch für StrikeIron's Super Data Pack Web Service » anmelden. Beide Schritte der Registrierung sind frei und können relativ schnell mit der WebSeite von StrikeIron durchgeführt werden. BeginnenSobald man sich für einen StrikeIron Account » registriert und für das » Super Data Pack angemeldet hat, ist man für die Benutzung von Zend_Service_StrikeIron bereit. StrikeIron besteht aus hunderten von verschiedenen WebServices. Zend_Service_StrikeIron kann mit vielen dieser Services verwendet werden bietet aber nur für drei von Ihnen unterstützte Wrapper: Die Klasse Zend_Service_StrikeIron bietet einen einfachen Web um die eigenen Account Informationen von StrikeIron und andere Option im Konstruktor zu spezifizieren. Sie bietet auch eine Factory Methode die Clients für StrikeIron Services zurück gibt:
Die getService() Methode gibt einen Client für irgendein StrikeIron Service zurück das durch den Namen seiner PHP Wrapper Klasse definiert wurde. In diesem Fall, referiert der Name 'SalesUseTaxBasic' zu der Wrapper Klasse Zend_Service_StrikeIron_SalesUseTaxBasic. Wrapper sind für drei Services inkludiert und in Bundled Services beschrieben. Die getService() Methode kann auch einen Client für ein StrikeIron Service zurückgeben das bisher keinen PHP Wrapper hat. Das wird in Services durch WSDL verwenden erklärt. Die erste Abfrage durchführenSobald die getService() Methode verwendet wurde um einen Clienten für ein gewünschtes StrikeIron Service zu erhalten, kann dieser Client verwendet werden durch Aufruf seiner Methoden ganz wie jedes andere PHP Objekt.
Im obigen Beispiel wird die getService() Methode verwendet um einen Client zum Verkaufs- & Steuergrundlagen Service zu erhalten. Das Client Objekt wird in $taxBasic gespeichert. Die getTaxRateCanada() Methode wird dann vom Service aus aufgerufen. Ein assoziatives Array wird verwendet um der Methode Schlüssel Parameter anzugeben. Das ist der Weg auf dem alle StrikeIron Methoden aufgerufen werden. Das Ergebnis von getTaxRateCanada() wird in $rateInfo gespeichert und hat Eigenschaften wie province und GST. Viele der Services von StrikeIron sind so einfach wie das obige Beispiel. Siehe mitgelieferte Services für detailierte Informationen zu drei der Services von StrikeIron. Ergebnisse betrachtenWenn man Services von StrikeIron lernt oder versucht fehler zu beheben, ist es oft nützlich das Ergebnis das von einem Methodenaufruf zurückgegeben wird auszugeben. Das Ergebnis wird immer ien Objekt sein das eine Instanz von Zend_Service_StrikeIron_Decorator ist. Das ist ein kleines » Dekorator Objekt das die Ergebnisse des Methoden Aufrufs ummantelt. Der einfachste Weg ein Ergebnis vom Service zu betrachten ist die Verwendung der eingebauten PHP Methode » print_r():
In der obigen Ausgabe sehen wir das der Dekorator ($rateInfo) ein Objekt ummantelt das GetTaxRateCanadaResult heißt, und das Ergebnis des Aufrufes von getTaxRateCanada() ist. Das bedeutet das $rateInfo öffentliche Eigenschaften wie abbreviation, province, und GST hat. Dieser werden z.B. mit $rateInfo->province aufgerufen. Tip
Die Eigenschaften von StrikeIron Ergebnissen beginnen oft mit einem Großbuchstaben wie Foo oder Bar wobei die meisten PHP Objekt Eigenschaften normalerweise mit einem Kleinbuchstaben wie foo oder bar beginnen. Der Dekorator wird diesen Eingriff automatisch durchführen sodas eine Eigenschaft von Foo als foo gelesen werden kann. Wenn man jemals das originale Objekt oder seinen Namen vom Dekorator heraus benötigt können die Methoden getDecoratedObject() und getDecoratedObjectName() verwendet werden. Fehler handhabenDie vorigen Beispiel sind naiv, was bedeutet das keine Handhabung von Fehlern gezeigt wurde. Es ist möglich das StrikeIron einen Fehler zurückgibt während des Aufrufs einer Methode. Selbst fehlerhafte Account Daten oder ein abgelaufener Zugang kann StrikeIron dazu bringen einen Fehler zu werfen. Eine Ausnahme wird geworfen wenn solch ein Fehler auftritt. Man sollte das berücksichtigen und solche Ausnahmen fangen wenn man Methodenaufrufe zu einem Service durchführt:
Die geworfenen Ausnahmen werden immer Zend_Service_StrikeIron_Exception sein. Es ist wichtig die Unterschiede zwischen Ausnahmen und normalen fehlgeschlagenen Methodenaufrufen zu verstehen. Ausnahmen treten für ausgenommene Verhaltenweisen auf, wie z.B. ein Netzwerk das abstürzt oder ein abgelaufener Account. Fehlgeschlagene Methodenaufrufe die häufig auftreten, wie z.B. wenn getTaxRateCanada() die angegebene province nicht findet, führen nicht dazu das Ausnahmen geworfen werden.
Den eigenen Account prüfenStrikeIron bietet viele verschiedene Services. Einige von Ihnen sind kostenlos, eine sind auf einer Testbasis vorhanden, und einige sind nur für zahlende Kunden. Wenn StrikeIron verwendet wird, ist es wichtig auf den Account Status für die Services zu achten die man verwendet und diesen regelmäßig zu prüfen. Jeder StrikeIron Client, der von der getService() Methode zurückgegeben wird, hat die Möglichkeit den Account Status für diesen Service zu prüfen indem die getSubscriptionInfo() Methode dieses Clients verwendet wird:
Die getSubscriptionInfo() Methode gibt ein Objekt zurück, das typischerweise eine remainingHits Eigenschaft hat. Es ist wichtig den Status, für jeden Service der verwendet wird, zu prüfen. Wenn ein Methodenaufruf zu StrikeIron gemacht wird, nachdem die möglichen Zugriffe aufgebraucht wurden, wird eine Ausnahme auftreten. Das Prüfen des Accounts zu einem Service benötigt keinen Zugriff (hit) auf diesen Server. Jedes Mal wenn irgendein Methodenaufruf zu einem Service gemacht wurde, wird die Anzahl der möglichen Zugriffe gecached und dieser gecachete Wert wird durch getSubscriptionInfo() zurückgegeben ohne das noch einmal mit dem Service eine Verbindung aufgebaut werden muß. Um getSubscriptionInfo() dazu zu bringen seinen Cache auszuschalten und die Account Informationen nochmals abzufragen, kann getSubscriptionInfo(true) verwendet werden.
|
|