Library part of type ServiceBindingLibrary

A service binding library (a library part of type ServiceBindingLibrary) contains only a set of variables, with no functions or constants:
You can declare variables of type Interface or Service elsewhere in EGL; but the declaration can include binding information only in a service binding library. Each declaration in this type of library includes one of the following complex properties:
@EGLBinding
For binding a variable to an EGL service. Details are in @EGLBinding.
@WebBinding
For binding a variable to a Web service. Details are in @WebBinding.

The library of type serviceBinding includes the property runtimeBind, which is set to no (the default) or yes. If you set the property to yes, a library-specific property file is created at generation time. That file includes binding information that takes effect at run time and can be changed at deployment time. Details are in Service binding library property file.

Any EGL library is generated separately from the parts that use it. EGL run time accesses the library by using the setting of the library property alias, which defaults to the EGL library name. That property is described in Library part in EGL source format.

At run time, the library is loaded when first used and is unloaded when the code that accessed the library leaves memory, as occurs when the run unit ends..

A PageHandler gets a new copy of the library whenever the PageHandler is loaded. Also, a library that is invoked by another library remains in memory as long as the invoking library does.

For details on creating a library to hold EGL values and code for local execution, see Library part of type BasicLibrary. For details on creating a library to access a native DLL from an EGL-generated Java™ program, see Library part of type NativeLibrary.

@EGLBinding

The complex property @EGLBinding specifies the binding for a variable that refers to an EGL service. The property fields and their types are as follows:
commType CommTypeKind
The type of communications used to connect the client and service. One of the following values:
LOCAL
As appropriate if the client and service are in the same run unit
TCPIP
As appropriate if the client and service communicate by way of TCP/IP

The property field commType is required.

serviceName STRING
The name of the Service part to which the variable refers.

The property field serviceName is required.

servicePackage STRING
The name of the EGL package in which the Service part resides.

The property field servicePackage is required.

serviceAlias STRING
The alias (if any) of the EGL Service part.
tcpipLocation STRING
A string having the following format:
  host:portNumber

host is the TCP/IP host name that refers to the machine where the service runs. portNumber is the number of the TCP/IP port that provides access to the service.

The property field tcpipLocation is required if the value of commType is TCPIP.

debugImpl STRING
The name of a Service part that is accessed at debug time. If no part is specified, the debug session invokes the deployed service but does not step through that service.

@WebBinding

The complex property @WebBinding specifies the binding for a Web service. The property fields are as follows:
wsdlFile STRING
The location of the WSDL file on the client side, with the start of the path in the WebContent folder, as in the following example:
  WebContent/WEB-INF/wsdl/HelloWorld.wsdl

The property field wsdlFile is required.

wsdlService STRING
The WSDL service element name.

This property field is required.

wsdlPort STRING
The WSDL port element name.

This property field is required.

endPoint STRING
The URL of the Web service. The default is the value of the soap:address element, as specified in the WSDL file.
debugImpl STRING
The name of a Service part that is accessed at debug time. If no part is specified, the debug session invokes the deployed service but does not step through that service.

Service binding library property file

The property file is composed a series of file property and value pairs. Only the following file properties are supported:
egl.service.varName.eglBinding.commType
egl.service.varName.eglBinding.servicePackage
egl.service.varName.eglBinding.serviceAlias
egl.service.varName.eglBinding.tcpipLocation

egl.service.varName.webBinding.endpoint
As shown, the name of each of file property begins with egl.service and continues with the following format:
  .varName.bindingType.propertyName=value
varName
Name of the variable of type Service or Interface
bindingType
One of the following:
  • eglBinding (if the variable refers to an EGL service)
  • webBinding (if the variable refers to a Web service)
propertyName
A binding property such as commType or endpoint. Not all binding properties are supported in the properties file, as noted earlier.
value
The value of the binding property.
Feedback
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.