Microservices Expo Authors: Liz McMillan, Pat Romanski, Carmen Gonzalez, Elizabeth White, Jason Bloomberg

Related Topics: Microservices Expo

Microservices Expo: Article

Web Services Soup to Nuts

Simplified Web services development using visual tools

When you set out to develop a new Web service, do you start banging out angle brackets right off the bat, or do you sketch out the logic of your service first? For most engineers, the graphical approach to implementing business logic is much more accessible. Only after a picture is created does the complexity of translating it into code come into play.

Though Web services are intended to simplify communications, developing them manually can be anything but simple. Altova has added visual Web services development and implementation capabilities to two of its most popular products, giving developers the ability to build a Web service from start to finish without becoming mired in manual code writing.

Altova provides support for developing all XML-related technologies, including Web services, in its XML Suite. By using these tools, developers can design and implement a Web service using a purely graphical approach. This article discusses this visual Web services design and implementation process and how it removes much of the complexity associated with Web services development.

Graphical WSDL Creation and Editing
Best practices dictate that designing the WSDL should be the first step in architecting Web services. By building the WSDL that will act as the Web services interface first, client and server programmers can implement their respective programming contract for accessing the service using any language or operating system, since WSDL is standards-based and programming language-neutral. That means a Web services client application can talk to a server application running on a different platform without interoperability issues. This built-in interoperability also means that the service can be reused easily. Unfortunately, given the complexity of WSDL and WSDL development, this design step is often overlooked or undertaken only as an afterthought.

Altova XMLSpy 2006 is an XML development environment that includes a graphical WSDL editor that removes much of the complexity associated with WSDL development by enabling a completely visual process. Instead of working solely with a text view, developers can build their WSDL files graphically, with full validation and editing help. This removes the complexity barrier to the design-before-implementation development approach.

The XMLSpy graphical WSDL editor in Figure 1 supports creating, editing, visualizing, and validating any WSDL file. It displays the WSDL file structure as well as the WSDL elements grouped by operations, portTypes, bindings, and services. You can manipulate the file by dragging and dropping elements, and context-sensitive windows and entry helpers provide useful editing options.

When you create a new WSDL file from scratch, XMLSpy presents you with a graphical representation that consists of a box for each type of WSDL element: operations, portTypes, bindings, and services. This visual representation allows you to easily see the structure of the WSDL and edit each portion in a logical way. Since the "skeleton" WSDL structure has already been created, you can edit each portion separately in any order - whatever makes the most sense to you. In general, to create a WSDL, the following must be completed:

  • Name the service
  • Associate ports with the service
  • Associate a binding name, type, and location for each port
  • Add operations in the operations component
  • Name each operation, then add input, output, and/or fault elements
  • Validate the WSDL file and correct any validation errors
There are several options and helpful features available in XMLSpy for completing these steps, as described below.

To the right of the design window, the overview window reveals the structure of the WSDL document. It displays the components of the WSDL file in a tree view in the sequence in which they appear in the code. You can expand and collapse components to reveal and hide subcomponents. Selecting a component in the overview window or from within the design itself displays that component and its properties in the details window, for example, the name, binding, and location of each port. These entries are editable by hand or by using context-sensitive drop-down menus.

The graphical WSDL display helps you immediately understand the relationships between the different components in the file and add new elements in a straightforward way. The operations component of the design window lists all of the operations in the WSDL, and each is connected to its respective port type with a color-coded line. Expanding any operation displays its input and output components, and a context-sensitive right-click menu lets you append, insert, or delete operations (Figure 2), as well as add input and output messages to any operation. To associate a port type with an operation, simply drag the operation to the desired port - the same is true for binding and services associations.

In addition to the colored links, clicking any port type in the port type component highlights all associated operations in the operations component and in the overview window. Each port type is also linked to the associated binding with the same color-coded line, and bindings are linked to their respective services in the services component. At a glance, you can tell which operations are associated with which port types, bindings, and services, and you can adjust these associations by dragging and dropping elements.

Selecting a binding lets you view or edit all relevant parameters in the details window:

  • The name attribute
  • The type attribute, which refers to the specific port type
  • The type of binding: SOAP, http/GET, http/POST
  • The transport URI, which defines the transport URI
  • The style attribute: RPC or document
You can also add, edit, and delete these connections using drag-and-drop and context-sensitive menus (right click, tool bar, or drop down - whichever you prefer).

In addition to the visual WSDL design view, XMLSpy also includes a graphical XML Schema editor. This means you can switch to and edit any schemas referenced or imported in the WSDL very easily, using a similar visual paradigm.

While you're working in the graphical view, the corresponding XML markup is built behind the scenes and is available under XMLSpy's text view tab, and you can, of course, edit the text directly in that view (Figure 3).

One last note about XMLSpy is that it also includes a WSDL documentation generator that will output documentation for any standards-conformant WSDL file. Documentation can be in HTML or Microsoft Word and is useful for giving business partners, other developers, or customers a detailed overview of the Web service interface. This feature is also useful for understanding WSDL files that are generated by other platforms.

Overall, designing WSDL using a graphical paradigm makes WSDL development more accessible and productive, which in turn makes the Web services implementation phase more straightforward.

Visual Web Services Implementation
Once a WSDL is defined, implementing the Web service that it describes involves writing the code to access the data required for each transaction. Given that even simple Web services can require thousands of lines of code, this process quickly snowballs. Altova MapForce 2006 adopts the same visual design strategy used in the XMLSpy WSDL design view for building Web services.

More Stories By Erin Cavanaugh

Erin Cavanaugh is product marketing manager for Altova (www.altova.com), creator of XMLSpy and other leading XML, data management, UML, and Web services tools. In this role, Erin manages Altova's XML-related line of tools. She has held product marketing, training, and technical copywriting roles at a variety of hardware and software firms.

Comments (1)

Share your thoughts on this story.

Add your comment
You must be signed in to add a comment. Sign-in | Register

In accordance with our Comment Policy, we encourage comments that are on topic, relevant and to-the-point. We will remove comments that include profanity, personal attacks, racial slurs, threats of violence, or other inappropriate material that violates our Terms and Conditions, and will block users who make repeated violations. We ask all readers to expect diversity of opinion and to treat one another with dignity and respect.

Microservices Articles
Modern software design has fundamentally changed how we manage applications, causing many to turn to containers as the new virtual machine for resource management. As container adoption grows beyond stateless applications to stateful workloads, the need for persistent storage is foundational - something customers routinely cite as a top pain point. In his session at @DevOpsSummit at 21st Cloud Expo, Bill Borsari, Head of Systems Engineering at Datera, explored how organizations can reap the bene...
"NetApp's vision is how we help organizations manage data - delivering the right data in the right place, in the right time, to the people who need it, and doing it agnostic to what the platform is," explained Josh Atwell, Developer Advocate for NetApp, in this SYS-CON.tv interview at 20th Cloud Expo, held June 6-8, 2017, at the Javits Center in New York City, NY.
The Jevons Paradox suggests that when technological advances increase efficiency of a resource, it results in an overall increase in consumption. Writing on the increased use of coal as a result of technological improvements, 19th-century economist William Stanley Jevons found that these improvements led to the development of new ways to utilize coal. In his session at 19th Cloud Expo, Mark Thiele, Chief Strategy Officer for Apcera, compared the Jevons Paradox to modern-day enterprise IT, examin...
In his session at 20th Cloud Expo, Mike Johnston, an infrastructure engineer at Supergiant.io, discussed how to use Kubernetes to set up a SaaS infrastructure for your business. Mike Johnston is an infrastructure engineer at Supergiant.io with over 12 years of experience designing, deploying, and maintaining server and workstation infrastructure at all scales. He has experience with brick and mortar data centers as well as cloud providers like Digital Ocean, Amazon Web Services, and Rackspace. H...
Skeuomorphism usually means retaining existing design cues in something new that doesn’t actually need them. However, the concept of skeuomorphism can be thought of as relating more broadly to applying existing patterns to new technologies that, in fact, cry out for new approaches. In his session at DevOps Summit, Gordon Haff, Senior Cloud Strategy Marketing and Evangelism Manager at Red Hat, will discuss why containers should be paired with new architectural practices such as microservices ra...
In his session at 20th Cloud Expo, Scott Davis, CTO of Embotics, discussed how automation can provide the dynamic management required to cost-effectively deliver microservices and container solutions at scale. He also discussed how flexible automation is the key to effectively bridging and seamlessly coordinating both IT and developer needs for component orchestration across disparate clouds – an increasingly important requirement at today’s multi-cloud enterprise.
The Software Defined Data Center (SDDC), which enables organizations to seamlessly run in a hybrid cloud model (public + private cloud), is here to stay. IDC estimates that the software-defined networking market will be valued at $3.7 billion by 2016. Security is a key component and benefit of the SDDC, and offers an opportunity to build security 'from the ground up' and weave it into the environment from day one. In his session at 16th Cloud Expo, Reuven Harrison, CTO and Co-Founder of Tufin, ...
DevOps is often described as a combination of technology and culture. Without both, DevOps isn't complete. However, applying the culture to outdated technology is a recipe for disaster; as response times grow and connections between teams are delayed by technology, the culture will die. A Nutanix Enterprise Cloud has many benefits that provide the needed base for a true DevOps paradigm. In their Day 3 Keynote at 20th Cloud Expo, Chris Brown, a Solutions Marketing Manager at Nutanix, and Mark Lav...
Many organizations are now looking to DevOps maturity models to gauge their DevOps adoption and compare their maturity to their peers. However, as enterprise organizations rush to adopt DevOps, moving past experimentation to embrace it at scale, they are in danger of falling into the trap that they have fallen into time and time again. Unfortunately, we've seen this movie before, and we know how it ends: badly.
TCP (Transmission Control Protocol) is a common and reliable transmission protocol on the Internet. TCP was introduced in the 70s by Stanford University for US Defense to establish connectivity between distributed systems to maintain a backup of defense information. At the time, TCP was introduced to communicate amongst a selected set of devices for a smaller dataset over shorter distances. As the Internet evolved, however, the number of applications and users, and the types of data accessed and...