Bạn đang xem tài liệu về Apigee Edge. Chuyển đến tài liệu về Apigee X. thông tin
Chủ đề này giải thích cách tạo proxy API cho các dịch vụ web dựa trên SOAP. Bạn có thể tạo hai loại proxy SOAP trong Edge. Một lớp tạo giao diện RESTful cho dịch vụ SOAP phần phụ trợ và lớp còn lại thực hiện "chuyển tiếp" thông báo SOAP đến phần phụ trợ. Cả hai kỹ thuật này đều được mô tả trong chủ đề này.
Tạo proxy API RESTful cho một dịch vụ dựa trên SOAP
Phần này giải thích cách tạo proxy API SOAP RESTful bằng tuỳ chọn REST to SOAP to REST (REST sang SOAP sang REST) trong trình hướng dẫn Tạo proxy.
Tổng quan
Tuỳ chọn REST to SOAP to REST (REST sang SOAP sang REST) xử lý WSDL để tạo một proxy API RESTful. Edge xác định từ WSDL các thao tác được hỗ trợ của dịch vụ, tham số đầu vào, v.v. Edge "đoán" phương thức HTTP nào sẽ sử dụng cho mỗi thao tác. Thông thường, Edge sẽ dịch các thao tác thành yêu cầu GET. Loại yêu cầu này có ưu điểm là có thể lưu vào bộ nhớ đệm. Edge cũng thiết lập điểm cuối mục tiêu phụ trợ, có thể khác nhau tuỳ theo thao tác SOAP.
Đối với loại proxy này, Edge sẽ tự động tạo một Thông số kỹ thuật OpenAPI mà bạn có thể dùng để tạo tài liệu API.
Các bước cơ bản
Giới thiệu về proxy cuối cùng
Khi Edge tạo một proxy API dựa trên WSDL, proxy thu được thực sự là một quy trình phức tạp bao gồm các chính sách để chuyển đổi dữ liệu, trích xuất và đặt biến, thao tác với thông báo, v.v. Sau khi bạn tạo một proxy dựa trên WSDL, hãy xem luồng kết quả trong chế độ xem Phát triển của giao diện người dùng quản lý API. Tại đó, bạn có thể xem chính xác những chính sách đã được thêm.
Ví dụ: ở phía yêu cầu, chính sách AssignMessage được dùng để đặt URL mục tiêu. Ở phía phản hồi, các chính sách sẽ thực thi để chuyển đổi phản hồi từ XML sang JSON, trích xuất phần nội dung SOAP của phản hồi vào một biến và đặt thông báo phản hồi. Các chính sách này (và các chính sách khác) được thêm tự động khi bạn tạo proxy.
Quy cách OpenAPI: Để xem Quy cách OpenAPI được tạo tự động cho proxy này, hãy truy cập vào http(s)://[proxy_domain]/[proxy_base_path]/openapi.json. Tuy nhiên, quá trình chuyển đổi không phải lúc nào cũng chính xác vì không phải tất cả quy tắc của giản đồ XML đều có thể được biểu thị trong Thông số kỹ thuật OpenAPI.
Tạo proxy chuyển tiếp đến một dịch vụ dựa trên SOAP
Phần này giải thích cách tạo proxy chuyển tiếp bằng tuỳ chọn Proxy chuyển tiếp trong hộp thoại Tạo proxy mới.
Tổng quan
Tuỳ chọn Proxy truyền qua cho phép bạn tạo một proxy truyền thông báo SOAP trong một yêu cầu đến dịch vụ phụ trợ "không bị ảnh hưởng", giúp bạn dễ dàng tạo proxy cho một dịch vụ web dựa trên SOAP. Ở hậu trường, Edge sẽ tự động xử lý mọi hoạt động chuyển đổi và hoạt động khác trong luồng. Ví dụ: nếu yêu cầu có định dạng JSON, Edge sẽ thực hiện các bước để chuyển đổi yêu cầu đó thành một thông báo SOAP XML hợp lệ với không gian tên chính xác trước khi POST thông báo đó đến dịch vụ. Tương tự, khi dịch vụ trả về phản hồi SOAP dựa trên XML, Edge sẽ dịch phản hồi đó trở lại JSON trước khi trả về cho ứng dụng. Ngoài ra, Edge thiết lập điểm cuối mục tiêu phần phụ trợ, có thể thay đổi theo từng thao tác SOAP.
Mẹo: Bạn nên chọn Truyền qua nếu các thao tác WSDL hỗ trợ nhiều tham số không ràng buộc. Edge dễ dàng dịch WSDL chứa các tham số có giới hạn sang proxy hơn, vì các tham số này là hữu hạn và do đó có thể được biểu thị bằng một tập hợp hữu hạn các tham số truy vấn hoặc biến biểu mẫu.Đối với loại proxy này, Edge lưu trữ WSDL và tạo một luồng trong proxy để cho phép bạn truy cập vào WSDL đó. Địa chỉ đến WSDL do Edge lưu trữ này, http(s)://[proxy_domain]/[proxy_base_path]?wsdl, sẽ trở thành URL điểm cuối dịch vụ mới cho các ứng dụng gọi dịch vụ SOAP thông qua proxy.
Các bước cơ bản
Giới thiệu về proxy cuối cùng
Khi Edge tạo một proxy chuyển tiếp, proxy thu được thực sự là một luồng phức tạp bao gồm các chính sách để chuyển đổi dữ liệu, trích xuất và đặt biến, thao tác với thông báo, v.v. Sau khi bạn tạo proxy chuyển tiếp, hãy xem luồng kết quả trong chế độ xem Phát triển của giao diện người dùng quản lý API. Tại đó, bạn có thể xem chính xác những chính sách đã được thêm.
Ví dụ: hình sau đây cho thấy phần Luồng trước điểm cuối mục tiêu của một proxy chuyển tiếp. Ở phía yêu cầu, chính sách AssignMessage được dùng để đặt URL mục tiêu. Về phía phản hồi, các chính sách sẽ thực thi để chuyển đổi phản hồi từ XML sang JSON, trích xuất phần nội dung SOAP của phản hồi vào một biến và đặt thông báo phản hồi. Các chính sách này (và các chính sách khác) sẽ được tự động thêm khi bạn tạo proxy.
WSDL do Edge lưu trữ: Để xem WSDL do Edge lưu trữ được tạo cho loại proxy này, hãy chuyển đến http(s)://[proxy_domain]/[proxy_base_path]?wsdl.
Phát triển proxy SOAP-to-REST nâng cao
Các phần trước đã đề cập đến việc tạo proxy API SOAP-to-REST bằng trình hướng dẫn proxy API trong Edge. Tuy nhiên, nếu muốn kiểm soát chi tiết hơn đối với quá trình chuyển đổi SOAP sang REST, bạn có thể bỏ qua tính năng tự động hoá do trình hướng dẫn cung cấp và tạo một proxy bằng cách thêm và định cấu hình các chính sách theo cách thủ công để có được hành vi mà bạn muốn. Để biết thêm thông tin, hãy xem Hướng dẫn: Tạo thủ công proxy API SOAP-to-REST trong Apigee Edge.
