Tech-invite  3GPPspace  IETFspace
◀  ▶  21  22  23  24  25  26  27  28  29  31  32  33  34  35  36  37  38  4‑5x
Top   in Index   Prev   Next

TS 29.198-01
Open Service Access (OSA) API –
Part 1: Overview

3GPP‑Page   ETSI‑search
V9.0.0 (PDF)  2009/12  57 p.
V8.0.0  2008/12  57 p.
V7.0.0  2007/03  57 p.
V6.5.0  2006/12  57 p.
V5.8.3  2006/06  48 p.
V4.3.8  2005/12  16 p.
Rapporteur:
Mr. Unmehopa, Musa

full Table of Contents for  TS 29.198-01  Word version:  9.0.0

0Introduction  p. 6
1Scope  p. 9
2References  p. 9
3Definitions and abbreviations  p. 9
3.1Definitions  p. 9
3.2Abbreviations  p. 10
4Open Service Access APIs  p. 11
5Structure of the OSA API (29.198) and Mapping (29.998) documents  p. 12
6Methodology  p. 14
6.1Tools and Languages  p. 14
6.2Packaging  p. 14
6.3Colours  p. 14
6.4Naming scheme  p. 14
6.5State Transition Diagram text and text symbols  p. 15
6.6Exception handling and passing results  p. 15
6.7References  p. 15
6.8Strings and Collections  p. 15
6.9Prefixes  p. 15
7Introduction to OSA APIs  p. 16
7.1Interface Types  p. 16
7.2Service Factory  p. 16
7.3Use of Sessions  p. 16
7.4Interfaces and Sessions  p. 16
7.5Callback Interfaces  p. 16
7.6Setting Callbacks  p. 17
7.7Synchronous versus Asynchronous Methods  p. 17
7.8Out Parameters  p. 17
7.9Exception Hierarchy  p. 17
7.10Common Exceptions  p. 18
7.11Use of NULL  p. 18
7.12Notification Handling  p. 18
8Backwards Compatibility Considerations  p. 19
8.1Guidelines to enable backwards compatibility in implementations  p. 19
8.2Rule summary  p. 19
8.2.1Server side permitted changes  p. 19
8.2.2Client side permitted changes  p. 20
8.2.3Data type permitted changes  p. 20
8.3Implementation Guidelines for Server Programmers  p. 20
8.4Implementation Guidelines for Client Programmers  p. 20
8.5Tracking the changes in the specifications  p. 20
8.5.1New Tag  p. 20
8.5.2Deprecated Tag  p. 21
8.6Technology realization rules  p. 21
8.6.1Corba IDL Rules  p. 21
8.6.2Java rules  p. 21
8.7Rules for removal of deprecated items from the specifications  p. 21
A(Normative)  OMG IDL  p. 22
A.1Tools and Languages  p. 22
A.2Namespace  p. 22
A.3Object References  p. 22
A.4Mapping of Datatypes  p. 22
A.4.1Basic Datatypes  p. 22
A.4.2Constants  p. 22
A.4.3Collections  p. 22
A.4.4Sequences  p. 23
A.4.5Enumerations  p. 23
A.4.6Choices  p. 23
A.5Use of NULL  p. 24
A.6Exceptions  p. 24
A.7Naming space across CORBA modules  p. 24
BW3C WSDL  p. 25
B.1Tools and Languages  p. 25
B.2Proposed Namespaces for the OSA WSDL  p. 25
B.3Object References  p. 26
B.4Mapping UML Data Types to XML Schema  p. 26
B.4.1Data Types  p. 26
B.4.1.2<<Constant>>  p. 26
B.4.1.3<<NameValuePair>>  p. 27
B.4.1.4<<SequenceOfDataElements>>  p. 27
B.4.1.5<<TypeDef>>  p. 27
B.4.1.6<<NumberedSetOfDataElements>>  p. 28
B.4.1.7<<TaggedChoiceOfDataElements>>  p. 28
B.5Mapping of UML Interfaces to WSDL  p. 28
B.5.1Mapping of UML Operations to WSDL message element  p. 28
B.5.2Mapping of Exception to WSDL message element  p. 29
B.5.4Mapping of Interface Class to WSDL portType and binding elements  p. 29
B.5.5Mapping of UML Interfaces to WSDL service element  p. 30
CJava™ Realisation API  p. 31
C.1Java™ Realisation Overview  p. 31
C.1.1J2SE™ API  p. 31
C.1.2J2EE™ API  p. 31
C.1.3Javadoc™  p. 31
C.2Tools and languages  p. 32
C.3Generic mappings (Elements common to J2SE™ and J2EE™)  p. 32
C.3.1Namespace  p. 32
C.3.2Package Naming Conventions  p. 32
C.3.3Object References  p. 32
C.3.4Element Naming  p. 33
C.3.5Element Naming Collisions  p. 33
C.3.6Data Type Definitions  p. 33
C.3.6.1Basic Data Types  p. 33
C.3.6.2Constants  p. 33
C.3.6.3NumberedSetsOfDataElements (Collections)  p. 34
C.3.6.4SequenceOfDataElements (Structures)  p. 34
C.3.6.5NameValuePair (Enumerations)  p. 35
C.3.6.6TaggedChoiceOfDataElements (Unions)  p. 36
C.3.6.7Exceptions  p. 38
C.3.6.7.1PlatformException  p. 38
C.3.6.7.2P_XXX_XXX Exceptions  p. 39
C.3.6.7.3TpCommonExceptions  p. 39
C.3.6.7.4TpCommonException's associated exceptions  p. 40
C.3.6.7.5Additional abstract exceptions  p. 40
C.3.6.7.6InvalidUnionAccessorException  p. 41
C.3.6.7.7InvalidEnumValueException  p. 41
C.3.6.8Deprecation  p. 41
C.4J2SE™ Specific Conventions  p. 42
C.4.1Removal of "Tp" Prefix  p. 42
C.4.2Constants  p. 42
C.4.3Removal of "Ip" prefix  p. 43
C.4.4Mapping of IpInterface  p. 43
C.4.5Mapping of IpService  p. 43
C.4.6Mapping of UML Operations  p. 43
C.4.7Mapping of TpSessionID  p. 44
C.4.8Mapping of TpAssignmentID to the creation of an Activity object  p. 44
C.4.9Callback Rule  p. 47
C.4.10Factory Rule  p. 48
C.4.11J2SE™ Specific Exceptions  p. 50
C.4.11.1PeerUnavailableException  p. 50
C.4.11.2IllegalStateException  p. 50
C.4.12User Interaction Specific Rules  p. 51
C.4.12.1Interfaces representing UML IpUI and IpUICall Rule  p. 51
C.4.12.2Naming Collisions of IpUI and IpUICall Rule  p. 51
C.4.12.3Naming Collisions of IpUICall and IpUIAdminManager Rule  p. 51
C.5J2EE™ Specific Conventions  p. 51
C.5.1Void  p. …
C.5.2Remote Interface Definitions  p. 51
C.5.2.1IpInterface  p. 51
C.5.2.2Methods for Remote Interfaces  p. 51
C.5.3Local Interface Definitions  p. 52
C.5.3.1Methods for Local Interfaces  p. 52
C.5.4Multi Party Call Control Specific Rules  p. 52
C.5.4.1IpCallLeg and IpAppCallLeg method name conflicts  p. 52
DDescription of Overview for 3GPP2 cdma2000 networks  p. 53
D.1General Exceptions  p. 53
D.2Specific Exceptions  p. 53
D.2.1Clause 1: Scope  p. 53
D2.2Clause 2: References  p. 53
D2.3Clause 3: Definitions and abbreviations  p. 53
D2.4Clause 4: Open Service Access APIs  p. 53
D2.5Clause 5: Structure of the OSA API (29.198) and Mapping (29.998) documents  p. 53
D.2.6Clause 6: Methodology  p. 54
D.2.7Clause 7: Introduction to OSA APIs  p. 54
D.2.8Annex A (normative): OMG IDL  p. 54
D.2.9Annex B (informative): W3C WSDL  p. 54
D.2.10Annex C (informative): Java™ API  p. 54
$Change history  p. 55

Top