Web Services

Understanding WebLogic Web Service

1. Overview

In this article, we will take a look at Weblogic Web Service examples.

2. WebLogic Web Service

Using weblogic webservices framework, SOAP web services are built. SOAP is an acronym for Simple Object Access Protocol. SOAP is used for developing web services that are based on XML based industry-standard protocol. SOAP security is based on WS Security. SOAP web services are platform and language independent.

2.1 Prerequisites

Java 8 is required on the Linux, windows or mac operating system. Ant 1.10.5 is required for ant projects. Weblogic 12.1.3 is used as a servlet container to deploy the examples.

2.2 Download

You can download Java 8 from the Oracle web site.  Apache Ant 1.10.5 can be downloaded from this link. Weblogic 12.1.3 can be downloaded from the weblogic website.

2.3 Setup

Below are the setup commands required for the Java Environment.


export JAVA_HOME
export PATH

2.3.1. Ant – Setup

The environment variables for ant are set as below:

Ant Environment

ANT_HOME= "Users/bhagvan.kommadi/desktop/opensource/apache-ant-1.10.5"
export ANT_HOME=$ANT_HOME\bin\ant

2.4 Weblogic Web Service in Java

SOAP is based on Web Services Description Language (WSDL). First, we create a service. The code below shows the service Greetings service implementation.


package webservices;
import javax.jws.WebService;
@WebService(name="GreetingsPortType", serviceName="GreetingsService")
public class GreetingsImpl {
  public String message(String message) {
  try {
    System.out.println("message is" + message);
  } catch (Exception exception) { exception.printStackTrace(); }

    return "The message sent is'" + message + "'";

EAR is created by using the ant script. The ant build.xml is shown below.

Ant Build.xml

<project name="webservices-greetings" default="all">
  <!-- set global properties for this build -->
  <property name="wls.username" value="manager" />
  <property name="wls.password" value="manager1$" />
  <property name="wls.hostname" value="localhost" />
  <property name="wls.port" value="7001" />
  <property name="wls.server.name" value="myserver" />
  <property name="ear.deployed.name" value="greetingsEar" />
  <property name="example-output" value="output" />
  <property name="ear-dir" value="${example-output}/greetingsEar" />
  <property name="clientclass-dir" value="${example-output}/clientclasses" />
  <path id="client.class.path">
    <pathelement path="${clientclass-dir}"/>
    <pathelement path="${java.class.path}"/>
    <pathelement path="${classpath}"/>  
  <path id="weblogic.class.path">
<fileset dir="${weblogic.dir}">
<include name="*.jar"/>
  <taskdef name="jwsc"
    classname="weblogic.wsee.tools.anttasks.JwscTask" />
  <taskdef name="clientgen"
    classname="weblogic.wsee.tools.anttasks.ClientGenTask" />
  <taskdef name="wldeploy"
  <target name="all" depends="clean,build-service,deploy,client" />
  <target name="clean" depends="undeploy">
    <delete dir="${example-output}"/>
  <target name="build-service">
      <jws file="webservices/GreetingsImpl.java" 
  <target name="deploy">
    <wldeploy action="deploy" name="${ear.deployed.name}"
      source="${ear-dir}" user="${wls.username}"
      password="${wls.password}" verbose="true"
      targets="${wls.server.name}" />
  <target name="undeploy">
    <wldeploy action="undeploy" name="${ear.deployed.name}"
      user="${wls.username}" password="${wls.password}" verbose="true"
      targets="${wls.server.name}" />
  <target name="client">
      srcdir="${clientclass-dir}" destdir="${clientclass-dir}"
      srcdir="src" destdir="${clientclass-dir}"
  <target name="run">
      srcdir="src" destdir="${clientclass-dir}"
    <java classname="webservices.client.Main" 
          fork="true" failonerror="true" >
      <classpath refid="client.class.path"/>
 line="http://${wls.hostname}:${wls.port}/GreetingsImpl/GreetingsService"  />
    </java> </target>

Ant command build-service is used to build the output ear. The following command is used to execute the building of web services.

Ant Build Service

ant build-service

The output of the ant build service command is shown below.

WSDL is created for the Greetings Service. WSDL created is shown below in the code.


<definitions xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd" xmlns:wsp="http://www.w3.org/ns/ws-policy" xmlns:wsp1_2="http://schemas.xmlsoap.org/ws/2004/09/policy" xmlns:wsam="http://www.w3.org/2007/05/addressing/metadata" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:tns="http://webservices/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://schemas.xmlsoap.org/wsdl/" targetNamespace="http://webservices/" name="GreetingsService">
<script id="tinyhippos-injected"/>
<xsd:import namespace="http://webservices/" schemaLocation="http://localhost:7001/GreetingsImpl/GreetingsService?xsd=1"/>
<message name="message">
<part name="parameters" element="tns:message"/>
<message name="messageResponse">
<part name="parameters" element="tns:messageResponse"/>
<portType name="GreetingsPortType">
<operation name="message">
<input wsam:Action="http://webservices/GreetingsPortType/messageRequest" message="tns:message"/>
<output wsam:Action="http://webservices/GreetingsPortType/messageResponse" message="tns:messageResponse"/>
<binding name="GreetingsPortTypePortBinding" type="tns:GreetingsPortType">
<soap:binding transport="http://schemas.xmlsoap.org/soap/http" style="document"/>
<operation name="message">
<soap:operation soapAction=""/>
<soap:body use="literal"/>
<soap:body use="literal"/>
<service name="GreetingsService">
<port name="GreetingsPortTypePort" binding="tns:GreetingsPortTypePortBinding">
<soap:address location="http://localhost:7001/GreetingsImpl/GreetingsService"/>

Weblogic server is configured using the command below:

Weblogic Configure


The output of the command is shown below:

WebLogic Web Service - Weblogic Configuration
Weblogic Configuration

The console can be accessed using the URL: http://localhost:7001/console

WebLogic Web Service - Weblogic Console
Weblogic Console

Greetings Ear can be accessed from the applications on the console

WebLogic Web Service - Greetings Ear Deployed
Greetings Ear Deployed

The WSDL can be accessed here

The output is shown in the screenshot below:

WebLogic Web Service - Greetings WSDL
Greetings WSDL

Webservices client is generated for Greetings Webservice. The command used is shown below:

Ant Client

ant client

The output of the command is shown below:

WebLogic Web Service - Services Client
Services Client

Client classes are used to invoke the service. The code is shown below.

Client Main

package webservices.client;

import webservices.client.*;

public class Main {
  public static void main(String[] args) { 
    GreetingsService test = new GreetingsService(); 
    GreetingsPortType port = test.getGreetingsPortTypePort();
        String result = port.message("Greetings to you");
    System.out.println("Greeting Service called. Result: " +  result);

Greeting Webservice is invoked by executing the client. The command used is shown below:

Ant Run

ant run

The output of the command is shown below:

WebLogic Web Service - Greetings Service Invocation
Greetings Service Invocation

The output is “Greetings to You” which is the message Sent.

3. Download the Source Code

You can download the full source code of this example here: Understanding WebLogic Web Service

Bhagvan Kommadi

Bhagvan Kommadi is the Founder of Architect Corner & has around 20 years’ experience in the industry, ranging from large scale enterprise development to helping incubate software product start-ups. He has done Masters in Industrial Systems Engineering at Georgia Institute of Technology (1997) and Bachelors in Aerospace Engineering from Indian Institute of Technology, Madras (1993). He is member of IFX forum,Oracle JCP and participant in Java Community Process. He founded Quantica Computacao, the first quantum computing startup in India. Markets and Markets have positioned Quantica Computacao in ‘Emerging Companies’ section of Quantum Computing quadrants. Bhagvan has engineered and developed simulators and tools in the area of quantum technology using IBM Q, Microsoft Q# and Google QScript. He has reviewed the Manning book titled : "Machine Learning with TensorFlow”. He is also the author of Packt Publishing book - "Hands-On Data Structures and Algorithms with Go".He is member of IFX forum,Oracle JCP and participant in Java Community Process. He is member of the MIT Technology Review Global Panel.
Notify of

This site uses Akismet to reduce spam. Learn how your comment data is processed.

Newest Most Voted
Inline Feedbacks
View all comments
Saif ul Islam Khan
Saif ul Islam Khan
4 years ago

Nice but should have used some new build tools like Maven or Gradle for a vast majority of tech people out there.

Bhagvan Kommadi
4 years ago


Back to top button