1. Diese Seite verwendet Cookies. Wenn du dich weiterhin auf dieser Seite aufhältst, akzeptierst du unseren Einsatz von Cookies. Weitere Informationen

Restful Lib Dokumentieren

Dieses Thema im Forum "Enterprise Java (JEE, J2EE, Spring & Co.)" wurde erstellt von Fasibio, 4. Dezember 2015.

  1. Fasibio

    Fasibio Mitglied

    Hallo,
    ich entwickle gerade etwas mit Restful.
    Dabei habe ich vor mich Streng an die Regeln zu halte.
    Heißt:
    Ich nutze GET, PUT,POST,DELTE . --> Macht die Sache erstmal undurchsichtig, wenn man von außen auf solch einen API schaurt.
    Deshalb würde ich diese API auch gerne Dokumentieren.
    Leider bietet Restful anscheinden keine Möglichkeit die "Rest"-Klassen/Methoden zu dokumentieren.
    Könnt ihr mich aufklären?
    Dokumentiert ihr eure Restful APIs nur von Hand oder nutzt ihr Tools die, die Kommentare der Klassen und Methoden erkennen und den Aufbau der Benötigten Anfrage z.B.: bei POST mit variabeln Dokumentieren.
    Ein Beispiel :

    URL Anfrage : http://url.de/restapi/mitarbeiter

    Dokumentation:
    GET: mitarbeiter/{id} --> Liefert die den Mitarbeiter mit der ensprechenden ID zurueck wenn # werden alle zureuckgeliefert

    PUT: mitarbeiter --> Legt einen neuen Mitarbeiter an oder updatet ihn (Wenn ID mit übergeben wird).
    Parameter: id, name, alter, tel

    So in der Art meinte ich das...

    Gibt es da etwas das mir sowas anfertigt. Like Javadoc nur für Restful
     
  2. Fasibio

    Fasibio Mitglied

    Ist meine Frage unklar ? Oder weiß keiner eine Antwort darauf ?
     
  3. Fasibio

    Fasibio Mitglied

    So habe mir jetzt mal vorrübergehend mit folgendem Code beholfen...

    Code (Java):
    1. private void outPutInfos(Class<?> c){
    2. Resource resource = Resource.from(c);
    3. if (resource != null){
    4. out("");
    5. out("------------------------------------------------------Class: "+resource.getName()+"------------------------------------------------------");
    6. outPutInfos("/rest",resource);
    7. out("-----------------------------------------------------------------------------------------------------------------------------------------");
    8. out("");
    9. }else{
    10. out("Can´t find restful Resource from "+ c);
    11. }
    12. }
    13. String result = "";
    14. private void out(String text){
    15. System.out.println(text);
    16. result +=text +"\r\n";
    17. }
    18. private void outPutInfos(String parentpath, Resource r){
    19. out(parentpath+r.getPath()+":");
    20. String path = r.getPath();
    21. for (ResourceMethod one: r.getAllMethods()){
    22. out("\t--------------------------------------------");
    23. out("\tHTTP Method: "+one.getHttpMethod());
    24. out("\tJava Method: "+Modifier.toString(one.getInvocable().getDefinitionMethod().getModifiers())+" "+one.getInvocable().getDefinitionMethod().getReturnType() +" "+ one.getInvocable().getDefinitionMethod().getName()+"");
    25. for (Parameter oneparam : one.getInvocable().getParameters()){
    26. if (oneparam.getSourceName() != null){
    27. out("\tParameter:"+oneparam.getType()+" "+oneparam.getSourceName());
    28. }else{
    29. out("\tParameter:"+oneparam.getType());
    30. }
    31. }
    32. if (one.getProducedTypes().size() != 0){
    33. out("\tproduct Types: "+one.getProducedTypes());
    34. }
    35. if (one.getConsumedTypes().size()!= 0){
    36. out("\tconsumed Types: "+one.getConsumedTypes());
    37. }
    38. out("\tManual Description:");
    39. out("");
    40. }
    41. for (Resource one : r.getChildResources()){
    42. outPutInfos(parentpath+r.getPath(),one);
    43. }
    44. }
    gibt etwas aus das jede einzelne Funktion einer Jeden Übergebenen Restfulklasse schematisch beschreibt.
    Leider fehlen die händischen Kommentare die Killt ja leider der Compiler...
     
Die Seite wird geladen...