02
Sat, Nov
2 New Articles

Weaving WebSphere: Web Services in WDSc

Development Tools
Typography
  • Smaller Small Medium Big Bigger
  • Default Helvetica Segoe Georgia Times

"She had a pretty gift for quotation, which is a serviceable substitute for wit."
--W. Somerset Maugham

Later in this article, I'll explain the relevance of the quote above. I don't want to lead with the explanation, because it's not entirely flattering, and the great majority of the Web Services support in WDSc deserves nothing but praise. So let's start with the good stuff, shall we?

The Good News

Before I start on the Web Services support, I'd like to give you an update on something I mentioned a couple of columns back: the Virtual Innovation Center, or VIC. The VIC is an adjunct to IBM support and is a place where we can get answers to our questions about new IBM technologies. And while the VIC's focus started out as primarily WebSphere, it continues to add new areas. The latest is an entire section devoted to iSeries/i5--something you, my faithful reader, should be happy to see.

In that previous column, I noted that I was going to actually use the VIC to address some problems I had. And while my problems with Portal have not been resolved yet, I did task the VIC with another real mystery. For some reason, my WDSc installation had gotten confused, and whenever I went into Update Manager, the system thought it needed to update to 5.0.1. That wouldn't be such a bad thing, except I was already at 5.1.0.2, the latest and greatest version. This bothered me, and nobody at IBM could tell me what was happening.

I had talked informally to some IBM folks, and the response was "uninstall and reinstall." Those of you who have installed WDSc (especially the Advanced Edition, which I was trying to use) understand why that is not an option. To go through the entire download, uninstall, reinstall, and re-upgrade process can literally take days. So, I went to the VIC, and they started in on the problem.

My biggest relief from the time I started to talk to the folks at the VIC was that they understood that uninstall and reinstall is not an option. Even though there seems to be a (growing?) minority within IBM that considers the Microsoft three R's (reboot, restore, reinstall) a valid answer to software problems, the VIC team stood firm with me and explained to the IBM support group that this was not acceptable. It's kind of like another Maugham quote: "It's a funny thing about life; if you refuse to accept anything but the best, you very often get it."

Eventually, I answered enough questions and gave the IBM support group enough information that they were able to diagnose my problem and fix it without my having to reinstall WDSc--despite my primary VIC contact leaving to get married in the middle of the process! That didn't stop the VIC; they picked up the ball and really did the job of acting as my advocate. I didn't have to constantly explain that the recommended solution was no solution at all; the VIC did that dirty work and got me a real resolution.

I recommend that everyone give the VIC a try. It's a great organization, and I think their heart is in the right place. Time will tell whether their advocacy is a short-lived phenomenon or a trend toward a new level of service, but I think they'll have a better shot at it if the general population starts taking advantage of their services.

A Quick Introduction to Web Services

The topic of Web Services is broad and complex. Nearly every little bit about it is not only fairly new, but also subject to rancorous debate. Well, "new" is a relative term. XML-based Remote Procedure Call (XML-RPC) has been around since 1998, and Simple Object Access Protocol (SOAP) was released from Microsoft to the World Wide Web Consortium (W3C) in 2001. But the specifications continue to evolve, and the latest SOAP specification was just released in June 2003.

The arguments are real, however, and they range from the smallest detail to the very core of the technology. For example, debate continues about the basic protocol of messages in Web Services. There a schism between the SOAP and the XML-RPC camps. And even in the SOAP camp, there are at least four subprotocols that define how the message is defined. All of this leads to some interesting issues when implementing Web Services, and I'll address some of those in my next feature article. For now, I'll just review the basics of Web Services.

The 20,000 Foot View

At the highest level, Web Services are simply a way for one program to call another program over the Internet. While this seems like a relatively simple goal, there are enough issues to make the process difficult.

What type of parameters do you support? Can you return binary data, such as images? How do you handle complex structures, like orders, which may have multiple different data structures? The various specifications exist to help answer these questions, but unfortunately they're not entirely compatible. Attempts have been made, especially in recent years, to allow more interoperability, but this comes at the price of complexity. I invite you to compare the original XML-RCP specification to the current SOAP specification, which requires four parts: the primer, the messaging framework, adjuncts, and a testing document.

Regardless of the specification used, the concept of a Web Service comes down to this: One program sends an HTTP request to another program. The HTTP request (usually) contains a short XML document identifying the program to be called and the parameters to be passed to that program. The program processes the request and makes an HTTP response. This response is also an XML document containing the results of the request. The response document should contain either valid data or an error code of some kind.

That's the idea, but as the standards get more "standardized," it becomes more difficult for a human being to actually format the request. Take a look at a typical Web Service request using the SOAP protocol:

POST /myservice/servlet/rpcrouter HTTP/1.0 

Host: localhost:7080 

Content-Type: text/xml; charset=utf-8 

Content-Length: 524 

SOAPAction: "" 

 

xmlns:SOAPENV="http://schemas.xmlsoap.org/soap/envelope/

xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance

xmlns:xsd="http://www.w3.org/2001/XMLSchema"> 

 

encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"> 

USD EUR 

 

 

This is just the request. In fact, this is just one variation of the request, the RPC/encoded variation. There are at least three others. With enough time, you could probably decipher this message. With even more time, you could probably write a program that would generate such a request. But the truth is that the conversation is so complex that just about any programmer will need some sort of help to get this programming feat accomplished. And that would be just one small part of the entire Web Service deployment.

WDSc to the Rescue

And that is where WDSc comes in. The WDSc wizards make it painless to create a Web Service. Not only that, but because there are so many different tasks involved in deploying a Web Service, WDSc came up with a new concept, the cheat sheet. Sort of a "meta-wizard," the cheat sheet is a walkthrough of the various steps required to create and deploy a Web Service. The cheat sheet for creating a Web Service from a JavaBean is depicted in Figure 1.

http://www.mcpressonline.com/articles/images/2002/040607%20-%20Web%20ServicesV400.jpg

Figure 1: This is the cheat sheet for creating a Web Service from a JavaBean. (Click images to enlarge.)

I actually used this cheat sheet to create a Bean from a Web Service. My "JavaBean" is a simple class that takes a string (this is meant to be a customer number) and returns the associated email address. I put the term "JavaBean" in quotes because you don't really need to adhere to the conventions of a traditional JavaBean. There is a step in which a wizard looks through your class and lists all of the methods, and you can select the ones you want to make visible.

My Web Service

Currently, my class is really simple, as shown in the code below:

package com.pbd.ws.server;

import java.util.*;

public class GetCustomerEmail {

private TreeMap map;

public String getEmail(String customer)
{
if (map == null) init();
return (String) map.get(customer);
}

private void init()
{
map = new TreeMap();
map.put("001987", "This email address is being protected from spambots. You need JavaScript enabled to view it.");
map.put("123456", "This email address is being protected from spambots. You need JavaScript enabled to view it.");
map.put("777777", "This email address is being protected from spambots. You need JavaScript enabled to view it.");
}
}

I'm not trying to be facetious here; I simply wanted to quickly create something that was a little more business-like than adding two numbers. This class will use the input parameter as a key to retrieve an email address. In a real business application, this would involve a connection to a database, but in this case, I use a simple TreeMap, which is basically a keyed list. I told you the class was simple; there is more code in the initialization than in the rest of the class.

What I Had to Do

Once the class was written, turning it into a Web Service required very little work. All I had to do was follow the steps in the cheat sheet. I read the introduction shown in Figure 1 and then clicked on the arrow at the bottom. This marked the first section of the cheat sheet complete and moved me on to the next section, as shown in Figure 2.

http://www.mcpressonline.com/articles/images/2002/040607%20-%20Web%20ServicesV401.png

Figure 2: This is the second task in the cheat sheet, creating a Dynamic Web Project.

After reading what was going to happen, I clicked on the black arrow, which then brought up the appropriate wizard for the step. In this case, the wizard was the New Web Project wizard (Figure 3). I entered a name for my project (WSServer) and continued on.

http://www.mcpressonline.com/articles/images/2002/040607%20-%20Web%20ServicesV402.png

Figure 3: This is the New Web Project wizard, which was invoked by the cheat sheet.

I continued working my way through each step of the cheat sheet until I had a working Web Service that I could test through the Web Services Explorer (Figure 4).

http://www.mcpressonline.com/articles/images/2002/040607%20-%20Web%20ServicesV403.png

Figure 4: The Web Services Explorer is used to test a Web Service.

I continued on with the cheat sheet and created a Web Services client and then ran that within the workbench. That gave me a lightly different view of the same Web Service (Figure 5).

http://www.mcpressonline.com/articles/images/2002/040607%20-%20Web%20ServicesV404.png

Figure 5: This is the Web Service after being called by the generated Web client proxy.

As you can see, the results are the same, which is a good thing. In the meantime, though, the workbench created an entire new project for me, as well as four client classes (in addition to the hefty WSDL file it created during the previous step).

What It Does, It Does Great

The Web Services cheat sheet works probably as well as anything like it I've ever seen. The integration between it and the various WDSc wizards is smooth, and the step-by-step nature of the approach appeals to me. And the cheat sheet I used is only one of three Web Service scenarios and only one of six cheat sheets. Given how well they work, I'm going to try some of the others when I get a chance.

The trick to the cheat sheet is how it encapsulates everything in simple, easy-to-follow steps that invoke the powerful WDSc wizards. With this technique, almost all of the actual work is hidden from you.

The Devil Is in the Details

Now, I must sound a warning, if only a mild one. Up until this point, everything has worked flawlessly, but that's because I've stayed strictly within the boundaries of the cheat sheet. Let's say I want to do something a little out of the ordinary; for example, suppose I want to write my own test client.

It would seem reasonable that I could simply go into the generated client code and start to play with it. The problem is that the code isn't that simple. There are over 300 lines of JSP code alone required to display the simple screen shown in Figure 5. Add to that over 200 lines of Java in the four generated classes, and it starts to get awfully top-heavy.

I managed to cut the client-side code in half, creating a simple client class that invokes a Web Service without all the extra baggage of the JSP. However, because everything is wrapped in a SOAP document, I was unable to remove the bulk of the code that formats the document. The code below shows one method generated by the Web Service wizard.

    private OperationDesc _getgetEmailOperation0() {
        if (_getEmailOperation0 == null) {
            ParameterDesc[] _params = new ParameterDesc[] {
                new ParameterDesc(
                   QNameTable.createQName(
                      "http://server.ws.pbd.com",
                      "customer"),
                   ParameterDesc.IN,
                   QNameTable.createQName(
                      "http://www.w3.org/2001/XMLSchema",
                      "string"),
                   java.lang.String.class, false, false), 
            };
            _getEmailOperation0 = new OperationDesc(
               "getEmail", _params,
               QNameTable.createQName(
                  "http://server.ws.pbd.com",
                  "getEmailReturn"));
            _getEmailOperation0.setReturnType(
               QNameTable.createQName(
                  "http://www.w3.org/2001/XMLSchema",
                  "string"));
            _getEmailOperation0.setElementQName(
               QNameTable.createQName(
                  "http://server.ws.pbd.com",
                  "getEmail"));
            _getEmailOperation0.setSoapAction("");
            FaultDesc _fault = null;
        }
        return _getEmailOperation0;
    }

Although I tried, I was unable to remove the dense, nearly unreadable code generated in the bowels of the Web Service. And remember, this is for an almost trivial example. And even the code shown above is simplified; in the original code, every class was fully qualified, like so:

com.ibm.ws.webservices.engine.description.OperationDesc

So if I wanted to write my own version of this code, I'd have to figure out how the IBM classes work, and I don't believe IBM is releasing the source to the com.ibm.ws.webservices packages. That means a lot of guesswork on my part to make use of those classes, as well as the chance that my custom code could break with the next release of IBM's jar files.

So what does this all mean? Among other things, it means I'm stuck using whatever code WDSc generates. I can't go in and customize and streamline the code to my own liking, and since this code must be all things to all Web Services, I end up with some pretty fat code.

Also, I don't really know what this code does. Through careful examination, I think I can puzzle out some of what is intended, but given the high use of specialized IBM classes, I'm not sure I would be able to debug this in the event of a failure.

And that brings me back to my opening quotation: To me, the Web Services wizards generate code that, while good enough for testing, is really only a substitute for production code, not the real thing. Like someone who can quote witticisms to seem witty, I can use the wizards to generate Web Services and seem Web-enabled, but unless I can get in and debug those generated classes, I hesitate to put them into production.

Lots of Compliments and a Caveat

By far, the news is good. The VIC is doing great things, and the Web Services cheat sheets functioned flawlessly and indeed managed to automate a process of substantial complexity. I am still raising a red flag, albeit a small one, regarding the proliferation of wizard-generated code that may or may not be debuggable in production, but the fact that I turned a class into a Web Service in about 10 minutes is an awfully strong argument in favor of the process.

Joe Pluta is the founder and chief architect of Pluta Brothers Design, Inc. He has been working in the field since the late 1970s and has made a career of extending the IBM midrange, starting back in the days of the IBM System/3. Joe has used WebSphere extensively, especially as the base for PSC/400, the only product that can move your legacy systems to the Web using simple green-screen commands. Joe is also the author of E-Deployment: The Fastest Path to the Web and Eclipse: Step by Step, with WDSc: Step by Step coming out this September. You can reach him at This email address is being protected from spambots. You need JavaScript enabled to view it..

Joe Pluta

Joe Pluta is the founder and chief architect of Pluta Brothers Design, Inc. He has been extending the IBM midrange since the days of the IBM System/3. Joe uses WebSphere extensively, especially as the base for PSC/400, the only product that can move your legacy systems to the Web using simple green-screen commands. He has written several books, including Developing Web 2.0 Applications with EGL for IBM i, E-Deployment: The Fastest Path to the Web, Eclipse: Step by Step, and WDSC: Step by Step. Joe performs onsite mentoring and speaks at user groups around the country. You can reach him at This email address is being protected from spambots. You need JavaScript enabled to view it..


MC Press books written by Joe Pluta available now on the MC Press Bookstore.

Developing Web 2.0 Applications with EGL for IBM i Developing Web 2.0 Applications with EGL for IBM i
Joe Pluta introduces you to EGL Rich UI and IBM’s Rational Developer for the IBM i platform.
List Price $39.95

Now On Sale

WDSC: Step by Step WDSC: Step by Step
Discover incredibly powerful WDSC with this easy-to-understand yet thorough introduction.
List Price $74.95

Now On Sale

Eclipse: Step by Step Eclipse: Step by Step
Quickly get up to speed and productivity using Eclipse.
List Price $59.00

Now On Sale

BLOG COMMENTS POWERED BY DISQUS

LATEST COMMENTS

Support MC Press Online

$

Book Reviews

Resource Center

  • SB Profound WC 5536 Have you been wondering about Node.js? Our free Node.js Webinar Series takes you from total beginner to creating a fully-functional IBM i Node.js business application. You can find Part 1 here. In Part 2 of our free Node.js Webinar Series, Brian May teaches you the different tooling options available for writing code, debugging, and using Git for version control. Brian will briefly discuss the different tools available, and demonstrate his preferred setup for Node development on IBM i or any platform. Attend this webinar to learn:

  • SB Profound WP 5539More than ever, there is a demand for IT to deliver innovation. Your IBM i has been an essential part of your business operations for years. However, your organization may struggle to maintain the current system and implement new projects. The thousands of customers we've worked with and surveyed state that expectations regarding the digital footprint and vision of the company are not aligned with the current IT environment.

  • SB HelpSystems ROBOT Generic IBM announced the E1080 servers using the latest Power10 processor in September 2021. The most powerful processor from IBM to date, Power10 is designed to handle the demands of doing business in today’s high-tech atmosphere, including running cloud applications, supporting big data, and managing AI workloads. But what does Power10 mean for your data center? In this recorded webinar, IBMers Dan Sundt and Dylan Boday join IBM Power Champion Tom Huntington for a discussion on why Power10 technology is the right strategic investment if you run IBM i, AIX, or Linux. In this action-packed hour, Tom will share trends from the IBM i and AIX user communities while Dan and Dylan dive into the tech specs for key hardware, including:

  • Magic MarkTRY the one package that solves all your document design and printing challenges on all your platforms. Produce bar code labels, electronic forms, ad hoc reports, and RFID tags – without programming! MarkMagic is the only document design and print solution that combines report writing, WYSIWYG label and forms design, and conditional printing in one integrated product. Make sure your data survives when catastrophe hits. Request your trial now!  Request Now.

  • SB HelpSystems ROBOT GenericForms of ransomware has been around for over 30 years, and with more and more organizations suffering attacks each year, it continues to endure. What has made ransomware such a durable threat and what is the best way to combat it? In order to prevent ransomware, organizations must first understand how it works.

  • SB HelpSystems ROBOT GenericIT security is a top priority for businesses around the world, but most IBM i pros don’t know where to begin—and most cybersecurity experts don’t know IBM i. In this session, Robin Tatam explores the business impact of lax IBM i security, the top vulnerabilities putting IBM i at risk, and the steps you can take to protect your organization. If you’re looking to avoid unexpected downtime or corrupted data, you don’t want to miss this session.

  • SB HelpSystems ROBOT GenericCan you trust all of your users all of the time? A typical end user receives 16 malicious emails each month, but only 17 percent of these phishing campaigns are reported to IT. Once an attack is underway, most organizations won’t discover the breach until six months later. A staggering amount of damage can occur in that time. Despite these risks, 93 percent of organizations are leaving their IBM i systems vulnerable to cybercrime. In this on-demand webinar, IBM i security experts Robin Tatam and Sandi Moore will reveal:

  • FORTRA Disaster protection is vital to every business. Yet, it often consists of patched together procedures that are prone to error. From automatic backups to data encryption to media management, Robot automates the routine (yet often complex) tasks of iSeries backup and recovery, saving you time and money and making the process safer and more reliable. Automate your backups with the Robot Backup and Recovery Solution. Key features include:

  • FORTRAManaging messages on your IBM i can be more than a full-time job if you have to do it manually. Messages need a response and resources must be monitored—often over multiple systems and across platforms. How can you be sure you won’t miss important system events? Automate your message center with the Robot Message Management Solution. Key features include:

  • FORTRAThe thought of printing, distributing, and storing iSeries reports manually may reduce you to tears. Paper and labor costs associated with report generation can spiral out of control. Mountains of paper threaten to swamp your files. Robot automates report bursting, distribution, bundling, and archiving, and offers secure, selective online report viewing. Manage your reports with the Robot Report Management Solution. Key features include:

  • FORTRAFor over 30 years, Robot has been a leader in systems management for IBM i. With batch job creation and scheduling at its core, the Robot Job Scheduling Solution reduces the opportunity for human error and helps you maintain service levels, automating even the biggest, most complex runbooks. Manage your job schedule with the Robot Job Scheduling Solution. Key features include:

  • LANSA Business users want new applications now. Market and regulatory pressures require faster application updates and delivery into production. Your IBM i developers may be approaching retirement, and you see no sure way to fill their positions with experienced developers. In addition, you may be caught between maintaining your existing applications and the uncertainty of moving to something new.

  • LANSAWhen it comes to creating your business applications, there are hundreds of coding platforms and programming languages to choose from. These options range from very complex traditional programming languages to Low-Code platforms where sometimes no traditional coding experience is needed. Download our whitepaper, The Power of Writing Code in a Low-Code Solution, and:

  • LANSASupply Chain is becoming increasingly complex and unpredictable. From raw materials for manufacturing to food supply chains, the journey from source to production to delivery to consumers is marred with inefficiencies, manual processes, shortages, recalls, counterfeits, and scandals. In this webinar, we discuss how:

  • The MC Resource Centers bring you the widest selection of white papers, trial software, and on-demand webcasts for you to choose from. >> Review the list of White Papers, Trial Software or On-Demand Webcast at the MC Press Resource Center. >> Add the items to yru Cart and complet he checkout process and submit

  • Profound Logic Have you been wondering about Node.js? Our free Node.js Webinar Series takes you from total beginner to creating a fully-functional IBM i Node.js business application.

  • SB Profound WC 5536Join us for this hour-long webcast that will explore:

  • Fortra IT managers hoping to find new IBM i talent are discovering that the pool of experienced RPG programmers and operators or administrators with intimate knowledge of the operating system and the applications that run on it is small. This begs the question: How will you manage the platform that supports such a big part of your business? This guide offers strategies and software suggestions to help you plan IT staffing and resources and smooth the transition after your AS/400 talent retires. Read on to learn: