Reprise du message précédent :

Pour la partie serveur, si tu fais du REST comme un homme, t'es censé savoir comment organiser tes URLs pour qu'elles suivent une logique au sens HTTP. En fait, ta lib coté serveur doit être capable de faire ça à partir d'un jeu de données.
 
J'ai pas parlé de client.

Ouais enfin dans ton serveur tu peux coller tout le dispatching dans les query args c'est REST tout pareil hein.

sur un sujet un poil transverse, j'ai remarqué qu'un certain nombre de WSDL n'incluent pas la javadoc des interfaces à partir desquels ils ont été générés

princesse peach
 
sonic
 
link
 
ca bosse fort au mois d'aout sur velizy

En même temps chuis pas sûr qu'il y ait un format spécifié pour wsdl:documentation, donc tu fais quoi, tu mets de la javadoc quand c'est généré à partir de java, des docs XML quand ça vient de C#, du docutils quand c'est sourcé de C++ et du RST quand ça vient de Python? Et la doc "interne" (Java) et la doc "WSDL" sont pas nécessairement les mêmes non plus.

En C#, les annotations de webservice ont un attribut "Documentation" spécifiquement pour ça:

[WebService(Description="A description of this service..." )]
public class CustomerService : System.Web.Services.WebService
{
    [WebMethod(Description="A description of this operation..." )]
    public string HelloWorld()
    {
        return "Hello World";
    }
}

va sortir

<wsdl:definitions targetNamespace="http://tempuri.org/">
    <wsdl:documentation>A description of this service...</wsdl:documentation>
    ...
    <wsdl:portType name="CustomerServiceSoap">
        <wsdl:operation name="HelloWorld">
            <wsdl:documentation>A description of this operation...</wsdl:documentation>
            <wsdl:input message="tns:HelloWorldSoapIn"/>
            <wsdl:output message="tns:HelloWorldSoapOut"/>
        </wsdl:operation>
    </wsdl:portType>
    ...
</wsdl:definitions>

mais je sais pas si t'as un truc du style dans les générateurs Java. Probablement que oui.

[WebService(Description="A description of this service..." )]
public class CustomerService : System.Web.Services.WebService
{
    [WebMethod(Description="A description of this operation..." )]
    public string HelloWorld()
    {
        return "Hello World";
    }
}

<wsdl:definitions targetNamespace="http://tempuri.org/">
    <wsdl:documentation>A description of this service...</wsdl:documentation>
    ...
    <wsdl:portType name="CustomerServiceSoap">
        <wsdl:operation name="HelloWorld">
            <wsdl:documentation>A description of this operation...</wsdl:documentation>
            <wsdl:input message="tns:HelloWorldSoapIn"/>
            <wsdl:output message="tns:HelloWorldSoapOut"/>
        </wsdl:operation>
    </wsdl:portType>
    ...
</wsdl:definitions>

du plain text au pire, ce que tu peux en fonction de ce que le contexte te donne, mais tu fais le max pour que les utilisateurs aient un max d'info pour faire leur taf.

Je dis pas le contraire, mais dumper la javadoc dans wsdl:documentation ne me semble pas être une très bonne solution. En tout cas pas en comportement par défaut, avec un flag de config à la limite mais bon.

En Java, t'as Enunciate qui est top pour ça (et compatible REST / SOAP pour rester dans le sujet ).
Edit : génère du HTML à côté, la doc est pas dans le WSDL.

au contraire, si tu fais rien t'as la meilleure doc possible sans rien faire, et si tu as une idée précise de ce que tu veux, ben tu te tapes le manuel et tu te fias chier à configurer.

Ouais enfin "la meilleure doc possible sans rien faire" ça reste de la doc de merde, donc si tu fais rien t'as une doc de merde, et si tu veux faire une vraie doc faut des efforts supplémentaires, super

Tu chiffres les deux

une "doc de merde" c'est mieux que pas de doc. Et oui pour avoir une autre doc il faudra faire des efforts pour l'écrire et la formater.

 
Bin clairement avec les devs actuels, c'est SOAP le moins cher

Pas d'accord. Une doc de merde, ça te fait penser qu'il y a une doc utile disponible. Quand t'as pas de doc du tout, au au moins t'es fixé et tu t'attends au pire direct.

Je préfère largement ne pas avoir de doc, au moins je sais immédiatement que j'ai des branques en face.

 
et puis SOAP, c'est une techno tres propre

Hé Ho

SFR m'a coupé le téléphone, mais j'ai le net.    
Mais j'ai besoin de téléphoner là

la javadoc d'une méthode on peut imaginer qu'elle est utile. Et une bonne doc commence par une doc de merde. D'autre part les critères d'une bonne doc sont trop variables d'une personne à l'autre pour que ça vaille le coup de se *bloquer* à attendre qu'elle soit généralement déclarée bonne avant de la mettre en ligne. Ta fais ce que t'as et tu reviens plus tad.

Ah bon on est en aout?  

 
http://www.01net.com/editorial/536 [...] en-france/

Et hop  

bordel de merde, ils viennent d'installer un redmine sur un serveur raz-la gueule pour "partager des fichiers avec un client" bordel de merde, partager des fichiers avec redmine !
 
putain de merde, on est un PHP-shop, on développe un PORTAIL DE PARTAGE DE FICHIERS fondé sur drupal, on a ouvert la technologie sur python, pas sur ruby.
 
À CHAQUE CONNERIE COMME ÇA MON PACTOLE S'EFFRITE UN PEU PLUS ON VA FINIR AVEC LE RENDEMENT SUR CAPITAL D'UNE SSII ET J'AURAI PAS L'AIR CON TIENS !

OUAIS §§§ ET APRES VOUS POURREZ PAS EMBAUCHER §§§

nraynal, je t'ai trouvé une solution pour gagner du temps en transport  

entre ma piaule et mon bureau ? ça passe pas dans le couloir ...

edit : devinez la région, attention y'a pas de piège ...

oui de moi.  
 perso, j'ai installé l'appli kindle gratuite
 

8000€

oui moi aussi mais ça fait bcp pour convaincre des collegues de lire le truc quoi

apres l'avoir lu, pas avant sans savoir si c'est bien, non?

oui, enfin apres l'avoir lu MOI, le probleme c'est de convaincre les bozos de lire un truc dans un format qui les force à installer une appli.

si la version gratuite (pendant 7 jours) est bien. tu achetes la version papier au frais de la boite (ma boite a payé pour rework )

 
et elle a 6 ans

devinez quoi : mon nouveau pc marche toujours pas
 
et un collegue a eut le mauvais PC : il faut faire un échange

depuis le debut de ton histoire de java pas installé, t'as rien foutu?

il code sur papier je crois ...

 
si, j'en encaissé le pognon

Surtout le passage de la Saône (encore que depuis le pont sud ça a du améliorer les choses ...)

Belgique

Je fais du refactoring de code depuis ce matin. Mon code va-t-il refonctionner un jour
1) oui
2) non
3) obiwan ne fait que de la metaprog

(1)

et (3), je fais du metarefactoring