Cách tiếp cận của bạn để tạo ra một số loại tài liệu có thể đọc được từ con người từ WSDL là gì? Trong quá khứ tôi đã sử dụng WSDL viewer (bởi Tomi Vanek) (xem my blog post about integrating it into NAnt) và tôi hài lòng với kết quả, nhưng tôi quan tâm đến bất kỳ lựa chọn thay thế có thể.Tạo tài liệu HTML từ WSDL
Tôi cũng đã nghe nói về x3sp, nhưng tôi chưa thử.
Tôi đã thử nhiều lựa chọn thay thế
và kết thúc điều chỉnh trình xem WSDL theo nhu cầu của tôi.
Tôi biết đây là phương pháp tài liệu của người nghèo, nhưng tôi đã sử dụng XSD của wsdl trong studio trực quan và thực hiện các bản in có chú thích và mũi tên được thêm vào để rõ ràng và khách hàng của chúng tôi có vẻ thích nó để sử dụng công cụ khác. Bạn cũng có thể không có điều này nhưng có thể sử dụng một phiên bản từ một thuê bao VPC hoặc MSDN miễn phí, tôi cũng đã sử dụng trình soạn thảo lược đồ BizTalk để xem XSD và ghi tài liệu từ đó bằng cách sử dụng snag-it hoặc một ứng dụng chụp màn hình khác. Tôi sẽ thử và sử dụng những gì bạn có!
-Bryan
XMLSpy Altova của không tạo ra tài liệu HTML từ một WSDL ... nhưng nó không phải là miễn phí;)
Bạn có thể sử dụng "wsimport" là một phần của JDK và chạy Javadoc trên các tệp được tạo. Giả sử bạn đã đưa vào các chú thích, nó sẽ đặt chúng như một phần của tài liệu.
Công cụ khác sẽ là Rational Application Developer cho phép bạn nhấp chuột phải và tạo tài liệu HTML có hình ảnh siêu liên kết đẹp.
Sử dụng http://code.google.com/p/wsdl-viewer/ và xsltproc Cygwin của
xsltproc wsdl-viewer.xsl downloaded-wsdl.xml > documetnation.html
trình như một say mê
nó trông giống như sản phẩm khác nhau lúc đầu, nhưng tôi có thể nhìn thấy nó giống như bây giờ :)) –
làm việc tuyệt vời nhưng không đi quá sâu vào XSD nếu một trong những đi kèm với các tập tin bên ngoài. tôi đã phải sử dụng trình xem + lược đồ này cũng như –
Vâng, đó là một hình mới: wsdl2html. Nó tập trung vào yêu cầu/phản hồi và loại bỏ thông tin mà mọi người không quan tâm.
Liên kết này đã chết. – Vaccano
Tôi đã thử sử dụng nhưng tôi không nhận được danh sách đầy đủ các dịch vụ. Chỉ một trong 27 dịch vụ của tôi đã được hiển thị – Lai
Tôi thích sự đơn giản của wsdl2html, điều này giúp việc truyền đạt thông tin cần thiết về một dịch vụ mà không gây nhầm lẫn cho khán giả. Theo tôi, tính năng quan trọng duy nhất còn thiếu là nhận được mô tả/bình luận cho các hoạt động và các yếu tố. – Juanal
Bạn có thể sử dụng iDocIt! để ghi lại một WSDL và xuất ra tài liệu đó thành HTML. Nó là một plugin Eclipse nguồn mở có thể tải về here.
Nó cung cấp một cách tiếp cận mới để tạo tài liệu với lưới chuyên đề và vai trò chuyên đề, nhưng bạn không cần sử dụng chúng. Bạn có thể tạo tài liệu tĩnh dưới dạng văn bản thuần túy.
Tôi vừa phát hiện ra rằng Notepad ++ với plugin Công cụ Xml được cài đặt cũng có thể thực hiện các phép biến đổi xsl. Nếu bạn cung cấp cho nó tệp wsdl-viewer.xsl được đề cập trước đó và tệp wsdl, bạn sẽ nhận được một định dạng html độc đáo.
Nếu bạn sử dụng Eclipse với các tính năng EE, nó cho phép bạn xử lý tệp XSLT bằng cách nhấp chuột phải vào tệp đó và chọn Chạy. – Juanal
Bây giờ, có thêm một công cụ cho việc này, được gọi là "DocFlex/XML WSDLDoc".
Đây là trình tạo tài liệu WSDL/XSD mới cho phép bạn ghi lại bất kỳ số lượng tệp WSDL và XML schema (XSD) nào cùng với bất kỳ kết nối nào giữa chúng.
Ngoài ra còn có một tùy chọn để tự động đưa vào sơ đồ XSD được tạo bởi Altova XMLSpy hoặc Oxygen XML. Hiệu quả, bất kỳ trong số chúng có thể được sử dụng như động cơ sơ đồ liên kết động.
KEY FEATURES
<wsdl:definitons>/<wsdl:types> yếu tố)<wsdl:import>, <xs:import>, <xs:include>, <xs:redefine> được tìm thấy trên tất cả các tệp WSDL/XSD có liên quan.VÍ DỤ
Đây là một bản demo của tài liệu đó (nó được tạo ra bởi một tập tin nguồn duy nhất: http://developer.ebay.com/webservices/latest/ebaySvc.wsdl):
HTML riêng của mình: http://www.filigris.com/docflex-xml/wsdldoc/examples/html/ebaySvc/index.html
LIÊN KẾT
Tôi đã sử dụng sản phẩm XML doc trong một thời gian và tôi hoàn toàn hài lòng về chất lượng sản phẩm .... quá tệ đến mức công ty của tôi không có ngân sách để mua một số giấy phép, nhưng tôi rất vui khi mua một sản phẩm cho bản thân mình ... – PierluigiVernetto
Có vẻ như sản phẩm thương mại, yêu cầu giấy phép cho đầy đủ chức năng –
Nó không được liệt kê ở đây, nhưng SoapUI có một máy phát tài liệu wsdl hữu ích.
Nhấp chuột phải vào dự án của bạn và chọn "Tạo tài liệu".
Phiên bản hiện tại của TechWriter cho Dịch vụ Web cũng hỗ trợ đầu ra HTML trang đơn. –
Điều tương tự ở đây. tôi đã đi xem wsdl. soapui pro sử dụng nó quá haha –
TechWriter đã được gỡ bỏ ... một số có thể chia sẻ một số giấy phép? – willyMon