Public Interface: Design Considerations

When you design a Web service, you have to consider two aspects:

  • The public interface to the service, which prescribes how clients can interface with your SOAP node

  • The internal implementation of the node that implements the public interface

Be careful to keep in mind the distinction between the two as you design your service. You do not necessarily want the public interface to directly reflect the internal implementation.

For example, if the Web service is built on top of a legacy system, you might decide to not expose a slightly modified version of the service. Alternatively, you might decide to not make every local service available remotely—for security reasons, for example.

This section is concerned ...

Get Java™ Web Services Unleashed now with the O’Reilly learning platform.

O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.