Technologies for Building Grids
description
Transcript of Technologies for Building Grids
![Page 1: Technologies for Building Grids](https://reader036.fdocuments.us/reader036/viewer/2022062321/56813f93550346895daa85b2/html5/thumbnails/1.jpg)
EGEE is a project funded by the European Union under contract IST-2003-508833
Technologies for Building Grids
15th October 2004
www.eu-egee.org
![Page 2: Technologies for Building Grids](https://reader036.fdocuments.us/reader036/viewer/2022062321/56813f93550346895daa85b2/html5/thumbnails/2.jpg)
Introduction to web services, 3-4 June 2004 - 2
Objectives
To understand the major Java environment packages for writing and deploying Java services and clients
Basic concepts of containers
Some JAX-RPC basics.
Basics of deploying to containers
An introduction to the ANT tool.
![Page 3: Technologies for Building Grids](https://reader036.fdocuments.us/reader036/viewer/2022062321/56813f93550346895daa85b2/html5/thumbnails/3.jpg)
Introduction to web services, 3-4 June 2004 - 3
Making java based web services
![Page 4: Technologies for Building Grids](https://reader036.fdocuments.us/reader036/viewer/2022062321/56813f93550346895daa85b2/html5/thumbnails/4.jpg)
Introduction to web services, 3-4 June 2004 - 4
Java web services development environment
• Main components used: J2EE (Java 2 Enterprise Edition)
• Provides basic Java environment: compiler, virtual machine, etc.
JWSDP (Java Web Services Developer Pack)• Provides web services specific java APIs. • Automatic code generation to provide web services communication (eg.
stubs)
Container (Tomcat/Axis)• Provides access to low level communications protocols (eg. http
through web server. Axis also provides some functions such as XML parsing)
![Page 5: Technologies for Building Grids](https://reader036.fdocuments.us/reader036/viewer/2022062321/56813f93550346895daa85b2/html5/thumbnails/5.jpg)
Introduction to web services, 3-4 June 2004 - 5
What’s in JWSDP
• (JAX = Java APIs for XML)
• JAX-RPC (Remote Procedure Calls) APIs for using web services and automatically creating ‘glue’ code to make
it work.
• JAXP (Processing) XML parsing components
• JAXR (Registries) UDDI etc.
• JAXM (Messaging) depricated
• JAXB (Binding) Mapping XML to Java
• SAAJ (SOAP with attachments API for Java) Produce and consume SOAP messages
![Page 6: Technologies for Building Grids](https://reader036.fdocuments.us/reader036/viewer/2022062321/56813f93550346895daa85b2/html5/thumbnails/6.jpg)
Introduction to web services, 3-4 June 2004 - 6
The classpath
• With java based web services development the most common source of problems is with incorrectly set variables in the classpath.
• Similarly with Globus toolkit based grid development.
• The classpath is often the first place to look for compile time problems.
![Page 7: Technologies for Building Grids](https://reader036.fdocuments.us/reader036/viewer/2022062321/56813f93550346895daa85b2/html5/thumbnails/7.jpg)
Introduction to web services, 3-4 June 2004 - 7
Axis – Tomcat what’s the difference?
• Tomcat was developed as a container to add functionality to the Apache web server.
• Tomcat deals mainly with servlets (non- web services).
• Tomcat was adapted to deal with web services initially
• Axis is the new development specifically for web services – actually is like Tomcat +.
• Can use Tomcat but moving towards Axis.
![Page 8: Technologies for Building Grids](https://reader036.fdocuments.us/reader036/viewer/2022062321/56813f93550346895daa85b2/html5/thumbnails/8.jpg)
Introduction to web services, 3-4 June 2004 - 8
JAX - RPC
![Page 9: Technologies for Building Grids](https://reader036.fdocuments.us/reader036/viewer/2022062321/56813f93550346895daa85b2/html5/thumbnails/9.jpg)
Introduction to web services, 3-4 June 2004 - 9
JAX-RPC API packages
• javax.xml.rpc Core classes for the client side programming model
• javax.xml.rpc.encoding Java primatives <-> XML SOAP messages
• javax.xml.rpc.handler processing XML messages
• javax.xml.rpc.handler.soap
• javax.xml.rpc.holders support the use of IO parameters
• javax.xml.rpc.server minimal API for web service inplementation
• Javax.xml.rpc.soap specific SOAP bindings
![Page 10: Technologies for Building Grids](https://reader036.fdocuments.us/reader036/viewer/2022062321/56813f93550346895daa85b2/html5/thumbnails/10.jpg)
Introduction to web services, 3-4 June 2004 - 10
JAX-RPC Architecture
![Page 11: Technologies for Building Grids](https://reader036.fdocuments.us/reader036/viewer/2022062321/56813f93550346895daa85b2/html5/thumbnails/11.jpg)
Introduction to web services, 3-4 June 2004 - 11
Java web service flow
![Page 12: Technologies for Building Grids](https://reader036.fdocuments.us/reader036/viewer/2022062321/56813f93550346895daa85b2/html5/thumbnails/12.jpg)
Introduction to web services, 3-4 June 2004 - 12
Defining a service
• A service can be defined starting with: A java interface
A WSDL document
• Which to use? If the service end point interface is defined in java it may not be
interoperable with services/clients defined in other languages
If the service is initially defined in WSDL it will be open
![Page 13: Technologies for Building Grids](https://reader036.fdocuments.us/reader036/viewer/2022062321/56813f93550346895daa85b2/html5/thumbnails/13.jpg)
Introduction to web services, 3-4 June 2004 - 13
Client side Implementation
![Page 14: Technologies for Building Grids](https://reader036.fdocuments.us/reader036/viewer/2022062321/56813f93550346895daa85b2/html5/thumbnails/14.jpg)
Introduction to web services, 3-4 June 2004 - 14
wscompile
• Generates Compiled class files + optionally source files for stubs to interface
with client side JAX-RPC
WSDL file
Model file
Example commandline
wscompile –gen:client –d output/client –classpath classpath config-file
(add –keep –s to retain java source files)
![Page 15: Technologies for Building Grids](https://reader036.fdocuments.us/reader036/viewer/2022062321/56813f93550346895daa85b2/html5/thumbnails/15.jpg)
Introduction to web services, 3-4 June 2004 - 15
config.xml
<?xml version=“1.0” encoding=“UTF-8” ?>
<configuration xmlns=“http://java.sun.com/xml/ns/jax-rpc/ri/config”>
<service name=“……..”
targetNamespace=“………………………”
typeNamespace=“……………………………..”
packageName=“……………………………….”>
<interface name=“……………………………”/>
</service>
</configuration>
name = name of servicetargetNamespace = namespace of WSDL for names associated with the
service eg. port typetypeNamespace = namespace of WSDL for data typespackageName = name of java package
![Page 16: Technologies for Building Grids](https://reader036.fdocuments.us/reader036/viewer/2022062321/56813f93550346895daa85b2/html5/thumbnails/16.jpg)
Introduction to web services, 3-4 June 2004 - 16
Generated files
Some of the client side generated files:
Service Service.java
Service_Impl.java
Service_SerializerRegistry.java
Exception ServiceException_SOAPSerializer.java
ServiceException_SOAPBuilder.java
Value type Info_SOAPSerializer.java
Info_SOAPBuilder.java
Interface Interface_Stub.java
method.java
![Page 17: Technologies for Building Grids](https://reader036.fdocuments.us/reader036/viewer/2022062321/56813f93550346895daa85b2/html5/thumbnails/17.jpg)
Introduction to web services, 3-4 June 2004 - 17
Service.java file
• The Service.java file corresponds to the definition of the interface for the web service, ie it contains the same info as the <service> element in the config file.
package servicePackage;
import javax.xml.rpc.*;
Public interface Service extends javax.aml.rpc.Service{
public servicePackage getServicePort();}
![Page 18: Technologies for Building Grids](https://reader036.fdocuments.us/reader036/viewer/2022062321/56813f93550346895daa85b2/html5/thumbnails/18.jpg)
Introduction to web services, 3-4 June 2004 - 18
Referencing the stub
• In order to get an object to reference the stub you have to instantiate Service_Impl. (Unfortunately this name is only recommended)
• Service_Impl service = new Service_Impl ();
• value* name = (value)service.getServicePort ();
• With this reference you can call the methods of the service.
![Page 19: Technologies for Building Grids](https://reader036.fdocuments.us/reader036/viewer/2022062321/56813f93550346895daa85b2/html5/thumbnails/19.jpg)
Introduction to web services, 3-4 June 2004 - 19
Stub Interface (javax.xml.rpc.Stub)
Public interface Stub
{
public abstract Object _getProperty (String name) throws JAXRPCException;
public abstract Iterator _getPropertyNames ();
public abstract void _setProperty(String name, Object value) throws JAXRPCException;
}
These methods allow the stub to be configured by setting various properties.
![Page 20: Technologies for Building Grids](https://reader036.fdocuments.us/reader036/viewer/2022062321/56813f93550346895daa85b2/html5/thumbnails/20.jpg)
Introduction to web services, 3-4 June 2004 - 20
Deploying with JWSDP - Tomcat
![Page 21: Technologies for Building Grids](https://reader036.fdocuments.us/reader036/viewer/2022062321/56813f93550346895daa85b2/html5/thumbnails/21.jpg)
Introduction to web services, 3-4 June 2004 - 21
Deployment: Making the container aware of a servlet
• The web server has to be aware of the interface and exposed methods of a servlet in order to use it.
• Using Tomcat as an example this can be done in a number of ways.
1. Enter the values manually into the SOAP admin page from a Deployment descriptor.
3. You can manually edit Tomcat’s WEB-INFO/web.xml file
4. You can create a WAR file and place it in Tomcat’s webapps folder
2. You can use the SOAP manager application from the command line
5. You can use ANT
![Page 22: Technologies for Building Grids](https://reader036.fdocuments.us/reader036/viewer/2022062321/56813f93550346895daa85b2/html5/thumbnails/22.jpg)
Introduction to web services, 3-4 June 2004 - 22
Using a WAR file
• A WAR file is basically an archive description of a servlet installation
(JAR and WAR naming derives from UNIX TAR – java archive, web archive,
tape archive).
• Example: placed in Tomcat’s webapps folder it can be interpreted by the container.
![Page 23: Technologies for Building Grids](https://reader036.fdocuments.us/reader036/viewer/2022062321/56813f93550346895daa85b2/html5/thumbnails/23.jpg)
Introduction to web services, 3-4 June 2004 - 23
Deployment Descriptor
<isd:service xmlns:isd=“http://xml.apache.org/xml-soap/deployment” id=“urn:stock-onhand”>
<isd:provider type=“java” scope=“Application” methods=“getQty”>
<isd:java class=“StockQuantity”/>
</isd:provider>
<isd:faultListener>org.apache.soap.sever.DOMFaultListener</isd:faultListener>
</isd:service>
A SOAP manager file
Some containers (Tomcat) provide GUIs for deployment
![Page 24: Technologies for Building Grids](https://reader036.fdocuments.us/reader036/viewer/2022062321/56813f93550346895daa85b2/html5/thumbnails/24.jpg)
Introduction to web services, 3-4 June 2004 - 24
Additional WAR files required for JWSDP
WEB-INF/web.xml Web application deployment descriptor
WEB-INF/jaxrpc-ri.xml JWSDP-specific deployment information
WEB-INF/model Model file generated by wscompile
![Page 25: Technologies for Building Grids](https://reader036.fdocuments.us/reader036/viewer/2022062321/56813f93550346895daa85b2/html5/thumbnails/25.jpg)
Introduction to web services, 3-4 June 2004 - 25
web.xml file
<?xml version=“1.0” encoding=“UTF-8” ?>
<!DOCTYPE web-app
PUBLIC “-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN”
“http://java.sun.com/j2ee/dtds/web-app_2_3.dtd”>
<web-app>
<display-name>Service Name</display-name>
<description>A web service application</description>
</web-app>
![Page 26: Technologies for Building Grids](https://reader036.fdocuments.us/reader036/viewer/2022062321/56813f93550346895daa85b2/html5/thumbnails/26.jpg)
Introduction to web services, 3-4 June 2004 - 26
Creating a deployable WAR file
wsdeploy –o targetFileName portableWarFileName
The process is informed by the content of the jaxrpc-ri.xml file.
The archive contains:class files and resourcescompiled class files for the tiescompiled class files for serializersWSDL (in WEB-INF directory)model file for the service ( in WEB-INF)modified web.xml filejaxrpc-ri-runtime.xml (based on jaxrpc-ri.xml)
![Page 27: Technologies for Building Grids](https://reader036.fdocuments.us/reader036/viewer/2022062321/56813f93550346895daa85b2/html5/thumbnails/27.jpg)
Introduction to web services, 3-4 June 2004 - 27
Package Structure for JAX-RPC Service Endpoint
![Page 28: Technologies for Building Grids](https://reader036.fdocuments.us/reader036/viewer/2022062321/56813f93550346895daa85b2/html5/thumbnails/28.jpg)
Introduction to web services, 3-4 June 2004 - 28
Introducing the ANT tool
![Page 29: Technologies for Building Grids](https://reader036.fdocuments.us/reader036/viewer/2022062321/56813f93550346895daa85b2/html5/thumbnails/29.jpg)
Introduction to web services, 3-4 June 2004 - 29
Ant
Ant – Another Neat Tool
• Ant is a tool for building projects
• It uses a build file, called build.xml, to determine how to build a particular project
![Page 30: Technologies for Building Grids](https://reader036.fdocuments.us/reader036/viewer/2022062321/56813f93550346895daa85b2/html5/thumbnails/30.jpg)
Introduction to web services, 3-4 June 2004 - 30
ANT vs MAKE
• ANT performs similar functions to make as a software project build tool.
• Build.xml is similar to a Makefile
• It is written in Java and is therefore entirely platform independent
![Page 31: Technologies for Building Grids](https://reader036.fdocuments.us/reader036/viewer/2022062321/56813f93550346895daa85b2/html5/thumbnails/31.jpg)
Introduction to web services, 3-4 June 2004 - 31
Understanding Ant
• The key to understanding Ant is to understand the build.xml file structure
• The root element is project• There are then properties elements, which can be set
externally or internally to the file• There are also target elements which specify what actions
are to be taken
<project ..> <property .../> <target .../></project>
![Page 32: Technologies for Building Grids](https://reader036.fdocuments.us/reader036/viewer/2022062321/56813f93550346895daa85b2/html5/thumbnails/32.jpg)
Introduction to web services, 3-4 June 2004 - 32
Target in ANT
The use of the word target can be confusing.
In ANT a target is an action
It is not a destination – as the word is used in some other development environments.
(There is also a task in ANT – this is a finer grained action than a target.)
![Page 33: Technologies for Building Grids](https://reader036.fdocuments.us/reader036/viewer/2022062321/56813f93550346895daa85b2/html5/thumbnails/33.jpg)
Introduction to web services, 3-4 June 2004 - 33
Example Project (1)
• The next few slides will demonstrate the use of Ant to build a very simple project
• There are three classes in the Project
Person• Contains a name, age and an Address
Address• Contains street, town and country information
Display• Instantiates 3 Person classes and displays their details on the
command line
![Page 34: Technologies for Building Grids](https://reader036.fdocuments.us/reader036/viewer/2022062321/56813f93550346895daa85b2/html5/thumbnails/34.jpg)
Introduction to web services, 3-4 June 2004 - 34
Example Project (2)
• All the source files are in a package structure in a directory called src
• An example output would be:
![Page 35: Technologies for Building Grids](https://reader036.fdocuments.us/reader036/viewer/2022062321/56813f93550346895daa85b2/html5/thumbnails/35.jpg)
Introduction to web services, 3-4 June 2004 - 35
Compile Example
• This example will perform a simple compile
• There is only one target, which will compile all classes in the same location as the source files
<project name="PeopleProject" default="compile" basedir="."> <!-- set global properties for this build --> <property name="src" location="src"/> <target name="compile” > <!-- Compile the java code --> <javac srcdir="${src}"/> </target></project>
![Page 36: Technologies for Building Grids](https://reader036.fdocuments.us/reader036/viewer/2022062321/56813f93550346895daa85b2/html5/thumbnails/36.jpg)
Introduction to web services, 3-4 June 2004 - 36
More Complex Example
• This example will now create a directory called build and put the compiled code in there, preserving package structure
<property name="src" location="src"/><property name="build" location="build"/>
<target name="init"> <mkdir dir="${build}"/></target>
<target name="compile" depends="init" > <!-- Compile the java code --> <javac srcdir="${src}" destdir="${build}“ /></target>
![Page 37: Technologies for Building Grids](https://reader036.fdocuments.us/reader036/viewer/2022062321/56813f93550346895daa85b2/html5/thumbnails/37.jpg)
Introduction to web services, 3-4 June 2004 - 37
Creating JAR files (1)
• This build.xml will require two runs: One to compile and package in to a JAR One to clean up unnecessary files
<project name="PeopleProject" default="dist" basedir=".">
<target name="init" description="prepare the environment"> <mkdir dir="${build}"/> <mkdir dir="lib"/></target>
...
![Page 38: Technologies for Building Grids](https://reader036.fdocuments.us/reader036/viewer/2022062321/56813f93550346895daa85b2/html5/thumbnails/38.jpg)
Introduction to web services, 3-4 June 2004 - 38
Creating JAR files (2)
...
<target name="compile" depends="init" > <!-- Compile the java code --> <javac srcdir="${src}" destdir="${build}"/> </target>
<target name="dist" depends="compile" > <jar jarfile="lib/PeopleProject.jar" basedir="${build}"/> </target>
<target name="clean" description="clean up"> <delete dir="${build}"/> </target>
</project>
![Page 39: Technologies for Building Grids](https://reader036.fdocuments.us/reader036/viewer/2022062321/56813f93550346895daa85b2/html5/thumbnails/39.jpg)
Introduction to web services, 3-4 June 2004 - 39
Invoking targets
• Here dist invokes clean so we now only require one run of ant
<target name="dist" depends="compile" > <jar jarfile="lib/PeopleProject.jar" basedir="${build}"/> <antcall target="clean"/></target> <target name="clean" description="clean up" > <delete dir="${build}"/></target>
![Page 40: Technologies for Building Grids](https://reader036.fdocuments.us/reader036/viewer/2022062321/56813f93550346895daa85b2/html5/thumbnails/40.jpg)
Introduction to web services, 3-4 June 2004 - 40
Setting the classpath
• To set the classpath, use the classpath task and specify the appropriate pathelement tags
• All of the above JAR files will now be on the class path when the source is compiled
<javac srcdir="${src}" destdir="${build}"> <classpath> <pathelement path="${basedir}/lib/Jar1.jar"/> <pathelement path="${basedir}/lib/Jar2.jar"/> <pathelement path="${basedir}/lib/Jar2.jar"/> </classpath></javac>
![Page 41: Technologies for Building Grids](https://reader036.fdocuments.us/reader036/viewer/2022062321/56813f93550346895daa85b2/html5/thumbnails/41.jpg)
Introduction to web services, 3-4 June 2004 - 41
Copying Files
• The copy task in ant allow you to copy files and/or directories
• This example will copy the file Example.txt to the MyFiles directory.
<copy file=“Example.txt" toDir="MyFiles/"/>
![Page 42: Technologies for Building Grids](https://reader036.fdocuments.us/reader036/viewer/2022062321/56813f93550346895daa85b2/html5/thumbnails/42.jpg)
Introduction to web services, 3-4 June 2004 - 42
Looking ahead to Globus and Ant
• Much of the work in building and deploying Grid Services for Globus can be done using Ant build files
• The next few slides will go through some of the build files that are provided with Globus
• You can also write your own build files for use with Globus
![Page 43: Technologies for Building Grids](https://reader036.fdocuments.us/reader036/viewer/2022062321/56813f93550346895daa85b2/html5/thumbnails/43.jpg)
Introduction to web services, 3-4 June 2004 - 43
startContainer(1)
• The main build file that is provided with Globus contains a target called startContainer
• This is invoking a target with the same name in another build file called build.services
• We will see this target on the next slide
<target name="startContainer"> <ant antfile="${build.services}" target="startContainer"/></target>
![Page 44: Technologies for Building Grids](https://reader036.fdocuments.us/reader036/viewer/2022062321/56813f93550346895daa85b2/html5/thumbnails/44.jpg)
Introduction to web services, 3-4 June 2004 - 44
startContainer(2)
• Here is the target in build.services
• The dependencies add JAR files to the classpath
<target name="startContainer" depends="setJbossClientClasspath, setWebSphereClientClasspath">
…
</target>
![Page 45: Technologies for Building Grids](https://reader036.fdocuments.us/reader036/viewer/2022062321/56813f93550346895daa85b2/html5/thumbnails/45.jpg)
Introduction to web services, 3-4 June 2004 - 45
Starting a Java VM
• The java task runs the specified Java class
• The fork attribute indicates that this class should be run in a new VM
<target name="startContainer" depends="setJbossClientClasspath, setWebSphereClientClasspath">
<java classname="org.globus.ogsa.server.ServiceContainer" fork="yes"> … </java>
</target>
![Page 46: Technologies for Building Grids](https://reader036.fdocuments.us/reader036/viewer/2022062321/56813f93550346895daa85b2/html5/thumbnails/46.jpg)
Introduction to web services, 3-4 June 2004 - 46
Specifying Java Options (1)
• The arg task allows you to specify arguments for the class
<java classname="org.globus.ogsa.server.ServiceContainer" fork="yes">
... <arg line="-p ${service.port}"/> <arg line="-${container.initialization}"/> ...</java>
![Page 47: Technologies for Building Grids](https://reader036.fdocuments.us/reader036/viewer/2022062321/56813f93550346895daa85b2/html5/thumbnails/47.jpg)
Introduction to web services, 3-4 June 2004 - 47
Specifying Java Options (2)
• The arguments being used would, so far, be equivalent to:
• The –p switch specifies the port
• container.initializion has evaluated to eager
java org.globus.ogsa.server.ServiceContainer –p 8080 -eager
![Page 48: Technologies for Building Grids](https://reader036.fdocuments.us/reader036/viewer/2022062321/56813f93550346895daa85b2/html5/thumbnails/48.jpg)
Introduction to web services, 3-4 June 2004 - 48
Classpath
• The classpath is set using properties specified in an external properties file
<arg line="-p ${service.port}"/><arg line="-${container.initialization}"/>
...
<classpath> <pathelement location="${ogsa.jar}"/> <pathelement location="${samples.lib}/${samples.jar}"/> <path refid="classpath"/></classpath>
<project ... >
<property file="ogsa.properties"/>