CORBA Scripting Language Specification Version 1.0 June 2001 Copyright © 1997-99 Laboratoire d’Informatique Fondamentale de Lille Copyright © 2001 Object Management Group Copyright © 1997-99 Object–Oriented Concepts, Inc. The companies listed above have granted to the Object Management Group, Inc. (OMG) a nonexclusive, royalty-free, paid up, worldwide license to copy and distribute this document and to modify this document and distribute copies of the modified version. Each of the copyright holders listed above has agreed that no person shall be deemed to have infringed the copyright in the included material of any such copyright holder by reason of having used the specification set forth herein or having conformed any computer software to the specification. PATENT The attention of adopters is directed to the possibility that compliance with or adoption of OMG specifications may require use of an invention covered by patent rights. OMG shall not be responsible for identifying patents for which a license may be required by any OMG specification, or for conducting legal inquiries into the legal validity or scope of those patents that are brought to its attention. OMG specifications are prospective and advisory only. Prospective users are responsible for protecting themselves against liability for infringement of patents. NOTICE The information contained in this document is subject to change without notice. The material in this document details an Object Management Group specification in accordance with the license and notices set forth on this page. This document does not represent a commitment to implement any portion of this specification in any company's products. WHILE THE INFORMATION IN THIS PUBLICATION IS BELIEVED TO BE ACCURATE, THE OBJECT MANAGEMENT GROUP AND THE COMPANIES LISTED ABOVE MAKE NO WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, WITH REGARD TO THIS MATERIAL INCLUDING, BUT NOT LIMITED TO ANY WARRANTY OF TITLE OR OWNERSHIP, IMPLIED WARRANTY OF MERCHANTABILITY OR WARRANTY OF FITNESS FOR PARTICULAR PURPOSE OR USE. In no event shall The Object Management Group or any of the companies listed above be liable for errors contained herein or for indirect, incidental, special, consequential, reliance or cover damages, including loss of profits, revenue, data or use, incurred by any user or any third party. The copyright holders listed above acknowledge that the Object Management Group (acting itself or through its designees) is and shall at all times be the sole entity that may authorize developers, suppliers and sellers of computer software to use certification marks, trademarks or other special designations to indicate compliance with these materials. This document contains information which is protected by copyright. All Rights Reserved. No part of this work covered by copyright herein may be reproduced or used in any form or by any means--graphic, electronic, or mechanical, including photocopying, recording, taping, or information storage and retrieval systems--without permission of the copyright owner. RESTRICTED RIGHTS LEGEND. Use, duplication, or disclosure by government is subject to restrictions as set forth in subdivision (c) (1) (ii) of the Right in Technical Data and Computer Software Clause at DFARS 252.227.7013 OMG®and Object Management are registered trademarks of the Object Management Group, Inc. Object Request Broker, OMG IDL, ORB, CORBA, CORBAfacilities, CORBAservices, COSS, and IIOP are trademarks of the Object Management Group, Inc. X/Open is a trademark of X/Open Company Ltd. ISSUE REPORTING All OMG specifications are subject to continuous review and improvement. As part of this process we encourage readers to report any ambiguities, inconsistencies, or inaccuracies they may find by completing the issue reporting form at http://www.omg.org/library/issuerpt.htm. Contents Preface . vii 1. IDLscript Overview. 1-1 1.1 Scripting Languages. 1-1 1.2 CORBA and Scripting Languages . 1-2 1.3 The IDLscript Language . 1-3 1.4 An IDLscript Example . 1-6 1.4.1 A Grid Distributed Application . 1-6 1.4.2 Basic Functionalities . 1-7 1.4.3 Dynamic CORBA Connection . 1-8 1.4.4 Direct Access to all OMG IDL Definitions . 1-8 1.4.5 Connection to Any CORBA Object . 1-9 1.4.6 OMG IDL Operations, Attributes, and Exceptions1-9 1.4.7 Procedures and Modules. 1-10 1.4.8 Implementation of OMG IDL Interfaces . 1-11 1.4.9 Creation of Stand-alone CORBA Servers . 1-14 1.4.10 Conclusion . 1-14 2. The IDLscript Language Core . 2-1 2.1 Overview . 2-2 2.2 Lexical Conventions. 2-2 2.2.1 Tokens . 2-3 2.2.2 Comments. 2-3 2.2.3 Identifiers . 2-3 2.2.4 Keywords . 2-4 2.2.5 Literals . 2-4 June 2001 CORBA Scripting Language i Contents 2.3 IDLscript Grammar . 2-6 2.4 Scripts . 2-9 2.5 Expressions . 2-9 2.5.1 Syntax. 2-10 2.5.2 Literal Values . 2-10 2.5.3 Identifiers . 2-11 2.5.4 Arithmetic Operators . 2-11 2.5.5 Relational Operators. 2-12 2.5.6 Logical Operators . 2-12 2.5.7 Procedural Call . 2-13 2.5.8 Attribute Getting. 2-13 2.5.9 Method Call . 2-13 2.5.10 Array Creation . 2-14 2.5.11 Dictionary Creation . 2-14 2.5.12 Indexed Getting . 2-14 2.6 Variable and Attribute Management. 2-14 2.6.1 Assignments . 2-15 2.6.2 The Del Statement. 2-15 2.7 Objects and Types . 2-15 2.7.1 Everything is Typed Object . 2-15 2.7.2 Basic Value Types. 2-16 2.7.3 String Objects . 2-17 2.7.4 Array Objects . 2-19 2.7.5 Dictionary Objects . 2-21 2.7.6 Predefined Internal Procedures. 2-22 2.8 Control Flow Statements . 2-23 2.8.1 Syntax. 2-23 2.8.2 The If Statement . 2-23 2.8.3 The While Statement . 2-24 2.8.4 The Do Statement . 2-24 2.8.5 The For Statement. 2-25 2.8.6 The Return Statement . 2-25 2.9 Procedures . 2-26 2.9.1 Declaration . 2-26 2.9.2 Formal Parameters and Default Values . 2-26 2.9.3 The Returned Object. 2-27 2.9.4 Local and Global Variables. 2-27 2.9.5 Procedure Aliasing . 2-28 2.10 Classes . 2-28 2.10.1 Declaration . 2-28 ii CORBA Scripting Language June 2001 Contents 2.10.2 A Simple Class Example . 2-29 2.10.3 A Single Class Inheritance Example . 2-31 2.10.4 A Multiple Class Inheritance Example . 2-31 2.10.5 Class and Instance Types . 2-32 2.11 Exceptions . 2-32 2.11.1 Internal Exceptions. 2-32 2.11.2 User Exceptions . 2-34 2.11.3 Exception Handling . 2-35 2.12 Modules . 2-36 2.12.1 Importation. 2-36 2.12.2 Initialization . 2-37 2.12.3 Access to the Content . 2-37 2.12.4 Module Aliasing . 2-37 2.12.5 Module Management . 2-37 3. The OMG IDL Binding. 3-1 3.1 Overview . 3-2 3.2 Binding for Basic OMG IDL Types . 3-2 3.2.1 IDLscript Representation . 3-3 3.2.2 Basic OMG IDL Values . 3-3 3.3 Binding for OMG IDL Module . 3-4 3.3.1 OMG IDL Examples . 3-4 3.3.2 IDLscript Representation . 3-4 3.4 Binding for OMG IDL Constant . 3-4 3.4.1 OMG IDL Examples . 3-4 3.4.2 IDLscript Representation . 3-5 3.5 Binding for OMG IDL Enum. 3-5 3.5.1 An OMG IDL Example . 3-5 3.5.2 IDLscript Representation . 3-6 3.5.3 Enum Values. 3-6 3.6 Binding for OMG IDL Structure . 3-6 3.6.1 OMG IDL Examples . 3-7 3.6.2 IDLscript Representation . 3-7 3.6.3 Structure Values . 3-8 3.6.4 Structure Fields . 3-8 3.7 Binding for OMG IDL Union. 3-9 3.7.1 An OMG IDL Example . 3-9 3.7.2 IDLscript Representation . 3-9 3.7.3 Union Values . 3-9 3.7.4 Union Fields . 3-10 June 2001 CORBA Scripting Language iii Contents 3.8 Binding for OMG IDL Typedef . 3-11 3.8.1 OMG IDL Examples . 3-11 3.8.2 IDLscript Representation . 3-11 3.8.3 Typedef Values . 3-11 3.9 Binding for OMG IDL Sequence . 3-12 3.9.1 OMG IDL Examples . 3-12 3.9.2 IDLscript Representation . 3-12 3.9.3 Sequence Values . ..