1、 ETSI ES 202 915-1 V1.4.1 (2006-12)ETSI Standard Open Service Access (OSA);Application Programming Interface (API);Part 1: Overview(Parlay 4)floppy3 ETSI ETSI ES 202 915-1 V1.4.1 (2006-12) 2 Reference RES/TISPAN-01028-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 2006. The Parlay Group 2006. All rights reserved. DECTTM, PLUGTESTSTM and UMTSTM are Trade Marks of ETSI registered for the benefit of its Members. TIPHONTMand the TIPHON logo are Trade Marks currently being regi
7、stered by ETSI for the benefit of its Members. 3GPPTM is a Trade Mark of ETSI registered for the benefit of its Members and of the 3GPP Organizational Partners. ETSI ETSI ES 202 915-1 V1.4.1 (2006-12) 3 Contents Intellectual Property Rights6 Foreword.6 1 Scope 7 2 References 7 3 Definitions and abbr
8、eviations.10 3.1 Definitions10 3.2 Abbreviations .11 4 Open Service Access APIs.12 5 Document structure 13 6 Methodology 14 6.1 Tools and Languages14 6.2 Packaging Structure14 6.3 Colours .16 6.4 Naming scheme 17 6.5 State Transition Diagram text and text symbols.17 6.6 Exception handling and passin
9、g results17 6.7 References 18 6.8 Strings and Collections.18 6.9 Prefixes.18 7 Introduction to Parlay/OSA APIs.18 7.1 Interface Types.18 7.2 Service Factory.18 7.3 Use of Sessions.19 7.4 Interfaces and Sessions.19 7.5 Callback Interfaces.19 7.6 Setting Callbacks19 7.7 Synchronous versus Asynchronous
10、 Methods .19 7.8 Out Parameters .20 7.9 Exception Hierarchy.20 7.10 Common Exceptions 20 7.11 Use of NULL20 7.12 Notification Handling.21 8 Relationship between ETSI, Parlay and 3GPP OSA releases 21 Annex A (normative): OMG IDL .23 A.1 Tools and languages .23 A.2 Namespace .23 A.3 Object References.
11、23 A.4 Mapping of Datatypes 23 A.4.1 Basic Datatypes 23 A.4.2 Constants 23 A.4.3 Collections23 A.4.4 Sequences.24 A.4.5 Enumerations24 A.4.6 Choices.24 A.5 Use of NULL24 A.6 Exceptions 25 ETSI ETSI ES 202 915-1 V1.4.1 (2006-12) 4 A.7 Naming space across CORBA modules.25 Annex B (informative): W3C WS
12、DL26 Annex C (informative): Java Realisation API .27 C.1 Java Realisation Overview .27 C.1.1 J2SE API 27 C.1.2 J2EE API 27 C.1.3 Javadoc .27 C.2 Tools and languages .28 C.3 Generic Mappings (Elements common to J2SE and J2EE)28 C.3.1 Namespace .28 C.3.2 Package Naming Conventions28 C.3.3 Object Refer
13、ences.28 C.3.4 Element Naming.29 C.3.5 Element Naming Collisions29 C.3.6 Data Type Definitions 29 C.3.6.1 Basic Data Types 29 C.3.6.2 Constants 29 C.3.6.3 NumberedSetsOfDataElements (Collections).30 C.3.6.4 SequenceOfDataElements (Structures).30 C.3.6.5 NameValuePair (Enumerations) .31 C.3.6.6 Tagge
14、dChoiceOfDataElements (Unions) .32 C.3.6.7 Exceptions.34 C.3.6.7.1 PlatformException 34 C.3.6.7.2 P_XXX_XXX Exceptions 35 C.3.6.7.3 TpCommonExceptions35 C.3.6.7.4 TpCommonExceptions associated exceptions36 C.3.6.7.5 Additional abstract exceptions 36 C.3.6.7.6 InvalidUnionAccessorException.37 C.3.6.7
15、.7 InvalidEnumValueException 37 C.3.6.8 Deprecation.37 C.4 J2SE Specific Conventions.38 C.4.1 Removal of “Tp“ Prefix38 C.4.2 Constants 38 C.4.3 Removal of “Ip“ prefix .38 C.4.4 Mapping of IpInterface.39 C.4.5 Mapping of IpService.39 C.4.6 Mapping of UML Operations.39 C.4.7 Mapping of TpSessionID .40
16、 C.4.8 Mapping of TpAssignmentID to the creation of an Activity object .40 C.4.9 Callback Rule .43 C.4.10 Factory Rule .44 C.4.11 J2SE Specific Exceptions .45 C.4.11.1 PeerUnavailableException45 C.4.11.2 IllegalStateException46 C.4.12 User Interaction Specific Rules 46 C.4.12.1 Interfaces representi
17、ng UML IpUI and IpUICall Rule .46 C.4.12.2 Naming Collisions of GUI and CUI Activities Rule 46 C.5 J2EE Specific Conventions 46 C.5.1 Void47 C.5.2 Remote Interface Definitions .47 C.5.2.1 IpInterface.47 C.5.2.2 Methods for Remote Interfaces.47 C.5.3 Local Interface Definitions.47 C.5.3.1 Methods for
18、 Local Interfaces47 C.5.4 Multi Party Call Control Specific Rules.47 C.5.4.1 IpCallLeg and IpAppCallLeg method name conflicts 47 ETSI ETSI ES 202 915-1 V1.4.1 (2006-12) 5 Annex D (informative): Bibliography.49 History 50 ETSI ETSI ES 202 915-1 V1.4.1 (2006-12) 6 Intellectual Property Rights IPRs ess
19、ential or potentially essential to the present document may have been 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 potenti
20、ally Essential, IPRs notified to ETSI in respect of ETSI standards“, which 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
21、 by ETSI. No guarantee can be given as to the existence of other IPRs 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 Telec
22、ommunications and Internet converged Services and Protocols for Advanced 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 202 915) is structured
23、in the following parts: Part 1: “Overview“; Part 2: “Common Data Definitions“; 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: “Conn
24、ectivity Manager SCF“; Part 11: “Account Management SCF“; Part 12: “Charging SCF“; Part 13: “Policy Management SCF“; Part 14: “Presence and Availability Management SCF“. The present document has been defined jointly between ETSI, The Parlay Group (http:/www.parlay.org) and the 3GPP, in co-operation
25、with a number of JAIN Community (http:/ member companies. The present document forms part of the Parlay 4.3 set of specifications. The present document is equivalent to 3GPP TS 29.198-1 V5.8.3 (Release 5). ETSI ETSI ES 202 915-1 V1.4.1 (2006-12) 7 1 Scope The present document is the part 1 of the St
26、age 3 specification for an Application 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
27、 service application developers to make use of network functionality through an open standardized interface, i.e. the OSA APIs. 2 References The following documents contain provisions which, through reference in this text, constitute provisions of the present document. References are either specific
28、 (identified by date of publication and/or edition number or version number) or non-specific. For a specific reference, subsequent revisions do not apply. For a non-specific reference, the latest version applies. Referenced documents which are not found to be publicly available in the expected locat
29、ion might be found at http:/docbox.etsi.org/Reference. NOTE: While any hyperlinks included in this clause were valid at the time of publication ETSI cannot guarantee their long term validity. 1 ETSI TR 121 905: “Universal Mobile Telecommunications System (UMTS); Vocabulary for 3GPP Specifications (3
30、GPP 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 Subscriber Signal
31、ling 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 System (UMTS)
32、; 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/). 7 ETSI TS 129 002: “Digital cellular telecommunications system (Phase 2+); Univer
33、sal 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 Applications for Mobile network Enhanced Logic (CAMEL);
34、 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 telecommunications system (Phase 2+) (GSM); Universal
35、Mobile Telecommunications System (UMTS); Circuit Bearer Services (BS) supported by a Public Land Mobile Network (PLMN) (3GPP TS 22.002)“. ETSI ETSI ES 202 915-1 V1.4.1 (2006-12) 8 11 ETSI TS 122 003: “Digital cellular telecommunications system (Phase 2+); Universal Mobile Telecommunications System (
36、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 (
37、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
38、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
39、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
40、 Access (OSA) Application Programming Interface (API); (3GPP TS 29.198 Release 5)“. 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+)
41、; Universal Mobile Telecommunications System (UMTS); Location Services (LCS); Functional description; Stage 2 (3GPP TS 23.271)“. 24 ANSI T1.113: “Signalling System No. 7 (SS7) - Integrated Services Digital Network (ISDN) User Part“. 25 IETF RFC 3261: “SIP: Session Initiation Protocol“. 26 ITU-T Reco
42、mmendation Q.932: “Digital subscriber signalling system No. 1 - Generic procedures for the control of ISDN supplementary services“. 27 ITU-T Recommendation H.221: “Frame structure for a 64 to 1920 kbit/s channel in audiovisual teleservices“. 28 ITU-T Recommendation H.323: “Packet-based multimedia co
43、mmunications systems“. 29 IETF RFC 1994: “PPP Challenge Handshake Authentication Protocol (CHAP)“. 30 IETF RFC 2630: “Cryptographic Message Syntax“. 31 IETF RFC 2313: “PKCS #1: RSA Encryption Version 1.5“. 32 IETF RFC 2459: “Internet X.509 Public Key Infrastructure Certificate and CRL Profile“. 33 I
44、ETF RFC 2437: “PKCS #1: RSA Cryptography Specifications Version 2.0“. 34 IETF RFC 1321: “The MD5 Message-Digest Algorithm“. 35 IETF RFC 2404: “The Use of HMAC-SHA-1-96 within ESP and AH“. 36 IETF RFC 2403: “The Use of HMAC-MD5-96 within ESP and AH“. ETSI ETSI ES 202 915-1 V1.4.1 (2006-12) 9 37 ITU-T
45、 Recommendation G.722: “7 kHz audio-coding within 64 kbit/s“. 38 ITU-T Recommendation G.711: “Pulse code modulation (PCM) of voice frequencies“. 39 ITU-T Recommendation G.723.1: “Speech coders: Dual rate speech coder for multimedia communications transmitting at 5.3 and 6.3 kbit/s“. 40 ITU-T Recomme
46、ndation G.728: “Coding of speech at 16 kbit/s using low-delay code excited linear prediction“. 41 ITU-T Recommendation G.729: “Coding of speech at 8 kbit/s using conjugate-structure algebraic-code-excited linear-prediction (CS-ACELP)“. 42 ITU-T Recommendation H.261: “Video codec for audiovisual serv
47、ices at p x 64 kbit/s“. 43 ITU-T Recommendation H.263: “Video coding for low bit rate communication“. 44 ITU-T Recommendation H.262: “Information technology - Generic coding of moving pictures and associated audio information: Video“. 45 World Geodetic System 1984 (WGS 84) (http:/ NOTE: The above li
48、nk is temporarily not accessible. The following mirror site may contain the same information, but has not been verified by ETSI. http:/octopus.hit.bme.hu/tkatona/mirrors/WGS84/ 46 ITU-T Recommendation X.400: “Message handling services: Message handling system and service overview“. 47 ITU-T Recommen
49、dation E.164: “The international public telecommunication numbering plan“. 48 IETF RFC 2445: “Internet Calendaring and Scheduling Core Object Specification (iCalendar)“. 49 IETF RFC 2778: “A Model for Presence and Instant Messaging“. 50 ETSI ES 202 915-2: “Open Service Access (OSA); Application Programming Interface (API); Part 2: Common Data Definitions (Par
