أي وسيلة لتوليد WSDL الوثائق من جافادوك مع جاكس-WS?
-
20-09-2019 - |
سؤال
أنا على أمل أن امتداد من نوع ما هو متاح أن يفعل ذلك (على الرغم من أنني افترض أن أملي هو بحماقة متفائل).
/**
* <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
المحلول
كنت قد ننظر في تعلن.أنه من الممكن استخدام إنه مخضرم المساعد توليد ملفات HTML ثابتة من جافادوك التعليقات.يعمل هذا الصابون (أيجاكس-WS) والباقي (أيجاكس-RS) نقاط.
مثيرة للاهتمام على ما يلي:
- https://github.com/stoicflame/enunciate/wiki/Documentation-Only
- http://raibledesigns.com/rd/entry/my_experience_with_java_rest
إنتاج أمثلة:
نصائح أخرى
أنت لست الوحيد الذي يبحث عن وسيلة لتوليد WSDL الوثائق (انظر توليد WSDL الوثائق من جافادوك موضوع) ولكن AFAIK لا يوجد القياسية جاكس-WS طريقة للقيام بذلك.
الآن ربما يكون لديك نظرة على جبوس الملكية الشرح @Documentation
ذكر في JBWS-1850 أن يولد jaxws:binding
التحف هو موضح في القسم 2.9 جافادوك التخصيص عند استخدام جافا->WSDL النهج أيضا.انها ليست بالضبط ما طلبته ولكن قد تعطيك بعض الأفكار.
في أي حال, أعتقد أن هذا يتطلب توفير الخاصة بك WSDLGeneratorExtension
تمديد wsgen
وتوليد المطلوب WSDL.
في مشروع واحد نشرنا الكثير من WSDLs. لكل خدمة ويب لدينا يتعرض طريقة WS "getDocumentationURL ()". هذه طريقة تسليم ظهر رابط لجافادوك المتولدة من SEI. كان جافادوك مكان في الخادم الإنترانت للوصول.