كيفية إنشاء اختصار موثقة باستخدام طنك

Question

طنك لإنشاء مجمع خدمة ويب حول طلبي. يوفر طنك واجهة خدمة ويب وWSDL في وقت التشغيل (أو يخلق لهم في وقت الترجمة، لا أعرف بالضبط).

والعديد من عملائنا لا أعرف خدمات ويب جيدا وبالإضافة إلى ذلك أنهم ببساطة لا تقرأ أي وثائق الخارجية مثل جافادوك. وأنا أعلم أنه من الممكن لإضافة وثائق (لمعلمات وأساليب) مباشرة إلى ملف WSDL.

وفكرت في شروح أو ملفات XML ايجيس ولكن لا أعرف كيف ... هل تعرف الطريقة؟

وتحرير: أنا فقط وجدت هذا قضية جيرة لكن النشاط الماضي 2006. أيه أفكار؟

Answer 1

ويرأس

وطنك ببطء ل/ ديف / لاغية. استخدام CXF بدلا من ذلك. وبعبارة أخرى، يجري إهمال طنك لصالح CXF - انها الى حد كبير نفس المطورين

.

ومنذ استخدام نهج جافا والعشرين، أقترح عليك أن تولد لك اختصار مرة واحدة وإلى الأبد مع أداة java2wsdl CXF، ثم قمت بوضع وثائق في ذلك وأقول CXF استخدام <م> أن WSDL موثقة بدلا السماح CXF توليد خاصة بها (غير موثق) WSDL في وقت التشغيل / نشر الوقت.

هذه الصفحة إلى حد كبير كل ما تحتاج لمعرفته حول إنشاء خدمة على شبكة الإنترنت في CXF.

Answer 2

<اقتباس فقرة>   

وبلدي تلميح الماضي بشأن CXF - استخدام ايجيس لربط البيانات بدلا من JAXB. أنها لا تعمل لPOJO معقدة.

وليس لدينا مشكلة مع POJO معقدة وJAXB في تجربتي، والمشكلة الوحيدة هي أن رمز يبدأ أن تشوش مع JAXBElements. من ناحية أخرى، وثائق ايجيس نادرة جدا، وليس مجموعاتها مع يتعلق CXF.

Answer 3

ودعونا لي أن أضيف بلدي اثنين سنتا فيما يتعلق طنك. كان لدينا قضية خطيرة جدا مع XFie تحت JDK6 (سواء القط 6.0 و 5.5). يرجى اتخاذ نظرة على هذه المسألة . في حالتنا طنك مع 4+ خدمات الويب تحت JDK6 يؤدي إلى شنقا خوادم التطبيقات (المآزق موضوع الخ). انها مثيرة للاهتمام، ولكن تحت JDK5 كان كل شيء جيد.

وأنا أتفق تماما مع المسيحيين الصدرية فيما يتعلق بالهجرة إلى CXF من طنك. له معنى في كثير من الحالات على سبيل المثال ESB البغل 2 لا يدعم الروابط طنك الأم بعد الآن ( انظر أيضا ).

وأود أن أضيف أن الهجرة من طنك لCXF ليس طريقة straitforward (على سبيل المثال CXF ديه الإعتماد جرة التي تتعارض مع بعض الإصدارات السبات <لأ href = "http://cxf.apache.org/docs/xfire-migration -guide.html "يختلط =" نوفولو noreferrer "> انظر أيضا )، لكنها قابلة للتنفيذ. في حالتنا فعلنا ذلك لبضعة أيام دون تصحيح الرمز (الربيع التكوين الوحيد).

وبلدي تلميح الماضي بشأن CXF - استخدام ايجيس لربط البيانات بدلا من JAXB. أنها لا تعمل لPOJO معقدة.