Webservice Contract first

[Generic1]

Hallo,

es wird ja empfohlen, Webservices nach dem Contract First- Prinzip zu erzeugen. Ich hab mir jetzt ein paar WSDL's angesehen und weiß jetzt nicht so recht, wie ich so eine WSDL schreiben soll da braucht man ja soviel wissen !?

Meine Frage wäre jetzt, wie macht man das, muss man die WSDL wirklich herunterschreiben können oder gibt es da Unterstützung durch Eclipse?
lg
Generic

 

[Noctarius]

Ich würde ein XSD schreiben und den WebService per Spring und CXF aufbauen und damit das WSDL automatisch erstellen lassen.

 

[Generic1]

Also wenn ich mir das Schema unten anschau, so ein XSD muss ich mir dann selber schreiben?
Das ist ja auch nicht so ohne, würd ich mal sagen!?

Aber theoretisch, wenn ich dann die Schema hätte, könnte ich mir mit Spring die WSDL erzeugen, hab ich das richtig verstanden.
Hättest du da einen Link wie man das mit Spring macht, ist das viel Aufwand?

Ich brauche z.B. eine WSDL für einen Login, d.h. die Methode beim WebService heißt

public Login login(String username, String password)

, weiß vielleicht jemand, wie man da den "XSD- ComplexType" für die Klasse Login macht bzw. wie da die WSDL ausschaut.

Vielen Dank,
lg

[XML]
<?xml version="1.0" encoding="UTF-8"?>
<schema xmlns="http://www.w3.org/2001/XMLSchema" xmlns:tns="http://my.url.com/scm/v1/types/user" xmlns:xsd="http://www.w3.org/2001/XMLSchema" attributeFormDefault="unqualified" elementFormDefault="qualified" targetNamespace="http://my.url.com/scm/v1/types/user">

<xsd:complexType name="userBean">
<xsd:sequence>
<xsd:element name="id" type="xsd:int"/>
<xsd:element name="name" type="xsd:string"/>
<xsd:element minOccurs="0" name="description" type="xsd:string"/>
<xsd:element name="password" type="xsd:string"/>
<xsd:element minOccurs="0" name="userGroup" type="tns:userGroupBean"/>
</xsd:sequence>
</xsd:complexType>

<xsd:complexType final="#all" name="userBeanArray">
<xsd:sequence>
<xsd:element maxOccurs="unbounded" minOccurs="0" name="item" nillable="true" type="tns:userBean"/>
</xsd:sequence>
</xsd:complexType>

<xsd:complexType name="userGroupBean">
<xsd:sequence>
<xsd:element name="id" type="xsd:int"/>
<xsd:element name="name" type="xsd:string"/>
<xsd:element minOccurs="0" name="description" type="xsd:string"/>
<xsd:element minOccurs="0" name="parentGroup" type="tns:userGroupBean"/>
</xsd:sequence>
</xsd:complexType>
</schema>
[/XML]

 

[Noctarius]

Was wir in der Firma im Prinzip machen ist per JAXB aus dem XSD die Java-Klassen erstellen lassen und diese dann nutzen (Apache CXF Tutorial - Building JAX-WS, JAXB and JPA-based web service with Apache CXF, Spring and Hyperjaxb3 - Confluence - nicht sonn ganz tolles Tutorial, hab aber gerade kein anderes gefunden). Das WSDL lassen wir von Spring erstellen (Now in SVN: dynamically create WSDL based on XSD - Spring Community Forums)

Alternativ geht es auch mit Java pur:
Tutorial: SOAP over HTTP Webservice mit Apache CXF (Java First Development)

 

[Generic1]

Also was ich mal brauche sind die XSD's. Da werd ich nicht trum rumkommen, dass ich mich intensiv mit den XSD's befasse, oder gibts da auch ein tool? (Das oben ist nur ein Beispiel von unserer Applikation)

Weiß vielleicht jemand als Beispiel, wie man eine XSD sxhreibt für folgende Klasse:

public class Login {
   
    private String message;
    private String decision;

   getter und setter

das müsste dann ja irgendwie so aussehen:

[XML]
<xsd:complexType name="loginBean">
<xsd:sequence>
<xsd:element minOccurs="1" name="message" type="xsd:string"/>
<xsd:element minOccurs="1" name="decision" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>

[/XML]

Könnte man die XSD so machen?
Das würd ich nämlich hinbekommen, glaub ich, was ich aber nicht versteh ist, wie die XSD's in die WSDL einbezogen werden:


[XML]
<types>
<xsd:schema targetNamespace="http://my.url.com/scm/v1/services/softwarepackageservice/parameters">
<xsd:import namespace="http://my.url.com/scm/v1/types/exceptions" schemaLocation="MyXSD1.xsd"/>
<xsd:import namespace="http://my.url.com/scm/v1/types/exceptions/services" schemaLocation="MyXSD2.xsd"/>
...
[/XML]

Wo nehm ich da die URLs her, z.B.: http://my.url.com/scm/v1/services/softwarepackageservice/parameters, kann ich mir das aussuchen bzw. mit welchen konsequenzen, wird dann bei der codegenerierung ein Package mit diesem Namen erstellt?

Vielen Dank
lg und schöne Weihnachten.
Generic

 

[Noctarius]

Ja Eclipse hat einen recht brauchbaren XSD Editor, ansonsten XML Editor, kostet allerdings auch in der Personal Version 64€.

PS: Bei dem reinen Codeansatz brauchst du kein XSD, da wird das WSDL automatisch aus deiner Service-Klasse erstellt.

 

[Generic1]

Beim Code- Ansatz ists mir klar aber ich möchte den Contract First Ansatz machen.
Weißt du wie man die URLs definiert z.B.: bei

[XML]
<types>
<xsd:schema targetNamespace="http://my.url.com/scm/v1/services/softwarepackageservice/parameters">
<xsd:import namespace="http://my.url.com/scm/v1/types/exceptions" schemaLocation="MyXSD1.xsd"/>
<xsd:import namespace="http://my.url.com/scm/v1/types/exceptions/services" schemaLocation="MyXSD2.xsd"/>
...
[/XML]

und ob die obere XSD passt für die Login- Klasse?
lg und Danke,
Generic1

 

[eRaaaa]

Chapter3.Writing Contract-First Web Services
könnte dir evtl. auch weiterhelfen ???:L

 

[Noctarius]

Chapter3.Writing Contract-First Web Services
könnte dir evtl. auch weiterhelfen ???:L

Sehr schön, den hatte ich gesucht 😀

Die Imports müssen die TargetNamespaces beinhalten und auch erreichbar sein. Das heißt: Der Parser muss den TNS auflösen und das passende Schema-File lesen können.

Js das Schema sollte so zur Loginklasse passen. Du solltest dir aber direkt angewöhnen die Häufigkeitsbeschränkungen für Vorkommen von Tags anzugeben. Hier eine hübsche kleine Erklärung von XSD http://www.informatik.uni-mainz.de/lehre/wt/download/vortrag_06/Ausarbeitung.pdf