semi合集-English.pdf - 第3407页

SEMI E132.1-0305 © SEMI 2005 34 Table 57 SessionMana ger Binding Definitions File Name E132-1-V0305-SessionManager-Binding.wsdl Target Namespace urn:semi-org:ws.E132- 1.V0305.sessMgr-binding Imported/Referenced Namespace…

100%1 / 7923
SEMI E132.1-0305 © SEMI 2005 33
Table 53 GetMaxSessions PortType Operation
Input Message Name
GetMaxSessionsRequestMessage
Output Message Name GetMaxSessionsResponseMessage
8.2.15.4 WSDL Operation Binding
8.2.15.4.1 See the operation binding for “GetMaxSessions” in E132-1-V0305-SecurityAdmin-Binding.wsdl. Key
information is shown for convenience in Table 54.
Table 54 GetMaxSessions Operation Binding
SOAPAction urn:semi-org:ws.E132-1.V0305.secAdmin-binding:GetMaxSessions
Input Headers (WSDL Message, Required) E132HeaderMessage, required
Output Headers (WSDL Message, Required) E132HeaderMessage, required
8.3 SessionManager Interface
8.3.1 Session Identifier
8.3.1.1 The SessionManager interface uses the same SOAP header as described in ¶8.2.7 for the SecurityAdmin
interface. With the exception of the EstablishSession operation, all SOAP request and response messages defined in
the SessionManager interface includes this SOAP header to contain the session identifier. The EstablishSession
operation is where the session identifier is first defined by the equipment and communicated to client in the
EstablishSession response.
8.3.2 XML Schema and WSDL Files
8.3.2.1 The XML Schema and WSDL defined by this specification for the SessionManager interface is contained in
the following documents:
Table 55 XML Schema
File Name E132-1-V0305-Schema.xsd
Target Namespace urn:semi-org:xsd.E132-1.V0305.auth
Imported/Referenced
Namespaces
http://www.w3.org/2001/XMLSchema
urn:semi-org:xsd.CommonComponents.V0305.ccs
Description
This file defines all of the SEMI E132 data types and elements used by the SecurityAdmin,
SessionManager and SessionClient interfaces.
Table 56 SessionManager PortType Definitions
File Name E132-1-V0305-SessionManager-PortType.wsdl
Target Namespace urn:semi-org:ws.E132-1.V0305.sessMgr-portType
Imported/Referenced
Namespaces
urn:semi-org:xsd.E132-1.V0305.auth
http://schemas.xmlsoap.org/wsdl/
http://www.w3.org/2001/XMLSchema
Description
This file defines all of the input/output messages and operations for the SessionManager
interface, based on the data types defined in the SEMI E132 XML Schema.
SEMI E132.1-0305 © SEMI 2005 34
Table 57 SessionManager Binding Definitions
File Name E132-1-V0305-SessionManager-Binding.wsdl
Target Namespace urn:semi-org:ws.E132-1.V0305.sessMgr-binding
Imported/Referenced
Namespaces
urn:semi-org:ws.E132-1.V0305.sessMgr-portType
http://schemas.xmlsoap.org/wsdl/soap/
http://schemas.xmlsoap.org/wsdl/
Description
This file binds the abstract portType definition to HTTP and SOAP, specifying required SOAP
and HTTP headers for each operation and the XML encoding style for the SessionManager
interface.
8.3.2.2 These documents are a part of this specification and should accompany this document. The contents of
these documents constitute the core part of this specification.
8.3.3 WSDL Port Type Overview
8.3.3.1 The SessionManager WSDL portType definition organizes the SEMI E132.1 XML Schema data types into a
collection of named operations with inputs and outputs that correspond to the UML operations that are defined for
the SessionManager interface in SEMI E132. The WSDL portType itself is named after the SEMI E132 interface,
and each WSDL portType operation is named after the corresponding UML operation defined for the interface.
Each WSDL operation consists of two WSDL message definitions corresponding to the input and output (request
and response) for the UML operation defined in SEMI E132. The relationship between the UML interface and the
WSDL portType definition is similar in structure to that of the SecurityAdmin interface. Table 58 describes the
mapping between UML operations and WSDL operations of the SessionManager interface. The WSDL message
and operation definitions are described in ¶¶8.3.6 through 8.3.9.
Table 58 SessionManager Port Type
SEMI E132 Class Name SessionManager
WSDL Port Type Name SessionManager
SEMI E132 Operation
WSDL Operation
EstablishSession EstablishSession
CloseSession CloseSession
SessionPing SessionPing
PersistSession PersistSession
8.3.4 WSDL Binding Overview
8.3.4.1 The WSDL SessionManager binding definition specifies a message and transport protocol to use for a given
portType (SOAP and HTTP for SEMI E132.1), the interface style used (document style for SEMI E132.1). These
settings are shown in Table 59. For each WSDL portType operation, the binding defines any SOAP headers used
and whether or not they are required, the HTTP SOAPAction header value to use for that operation, and the XML
encoding to use (literal for SEMI E132.1). The binding definitions for each portType operation are described in
¶¶8.3.6 through 8.3.9.
Table 59 SessionManager Binding
SEMI E132 Class Name SessionManager
WSDL Binding Name SessionManagerBinding
SOAP Binding Style document
SOAP Transport http://schemas.xmlsoap.org/soap/http
8.3.5 WSDL Service Overview
8.3.5.1 This specification does not provide a WSDL service definition. WSDL service definitions provide one way
to define and locate the endpoint(s) at which a given interface can be accessed by a client. Such information cannot
be determined until the equipment has been installed on a factory network, and therefore is out of scope for this
SEMI E132.1-0305 © SEMI 2005 35
specification. Users are responsible for defining the mechanisms by which clients locate E132 equipment services
in the factory. A sample SessionManager service definition is provided in Figure 32 for reference only.
<?xml version="1.0" encoding="UTF-8"?>
<wsdl:definitions name="SessionManager"
xmlns="urn:semi-org:ws.E132-1.V0305.sessMgr-session"
targetNamespace="urn:semi-org:ws.E132-1.V0305.sessMgr-session"
xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
xmlns:SMBind="urn:semi-org:ws.E132-1.V0305.sessMgr-binding">
<wsdl:import namespace="urn:semi-org:ws.E132-1.V0305.sessMgr-binding"
location="E132-1-V0305-SessionManager-Binding.wsdl"/>
<wsdl:service name="SessionManager">
<wsdl:port name="SessionManagerPort"
binding="SMBind:SessionManagerBinding">
<soap:address location="https://www.someplace/SessionManager"/>
</wsdl:port>
</wsdl:service>
</wsdl:definitions>
Figure 32
Sample SessionManager WSDL Service Definition
8.3.6 EstablishSession Operation
8.3.6.1 XML Schema Types
8.3.6.1.1 This section describes the XML mappings for the classes defined in SEMI E132 for the EstablishSession
operation. See GetDefinedPrivileges operation regarding schema conventions used. The session identifier SOAP
header is not used for this operation.
8.3.6.1.2 EstablishSession Request
8.3.6.1.2.1 The service request is mapped to the XML Schema element EstablishSessionRequest of type
EstablishSessionRequestType. Table 60 shows how the input parameters are mapped to XML.
EndPointSelectorType is as described in ¶8.2.13.1.5, XML description for the EndPoint class.
Table 60 Translation Table for EstablishSession Input Parameters
Argument Name Format XML Element or Attribute XML Name/Type
endpoint Structured type Element EndPoint: EndPointSelectorType
Figure 33
EstablishSessionRequest XML Schema Element
8.3.6.1.3 EstablishSession Response
8.3.6.1.3.1 The service response is mapped to the XML Schema element EstablishSessionResponse of type
EstablishSessionResponseType. Table 61 shows how the output parameters are mapped to XML. The XML
schema diagram for EstablishSessionResponse is shown in Figure 34. Errors for this operation are returned using