Wie erstelle ich einen benutzerdefinierten Medientyp (application / vnd) für einen RESTful Webservice?

Spiele ich mit dem REST jetzt und dachte, dass ich richtig umzusetzen HATEOAS nur, um alle Konzepte Recht.

Dafür will ich, um meine eigene Medien-Typen (application/vnd[...]+xml und application/vnd[...]+json).

Einer ersten Frage: Hat den Medien-Typ zu definieren, der Vertrag zwischen meinem server und client?

Den Medien-Typ zu definieren, meine message-Formate, so muss ich hinzufügen, XML-schema und JSON-schema zu gehen mit den neuen Medien (so, dass die ÜBRIGEN Kunden wissen, was kommt in die Nachrichten und was zurück zu senden).

Ich habe getan, einige der Forschung auf dem web, aber die details, wie man dies tut, fehlen. Funktioniert es nur mit schreiben erschöpfende Spezifikation/Dokumentationen oder gibt es einige technische Schritte, die zu implementieren? (Ich habe nicht die Registrierung bei der IANA kann ich?)

Wie kann eine neu - voll funktionsfähig - application/vnd Medien-Typ erstellt werden? und was tun Sie brauchen zu kümmern, so dass Kunden ordnungsgemäß nutzen können?

InformationsquelleAutor der Frage JohnDoDo | 2013-02-04

  1. 25

    @JohnDoDo

    Eine erste Frage: Hat das media-type definiert den Vertrag zwischen meinem server und client?

    Ja, Medientyp ist ein Teil des Vertrages. Vertrag REST-API ist nicht statisch, im Gegensatz zu SEIFE(z.B. WSDL). Vertrag ist definiert durch die Kombination der zugrunde liegenden Protokolls(z.B. HTTP), - URIs und-Medien-Typen(es ist nicht verboten, mehrere Medien-Typen zusammen). Medien-Typ definiert die Daten-Modell-Verarbeitung Modell -, hypermedia-Steuerelemente(z.B. kommentierte links, Formulare etc...) und die Unterstützung um zusätzliche, anwendungsspezifische Informationen beschrieben, die von link-Beziehungen, element-Namen, ids, Klassennamen etc...

    Den Medien-Typ zu definieren, meine message-Formate, so muss ich hinzufügen, XML-schema und JSON-schema zu gehen mit den neuen Medien (so, dass die ÜBRIGEN Kunden wissen, was kommt in die Nachrichten und was zurück zu senden).

    Müssen Sie nur definieren, generische Schemata, die decken, die Struktur des Dokuments. Sie nicht brauchen, um zu definieren, separate schemas für Nachrichten. Ihre Nachrichten müssen die Füße in die definierte Struktur von Medien-Typ.

    Wie kann eine neu - voll funktionsfähig - application/vnd Medien-Typ erstellt werden? und was tun Sie brauchen zu kümmern, so dass Kunden ordnungsgemäß nutzen können?

    1. Beschreiben(d.h. write-format-Spezifikation);
    2. Registrierung bei IANA: http://www.iana.org/cgi-bin/mediatypes.pl Registrierung Medientyp unter VDN.* Baum dauert fast eine Woche um sich zu registrieren.

    InformationsquelleAutor der Antwort ioseb

  2. 3

    Haben Sie einen Blick auf Ein RESTful Hypermedia-API in Drei Einfachen Schritten

    Ihre Medien-Typ beschreiben soll, die Datentypen aber ich würde es nicht mit einem XML-schema. Wenn Sie ein XML-schema, empfehle ich Ihnen, verwenden Sie einen Lose versioning-Strategiesonst werden Sie finden, müssen Sie einen neuen Medien-Typ jedes mal, wenn Sie wollen, fügen Sie ein neues element oder Attribut.

    InformationsquelleAutor der Antwort Tom Howard

  3. 1

    Macht der Medien-Typ definieren, der Vertrag zwischen meinem server und client?

    Nein, die Medien geben nur den Typ definieren (z.B. Anwendung) und sub-Typ (e.g json -) Daten

    Wie kann eine neu - voll funktionsfähig - application/vnd Medien-Typ erstellt werden? und was tun Sie brauchen zu kümmern, so dass Kunden ordnungsgemäß nutzen können? (http://www.ietf.org/rfc/rfc2046.txt?number=2046)

    Wenn Sie sich entscheiden, erstellen Sie Ihre eigenen benutzerdefinierten Medien-sub-Typ und erwarten, dass es weit verbreitet ist, sollte es registriert die IANA (http://www.iana.org/assignments/media-types).
    Dies ist ein standard-Weg für die Freigabe von out-of-band-Informationen mit potenziellen Kunden.

    InformationsquelleAutor der Antwort subodh

Schreibe einen Kommentar