DOCSLIB.ORG

IBM Content Manager Ondemand Web Enablement Kit Java Apis the Basics and Beyond

Total Page：16

File Type：pdf, Size：1020Kb

Download full-text PDF Read full-text
IBM Content Manager Ondemand Web Enablement Kit Java Apis the Basics and Beyond Front cover IBM Content Manager OnDemand Web Enablement Kit Java APIs The Basics and Beyond Develop Web applications by using ODWEK V8.4 Java APIs Gain insightful best practices, hints, and tips Tune and troubleshoot OnDemand Web applications Wei-Dong Zhu Mark Mikeal Hassan A. Shazly Elliott Wade Sebastian Welter ibm.com/redbooks International Technical Support Organization IBM Content Manager OnDemand Web Enablement Kit Java APIs: The Basics and Beyond December 2008 SG24-7646-00 Note: Before using this information and the product it supports, read the information in “Notices” on page ix. First Edition (December 2008) This edition applies to Version 8 Release 4 of IBM Content Manager OnDemand (program number 5724-J33). © Copyright International Business Machines Corporation 2008. All rights reserved. Note to U.S. Government Users Restricted Rights -- Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents Notices . ix Trademarks . x Preface . xi The team that wrote this book . xii Become a published author . xiv Comments welcome. xiv Part 1. Programming with the ODWEK Java APIs . 1 Chapter 1. ODWEK Java API overview . 3 1.1 Origin of the ODWEK Java APIs . 4 1.2 Content Manager OnDemand system overview . 4 1.2.1 Content Manager OnDemand Library Server and Object Servers . 4 1.2.2 Content Manager OnDemand data . 6 1.2.3 Content Manager OnDemand data model . 7 1.2.4 Content Manager OnDemand data indexing and loading . 10 1.3 ODWEK Java APIs function overview. 11 1.3.1 Typical Web applications developed by using the ODWEK Java APIs . 11 1.4 ODWEK Java APIs architecture . 12 1.5 ODWEK Java APIs components . 13 1.5.1 ODWEK Java and native shared library . 14 1.5.2 Viewers . 14 1.5.3 ODWEK Java API distribution files . 15 1.6 WEBi client . 17 Chapter 2. ODWEK Java API classes . 21 2.1 Core API classes and their functional relationship . 22 2.1.1 Core API classes. 22 2.1.2 Functional relationship . 23 2.1.3 Server connection classes . 24 2.1.4 Content Manager OnDemand data model classes . 28 2.1.5 Search classes . 32 2.1.6 Document data retrieval classes . 35 2.1.7 Error handling class . 38 2.2 Sample console application. 39 2.3 Setting up a Web development environment by using Rational Application Developer . 43 © Copyright IBM Corp. 2008. All rights reserved. iii Chapter 3. ODWEK Java API examples . 53 3.1 Examples overview . 54 3.1.1 Example files. 54 3.1.2 Program flow and control . 59 3.2 Making a connection to Content Manager OnDemand . 59 3.3 Obtaining a list of cabinets and folders . 63 3.4 Displaying OnDemand folder information . 66 3.5 Obtaining a list of OnDemand folder search fields . 70 3.6 Displaying an Content Manager OnDemand search results list . 74 3.7 Retrieving and displaying an OnDemand document . 79 3.7.1 Viewing line data documents with the applet . 84 3.8 Disconnecting from OnDemand . 88 Chapter 4. Internet use case . 91 4.1 Use case overview . 92 4.2 Connection pooling consideration for the use case. 94 4.3 Sample application for the use case . 98 Part 2. Best practices, hints, and tips . 105 Chapter 5. Introduction to best practices, hints, and tips. 107 Chapter 6. Connection pooling and connection handling . 111 6.1 Connection pooling overview . 112 6.1.1 Benefits of connection pooling . 112 6.2 Connection pooling objects and pooling technique . 113 6.2.1 The ODServer class . 113 6.2.2 ODWEK Java API objects and threads. 114 6.2.3 The ODWEK Java API pool levels . 117 6.3 A simple connection pool code example . 118 6.3.1 The pooling mechanism . 118 6.3.2 Connection pool code functions . 120 6.3.3 Connection pool code sample. 121 6.4 Thread safety . 128 6.4.1 Instance variables . 129 6.4.2 Synchronization. 129 6.4.3 Implementing synchronization in the ODWEK Java APIs . 130 6.4.4 Synchronizing servlet code . 131 6.5 Resource consumption control . 132 6.5.1 Connection initialization . 132 6.5.2 Logging off and terminating a client connection . 135 6.5.3 Allocation and release of resources and sessions . 136 6.6 Timeout . 137 6.6.1 Inactivity timeout . 138 iv IBM Content Manager OnDemand Web Enablement Kit Java APIs: The Basics and Beyond 6.6.2 Other timeouts. 139 6.6.3 Implementing an application timeout by using the ODServer.cancel() method . 140 6.6.4 Recommended timeout implementation for a Web application. 141 Chapter 7. Globalization . 143 7.1 Globalization overview . 144 7.2 Content Manager OnDemand character conversion architecture . 146 7.2.1 Index data and annotations conversions. 147 7.2.2 UTF conversion. 148 7.2.3 Document data conversions . 149 7.3 Code page conversion in ODWEK . 149 7.3.1 API conversions . 149 7.3.2 Browser conversions. 150 7.3.3 Document data conversions . 150 7.4 The ICU conversion library . 151 7.5 Using Unicode as the database code page. 152 7.6 ODWEK language configuration . 154 7.7 Integrating custom code pages . 156 7.7.1 Locations that require configuration . 156 7.7.2 ICU and ICONV. 157 7.7.3 Customizing code page mappings for ICU . 158 7.8 Globalizing applications by using ICU . 158 Chapter 8. Folder searching. ..
Load more

Recommended publications
  • Code Structure by Miklos Vajna Senior Software Engineer at Collabora Productivity 2017-10-11
    LibreOffice: Code Structure By Miklos Vajna Senior Software Engineer at Collabora Productivity 2017-10-11 @CollaboraOffice www.CollaboraOffice.com About Miklos ● From Hungary ● More blurb: http://vmiklos.hu/ ● Google Summer of Code 2010/2011 ● Rewrite of the Writer RTF import/export ● Writer developer since 2012 ● Contractor at Collabora since 2013 LibreOffice Conference 2017, Rome | Miklos Vajna 2 / 30 Thanks ● This is an updated version of Michael Meeks’ talk from last year LibreOffice Conference 2017, Rome | Miklos Vajna 3 / 30 Overview ● Code-base overview ● Internal core modules, internal leaf ● Ignoring externals ● Building / packaging: gnumake, scp2 ● Code organisation, git bits ● Keep in mind: this is a 20 years old code-base ● The quality is much better than you would expect after knowing its age ● Things continue to improve over time LibreOffice Conference 2017, Rome | Miklos Vajna 4 / 30 Module overview lowest level Internal non-leaf modules: UNO modules ● Module = toplevel dir ● make dumps-deps-png ● Each module has a README ● e.g. sal/README ● sal: at the bottom ● The system abstraction layer ● tools is an obsolete internal (more or less) duplication of this ● salhelper: wrapper code around sal, also part of the URE LibreOffice Conference 2017, Rome | Miklos Vajna 6 / 30 What is the Uno Runtime Environment (URE)? ● We’ll come to UNO in detail a bit later, but for now: ● Uno Runtime Environment ● See also JRE, Java Runtime Env. ● Belongs to the idea that UNO would be reused somewhere else ● Provides an API/ABI-stable abstraction layer for the suite URE ● Allows writing C++ extensions ● Modify carefully: ● Should not change the ABI ● ABI control via C .map files LibreOffice Conference 2017, Rome | Miklos Vajna 7 / 30 UNO modules ● store: legacy .rdb format ● registry: UNO type regisistry ● unoidl: a .idl file compiler ● cppu: C++ UNO ● Implements basic UNO types and infrastructure for C++, e.g.
    [Show full text]
  • Art-Workbook-V0 84
    Intensity Frontier Common Offline Documentation: art Workbook and Users Guide Alpha Release 0.84 August 18, 2014 This version of the documentation is written for version v0_00_27 of the art-workbook code. Scientific Computing Division Future Programs and Experiments Department Scientific Software Infrastructure Group Principal Author: Rob Kutschke Editor: Anne Heavey art Developers: L. Garren, C. Green, J. Kowalkowski, M. Paterno and P. Russo 1 2 List of Chapters Detailed Table of Contents iv List of Figures xx List of Tables xxii List of Code and Output Listings xxii art Glossary xxvii I Introduction 1 1 How to Read this Documentation 2 2 Conventions Used in this Documentation 4 3 Introduction to the art Event Processing Framework 7 4 Unix Prerequisites 34 5 Site-Specific Setup Procedure 45 i 6 Get your C++ up to Speed 47 7 Using External Products in UPS 107 II Workbook 119 8 Preparation for Running the Workbook Exercises 120 9 Exercise 1: Running Pre-built art Modules 124 10 Exercise 2: Building and Running Your First Module 163 11 General Setup for Login Sessions 220 12 Keeping Up to Date with Workbook Code and Documentation 222 13 Exercise 3: Some other Member Functions of Modules 228 14 Exercise 4: A First Look at Parameter Sets 240 15 Exercise 5: Making Multiple Instances of a Module 265 16 Exercise 6: Accessing Data Products 272 17 Exercise 7: Making a Histogram 291 18 Exercise 8: Looping Over Collections 317 19 3D Event Displays 341 20 Troubleshooting 377 ii III User’s Guide 379 21 Obtaining Credentials to Access Fermilab Computing Resources 380 22 git 382 23 art Run-time and Development Environments 391 24 art Framework Parameters 399 25 Job Configuration in art: FHiCL 405 IV Appendices 424 A art Completion Codes 425 B Viewing and Printing Figure Files 428 C CLHEP 430 D Include Guards 446 V Index 448 Index 449 iii Detailed Table of Contents Detailed Table of Contents iv List of Figures xx List of Tables xxii List of Code and Output Listings xxii art Glossary xxvii I Introduction 1 1 How to Read this Documentation 2 1.1 If you are new to HEP Software..
    [Show full text]
  • Release 0.11 Todd Gamblin
    Spack Documentation Release 0.11 Todd Gamblin Feb 07, 2018 Basics 1 Feature Overview 3 1.1 Simple package installation.......................................3 1.2 Custom versions & configurations....................................3 1.3 Customize dependencies.........................................4 1.4 Non-destructive installs.........................................4 1.5 Packages can peacefully coexist.....................................4 1.6 Creating packages is easy........................................4 2 Getting Started 7 2.1 Prerequisites...............................................7 2.2 Installation................................................7 2.3 Compiler configuration..........................................9 2.4 Vendor-Specific Compiler Configuration................................ 13 2.5 System Packages............................................. 16 2.6 Utilities Configuration.......................................... 18 2.7 GPG Signing............................................... 20 2.8 Spack on Cray.............................................. 21 3 Basic Usage 25 3.1 Listing available packages........................................ 25 3.2 Installing and uninstalling........................................ 42 3.3 Seeing installed packages........................................ 44 3.4 Specs & dependencies.......................................... 46 3.5 Virtual dependencies........................................... 50 3.6 Extensions & Python support...................................... 53 3.7 Filesystem requirements........................................
    [Show full text]
  • GNAT User's Guide
    GNAT User's Guide GNAT, The GNU Ada Compiler For gcc version 4.7.4 (GCC) AdaCore Copyright c 1995-2009 Free Software Foundation, Inc. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no Invariant Sections, with no Front-Cover Texts and with no Back-Cover Texts. A copy of the license is included in the section entitled \GNU Free Documentation License". About This Guide 1 About This Guide This guide describes the use of GNAT, a compiler and software development toolset for the full Ada programming language. It documents the features of the compiler and tools, and explains how to use them to build Ada applications. GNAT implements Ada 95 and Ada 2005, and it may also be invoked in Ada 83 compat- ibility mode. By default, GNAT assumes Ada 2005, but you can override with a compiler switch (see Section 3.2.9 [Compiling Different Versions of Ada], page 78) to explicitly specify the language version. Throughout this manual, references to \Ada" without a year suffix apply to both the Ada 95 and Ada 2005 versions of the language. What This Guide Contains This guide contains the following chapters: • Chapter 1 [Getting Started with GNAT], page 5, describes how to get started compiling and running Ada programs with the GNAT Ada programming environment. • Chapter 2 [The GNAT Compilation Model], page 13, describes the compilation model used by GNAT. • Chapter 3 [Compiling Using gcc], page 41, describes how to compile Ada programs with gcc, the Ada compiler.
    [Show full text]
  • Mvbluefox3 Technical Manual (Pdf)
    mvBlueFOX3 Technical Manual English - Version 3.04 i 1.1 About this manual............................................ 1 1.1.1 Goal of the manual ....................................... 1 1.1.2 Contents of the manual..................................... 1 1.2 Imprint.................................................. 2 1.2.1 Introduction ........................................... 3 1.2.2 wxWidgets............................................ 3 1.2.3 Sarissa ............................................. 3 1.2.4 GenICam ............................................ 3 1.2.5 libusb .............................................. 3 1.2.6 libusbK.............................................. 3 1.2.6.1 libusbK license .................................... 3 1.2.7 Doxygen............................................. 4 1.2.7.1 Doxygen license ................................... 4 1.2.8 SHA1 algorithm......................................... 4 1.2.9 Expat .............................................. 5 1.2.9.1 Expat Copyright.................................... 5 1.2.10 CppUnit ............................................ 5 1.2.11 NUnit.............................................. 5 1.2.11.1 NUnit License.................................... 5 1.3 Legal notice............................................... 6 1.3.1 Introduction ........................................... 6 1.3.2 cJSON.............................................. 6 1.3.3 Unity............................................... 6 1.4 Revisions ...............................................
    [Show full text]
  • An Infrastructure to Support Interoperability in Reverse Engineering Nicholas Kraft Clemson University, [email protected]
    Clemson University TigerPrints All Dissertations Dissertations 5-2007 An Infrastructure to Support Interoperability in Reverse Engineering Nicholas Kraft Clemson University, [email protected] Follow this and additional works at: https://tigerprints.clemson.edu/all_dissertations Part of the Computer Sciences Commons Recommended Citation Kraft, Nicholas, "An Infrastructure to Support Interoperability in Reverse Engineering" (2007). All Dissertations. 51. https://tigerprints.clemson.edu/all_dissertations/51 This Dissertation is brought to you for free and open access by the Dissertations at TigerPrints. It has been accepted for inclusion in All Dissertations by an authorized administrator of TigerPrints. For more information, please contact [email protected]. AN INFRASTRUCTURE TO SUPPORT INTEROPERABILITY IN REVERSE ENGINEERING A Dissertation Presented to the Graduate School of Clemson University In Partial Fulfillment of the Requirements for the Degree Doctor of Philosophy Computer Science by Nicholas A. Kraft May 2007 Accepted by: Dr. Brian A. Malloy, Committee Chair Dr. Harold C. Grossman Dr. James F. Power Dr. Roy P. Pargas ABSTRACT An infrastructure that supports interoperability among reverse engineering tools and other software tools is described. The three major components of the infrastruc- ture are: (1) a hierarchy of schemas for low- and middle-level program representation graphs, (2) g4re, a tool chain for reverse engineering C++ programs, and (3) a repos- itory of reverse engineering artifacts, including the previous two components, a test suite, and tools, GXL instances, and XSLT transformations for graphs at each level of the hierarchy. The results of two case studies that investigated the space and time costs incurred by the infrastructure are provided. The results of two empirical evaluations that were performed using the api module of g4re, and were focused on computation of object-oriented metrics and three-dimensional visualization of class template diagrams, respectively, are also provided.
    [Show full text]
  • Red Hat Enterprise Linux 7 7.8 Release Notes
    Red Hat Enterprise Linux 7 7.8 Release Notes Release Notes for Red Hat Enterprise Linux 7.8 Last Updated: 2021-03-02 Red Hat Enterprise Linux 7 7.8 Release Notes Release Notes for Red Hat Enterprise Linux 7.8 Legal Notice Copyright © 2021 Red Hat, Inc. The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at http://creativecommons.org/licenses/by-sa/3.0/ . In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version. Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law. Red Hat, Red Hat Enterprise Linux, the Shadowman logo, the Red Hat logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries. Linux ® is the registered trademark of Linus Torvalds in the United States and other countries. Java ® is a registered trademark of Oracle and/or its affiliates. XFS ® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries. MySQL ® is a registered trademark of MySQL AB in the United States, the European Union and other countries. Node.js ® is an official trademark of Joyent. Red Hat is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
    [Show full text]
  • Red Hat Enterprise Linux 7 7.9 Release Notes
    Red Hat Enterprise Linux 7 7.9 Release Notes Release Notes for Red Hat Enterprise Linux 7.9 Last Updated: 2021-08-17 Red Hat Enterprise Linux 7 7.9 Release Notes Release Notes for Red Hat Enterprise Linux 7.9 Legal Notice Copyright © 2021 Red Hat, Inc. The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at http://creativecommons.org/licenses/by-sa/3.0/ . In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version. Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law. Red Hat, Red Hat Enterprise Linux, the Shadowman logo, the Red Hat logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries. Linux ® is the registered trademark of Linus Torvalds in the United States and other countries. Java ® is a registered trademark of Oracle and/or its affiliates. XFS ® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries. MySQL ® is a registered trademark of MySQL AB in the United States, the European Union and other countries. Node.js ® is an official trademark of Joyent. Red Hat is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
    [Show full text]
  • Event-Driven Software-Architecture for Delay- and Disruption-Tolerant Networking
    Event-driven Software-Architecture for Delay- and Disruption-Tolerant Networking Der Carl-Friedrich-Gauß-Fakultät der Technischen Universität Carolo-Wilhelmina zu Braunschweig zur Erlangung des Grades eines Doktoringenieurs (Dr.-Ing.) genehmigte Disseration von Johannes Morgenroth geboren am 28.08.1981 in Braunschweig Eingereicht am: 19.12.2014 Disputation am: 17.07.2015 1. Referent: Prof. Dr.-Ing. Lars Wolf 2. Referent: Prof. Dr.-Ing. Klaus Wehrle 2015 Bibliografische Information der Deutschen Nationalbibliothek: Die Deutsche Nationalbibliothek verzeichnet diese Publikation in der Deutschen Nationalbibliografie; detaillierte bibliografische Daten sind im Internet über www.dnb.de abrufbar. Diss., Technische Universität Carolo Wilhelmina zu Braunschweig, 2015 © 2015 Johannes Morgenroth Herstellung: BoD – Books on Demand, Norderstedt BoD Ref. 0011632925 Abstract Continuous end-to-end connectivity is not available all the time, not even in wired networks. Thus, the »Off-line first« paradigm is applied to applications of mobile devices to deal with intermittent connectivity without annoying the users every time the network is going to be flaky. But since mobile devices, particularly smart- phones, are typically bound to the Internet, they become almost useless as soon as their connectivity is gone. Delay- and Disruption-Tolerant Networking (DTN) al- lows devices to communicate even if there is no continuous path to the destination by replacing the end-to-end semantics with a hop-by-hop store-carry-and-forward approach. Since existing implementations of DTN software suffer from various limita- tions, this thesis presents an event-driven software architecture for Delay- and Disruption-Tolerant Networking and a lean, lightweight, and extensible imple- mentation of a bundle node.
    [Show full text]
  • Art-Documentation-Alpha-V0 82
    Intensity Frontier Common Offline Documentation: art Workbook and Users Guide Alpha Release 0.82 August 7, 2014 This version of the documentation is written for version v0_00_26 of the art-workbook code. Scientific Computing Division Future Programs and Experiments Department Scientific Software Infrastructure Group Principal Author: Rob Kutschke Editor: Anne Heavey art Developers: L. Garren, C. Green, J. Kowalkowski, M. Paterno and P. Russo 1 2 List of Chapters Detailed Table of Contents iv List of Figures xx List of Tables xxii List of Code and Output Listings xxii art Glossary xxv I Introduction 1 1 How to Read this Documentation 2 2 Conventions Used in this Documentation 4 3 Introduction to the art Event Processing Framework 7 4 Unix Prerequisites 34 5 Site-Specific Setup Procedure 45 i 6 Get your C++ up to Speed 47 7 Using External Products in UPS 105 II Workbook 117 8 Preparation for Running the Workbook Exercises 118 9 Exercise 1: Running Pre-built art Modules 122 10 Exercise 2: Building and Running Your First Module 161 11 General Setup for Login Sessions 218 12 Keeping Up to Date with Workbook Code and Documentation 220 13 Exercise 3: Some other Member Functions of Modules 226 14 Exercise 4: A First Look at Parameter Sets 238 15 Exercise 5: Making Multiple Instances of a Module 263 16 Exercise 6: Accessing Data Products 270 17 Exercise 7: Making a Histogram 289 18 Exercise 8: Looping Over Collections 314 19 Troubleshooting 338 ii III User’s Guide 340 20 Obtaining Credentials to Access Fermilab Computing Resources 341 21 git 343 22 art Run-time and Development Environments 352 23 art Framework Parameters 360 24 Job Configuration in art: FHiCL 366 IV Appendices 385 A art Completion Codes 386 B Viewing and Printing Figure Files 389 C CLHEP 391 V Index 407 iii Detailed Table of Contents Detailed Table of Contents iv List of Figures xx List of Tables xxii List of Code and Output Listings xxii art Glossary xxv I Introduction 1 1 How to Read this Documentation 2 1.1 If you are new to HEP Software..
    [Show full text]
  • An Automated Testing Suite for Computer Music Environments
    An Automated Testing Suite for Computer Music Environments Nils Peters Trond Lossius Timothy Place ICSI, CNMAT UC Berkeley BEK Electrotap [email protected] [email protected] [email protected] ABSTRACT temporary programming practice, making extensive use of solutions for running automated tests on a regular basis. Software development benefits from systematic testing In the sound and music computing community adop- with respect to implementation, optimization, and mainte- tion of systematic approaches to testing remain less wide- nance. Automated testing makes it easy to execute a large spread. Bugs often surface when making changes to the number of tests efficiently on a regular basis, leading to program, or the target environment or operating system, faster development and more reliable software. and for this reason many artists tend to be hesitant about Systematic testing is not widely adopted within the com- changing their performance computer system or software puter music community, where software patches tend to version because of the fear of unforeseen problems. They be continuously modified and optimized during a project. might also be reluctant to doing last-minute changes and Consequently, bugs are often discovered during rehearsal improvements to their patches. The programs or patches or performance, resulting in literal “show stoppers”. This developed are often custom developed for a particular paper presents a testing environment for computer music project, and with increasing complexity patches become systems, first developed for the Jamoma framework and increasingly vulnerable. Max. The testing environment works with Max 5 and 6, is independ from any 3rd-party objects, and can be used with 1.2 Importance of testing to Jamoma development non-Jamoma patches as well.
    [Show full text]
  • Libreoffice and Collabora
    LibreOffice: Code Structure Hermenutical keys to a complex code-base Michael Meeks General Manager at Collabora Productivity [email protected] mmeeks, #libreoffice-dev, irc.freenode.net “Stand@CollaboraOffice at the crossroads and look; ask for the ancient paths, ask where the good way is, and walk in it, and you will find rest for your souls...” - Jeremiah 6:16 LibreOffice@CollaboraOffice Conference 2015, Aarhus | Michaelwww.CollaboraOffice.com Meeks 1 / 28 Overview / Agenda … Chunk #1 ● Codebase overview – Internal core modules, internal leaf, (ignore externals) ● Build + package: gnumake + scp2 ● Code organisation / git bits ● Bear in mind: this is a 20 year old code- base ● The code-base is rather better than can be expected, and things continue to improving over time. 2 Module overview – lowest level https://collaboraoffice.com Internal non-leaf modules: UNO modules ● Top-level directory names. ● make dump-deps-png # needs graphviz ● Each module has a README file: ● eg. sal/README ● sal: - at the bottom ● The system abstraction layer ● 'tools' is an obsolete internal ~duplication of this module ● salhelper: - wrapper code around sal – also part of URE 4 What is the Uno Runtime Environment (URE) ● We'll come onto UNO later in detail but … for now: ● “Uno Runtime Environment” ● cf. JRE → Java Runtime Env. ● Belongs to the pipe-dream of a world where UNO was re-used by other applications. ● Provides an ABI / API stable URE abstraction layer for the suite ● So you can write C++ plugins ● Careful: ● We have to watch our ABI here. ● ABI control via C symbol map files 5 UNO module dissection ● store: obsolete & irrelevant.
    [Show full text]