1、 UNION INTERNATIONALE DES TLCOMMUNICATIONS T.176 SECTEUR DE LA NORMALISATION DES TLCOMMUNICATIONS DE LUIT (02/98) SRIE T: TERMINAUX DES SERVICES TLMATIQUES Interface de programmation dapplication pour la commande et le contrle de support de stockage numrique Recommandation UIT-T T.176 (Antrieurement
2、 Recommandation du CCITT) RECOMMANDATIONS UIT-T DE LA SRIE T TERMINAUX DES SERVICES TLMATIQUES Pour plus de dtails, voir la Liste des Recommandations de lUIT-T. RECOMMANDATION UIT-T T.176 INTERFACE DE PROGRAMMATION DAPPLICATION POUR LA COMMANDE ET LE CONTROLE DE SUPPORT DE STOCKAGE NUMERIQUE Rsum La
3、 prsente Recommandation donne la spcification de linterface de programmation dapplication (API, application programming interface) pour la commande et le contrle de support de stockage numrique (DSM-CC, digital storage media command and control) utiliser dans les applications multimdia de base. Sour
4、ce La Recommandation UIT-T T.176, labore par la Commission dtudes 16 (1997-2000) de lUIT-T, a t approuve le 6 fvrier 1998 selon la procdure dfinie dans la Rsolution n 1 de la CMNT. ii Recommandation T.176 (02/98) AVANT-PROPOS LUIT (Union internationale des tlcommunications) est une institution spcia
5、lise des Nations Unies dans le domaine des tlcommunications. LUIT-T (Secteur de la normalisation des tlcommunications) est un organe permanent de lUIT. Il est charg de ltude des questions techniques, dexploitation et de tarification, et met ce sujet des Recommandations en vue de la normalisation des
6、 tlcommunications lchelle mondiale. La Confrence mondiale de normalisation des tlcommunications (CMNT), qui se runit tous les quatre ans, dtermine les thmes dtudes traiter par les Commissions dtudes de lUIT-T lesquelles laborent en retour des Recommandations sur ces thmes. Lapprobation des Recommand
7、ations par les Membres de lUIT-T seffectue selon la procdure dfinie dans la Rsolution n 1 de la CMNT. Dans certains secteurs de la technologie de linformation qui correspondent la sphre de comptence de lUIT-T, les normes ncessaires se prparent en collaboration avec lISO et la CEI. NOTE Dans la prsen
8、te Recommandation, lexpression “Administration“ est utilise pour dsigner de faon abrge aussi bien une administration de tlcommunications quune exploitation reconnue. DROITS DE PROPRIT INTELLECTUELLE LUIT attire lattention sur la possibilit que lapplication ou la mise en uvre de la prsente Recommanda
9、tion puisse donner lieu lutilisation dun droit de proprit intellectuelle. LUIT ne prend pas position en ce qui concerne lexistence, la validit ou lapplicabilit des droits de proprit intellectuelle, quils soient revendiqus par un Membre de lUIT ou par une tierce partie trangre la procdure dlaboration
10、 des Recommandations. A la date dapprobation de la prsente Recommandation, lUIT navait pas t avise de lexistence dune proprit intellectuelle protge par des brevets acqurir pour mettre en uvre la prsente Recommandation. Toutefois, comme il ne sagit peut-tre pas de renseignements les plus rcents, il e
11、st vivement recommand aux responsables de la mise en uvre de consulter la base de donnes des brevets du TSB. UIT 1998 Droits de reproduction rservs. Aucune partie de cette publication ne peut tre reproduite ni utilise sous quelque forme que ce soit et par aucun procd, lectronique ou mcanique, y comp
12、ris la photocopie et les microfilms, sans laccord crit de lUIT. Recommandation T.176 (02/98) iii TABLE DES MATIRES Page 1 Domaine dapplication 1 2 Rfrences normatives 1 3 Dfinitions et abrviations 1 3.1 Dfinitions 1 3.2 Abrviations 2 4 Aperu gnral 2 4.1 Format dchange dapplication DAVIC . 2 4.2 Ense
13、mble essentiel dinterfaces API Java . 3 5 Module davic.CosNaming 4 5.1 Classe davic.CosNaming.NameComponent . 4 5.2 Classe davic.CosNaming.Binding 4 5.3 Anomalie davic.CosNaming.NotFound 4 5.4 Anomalie davic.CosNaming.CannotProceed 4 5.5 Anomalie davic.CosNaming.InvalidName . 5 5.6 Classe davic.CosN
14、aming.BindingIterator. 5 5.7 Interface davic.CosNaming.NamingContext 5 6 Module davic.dsmccuu . 5 6.1 Classe davic.dsmccuu.Step . 5 6.2 Anomalie davic.dsmccuu.SERVICE_XFR 6 6.3 Anomalie davic.dsmccuu.dsmccuuException 6 6.4 Anomalie davic.dsmccuu.INV_OFFSET . 6 6.5 Anomalie davic.dsmccuu.INV_SIZE 6 6
15、.6 Anomalie davic.dsmccuu.READ_LOCKED 6 6.7 Anomalie davic.dsmccuu.WRITE_LOCKED 6 6.8 Anomalie davic.dsmccuu.OPEN_LIMIT 7 6.9 Anomalie davic.dsmccuu.NO_AUTH 7 6.10 Anomalie davic.dsmccuu.UNK_USER 7 6.11 Anomalie davic.dsmccuu.BAD_COMPAT_INFO. 7 6.12 Anomalie davic.dsmccuu.NO_RESUME. 7 6.13 Anomalie
16、davic.dsmccuu.NO_SUSPEND . 7 6.14 Interface davic.dsmccuu.Base. 7 6.15 Classe davic.dsmccuu.File 7 6.16 Classe davic.dsmccuu.Directory. 8 iv Recommandation T.176 (02/98) Page 6.17 Interface davic.dsmccuu.SessionI. 9 6.18 Classe davic.dsmccuu.Session 9 6.19 Classe davic.dsmccuu.SessionGateway 10 Reco
17、mmandation T.176 INTERFACE DE PROGRAMMATION DAPPLICATION POUR LA COMMANDE ET LE CONTROLE DE SUPPORT DE STOCKAGE NUMERIQUE (Genve, 1998) 1 Domaine dapplication La prsente Recommandation donne la spcification de linterface de programmation dapplication (API, application programming interface) pour la
18、commande et le contrle de mdia de stockage numrique (DSM-CC, digital storage media command and control) utiliser dans les applications multimdia de base. La prsente Recommandation sapplique aux systmes DAVIC conformes. 2 Rfrences normatives La prsente Recommandation se rfre certaines dispositions de
19、s Recommandations UIT-T et textes suivants qui de ce fait en sont partie intgrante. Les versions indiques taient en vigueur au moment de la publication de la prsente Recommandation. Toute Recommandation ou tout texte tant sujet rvision, les utilisateurs de la prsente Recommandation sont invits se re
20、porter, si possible, aux versions les plus rcentes des rfrences normatives suivantes. La liste des Recommandations de lUIT-T en vigueur est rgulirement publie. 1 ETS 300 777-3, Terminal equipment (TE); End-to-end protocols for multimedia information retrieval services; Part 3: Application Programmab
21、le Interface (API) for MHEG-5. 2 ISO/CEI DIS 13818-6, Technologies de linformation Codage gnrique des images animes et des informations sonores associes Partie 6: Extensions pour DSM-CC. 3 ISO/CEI 13522-5: 1997, Technologies de linformation Codage de linformation multimdia et hypermdia Partie 5: Sup
22、port pour applications interactives de niveau fondamental. 4 ISO/CEI DIS 13522-6, Technologies de linformation Codage de linformation multimdia et hypermdia Partie 6: Support pour les applications interactives amliores. 5 ETS 300 777-1, Terminal Equipment (TE); End-to-end protocols for multimedia in
23、formation retrieval services; Part 1: Coding of multimedia and hypermedia information for basic multimedia applications (MHEG-5). 3 Dfinitions et abrviations 3.1 Dfinitions Dans la prsente Recommandation, on utilise les dfinitions donnes dans lISO/CEI DIS 13818-6 2. La prsente Recommandation dfinit
24、les termes suivants: 3.1.1 interface de programmation dapplication (API, application programmable interface): frontire travers laquelle une application logicielle utilise des lments de langages de programmation pour invoquer des services logiciels. Ces lments peuvent comprendre des procdures ou des
25、oprations, des objets de donnes partags et la rsolution didentificateurs. 2 Recommandation T.176 (02/98) 3.1.2 application locale: sous-ensemble logiciel qui fait partie de lapplication (de tlcommunication) et qui tourne sur lquipement considr. 3.2 Abrviations La prsente Recommandation utilise les a
26、brviations suivantes: API interface de programmation dapplication (application programming interface) ASN.1 notation de syntaxe abstraite numro un (abstract syntax notation one) DAVIC consortium DAVIC (digital audio visual council) DSM-CC commande et contrle de mdia de stockage numrique (digital sto
27、rage media command and control) MHEG groupe dexperts pour le codage de linformation multimdia et hypermdia (multimedia and hypermedia information coding experts group) SI information de service (service information) STU dispositif dadaptation multimdia (set top unit) VM machine virtuelle (virtual ma
28、chine) 4 Aperu gnral Le paragraphe qui suit permet de positionner linterface API dfinie dans la prsente Recommandation dans le cadre gnral des spcifications DAVIC. 4.1 Format dchange dapplication DAVIC Pour distribuer des informations multimdia des dispositifs STU dans un environnement dinterfonctio
29、nnement, les applications doivent utiliser le format dchange MHEG-5 de type forme finale, tel quil est dfini dans lISO/CEI 13522-5 3. Le codage et la notation ASN.1, tels quils sont dfinis dans la Norme ETS 300 777-1 4, doivent tre utiliss pour lchange dobjets MHEG-5. Ce format donne la dfinition de
30、 la smantique et du codage des objets multimdia et hypermdia. Pour distribuer un code de programme des dispositifs STU dans un environnement dinterfonctionnement, les applications doivent utiliser la classe MHEG-5 InterchangedProgram (programme chang) pour encapsuler le code de machine virtuelle Jav
31、a1, conformment la smantique et au codage dfinis dans lISO/CEI DIS 13522-6 5. Les classes de machine virtuelle Java sont appeles partir dobjets MHEG-5 au moyen des actions lmentaires MHEG-5 Call et Fork. Lunit dchange de code de machine virtuelle Java est une classe de machine virtuelle Java. De tel
32、les classes doivent tre codes conformment la dfinition donne dans la section relative au format de la classe File (class file format) de la spcification de la machine virtuelle Java (Java virtual machine specification). Une classe Java encapsule des donnes et des mthodes qui sont composes de squence
33、s dinstructions. Lensemble des instructions est dfini dans la section relative lensemble des instructions de machine virtuelle Java (Java virtual machine instruction set) de la spcification de cette machine (Java virtual machine specification). _ 1Java est une marque ou une marque dpose de Sun Micro
34、systems, Inc. Recommandation T.176 (02/98) 3 4.2 Ensemble essentiel dinterfaces API Java Lensemble dinterfaces API correspondant aux modules numrs ci-aprs est utilis par le code de machine virtuelle Java dans les spcifications DAVIC 1.1 1 afin dexprimer laccs aux fonctions de bases du dispositif STU
35、 dans un environnement dinterfonctionnement: le module java.lang; le module java.util; le module iso.mheg5; le module davic.dsmccuu; le module etsi.si. NOTE 1 La spcification de la machine virtuelle Java fournit des mcanismes souples permettant dappeler des fonctions externes dont linterface est dfi
36、nie comme tant un module Java. La spcification DAVIC 1.1 ne comprend quun ensemble essentiel minimal de modules ncessaires pour que le code de machine virtuelle Java soit utile dans un environnement DAVIC. Dautres modules Java devraient tre normaliss ultrieurement. NOTE 2 Bien qu proprement parler i
37、l ne soit pas ncessaire pour la qualit de fonctionnement voulue de lenvironnement de machine virtuelle, le module java.io fait partie des classes Java fondamentales. Il est prvu dajouter le module java.io lensemble essentiel DAVIC dinterfaces API Java conjointement avec une spcification approprie de
38、 sa smantique dans un environnement DAVIC. Le module java.lang, tel quil est dfini dans le document relatif aux interfaces API Java (Java API documentation), est constitu de lensemble minimal de classes de machine virtuelle Java ncessaires pour faire tourner le code de machine virtuelle Java, ces cl
39、asses prenant en charge les fonctionnalits suivantes: types de donnes de base, objet, oprations mathmatiques, scurit, gestion des chemins, manipulation des chanes, traitement des anomalies. Le module java.util, tel quil est dfini dans le document relatif aux interfaces API Java (Java API documentati
40、on), est constitu de classes de machine virtuelle Java prenant en charge un certain nombre dutilitaires communs tous les programmes de machine virtuelle Java. Le module iso.mheg5, tel quil est dfini dans la Norme ETS 300 777-3 1, fournit le code de machine virtuelle Java avec accs aux objets de prse
41、ntation et dinteraction multimdia MHEG-5 et avec manipulation de ces objets, cest-dire avec accs aux attributs dynamiques des objets MHEG-5 et avec invocation dactions lmentaires sur les objets MHEG-5. Le module davic.dsmccuu et le module davic.CosNaming associ permettent au code de machine virtuell
42、e Java dutiliser les objets interface utilisateur-utilisateur DSM-CC pour laccs aux donnes de rseau. Le module davic.dsmccuu et le module davic.CosNaming associ permettent de donner accs un sous-ensemble de linterface API utilisateur-utilisateur DSM-CC dfinie dans lISO/CEI DIS 13818-6. Ce sous-ensem
43、ble comprend: les oprations list (listage) et resolve (rsolution) associes linterface abstraite NamingContext; les oprations close (fermeture) et destroy (destruction) associes linterface abstraite Base; les oprations next_one (passage au suivant) et next_n (passage aux N suivants) associes linterfa
44、ce instanciable BindingIterator; les oprations open (ouverture) et close (fermeture) associes linterface instanciable Directory; 4 Recommandation T.176 (02/98) les oprations read (lecture) et write (criture) ainsi que lattribut en lecture seule ContentSize (dimension de contenu) associs linterface F
45、ile; les oprations attach (rattachement) et detach (dtachement) associes linterface instanciable Session; linterface instanciable SessionGateway. Le module etsi.si permet au code de machine virtuelle Java daccder aux informations transmises dans le flux dinformations de service DAVIC. 5 Module davic
46、.CosNaming 5.1 Classe davic.CosNaming.NameComponent package davic.CosNaming; public class NameComponent public String id; public String kind; 5.2 Classe davic.CosNaming.Binding package davic.CosNaming; public class Binding / constant declarations for the “binding_type“ attribute public static final
47、short nobject = 0; public static final short ncontext = 1; public NameComponent binding_name; public int binding_type; 5.3 Anomalie davic.CosNaming.NotFound package davic.CosNaming; public class NotFound extends Exception / constant declarations for the “why“ attribute public static final short miss
48、ing_node = 0; public static final short not_context = 1; public static final short not_object = 2; public int why; public NameComponent rest_of_name; 5.4 Anomalie davic.CosNaming.CannotProceed package davic.CosNaming; public class CannotProceed extends Exception public NamingContext cxt; public NameComponen