2009-11-17 9 views
18

मुझे उम्मीद है कि किसी प्रकार का विस्तार उपलब्ध है जो ऐसा करता है (हालांकि मुझे लगता है कि मेरी आशा मूर्खतापूर्ण आशावादी है)।जेएडब्ल्यूडब्ल्यू से जेएक्स-डब्ल्यूएस के साथ डब्लूएसडीएल दस्तावेज उत्पन्न करने का कोई तरीका?

/** 
    * <p> 
    * Gets the {@link ResultObject} given the identifier. The following 
    * fields are not available for some users and will contain a null value: 
    * </p> 
    * 
    * <ul> 
    * <li>{@code resultObject.comment}</li> 
    * <li>{@code resultObject.anotherObject.actionById}</li> 
    * <li>{@code resultObject.anotherObject.actionByName}</li> 
    * </ul> 
    * 
    * <p> 
    * The {@code daysInPurgatory} value will be {@code -1} when not 
    * applicable 
    * </p> 
    * 
    * @param requestUser 
    *   the user initiating the request 
    * @param identifier 
    *   the id of the ResultObject 
    * @return the {@link ResultObject} or {@code null} if none exists 
    * @throws SomeException 
    *    if the {@code identifier} is {@code null} 
    */ 
    @WebMethod 
    @WebResult(name = "resultObject") 
    public ResultObject getResultObjectById(
    @WebParam(name = "RequestUser", header = true, partName = "RequestUser") final String requestUser, 
    @WebParam(name = "identifier") final Long identifier) 
    throws SomeException; 

धन्यवाद, LES2

उत्तर

9

आप Enunciate देख सकते हैं। जावाडोक टिप्पणियों से स्थिर HTML फ़ाइलों को उत्पन्न करने के लिए it's Maven plugin का उपयोग करना संभव है। यह एसओएपी (यानी जेएक्स-डब्ल्यूएस) और आरईएसटी (यानी जेएक्स-आरएस) एंडपॉइंट्स के लिए काम करता है।

दिलचस्प पढ़ता है:

उत्पादन उदाहरण:

+0

Enunciate [github] (https://github.com/stoicflame/enunciate/wiki/User-Guide) में स्थानांतरित हो गया है लेकिन कोई भी कम सुंदर मीठा नहीं है! –

7

आप केवल एक ही एक तरह से डबल्यूएसडीएल प्रलेखन उत्पन्न करने के लिए की तलाश में नहीं कर रहे हैं (Generating WSDL documentation from Javadoc धागा देखें) लेकिन, AFAIK, वहाँ है कोई मानक JAX-WS रास्ता ऐसा करने के लिए।

अब, संभव है JBoss मालिकाना एनोटेशन @DocumentationJBWS-1850 कि jaxws:binding कलाकृतियों अनुभाग 2.9 Javadoc Customization में वर्णित उत्पन्न करता है में उल्लेख किया है पर एक नज़र जब जावा> डबल्यूएसडीएल दृष्टिकोण के रूप में अच्छी तरह से उपयोग कर रहा है। यह बिल्कुल ठीक नहीं है कि आपने क्या पूछा लेकिन यह आपको कुछ विचार दे सकता है।

किसी भी मामले में, मुझे लगता है कि wsgen बढ़ाने के लिए इसे WSDLGeneratorExtension प्रदान करने और वांछित WSDL उत्पन्न करने की आवश्यकता होगी।

+0

मैं यह जवाब क्यों स्वीकार नहीं कर सकता? मुझे चेक मार्क नहीं दिख रहा है! – les2

+0

@ एलईएस 2 हुह? खैर, मुझे नहीं पता (और यह मेरे लिए बहुत दुखी है क्योंकि अगर मुझे अच्छी तरह याद है तो इस सवाल पर एक वरदान था :)। शायद मेल [email protected] या समस्या का उल्लेख करने के लिए http://meta.stackoverflow.com पर एक प्रश्न खोलें। –

0

एक परियोजना में हम WSDLs का एक बहुत प्रकाशित किया। प्रत्येक वेब सेवा के लिए हमने एक डब्ल्यूएस विधि "getDocumentationURL()" का खुलासा किया है। यह विधि एसईआई से उत्पन्न जावाडॉक के लिए एक लिंक वापस प्रदान करती है। JavaDoc एक सुलभ इंट्रानेट सर्वर पर था।

 संबंधित मुद्दे

  • कोई संबंधित समस्या नहीं^_^