أي وسيلة لتوليد WSDL الوثائق من جافادوك مع جاكس-WS?

Question

أنا على أمل أن امتداد من نوع ما هو متاح أن يفعل ذلك (على الرغم من أنني افترض أن أملي هو بحماقة متفائل).

   /**
     * <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

Answer 1

كنت قد ننظر في تعلن.أنه من الممكن استخدام إنه مخضرم المساعد توليد ملفات HTML ثابتة من جافادوك التعليقات.يعمل هذا الصابون (أيجاكس-WS) والباقي (أيجاكس-RS) نقاط.

مثيرة للاهتمام على ما يلي:

• https://github.com/stoicflame/enunciate/wiki/Documentation-Only
• http://raibledesigns.com/rd/entry/my_experience_with_java_rest

إنتاج أمثلة:

• http://www.realtybaron.com/api/
• http://www.agentrank.com/api/
• http://api.setlist.fm/docs/index.html

Answer 2

أنت لست الوحيد الذي يبحث عن وسيلة لتوليد WSDL الوثائق (انظر توليد WSDL الوثائق من جافادوك موضوع) ولكن AFAIK لا يوجد القياسية جاكس-WS طريقة للقيام بذلك.

الآن ربما يكون لديك نظرة على جبوس الملكية الشرح @Documentation ذكر في JBWS-1850 أن يولد jaxws:binding التحف هو موضح في القسم 2.9 جافادوك التخصيص عند استخدام جافا->WSDL النهج أيضا.انها ليست بالضبط ما طلبته ولكن قد تعطيك بعض الأفكار.

في أي حال, أعتقد أن هذا يتطلب توفير الخاصة بك WSDLGeneratorExtension تمديد wsgen وتوليد المطلوب WSDL.

Answer 3

في مشروع واحد نشرنا الكثير من WSDLs. لكل خدمة ويب لدينا يتعرض طريقة WS "getDocumentationURL ()". هذه طريقة تسليم ظهر رابط لجافادوك المتولدة من SEI. كان جافادوك مكان في الخادم الإنترانت للوصول.