1、 ETSI ES 203 915-1 V1.3.1 (2008-04)ETSI Standard Open Service Access (OSA);Application Programming Interface (API);Part 1: Overview(Parlay 5)floppy3 ETSI ETSI ES 203 915-1 V1.3.1 (2008-04) 2 Reference RES/TISPAN-01055-01-OSA Keywords API, IDL, OSA, UML ETSI 650 Route des Lucioles F-06921 Sophia Anti
2、polis Cedex - FRANCE Tel.: +33 4 92 94 42 00 Fax: +33 4 93 65 47 16 Siret N 348 623 562 00017 - NAF 742 C Association but non lucratif enregistre la Sous-Prfecture de Grasse (06) N 7803/88 Important notice Individual copies of the present document can be downloaded from: http:/www.etsi.org The prese
3、nt document may be made available in more than one electronic version or in print. In any case of existing or perceived difference in contents between such versions, the reference version is the Portable Document Format (PDF). In case of dispute, the reference shall be the printing on ETSI printers
4、of the PDF version kept on a specific network drive within ETSI Secretariat. Users of the present document should be aware that the document may be subject to revision or change of status. Information on the current status of this and other ETSI documents is available at http:/portal.etsi.org/tb/sta
5、tus/status.asp If you find errors in the present document, please send your comment to one of the following services: http:/portal.etsi.org/chaircor/ETSI_support.asp Copyright Notification No part may be reproduced except as authorized by written permission. The copyright and the foregoing restricti
6、on extend to reproduction in all media. European Telecommunications Standards Institute 2008. The Parlay Group 2008. All rights reserved. DECTTM, PLUGTESTSTM, UMTSTM, TIPHONTM, the TIPHON logo and the ETSI logo are Trade Marks of ETSI registered for the benefit of its Members. 3GPPTM is a Trade Mark
7、 of ETSI registered for the benefit of its Members and of the 3GPP Organizational Partners. ETSI ETSI ES 203 915-1 V1.3.1 (2008-04) 3 Contents Intellectual Property Rights6 Foreword.6 1 Scope 7 2 References 7 2.1 Normative references .7 2.2 Informative references10 3 Definitions and abbreviations.11
8、 3.1 Definitions11 3.2 Abbreviations .11 4 Open Service Access APIs.13 5 Document structure 14 6 Methodology 15 6.1 Tools and Languages15 6.2 Packaging Structure15 6.3 Colours .18 6.4 Naming scheme 18 6.5 State Transition Diagram text and text symbols.18 6.6 Exception handling and passing results19
9、6.7 References 19 6.8 Strings and Collections.19 6.9 Prefixes.19 7 Introduction to Parlay/OSA APIs.19 7.1 Interface Types.19 7.2 Service Factory.20 7.3 Use of Sessions.20 7.4 Interfaces and Sessions.20 7.5 Callback Interfaces.20 7.6 Setting Callbacks20 7.7 Synchronous versus Asynchronous Methods .20
10、 7.8 Out Parameters .21 7.9 Exception Hierarchy.21 7.10 Common Exceptions 21 7.11 Use of NULL22 7.12 Notification Handling.22 8 Relationship between ETSI, Parlay and 3GPP OSA releases 23 9 Backwards Compatibility Considerations 24 9.1 Guidelines to enable backwards compatibility in implementations .
11、24 9.2 Rule summary 24 9.2.1 Server side permitted changes 24 9.2.2 Client side permitted changes .24 9.2.3 Data type permitted changes.25 9.3 Implementation Guidelines for Server Programmers .25 9.4 Implementation Guidelines for Client Programmers25 9.5 Tracking the changes in the specifications .2
12、5 9.5.1 New Tag .25 9.5.2 Deprecated Tag.25 9.6 Technology realization rules 26 9.6.1 Corba IDL Rules.26 9.6.2 Java rules 26 9.7 Rules for removal of deprecated items from the specifications26 ETSI ETSI ES 203 915-1 V1.3.1 (2008-04) 4 Annex A (normative): OMG IDL .27 A.1 Tools and languages .27 A.2
13、Namespace .27 A.3 Object References.27 A.4 Mapping of Datatypes 27 A.4.1 Basic Datatypes 27 A.4.2 Constants 27 A.4.3 Collections28 A.4.4 Sequences.28 A.4.5 Enumerations28 A.4.6 Choices.28 A.5 Use of NULL29 A.6 Exceptions 29 A.7 Naming space across CORBA modules.29 Annex B (informative): W3C WSDL30 B
14、.1 Tools and Languages30 B.2 Proposed Namespaces for the OSA WSDL .30 B.3 Object References.31 B.4 Mapping UML Data Types to XML Schema.31 B.4.1 Data Types31 B.4.1.1 .32 B.4.1.2 32 B.4.1.3 32 B.4.1.4 .33 B.4.1.5 .33 B.4.1.6 33 B.5 Mapping of UML Interfaces to WSDL 34 B.5.1 Mapping of UML Operations
15、to WSDL message element.34 B.5.2 Mapping of Exception to WSDL message element34 B.5.3 Mapping of Interface Class to WSDL portType and binding elements34 B.5.4 Mapping of UML Interfaces to WSDL service element.35 Annex C (informative): Java Realisation API .36 C.1 Java Realisation Overview .36 C.1.1
16、J2SE API 36 C.1.2 J2EE API 36 C 1.3 Javadoc .36 C.2 Tools and languages .37 C.3 Generic Mappings (Elements common to J2SE and J2EE)37 C.3.1 Namespace .37 C.3.2 Package Naming Conventions37 C.3.3 Object References.37 C.3.4 Element Naming.38 C.3.5 Element Naming Collisions38 C.3.6 Data Type Definition
17、s 38 C.3.6.1 Basic Data Types 38 C.3.6.2 Constants 38 C.3.6.3 NumberedSetsOfDataElements (Collections).39 C.3.6.4 SequenceOfDataElements (Structures).39 C.3.6.5 NameValuePair (Enumerations) .40 C.3.6.6 TaggedChoiceOfDataElements (Unions) .41 ETSI ETSI ES 203 915-1 V1.3.1 (2008-04) 5 C.3.6.7 Exceptio
18、ns.43 C.3.6.7.1 PlatformException 43 C.3.6.7.2 P_XXX_XXX Exceptions 44 C.3.6.7.3 TpCommonExceptions44 C.3.6.7.4 TpCommonExceptions associated exceptions45 C.3.6.7.5 Additional abstract exceptions 45 C.3.6.7.6 InvalidUnionAccessorException.46 C.3.6.7.7 InvalidEnumValueException 46 C.3.6.8 Deprecation
19、.46 C.4 J2SE Specific Conventions.47 C.4.1 Removal of “Tp“ Prefix47 C.4.2 Constants 47 C.4.3 Removal of “Ip“ prefix .47 C.4.4 Mapping of IpInterface.48 C.4.5 Mapping of IpService.48 C.4.6 Mapping of UML Operations.48 C.4.7 Mapping of TpSessionID .49 C.4.8 Mapping of TpAssignmentID to the creation of
20、 an Activity object .49 C.4.9 Callback Rule .53 C.4.10 Factory Rule .53 C.4.11 J2SE Specific Exceptions .55 C.4.11.1 PeerUnavailableException55 C.4.11.2 IllegalStateException55 C.4.12 User Interaction Specific Rules 56 C.4.12.1 Interfaces representing UML IpUI and IpUICall Rule .56 C.4.12.2 Naming C
21、ollisions of IpUI and IpUICall Rule .56 C.4.12.3 Naming Collisions of IpUICall and IpUIAdminManager Rule 56 C.5 J2EE Specific Conventions 56 C.5.1 Void56 C.5.2 Remote Interface Definitions .56 C.5.2.1 IpInterface.56 C.5.2.2 Methods for Remote Interfaces.56 C.5.3 Local Interface Definitions.57 C.5.3.
22、1 Methods for Local Interfaces57 C.5.4 Multi Party Call Control Specific Rules.57 C.5.4.1 IpCallLeg and IpAppCallLeg method name conflicts 57 Annex D (informative): Description of Overview for 3GPP2 cdma2000 networks58 D.1 General Exceptions.58 D.2 Specific Exceptions58 D.2.1 Clause 1: Scope 58 D.2.
23、2 Clause 2: References 58 D.2.3 Clause 3: Definitions and abbreviations.58 D.2.4 Clause 4: Open Service Access APIs .58 D.2.5 Clause 5: Structure of the OSA API (29.198) and Mapping (29.998) documents .58 D.2.6 Clause 6: Methodology 58 D.2.7 Clause 7: Introduction to OSA APIs 58 D.2.8 Annex A (norma
24、tive): OMG IDL.59 D.2.9 Annex B (informative): W3C WSDL.59 D.2.10 Annex C (informative): Java API.59 Annex E (informative): Bibliography.60 History 61 ETSI ETSI ES 203 915-1 V1.3.1 (2008-04) 6 Intellectual Property Rights IPRs essential or potentially essential to the present document may have been
25、declared to ETSI. The information pertaining to these essential IPRs, if any, is publicly available for ETSI members and non-members, and can be found in ETSI SR 000 314: “Intellectual Property Rights (IPRs); Essential, or potentially Essential, IPRs notified to ETSI in respect of ETSI standards“, w
26、hich is available from the ETSI Secretariat. Latest updates are available on the ETSI Web server (http:/webapp.etsi.org/IPR/home.asp). Pursuant to the ETSI IPR Policy, no investigation, including IPR searches, has been carried out by ETSI. No guarantee can be given as to the existence of other IPRs
27、not referenced in ETSI SR 000 314 (or the updates on the ETSI Web server) which are, or may be, or may become, essential to the present document. Foreword This ETSI Standard (ES) has been produced by ETSI Technical Committee Telecommunications and Internet converged Services and Protocols for Advanc
28、ed Networking (TISPAN). The present document is part 1 of a multi-part deliverable covering Open Service Access (OSA); Application Programming Interface (API), as identified below. The API specification (ES 203 915) is structured in the following parts: Part 1: “Overview“; Part 2: “Common Data Defin
29、itions“; Part 3: “Framework“; Part 4: “Call Control“; Part 5: “User Interaction SCF“; Part 6: “Mobility SCF“; Part 7: “Terminal Capabilities SCF“; Part 8: “Data Session Control SCF“; Part 9: “Generic Messaging SCF“; Part 10: “Connectivity Manager SCF“; Part 11: “Account Management SCF“; Part 12: “Ch
30、arging SCF“; Part 13: “Policy Management SCF“; Part 14: “Presence and Availability Management SCF“; Part 15: “Multi-Media Messaging SCF“. The present document has been defined jointly between ETSI, The Parlay Group (http:/www.parlay.org) and the 3GPP, in co-operation with a number of JAIN Community
31、(http:/ member companies. The present document forms part of the Parlay 5.2 set of specifications. The present document is equivalent to 3GPP TS 29.198-1 V6.5.0 (Release 6). ETSI ETSI ES 203 915-1 V1.3.1 (2008-04) 7 1 Scope The present document is part 1 of the Stage 3 specification for an Applicati
32、on Programming Interface for Open Service Access (OSA), and provides an overview of the content and structure of the various parts of the present document, and of the relation to other standards documents. The OSA specifications define an architecture that enables service application developers to m
33、ake use of network functionality through an open standardized interface, i.e. the OSA APIs. 2 References References are either specific (identified by date of publication and/or edition number or version number) or non-specific. For a specific reference, subsequent revisions do not apply. Non-specif
34、ic reference may be made only to a complete document or a part thereof and only in the following cases: - if it is accepted that it will be possible to use all future changes of the referenced document for the purposes of the referring document; - for informative references. Referenced documents whi
35、ch are not found to be publicly available in the expected location might be found at http:/docbox.etsi.org/Reference. For online referenced documents, information sufficient to identify and locate the source shall be provided. Preferably, the primary source of the referenced document should be cited
36、, in order to ensure traceability. Furthermore, the reference should, as far as possible, remain valid for the expected life of the document. The reference shall include the method of access to the referenced document and the full network address, with the same punctuation and use of upper case and
37、lower case letters. NOTE: While any hyperlinks included in this clause were valid at the time of publication ETSI cannot guarantee their long term validity. 2.1 Normative references The following referenced documents are indispensable for the application of the present document. For dated references
38、, only the edition cited applies. For non-specific references, the latest edition of the referenced document (including any amendments) applies. 1 ETSI TR 121 905: “Digital cellular telecommunications system (Phase 2+); Universal Mobile Telecommunications System (UMTS); Vocabulary for 3GPP Specifica
39、tions (3GPP TR 21.905)“. 2 ETSI TS 122 024: “Digital cellular telecommunications system (Phase 2+); Universal Mobile Telecommunications System (UMTS); Description of Charge Advice Information (CAI) (3GPP TS 22.024)“. 3 ITU-T Recommendation Q.850: “Usage of cause and location in the Digital Subscribe
40、r Signalling System No. 1 and the Signalling System No. 7 ISDN User Part“. 4 ITU-T Recommendation Q.2931: “Digital Subscriber Signalling System No. 2 - User-Network Interface (UNI) layer 3 specification for basic call/connection control“. 5 ETSI TS 122 101: “Universal Mobile Telecommunications Syste
41、m (UMTS); Service aspects; Service principles (3GPP TS 22.101)“. 6 World Wide Web Consortium: “Composite Capability/Preference Profiles (CC/PP): A user side framework for content negotiation“. (http:/www.w3.org/TR/NOTE-CCPP/). ETSI ETSI ES 203 915-1 V1.3.1 (2008-04) 8 7 ETSI TS 129 002: “Digital cel
42、lular telecommunications system (Phase 2+); Universal Mobile Telecommunications System (UMTS); Mobile Application Part (MAP) specification (3GPP TS 29.002)“. 8 ETSI TS 129 078: “Digital cellular telecommunications system (Phase 2+); Universal Mobile Telecommunications System (UMTS); customized Appli
43、cations for Mobile network Enhanced Logic (CAMEL); CAMEL Application Part (CAP) specification (3GPP TS 29.078)“. 9 Wireless Application Protocol (WAP), Version 2.0: “User Agent Profiling Specification“ (WAP-248). (http:/www.wapforum.org/what/technical.htm). 10 ETSI TS 122 002: “Digital cellular tele
44、communications system (Phase 2+); Universal Mobile Telecommunications System (UMTS); Circuit Bearer Services (BS) supported by a Public Land Mobile Network (PLMN) (3GPP TS 22.002)“. 11 ETSI TS 122 003: “Digital cellular telecommunications system (Phase 2+); Universal Mobile Telecommunications System
45、 (UMTS); Circuit Teleservices supported by a Public Land Mobile Network (PLMN) (3GPP TS 22.003)“. 12 ETSI TS 124 002: “Digital cellular telecommunications system (Phase 2+); Universal Mobile Telecommunications System (UMTS); GSM-UMTS Public Land Mobile Network (PLMN) Access Reference Configuration (
46、3GPP TS 24.002)“. 13 ITU-T Recommendation Q.763: “Signalling System No. 7 - ISDN User Part formats and codes“. 14 ITU-T Recommendation Q.931: “ISDN user-network interface layer 3 specification for basic call control“. 15 ISO 8601: “Data elements and interchange formats - Information interchange - Re
47、presentation of dates and times“. 16 ISO 4217: “Codes for the representation of currencies and funds“. 17 ISO 639: “Code for the representation of names of languages“. 18 IETF RFC 822: “Standard for the format of ARPA Internet text messages“. 19 IETF RFC 1738: “Uniform Resource Locators (URL)“. 20 E
48、TSI TS 129 198 (V3.4.0): “Universal Mobile Telecommunications System (UMTS); Open Service Architecture (OSA) Application Programming Interface (API) - Part 1 (3GPP TS 29.198 version 3.4.0 Release 1999)“. 21 ETSI TS 129 198 (all parts): “Universal Mobile Telecommunications System (UMTS); Open Service
49、 Access (OSA) Application Programming Interface (API); (3GPP TS 29.198 Release 6)“. 22 ETSI TS 123 107: “Universal Mobile Telecommunications System (UMTS); Quality of Service (QoS) concept and architecture“ (3GPP TS 23.107)“. 23 ETSI TS 123 271: “Digital cellular telecommunications system (Phase 2+); Universal Mobile Telecommunications System (UMTS); Functional stage 2 description of Location Services (LCS) (3GPP TS 23.271)“. 24 ANSI T1.113: “Signalling System No. 7 (SS7) - Int
