Zend_Service_NirvanixEinführungNirvanix bietet ein Internet Media File System (IMFS), einen Internet Speicher Service der es Anwendungen erlaubt Dateien hochzuladen, zu speichern, zu organisieren und nachhaltig auf Sie zuzugreifen durch Verwendung eines Standard Web Service Interfaces. Ein IMFS ist ein verteiltes geclustertes Dateisystem, auf das über das Internet zugegriffen wird, und das für die Handhabung mit Mediendateien (Audio, Video, usw.) optimiert ist. Das Ziel eines IMFA ist es massive Skalarität zu bieten um den Problemen des Wachstums der Medienspeicher Herr zu werden, mit garantiertem Zugriff und Erreichbarkeit unabhängig von Zeit und Ort. Letztendlich, gibt eine IMFS Anwendung die Möglichkeit auf Daten sicher zuzugreifen, ohne die großen Fixkosten die mit der Beschaffung und Einrichtung von physikalischen Speicherbänken verbunden sind. Registrierung bei NirvanixBevor man mit Zend_Service_Nirvanix beginnt, muß man sich zuerst für einen Account anmelden. Bitte sehen Sie auf die » Wie man anfängt Seite auf der Nirvanix Webseite für weitere Informationen. Nach der Registrierung erhält man einen Benutzernamen, ein Passwort und einen Anwendungsschlüssel. Alle drei werden benötigt um Zend_Service_Nirvanix zu verwenden. API DokumentationDer Zugriff auf Nirvanix IMFS ist durch beide, sowohl ein SOAP als auch ein schnelleres REST Service möglich. Zend_Service_Nirvanix bietet einen relativ dünnen PHP 5 Wrapper um das REST Service. Zend_Service_Nirvanix zielt darauf ab das Nirvanix REST Service einfacher zu verwenden aber zu verstehen dass das Service selbst trotzdem noch essentiell ist um mit Nirvanix erfolgreich zu sein. Die » Nirvanix API Dokumentation bietet eine Übersicht sowie detailierte Informationen über die Verwendung des Services. Bitte machen Sie sich mit diesem Dokument vertraut und referieren Sie darauf wenn Sie Zend_Service_Nirvanix verwenden. FeaturesNirvanix's REST Service kann mit PHP effektiv verwendet werden alleine mit Hilfe der » SimpleXML Erweiterung und Zend_Http_Client. Trotzdem ist deren Verwendung auf diesem Weg irgendwie unbequem wegen der wiederholenden Operationen, wie die Übergabe des Session Tokens bei jeder Anfrage und der wiederholten Prüfung des Antwort Bodys nach Fehlercodes. Zend_Service_Nirvanix bietet die folgenden Funktionalitäten:
Der AnfangSobald man in Nirvanix registriert ist, ist man bereit die ersten Datein am IMFS zu speichern. Die üblichste Operation die man am IMFS benötigt ist der Erstellung einer neuen Datei, das Herunterladen bestehender Dateien, und das Löschen einer Datei. Zend_Service_Nirvanix bietet bequeme Methoden für diese drei Operationen.
Der erste Schritt um Zend_Service_Nirvanix zu verwenden ist immer sich gegenüber dem Service zu authentifizieren. Das wird durch die Übergabe der Anmeldedaten an den Kontruktor von Zend_Service_Nirvanix, wie oben, gemacht. Das assoziative Array wurd direkt an Nirvanix als POST Parameter übergeben. Nirvanix teilt seine WebService in » Namespaces auf. Jeder Namespace kapselt eine Gruppe von zusammengehörenden Operationen. Nachdem man eine Instanz von Zend_Service_Nirvanix erhalten hat, muß die getService() Methode aufgerufen werden um einen Proxy für den Namespace zu erhalten den man verwenden will. Oben wird ein Proxy für den IMFS Namespace erstellt. Nachdem man den Proxy für den Namespace hat den man verwenden will, muß die Methode auf Ihm aufgerufen werden. Der Proxy erlaubt es jedes Kommando zu verwenden das in der REST API vorhanden ist. Der Proxy kann auch bequeme Methoden verfügbar machen, welche Kommandos des Web Services wrappen. Das obige Beispiel zeigt die Verwendung der bequemen IMFS Methoden um eine neue Datei zu erstellen, sie zu empfangen, diese Datei anzuzeigen und letztendlich die Datei zu löschen. Den Proxy verstehenIm vorherigen Beispiel wurde die getService() Methode verwendet um ein Proxy Objekt zum IMFS Namespace zurückzugeben. Das Proxy Objekt erlaubt es das Nirvanix REST Service in einer Art zu verwenden die näher daran ist wie normalerweise ein PHP Methodenaufruf durchgeführt wird, gegenüber der Erstellung von eigenen HTTP Anfrage Objekten. Ein Proxy Objekt kann bequeme Methoden enthalten. Das sind Methoden die Zend_Service_Nirvanix bietet um die Verwendung der Nirvanix Web Services zu vereinfachen. Im vorigen Beispiel haben die Methoden putContents(), getContents(), und unlink() keine direkte Entsprechungen in der REST API. Das sind bequeme Methoden die von Zend_Service_Nirvanix angeboten werden um viel komplexere Operationen der REST API zu abstrahieren. Für alle anderen Methodenaufrufe zum Proxy Objekt konvertiert der Proxy dynamisch den Methodenaufruf in die entsprechende HTTP POST Anfrage zur REST API. Hierbei wird der Name der Methode als API Kommando verwendet, und ein assoziatives Array im ersten Argument als POST Parameter. Nehmen wir an das wir die REST API Methode » RenameFile aufrufen wollen welche keine bequeme Methode in Zend_Service_Nirvanix besitzen: Oben wird ein Proxy für den IMFS erstellt. Eine Methode, renameFile(), wird dann vom Proxy aufgerufen. Diese Methode existiert nicht als bequeme Methode im PHP Code, deswegen wird Sie durch __call() gefangen und in eine POST Anfrage für die REST API umgewandelt wo das assoziative Array als POST Parameter verwendet wird.
Es ist in der Nirvanix API Dokumentation zu beachten das
Das Ergebnis dieser Operation ist entweder ein Zend_Service_Nirvanix_Response Objekt welches das von Nirvanix zurückgegebene XML wrappt, oder Zend_Service_Nirvanix_Exception wenn ein Fehler aufgetreten ist. Ergebnisse erkunden
Die Nirvanix REST API gibt Ihre Ergebnisse immer in einem
XML zurück. Zend_Service_Nirvanix parst dieses
XML mit der Der einfachste Weg ein Ergebnis vom service zu betrachten ist die Verwendung der in PHP eingebauten Funktionen wie print_r():
Auf jede Eigenschaft oder Methode des dekorierten
Die üblichste Antwort von Nirvanix ist Erfolg ( Fehler behandelnWenn Nirvanix verwendet wird, ist es wichtig Fehler zu vermeiden die vom Service zurückgegeben werden können und diese entsprechend zu behandeln.
Alle Operationen gegenüber dem REST Service ergeben einen XML
RückgabePayload der ein
Wenn
Um die Notwendigkeit zu verringern immer zu Prüfen ob
im obigen Beispiel ist unlink() eine bequeme Methode die das
Die » Nirvanix
API Dokumentation beschreibt die mit jedem Kommando
assoziierten Fehler. Abhängig von den eigenen Bedürfnissen kann jedes Kommando in einen
|
|