The Openwings Tutorial

Introduction

This tutorial provides guidance on design, development, and deployment of components using the Openwings reference implementation. This document is meant to be a terse guide. It does not discuss the Openwings APIs in detail—please refer to the Javadocs for that information.

This tutorial contains material that is specific to this Reference Implementation of Openwings. It will be continually updated to reflect changes made in new releases. If you notice an error in the tutorial, please e-mail us so we can fix the problem.

Click here to download a PDF containing all the tutorial content.

Tutorial Trails

Trail I. Openwings Architecture Introduction

1. Introduction

2. Architecture Overview

3. Component Services

4. Container Services

5. Connector Services

6. Install Services

7. Context Services

8. Management Services

9. Security Services

Trail II. Getting Started (Quick Start)

1. Installation

2. Running the Demo Applications

3. The HelloWorld Demos

4. The HelloWorldSynchronous Component

5. The HelloWorldProvider Component

6. The HelloWorldSimpleUser Component

7. The HelloWorldUser Component

8. The HelloWorldAsynchronous Component

9. The HelloWorldPublisher Component

10. The HelloWorldSubscriber Component

11. Compilation

12. Connector Generation

13. Packaging

14. Installing Your Component

15. Running Your Component

Trail III. The Openwings Shell

1. Navigation

2. Basic Commands

3. The ls command

4. The cd command

5. The lcd, pwd, and lls commands

6. The install command

7. The process command

8. The uninstall command

9. The edit command

10. The findclass command

11. The quit command

12. Other Useful Shell Tricks

Trail IV. The Openwings Explorer

1. Introducing the Openwings Explorer

2. Basic Navigation

3. Installing a Component

4. Uninstalling a Component

5. Starting a Process

6. Stopping a Process

7. Moving a Process

8. Editing a Component Descriptor

9. Viewing more about a Component

10. Shutting Down a Platform

11. More Explorer Tips

Trail V. Design Topics

1. Design Introduction

2. Architecture Definition Language (ADL)

3. Service-Oriented Programming Principles

4. Defining Service Contracts

5. Defining Components

Trail VI. Developing Components

1. Developing Components

2. The Development Environment

3. Naming Conventions

4. Component Service APIs

5. The Component Interface

6. The ComponentComplex Interface

7. Failure Recovery Techniques

8. ServiceUI Development

9. Component Compilation

10. Connector Generation

11. Using Policies

12. Using Properties

13. Dependency Resolution

14. Dependency Substitution

15. Component Packaging

Trail VII. Deploying Components

1. Component Deployment

2. Component Installation

3. Component Execution

Trail VIII. Openwings Security Introduction

1. Introduction

2. Installing the Secure RI

3. Openwings Login

4. Security Service/GUI

5. Administering Service Security for the Core

6. Security Configuration Files

Trail IX. Code Security

1. Introduction to Openwings Code Security

2. Editing Your ICD

3. Create Your Component's Security Policy

4. Rebuild and Reinstall

5. Debug

Trail X. Service Security

1. Introduction to Service Security

2. Running the Secure HelloWorld Demo

3. Generating a Secure Connector

4. Configure Component to Use Secure Connector

Trail XI. Install Security

1. Install Security

2. Configuring Security for the Install Service

3. Sign a Secure Component

4. Configuring Code Signers on your System

5. Signing Component Libraries

Troubleshooting

Openwings Troubleshooting Tips

Glossary

Openwings Glossary

Appendices (Miscellaneous Topics)

Appendix A: Native Code

Appendix B: System Performance

Appendix C: Log Control