CORBA Component Model

Tutorial

OMG CCM Implementers Group,

MARS PTF & Telecom DTF
OMG Meeting, Yokohama, Japan,
April 24th, 2002

OMG TC Document ccm/2002-04-01

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 1

 Tutorial Team
 Speakers
 Philippe Merle - LIFL/INRIA - Philippe.Merle@lifl.fr
 Sylvain Leblanc - LIFL - Sylvain.Leblanc@lifl.fr
 Mathieu Vadet - Thalès/LIFL - Mathieu.Vadet@lifl.fr
 Frank Pilhofer - Alcatel/FPX - fp@fpx.de
 Tom Ritter - Fraunhofer Fokus - ritter@fokus.gmd.de
 Harald Böhme - Humboldt University
- boehme@informatik.hu-berlin.de

 Contributors
 J. Scott Evans - CPI - evans@cpi.com
 Diego Sevilla Ruiz - dsevilla@ditec.um.es
 Raphaël Marvie - LIFL – Raphael.Marvie@lifl.fr

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 2

 Tutorial Objectives

 A guided tour of the CORBA Component Model

 How to design, implement, package, deploy, execute,
and use CORBA components
 Putting the CCM to work

 Illustrated with a concrete example

 Well-known Dining Philosophers
 Demonstrated on various OS, ORB, CCM platforms, and
programming languages (C++, Java, OMG IDLscript)

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 3

 Agenda
 What is the CORBA Component Model?
 Defining CORBA components
 Programming CORBA component clients
 Implementing CORBA components
 Putting CORBA containers to work
 Packaging CORBA components
 Deploying CORBA component applications
 Summary
Wednesday, April 24th, 2002 CORBA Component Model Tutorial 4
 What is the
CORBA Component Model?

 From CORBA 2.x to the CCM

 Comparison with EJB, COM, and .NET
 CCM Technologies
 Typical Use Case

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 5

 Why Software Components?
 Time to market
 Improved application productivity
 Reduced complexity
 Reuse of existing code
 Programming by assembly (manufacturing) rather
than development (engineering)
 Reduced skills requirements
 Focus expertise on domain problems
 Improving software quality
 Key benefit with client side & server side
development
Wednesday, April 24th, 2002 CORBA Component Model Tutorial 6
 From CORBA 2 . . .
 A distributed object-oriented model
 Heterogeneity: OMG Interface Definition Language (OMG IDL)
 Portability: Standardized language mappings
 Interoperability: GIOP / IIOP
 Various invocation models: SII, DII, and AMI
 Middleware: ORB, POA, etc.
minimum, real-time, and fault-tolerance profiles
 No standard packaging and deployment facilities !!!
 Explicit programming of non functional properties !!!
 lifecycle, (de)activation, naming, trading, notification, persistence,
transactions, security, real-time, fault-tolerance, ...
 No vision of software architecture

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 7

 . . . to the CORBA Component Model
 A distributed component-oriented model
 An architecture for defining components and their interactions
 From client-side (GUI) to server-side (business) components
 A packaging technology for deploying binary multi-lingual
executables
 A container framework for injecting lifecycle, (de)activation,
security, transactions, persistence, and events
 Interoperability with Enterprise Java Beans (EJB)

 The Industry’s First Multi-Language Component Standard

 Multi-languages, multi-OSs, multi-ORBs, multi-vendors, etc.
 Versus the Java-centric EJB component model
 Versus the MS-centric .NET component model

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 8

 CCM Compared to EJB, COM and .NET
 Like SUN Microsystems’s Enterprise Java Beans (EJB)
 CORBA components created and managed by homes
 Run in containers managing system services transparently
 Hosted by application component servers

 Like Microsoft’s Component Object Model (COM)

 Have several input and output interfaces
 Both synchronous operations and asynchronous events
 Navigation and introspection capabilities

 Like Microsoft’s .NET Framework

 Could be written in different programming languages
 Could be packaged in order to be distributed

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 9

 But with CCM

 A CCM application is “really” distributed

 Could be deployed and run on several distributed
nodes simultaneously

 A CORBA component could be segmented into

several classes

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 10

 What is the CCM Specification?

 Abstract Component Model

 Extensions to IDL and the object model

 Component Implementation Framework

 Component Implementation Definition Language (CIDL)

 Component Container Programming Model

 Component implementer and client view
 Integration with Security, Persistence, Transactions, and
Events

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 11

 What is the CCM Specification?

 Packaging and deployment facilities

 Interoperability with EJB 1.1

 Component Metadata & Metamodel

 Interface Repository and MOF extensions

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 12

 Relations between
OMG Definition Languages
 OMG IDL 2.x OMG IDL
 Object-oriented collaboration 2.x
 i.e. data types, interfaces, and value types extends

 OMG IDL 3.0

extends
 Component-oriented collaboration OMG IDL
 i.e. component types, homes, and event types 3.0

 OMG PSDL
 Persistent state definition OMG extends
 i.e. [abstract] storage types and homes PSDL

 OMG CIDL extends

 Component implementation description OMG
 i.e. compositions and segments CIDL

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 13

 CCM User Roles
 Component designers
 Component clients
 Composition designers
(~ component implementation designers)
 Component implementers
 Component packagers
 Component deployers
 Component end-users

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 14

 Component Designers

 Define component and home types via

OMG IDL 3.0 extensions

 Output
 OMG IDL 3.0 files
 Client-side OMG IDL mapping
 Client-side stubs
 Interface Repository entries

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 15

 Component Clients

 View components and homes via the

client-side OMG IDL mapping

 Use client-side stubs

 Could navigate and introspect components via the

generic CCMObject and CCMHome interfaces

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 16

 Composition Designers

 Specify platform and language independent

features required to facilitate code generation
 Component Implementation Definition Language (CIDL)
 Persistence State Definition Language (PSDL)

 Output
 Local server-side OMG IDL mapping
 Component skeletons
 Component metadata as XML descriptors

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 17

 Component Implementers

 Implement business logic operations

 Defined by local server-side OMG IDL interfaces
 Could inherit from generated CIDL skeletons
 Could overload local container callback interfaces
 Could invoke local container interfaces

 Output
 Component binaries
 XML component descriptors enriched

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 18

 From CORBA Component Design
to Packaging

OMG IDL, Local Component

PSDL & implements Executor
Component server-side Component
CIDL OMG IDL Code
Designer Implementer

OMG IDL Programming

PSDL & CIDL Language
Compiler Tools
Stubs, Skeletons

XML
Client-side refers to Component describes Binary
OMG IDL Descriptor Component

Component Component
Client Packager

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 19

 Component Packagers

 Produce component packages containing

 Component binaries
 Software & component XML descriptors
 Default property XML descriptors
 Probably done using an interactive visual tool

 Output - component archive file (zip file)

 If “no further assembly required”, skip to

deployment
Wednesday, April 24th, 2002 CORBA Component Model Tutorial 20
 Component Assemblers

 Produce assembly packages containing

 Customized component packages
 Assembly XML descriptors
 Component instances and interconnections
 Logical distribution partitioning
 Probably done using an interactive visual tool

 Output - component assembly archive file

 Process may be iterated further

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 21

 Component Deployers

 Deployment/installation tool takes deployer input

+ component and assembly archives
 Attach virtual component locations to physical
nodes
 Start the deployment process
 Installs components and assemblies to particular nodes
on the network
 Output - instantiated and configured components
and assemblies now available
 CCM applications deployed in CCM containers
Wednesday, April 24th, 2002 CORBA Component Model Tutorial 22
 The CCM Big Picture

designers implementer
Programming
IDL/CIDL File User's Code Home Properties Component Properties
Language
Tools

IDL/CIDL
Default Properties
Compiler
CORBA
Stubs, Skeletons Implementation Component
Package

Packaging CORBA Assembly Component

Tool Component Tool Assembly
Package Package
Component
Descriptor
packager assembler Assembl
D
y escriptor
User written file softpkg
Deployment
Descriptor CORBA
Compiler Component
Package deployer
Tool

Generated files
Wednesday, April 24th, 2002 CORBA Component Model Tutorial 23
 Next Tutorial Steps
 Defining CORBA component types
 Abstract Component Model and OMG IDL 3.0 extensions
 Programming CORBA component clients
 Client-side OMG IDL mapping
 Implementing CORBA components
 Component Implementation Framework (CIF)
 Local server-side OMG IDL mapping
 Component Implementation Definition Language (CIDL)
 Putting CORBA containers to work
 Packaging CORBA components
 Associated XML DTDs
 Deploying CORBA component applications
 Component deployment objects and “basic” process

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 24

 Defining CORBA Components

 The Abstract Component Model

 OMG IDL 3.0 Extensions
 The Dining Philosophers Example

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 25

 The Abstract Component Model
 Allows component designers to capture how CORBA
components are viewed by other components and clients
 What a component offers to other components
 What a component requires from other components
 What collaboration modes are used between components
 Synchronous via operation invocation
 Asynchronous via event notification
 Which component properties are configurable
 What the business life cycle operations are (i.e. home)

 Expressed via OMG IDL 3.0 extensions

 Syntactic construction for well known design patterns
 Mapped to OMG IDL interfaces for clients and implementers

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 26

 What is a CORBA Component?
 component is a new CORBA meta-type
 Extension of Object (with some constraints)
 Has an interface, and an object reference
 Also, a stylized use of CORBA interfaces/objects
 Provides component features (also named ports)
 Could inherit from a single component type
 Could supports multiple interfaces
 Each component instance is created and managed
by a unique component home
Wednesday, April 24th, 2002 CORBA Component Model Tutorial 27
 Component Features

 Attributes = configurable properties

 Facets = offered operation interfaces
 Receptacles = required operation interfaces
 Event sources = produced events
 Event sinks = consumed events

 Navigation and introspection supported

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 28

 A CORBA Component
Component interface

Facets
Receptacles

REQUIRED
OFFERED

My
Business
Component
Event Event
sinks sources

Attributes
Wednesday, April 24th, 2002 CORBA Component Model Tutorial 29
 Building CCM Applications =
Assembling CORBA Component Instances

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 30

 Component Attributes
 Named configurable properties
 Vital key for successful re-usability
 Intended for component configuration
 e.g., optional behaviors, modality, resource hints, etc.
 Could raise exceptions
 Exposed through accessors and mutators

 Could be configured
 By visual property sheet mechanisms in assembly or
deployment environments
 By homes or during implementation initialization
 Potentially readonly thereafter
Wednesday, April 24th, 2002 CORBA Component Model Tutorial 31
 Component Facets

 Distinct named interfaces that provide the

component’s application functionality to clients
 Each facet embodies a view of the component,
corresponds to a role in which a client may act
relatively to the component
 A facet represents the component itself, not a
separate thing contained by the component
 Facets have independent object references

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 32

 Component Receptacles
 Distinct named connection points for potential
connectivity
 Ability to specialize by delegation, compose functions
 The bottom of the Lego, if you will
 Store a simple reference or multiple references
 But not intended as a relationship service
 Configuration
 Statically during initialization stage or assembly stage
 Dynamically managed at runtime to offer interactions
with clients or other components (e.g. callback)

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 33

 Component Events

 Simple publish / subscribe event model

 “push” mode only
 Sources (2 kinds) and sinks

 Events are value types

 Defined with the new eventtype meta-type
 valuetype specialization for component events

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 34

 Component Event Sources
 Named connection points for event production
 Push a specified eventtype
 Two kinds: Publisher & Emitter
 publishes = multiple client subscribers
 emits = only one client connected
 Client subscribes or connects to directly
component event source
 Container mediates access to CosNotification
channels
 scalability, quality of service, transactional, etc.

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 35

 Component Event Sinks

 Named connection points into which events of a

specific type may be pushed

 Subscription to event sources

 Potentially multiple (n to 1)

 No distinction between emitter and publisher

 Both push in event sinks

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 36

 What is a CORBA Component Home?
 Manages a unique component type
 More than one home type can manage the same
component type
 But a component instance is managed by a single home
instance
 home is a new CORBA meta-type
 Home definition is distinct from component one
 Has an interface, and an object reference
 Could inherit from a single home type
 Could supports multiple interfaces
 Is instantiated at deployment time
Wednesday, April 24th, 2002 CORBA Component Model Tutorial 37
 A CORBA Component Home

Home interface

MyBusinessHome

c1

cN

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 38

 Component Home Features

 Allows life cycle characteristics or key type to

vary/evolve without changing component
definition
 Optional use of primarykey for business
component identity and persistency primary key
 Standard factory and finder business logic
operations
 Extensible with arbitrary user-defined business
logic operations

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 39

 Primary Keys
 Values exposed to clients to create, find, and destroy
component instances
 Uniquely identifies a component instance within a home
 Assigned at creation time, or in pre-existing database
 Must be a value type derived from Components::PrimaryKeyBase
(empty, abstract)

 Association between a primary key and a component is

defined and maintained by its home
 Different home types may define different key types (or no key)
for the same component type
 Primary key is not necessarily a part of the component’s state

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 40

 Other OMG IDL 3.0 Extensions

 The new import keyword

 Importation of OMG IDL scopes
 To replace #include

 The new typeprefix keyword

 To replace #pragma prefix

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 41

 The Dining Philosophers Example
Thinking Thinking
Hungry Hungry
Starving Starving
Eating Eating
Dead Dead
Fork
Descartes

Kant

Fork Thinking
Hungry
Fork Starving
Eating
Dead

Aristotle

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 42

 Dining Philosophers as Component
CORBA Components Base ref.
Facet
Receptacle
Event Sink
Philosopher
Fork Event Source
name = Kant

Fork

Philosopher
Fork
name = Descartes

Philosopher
name = Aristotle
Observer

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 43

 OMG IDL 3.0 for Dining Philosophers
// Importation of the Components module
// when access to OMG IDL definitions contained
// into the CCM's Components module is required.
import Components;

module DiningPhilosophers
{
// Sets the prefix of all these OMG IDL definitions.
// Prefix generated Java mapping classes.
typeprefix DiningPhilosophers "omg.org";

. . .
};

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 44

 The Fork Interface

exception InUse {};

interface Fork Fork
{ Manager
void get() raises (InUse);
void release();
};
// The fork component.
component ForkManager
{
// The fork facet used by philosophers.
provides Fork the_fork;
};
// Home for instantiating ForkManager components.
home ForkHome manages ForkManager {};

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 45

 The Fork Manager Component

exception InUse {};

interface Fork Fork
{ Manager
void get() raises (InUse);
void release();
};
// The fork component.
component ForkManager
{
// The fork facet used by philosophers.
provides Fork the_fork;
};
// Home for instantiating ForkManager components.
home ForkHome manages ForkManager {};

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 46

 The Fork Manager Component Facet

exception InUse {};

interface Fork Fork
{ Manager
void get() raises (InUse);
void release();
};
// The fork component.
component ForkManager
{
// The fork facet used by philosophers.
provides Fork the_fork;
};
// Home for instantiating ForkManager components.
home ForkHome manages ForkManager {};

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 47

 The Fork Manager Home ForkHome

exception InUse {};

interface Fork Fork
{ Manager
void get() raises (InUse);
void release();
};
// The fork component.
component ForkManager
{
// The fork facet used by philosophers.
provides Fork the_fork;
};
// Home for instantiating ForkManager components.
home ForkHome manages ForkManager {};

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 48

 The Philosopher State Types

enum PhilosopherState
{
EATING, THINKING, HUNGRY, Philosopher
STARVING, DEAD
}; name = XXX

eventtype StatusInfo
{
public string name;
public PhilosopherState state;
public unsigned long ticks_since_last_meal;
public boolean has_left_fork;
public boolean has_right_fork;
};

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 49

 The Philosopher Component

component Philosopher
{
attribute string name; Philosopher

// The left fork receptacle.

name = XXX
uses Fork left;
// The right fork receptacle.
uses Fork right;
// The status info event source.
publishes StatusInfo info;
};

home PhilosopherHome manages Philosopher {

factory new(in string name);
};

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 50

 The Philosopher Component Receptacles

component Philosopher
{
Philosopher
attribute string name;
// The left fork receptacle.
name = XXX
uses Fork left;
// The right fork receptacle.
uses Fork right;
// The status info event source.
publishes StatusInfo info;
};

home PhilosopherHome manages Philosopher {

factory new(in string name);
};

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 51

 The Philosopher Component Receptacles

component Philosopher
{
attribute string name;
Philosopher

// The left fork receptacle.

name = XXX
uses Fork left;
// The right fork receptacle.
uses Fork right;
// The status info event source.
publishes StatusInfo info;
};

home PhilosopherHome manages Philosopher {

factory new(in string name);
};

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 52

 The Philosopher Component Event Source

component Philosopher
{
attribute string name;
Philosopher

// The left fork receptacle.

name = XXX
uses Fork left;
// The right fork receptacle.
uses Fork right;
// The status info event source.
publishes StatusInfo info;
};

home PhilosopherHome manages Philosopher {

factory new(in string name);
};

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 53

 The Philosopher Home
PhilosopherHome
component Philosopher
{
attribute string name;
Philosopher

// The left fork receptacle.

name = XXX
uses Fork left;
// The right fork receptacle.
uses Fork right;
// The status info event source.
publishes StatusInfo info;
};

home PhilosopherHome manages Philosopher {

factory new(in string name);
};

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 54

 The Observer Component

Observer
component Observer
{
// The status info sink port.
consumes StatusInfo info;
};

// Home for instantiating observers.

home ObserverHome manages Observer {};

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 55

 The Observer Component

Observer
component Observer
{
// The status info sink port.
consumes StatusInfo info;
};

// Home for instantiating observers.

home ObserverHome manages Observer {};

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 56

 The Observer Home
Observer Home

Observer
component Observer
{
// The status info sink port.
consumes StatusInfo info;
};

// Home for instantiating observers.

home ObserverHome manages Observer {};

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 57

 Programming CORBA Component Clients

 The Client-Side OMG IDL Mapping

 The Client Programming Model
 Client Use Examples

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 58

 The Client-Side OMG IDL Mapping
 Each OMG IDL 3.0 construction has an equivalent
in terms of OMG IDL 2
 Component and home types are viewed by clients
through the CCM client-side OMG IDL mapping
 Permits no change in client programming
language mapping
 Clients still use their favorite IDL-oriented tools like
CORBA stub generators, etc.
 Clients do NOT have to be “component-aware”
 They just invoke interface operations

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 59

 The Client-Side OMG IDL Mapping
User written
Compiler
Component Component Generated files
Client Designer

Client OMG IDL

Application 3.0

uses

OMG IDL
Client-side 3.0
OMG IDL 2.x Compiler

implemented by

Client Component
Stub ORB

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 60

 Main Client-Side OMG IDL Mapping Rules

 A component type is mapped to an interface

inheriting from Components::CCMObject
 Facets and event sinks are mapped to an
operation for obtaining the associated reference
 Receptacles are mapped to operations for
connecting, disconnecting, and getting the
associated reference(s)
 Event sources are mapped to operations for
subscribing and unsubscribing to produced events
Wednesday, April 24th, 2002 CORBA Component Model Tutorial 61
 Main Client-Side OMG IDL Mapping Rules
 An event type is mapped to
 A value type
 inheriting from Components::EventBase
 A consumer interface
 inheriting from Components::EventConsumerBase

 A home type is mapped to three interfaces

 One for explicit operations user-defined
 inheriting from Components::CCMHome
 One for implicit operations generated
 One inheriting from both previous interfaces

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 62

 Client-Side Mapping for
ForkManager Component
component ForkManager
{ Fork
provides Fork the_fork; Manager
};
Is mapped to

interface ForkManager :
::Components::CCMObject
{
Fork provide_the_fork();
};

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 63

 Client-Side Mapping
for Fork Home ForkHome

home ForkHome
manages ForkManager {}; Fork
Is mapped to Manager
interface ForkHomeExplicit :
::Components::CCMHome {};
interface ForkHomeImplicit :
::Components::KeylessCCMHome {
ForkManager create();
};
interface ForkHome :
ForkHomeExplicit,
ForkHomeImplicit {};
Wednesday, April 24th, 2002 CORBA Component Model Tutorial 64
 Client-Side Mapping for
StatusInfo Event Type
eventtype StatusInfo {. . .};

Is mapped to

valuetype StatusInfo :
::Components::EventBase { . . . };

interface StatusInfoConsumer :
::Components::EventConsumerBase {
void push_StatusInfo(in StatusInfo
the_StatusInfo);
};
Wednesday, April 24th, 2002 CORBA Component Model Tutorial 65
 Client-Side Mapping
for Observer Component

component Observer { Observer

consumes StatusInfo info;
};

Is mapped to

interface Observer :
::Components::CCMObject {
StatusInfoConsumer get_consumer_info();
};

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 66

 Client-Side Mapping
for Observer Home
Observer Home
home ObserverHome
manages Observer {};
Is mapped to Observer

interface ObserverHomeExplicit :
::Components::CCMHome {};
interface ObserverHomeImplicit :
::Components::KeylessCCMHome {
Observer create();
};

interface ObserverHome :
ObserverHomeExplicit,
ObserverHomeImplicit {};

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 67

 Client-Side Mapping
for Philosopher Component
component Philosopher { Philosopher
attribute string name;
uses Fork left; name = XXX
uses Fork right;
publishes StatusInfo info;
};
Is mapped to

interface Philosopher :
::Components::CCMObject {
attribute string name;

.../...
Wednesday, April 24th, 2002 CORBA Component Model Tutorial 68
 Client-Side Mapping
for Philosopher Component Philosopher

name = XXX

void connect_left(in Fork cnx) raises(…);

Fork disconnect_left() raises(…);
Fork get_connection_left();
void connect_right(in Fork cnx) raises (…);
Fork disconnect_right() raises (…);
Fork get_connection_right();
Components::Cookie subscribe_info(
in StatusInfoConsumer consumer) raises(…);
StatusInfoConsumer unsubscribe_info(
in Components::Cookie ck) raises(…);
};

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 69

 Client-Side Mapping
for Philosopher Home PhilosopherHome

home PhilosopherHome Philosopher

manages Philosopher {
factory new(in string name); name = XXX
};
Is mapped to
interface PhilosopherHomeExplicit :
::Components::CCMHome {
Philosopher new(in string name);
};
interface PhilosopherHomeImplicit :
::Components::KeylessCCMHome {
Philosopher create();
};
interface PhilosopherHome :
PhilosopherHomeExplicit,
PhilosopherHomeImplicit {};

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 70

 The Client Programming Model
 Component-aware and -unaware clients
 Clients see two design patterns
 Factory – Client finds a home and uses it to create a new
component instance
 Finder - Client searches an existing component instance through
Name Service, Trader Service, or home finder operations

 Optionally demarcation of transactions

 Could establish initial security credentials
 Invokes operations on component instances
 Those defined by the client-side mapping

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 71

 CORBA Component Home Finder

 A brokerage of homes to clients

 Home implementations register with home finder
 Clients request homes from home finder

 Home finder makes determination of what is the

“best” home for a client, based on the client’s
request and any available environmental or
configuration data
 A home finder constitutes a domain of
home/container/implementation visibility

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 72

 Using CORBA Components
with OMG IDLscript
# Obtains the component home finder.
chf = CORBA.ORB.resolve_initial_references
(“ComponentHomeFinder”)
# Finds a home by its home type.
forkHome = chf.find_home_by_type(ForkHome.id())
# Creates a fork manager component.
forkManager = forkHome.create()
# Obtains the fork facet.
fork = forkManager.provide_the_fork ()
# Uses the fork facet.
fork.get()
. . . . . . .

fork.release()

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 73

 Connecting CORBA Components
with OMG IDLscript
# Obtaining CORBA components to be interconnected.
kant = Philosopher(“corbaname:…”)
observer = Observer(“corbaname:…”)

Philosopher

name = Kant Observer

# Connects kant and observer.

ck = kant.subscribe_info(observer.get_consumer_info())
. . . . . .
# Disconnects kant and observer.
kant.unsubscribe_info(ck)

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 74

 Navigation and Introspection
 Navigation from any facet to component base
reference with CORBA::Object::get_component()
 Returns nil if target isn’t a component facet
 Returns component reference otherwise
 Navigation from component base reference to any
facet via generated facet-specific operations
 Navigation and introspection capabilities provided
by CCMObject
 Via the Navigation interface for facets
 Via the Receptacles interface for receptacles
 Via the Events interface for event ports
Wednesday, April 24th, 2002 CORBA Component Model Tutorial 75
 Implementing CORBA Components

 Component Implementation Framework (CIF)

 Local Server-Side OMG IDL Mapping

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 76

 Component Implementation Framework
 CIF defines a programming model for
constructing component implementations
 How components should be implemented

 Facilitates component implementation

 “only” business logic should be implemented
 Not activation, identify, port management and introspection

=> Local server-side OMG IDL mapping

 Interactions between implementations and containers

 Manages segmentation and persistency

=> Component Implementation Definition Language
Wednesday, April 24th, 2002 CORBA Component Model Tutorial 77
 Component Implementation Framework
to Component Skeleton Generation

Extended Component executor

OMG IDL
file
+
CIDL
Server-Side Mapping

Skeletons managing
ports, life cycle,
persistency, etc.
Compiling + GIOP/IIOP
for CIF/Java

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 78

 Executors and Home Executors
 Programming artifacts implementing a
component’s or component home’s behavior
 Local CORBA objects with interfaces defined
by the local server-side OMG IDL mapping
 Component executors could be monolithic
 All component attributes, supported interfaces, facet
operations, and event sinks implemented by one class
 Component executors could also be segmented
 Component features split into several classes
 Implements ExecutorLocator interface
 Home executors are always monolithic

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 79

 Executors Are Hosted by Container

 Container intercepts invocations on executors

for managing activation, security, transactions,
persistency, and so
 Component executors must implement a local
callback lifecycle interface used by the container
 SessionComponent for transient components
 EntityComponent for persistent components
 Component executors could interact with their
containers and connected components through
a local context interface
Wednesday, April 24th, 2002 CORBA Component Model Tutorial 80
 A Monolithic Component Executor

Component container

Component
Monolithic executor specific
context

Container context

Main component executor interface Component-oriented context interface

Container-oriented context interface
Facet or event sink executor interface
Context use
SessionComponent or EntityComponent Container interposition
Wednesday, April 24th, 2002 CORBA Component Model Tutorial 81
 A Segmented Component Executor

Component container

Main segment

Component
Seg2 Seg3 Seg4 specific
context

Container context

ExecutorLocator

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 82

 The Server-Side OMG IDL Mapping

Component Component Component

Client Designer Implementer

Client OMG IDL Component

Application 3.0 Executor

uses implemented by

OMG IDL
Client-side Local
3.0
OMG IDL 2.x server-side
Compiler
OMG IDL 2.x

implemented by delegates to
User written
Compiler Client Component
Stub ORB Skeleton
Generated files
Wednesday, April 24th, 2002 CORBA Component Model Tutorial 83
 Main Server-Side OMG IDL Mapping Rules
 A component type is mapped to three local interfaces
 The main component executor interface
 Inheriting from Components::EnterpriseComponent
 The monolithic component executor interface
 Operations to obtain facet executors and receive events
 The component specific context interface
 Operations to access component receptacles and event sources

 A home type is mapped to three local interfaces

 One for explicit operations user-defined
 Inheriting from Components::HomeExecutorBase
 One for implicit operations generated
 One inheriting from both previous interfaces

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 84

 Implementing CORBA Components
in Java

 Dining Philosophers Example

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 85

 Local Server-Side Mapping
for ForkManager Component
Fork
Manager
// Executor interface for the the_fork facet.
local interface CCM_Fork : Fork {};

// Main component executor interface.

local interface CCM_ForkManager_Executor :
::Components::EnterpriseComponent {
// Empty because no attributes.
};

// Monolithic executor interface.

local interface CCM_ForkManager :
CCM_ForkManager_Executor {
// Requested by container.
CCM_Fork get_the_fork();
};

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 86

 Local Server-Side Mapping
for ForkManager Component
Fork
Manager

// Component-specific context interface.

local interface CCM_ForkManager_Context :
// Container context interface.
::Components::CCMContext
{
// Empty because no receptacles or event sources.
};

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 87

 Different ForkManager Implementations

 Fork facet implementation

 class ForkImpl
Fork
Manager
 Monolithic executor approach
 By inheritance: MonolithicForkManager_1_Impl
 By delegation: MonolithicForkManager_2_Impl

 Executor locator approach

 One segment: SegmentedForkManager_1_Impl
 Two segments: SegmentedForkManager_2_Impl

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 88

 Fork Facet Implementation:
Just Business Operations Fork

public class ForkImpl

extends org.omg.CORBA.LocalObject
implements CCM_Fork
{
private boolean available_ = true;
public void get() throws InUse
{
// Check if there is no current philosopher.
if (!available_) throw new InUse();
available_ = false;
}
public void release()
{
available_ = true;
} }

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 89

 Monolithic ForkManager Executor:
Facet Implementation By Inheritance
Fork
Manager
public class MonolithicForkManager_1_Impl
extends ForkImpl // Fork implementation
implements CCM_ForkManager, // as monolithic
// Is a session executor
org.omg.Components.SessionComponent
{
// Required by CCM_ForkManager interface.
public CCM_Fork get_the_fork() {
// Itself as it extends ForkImpl.
return this;
}

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 90

 Monolithic ForkManager Executor:
Facet Implementation By Delegation
Fork
Manager
public class MonolithicForkManager_2_Impl
extends org.omg.CORBA.LocalObject
implements CCM_ForkManager, // as monolithic
// Is a session executor
org.omg.Components.SessionComponent
{
private ForkImpl the_fork_ = new ForkImpl();

// Required by CCM_ForkManager interface.

public CCM_Fork get_the_fork() {
// The delegate for the facet.
return the_fork_;
}

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 91

 Segmented ForkManager Executor
With One Segment
Fork
Manager
public class SegmentedForkManager_1_Impl
extends ForkImpl
implements CCM_ForkManager_Executor,
SessionComponent, ExecutorLocator
{ // Required by ExecutorLocator interface.
public org.omg.CORBA.Object obtain_executor(String name)
throws org.omg.Components.CCMException
{
if ( name.equals("ForkManager")
|| name.equals("the_fork”) )
return this;
throw new org.omg.Components.CCMException();
}
public void release_executor(org.omg.CORBA.Object exc)
throws org.omg.Components.CCMException {...}
public void configuration_complete()
throws org.omg.Components.InvalidConfiguration {...}

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 92

 Segmented ForkManager Executor
With Two Segments
Fork
Manager
public class SegmentedForkManager_2_Impl
extends org.omg.CORBA.LocalObject
implements CCM_ForkManager_Executor,
SessionComponent, ExecutorLocator
{
private ForkImpl the_fork_ = new ForkImpl();
// Required by ExecutorLocator interface.
public org.omg.CORBA.Object obtain_executor(String name)
throws org.omg.Components.CCMException
{
if (name.equals("ForkManager"))
return this;
if (name.equals("the_fork”))
return the_fork_;
throw new org.omg.Components.CCMException();
}
// Also release_executor and configuration_complete operations.

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 93

 SessionComponent
Callback Implementation
Fork
Manager
// import org.omg.Components.*;

// The context is fixed by the container.

public void set_session_context(SessionContext ctx)
throws CCMException {...}

// Called by container when component is activated.

public void ccm_activate() throws CCMException {...}

// Called by container when component is deactivated.

public void ccm_passivate() throws CCMException {...}

// Called by container when component is removed.

public void ccm_remove() throws CCMException {...}

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 94

 Local Server-Side Mapping
for Fork Home ForkHome

Fork
Manager
local interface CCM_ForkHomeExplicit :
::Components::HomeExecutorBase {
// Empty as no user-defined home operations.
};
local interface CCM_ForkHomeImplicit {
::Components::EnterpriseComponent
create() raises(::Components::CreateFailure);
};
local interface CCM_ForkHome :
CCM_ForkHomeExplicit,
CCM_ForkHomeImplicit {};

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 95

 Fork Home Executor ForkHome

public class ForkHomeImpl

extends org.omg.CORBA.LocalObject Fork
implements CCM_ForkHome Manager
{
// Required by CCM_ForkHome interface.
public org.omg.Components.EnterpriseComponent
create() {
// This home executor class manages a specific
// component executor class.
return new ...ForkManager...Impl();
}
// Called at deployment time.
public static org.omg.Components.HomeExecutorBase
create_home() {
return new ForkHomeImpl();
} }

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 96

 Local Server-Side Mapping
for Observer Component
Observer
// info event sink executor interface.
local interface CCM_StatusInfoConsumer {
void push(in StatusInfo ev);
};
// Main component executor interface.
local interface CCM_Observer_Executor :
::Components::EnterpriseComponent {
};
// Monolithic executor interface.
local interface CCM_Observer :
CCM_Observer_Executor {
void push_info(in StatusInfo ev);
};
// Component-specific context interface.
local interface CCM_Observer_Context :
::Components::CCMContext {};

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 97

 Monolithic Observer Executor
Observer

public class ObserverImpl

extends org.omg.CORBA.LocalObject
implements CCM_Observer,
SessionComponent
{
// Required for monolithic interface.
public void push_info(StatusInfo event)
{
… update GUI …
}

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 98

 Monolithic Observer Executor
Observer

public void set_session_context(SessionContext ctx)

throws CCMException {...}

public void ccm_activate() throws CCMException

{ … display GUI … }

public void ccm_passivate() throws CCMException

{ … hide GUI … }

public void ccm_remove() throws CCMException

{ … free GUI … }
}

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 99

 Local Server-Side Mapping
for Observer Home Observer Home

Observer
local interface
CCM_ObserverHomeExplicit :
::Components::HomeExecutorBase {};

local interface CCM_ObserverHomeImplicit {

::Components::EnterpriseComponent
create() raises(::Components::CreateFailure);
};

local interface CCM_ObserverHome :

CCM_ObserverHomeExplicit,
CCM_ObserverHomeImplicit {};

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 100

 Observer Home Executor Observer Home

Observer
public class ObserverHomeImpl
extends org.omg.CORBA.LocalObject
implements CCM_ObserverHome
{
// Required by CCM_ObserverHome interface.
public org.omg.Components.EnterpriseComponent
create()
{ return new ObserverImpl(); }

// Called at deployment time.

public static org.omg.Components.HomeExecutorBase
create_home()
{ return new ObserverHomeImpl(); }
}

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 101

 Local Server-Side Mapping
for Philosopher Component Philosopher

name = XXX

// Main component executor interface.

local interface CCM_Philosopher_Executor :
::Components::EnterpriseComponent {
attribute string name;
};

// Monolithic executor interface.

local interface CCM_Philosopher :
CCM_Philosopher_Executor {
};

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 102

 Local Server-Side Mapping
for Philosopher Context Philosopher

name = XXX

local interface CCM_Philosopher_Context :

::Components::CCMContext
{
// To obtain the connected left fork
Fork get_connection_left();
// To obtain the connected right fork
Fork get_connection_right();
// To push an info event to all subscribers
void push_info(in StatusInfo ev);
};

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 103

 Monolithic Philosopher Executor Philosopher

name = XXX
public class PhilosopherImpl
extends org.omg.CORBA.LocalObject
implements CCM_Philosopher,
SessionComponent,
java.lang.Runnable
{ // Constructor.
public PhilosopherImpl(String n) { name_ = n; }
// Transient state.
private String name_;
// Required by the CCM_Philosopher_Executor interface.
public void name(String n) { name_ = n; }
public String name() { return name_; }

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 104

 Monolithic Philosopher Executor Philosopher

// The philosopher behavior state machine.name = XXX

private java.lang.Thread behavior_;

// The philosopher CCM context.

private CCM_Philosopher_Context the_context_;

public void set_session_context(SessionContext ctx)

throws CCMException
{ the_context_ = (CCM_Philosopher_Context)ctx; }

public void ccm_activate() throws CCMException

{ behavior_ = new Thread(this); behavior_.start(); }

public void ccm_passivate() throws CCMException

{ behavior_.stop(); }

public void ccm_remove() throws CCMException {...}

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 105

 Monolithic Philosopher Executor Philosopher

public void run() { // The state machine. name = XXX

...
// Pushes the current status to all observers.
the_context_.push_info(...);
...
// Takes the left fork.
the_context_.get_connection_left().get();
...
// Takes the right fork.
the_context_.get_connection_right().get();
...
// Releases the left fork.
the_context_.get_connection_left().release();
...
// Releases the right fork.
the_context_.get_connection_right().release();
...
}

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 106

 Local Server-Side Mapping
for Philosopher Home PhilosopherHome

local interface Philosopher

CCM_PhilosopherHomeExplicit :
::Components::HomeExecutorBase name = XXX
{
::Components::EnterpriseComponent
new(in string name);
};
local interface CCM_PhilosopherHomeImplicit {
::Components::EnterpriseComponent
create() raises(Components::CreateFailure);
};
local interface CCM_PhilosopherHome :
CCM_PhilosopherHomeExplicit,
CCM_PhilosopherHomeImplicit {};

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 107

 Philosopher Home Executor PhilosopherHome

public class PhilosopherHomeImpl

Philosopher
extends org.omg.CORBA.LocalObject
implements CCM_PhilosopherHome name = XXX
{

// Required by CCM_PhilosopherHomeImplicit interface.

public org.omg.Components.EnterpriseComponent
create() { return new PhilosopherImpl(“”); }
// Required by CCM_PhilosopherHomeExplicit interface.
public org.omg.Components.EnterpriseComponent
_new(String name) {
return new PhilosopherImpl(name);
}
// Called at deployment time.
public static org.omg.Components.HomeExecutorBase
create_home() { return new PhilosopherHomeImpl(); }
}

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 108

 Implementing CORBA Components
in C++

 Dining Philosophers Example

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 109

 C++ Component Implementation
 As before:
 Based on Server-Side equivalent IDL
 Components and Homes are mapped to local interfaces
 Equivalent local interfaces are implemented according
to C++ language mapping
 Choice between monolithic and locator implementation
 Optionally aided by CIDL generated code
 C++ specific:
 entry point: factory for each home type
 extern “C” so that entry point can be found in shared
library

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 110

 Implementing ForkManager in C++
Fork
Manager

exception InUse {};

interface Fork {
void get () raises (InUse);
void release ();
};

component ForkManager {
provides Fork the_fork;
};

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 111

 Server Side equivalent IDL
for ForkManager
Fork
Manager
// Executor interface for the the_fork facet.
local interface CCM_Fork : Fork {};

// Main component executor interface.

local interface CCM_ForkManager_Executor :
::Components::EnterpriseComponent {
// Empty because no attributes.
};

// Monolithic executor interface.

local interface CCM_ForkManager :
CCM_ForkManager_Executor {
// Requested by container.
CCM_Fork get_the_fork();
};

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 112

 Server Side equivalent IDL
for ForkManager
Fork
Manager

// Component-specific context interface.

local interface CCM_ForkManager_Context :
::Components::CCMContext
{
// Empty because no receptacles or event sources.
};

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 113

 Different ForkManager Implementations

 Fork facet implementation

 class Fork_impl
Fork
Manager
 Monolithic approach
 By inheritance: ForkManager_1_impl
 By delegation: ForkManager_2_impl

 Executor locator approach

 Segmented: ForkManager_3_Executor_impl
and ForkManager_3_Locator_impl

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 114

 Fork Facet Implementation Fork

class Fork_impl : virtual public CCM_Fork

{ bool available_;
public:
Fork_impl () { available_ = true; }
public void get()
{
if (!available_) throw InUse();
available_ = false;
}
public void release()
{
available_ = true;
}
};

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 115

 ForkManager Implementation (1):
Monolithic, Inheritance of Facet
Fork
Manager
// IDL implied by the IDL to C++ mapping.
local interface MyFork : CCM_ForkManager, CCM_Fork {};
// C++
class ForkManager_1_impl :
virtual public MyFork,
virtual public Fork_impl
{
public:
// facet implemented by myself
CCM_Fork_ptr get_the_fork () {
return CCM_Fork::_duplicate (this);
}
};

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 116

 ForkManager Implementation (2):
Monolithic, Delegation of Facet
Fork
Manager
class ForkManager_2_impl :
virtual public CCM_ForkManager
{
CCM_Fork_var the_fork_;

public:
ForkManager_2_impl () {
the_fork_ = new Fork_impl;
}
CCM_Fork_ptr get_the_fork () {
return CCM_Fork::_duplicate (the_fork_);
}
};

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 117

 ForkManager Implementation (3):
Locator based
Fork
Manager
class ForkManager_3_Executor_impl :
virtual public CCM_ForkManager_Executor
{ /* empty */ };

class ForkManager_3_Locator_impl :
virtual public Components::ExecutorLocator
{
CCM_ForkManager_Executor_var _executor;
CCM_Fork_var _the_fork;
public:
ForkManager_3_Locator_impl ()
{
_executor = new ForkManager_3_Executor_impl;
_the_fork = new Fork_impl;
}

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 118

 ForkManager Implementation (3):
Locator based (contd)
Fork
Manager
/* MyFork_3_Locator_impl continued */

CORBA::Object_ptr
obtain_executor (const char * name) {
if (strcmp (name, “ForkManager”) == 0)
return CORBA::Object::_duplicate (_executor);
else
return CORBA::Object::_duplicate (_the_fork);
}

void release_executor (CORBA::Object_ptr obj)

{ /* empty */ }

void configuration_complete ()
{ /* empty */ }
};

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 119

 Server Side equivalent IDL
for ForkHome ForkHome

Fork
local interface CCM_ForkHomeExplicit : Manager
::Components::HomeExecutorBase {
// Empty
};
local interface CCM_ForkHomeImplicit {
::Components::EnterpriseComponent
create () raises(::Components::CreateFailure);
};
local interface CCM_ForkHome :
CCM_ForkHomeExplicit,
CCM_ForkHomeImplicit {};

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 120

 ForkHome Executor ForkHome

class ForkHome_impl :
virtual public CCM_ForkHome Fork
{ Manager
// from the implicit interface

Components::EnterpriseComponent_ptr create ()
{
return new ForkManager_1_impl;
// or: return new ForkManager_2_impl;
// or: return new ForkManager_3_Locator_impl;
};
extern “C” {
Components::HomeExecutorBase_ptr
create_ForkHome ()
{ return new ForkHome_impl; }
}

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 121

 Implementing Observer in C++
Observer

eventtype StatusInfo { ... };

component Observer {
consumes StatusInfo info;
};

home ObserverHome manages Observer {};

// to be notified of activation and passivation

local interface MyObserver :

CCM_Observer,
Components::SessionComponent
{};

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 122

 Server Side equivalent IDL
for Observer
Observer
// info event sink executor interface.
local interface CCM_StatusInfoConsumer {
void push(in StatusInfo ev);
};
// Main component executor interface.
local interface CCM_Observer_Executor :
::Components::EnterpriseComponent {
};
// Monolithic executor interface.
local interface CCM_Observer :
CCM_Observer_Executor {
void push_info (in StatusInfo ev);
};
// Component-specific context interface.
local interface CCM_Observer_Context :
::Components::CCMContext {};

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 123

 Observer Implementation
Monolithic
Observer

class Observer_impl :
virtual public MyObserver
{
public:
// receive StatusInfo event

void push_info (StatusInfo * event)

{
… update GUI …
}

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 124

 Observer Implementation
Monolithic (2)
Observer
// from SessionComponent interface

void set_session_context
(Components::SessionContext_ptr ctx)
{ /* empty */ }

void ccm_activate ()
{ … display GUI … }

void ccm_passivate ()
{ … hide GUI … }

void ccm_remove ()
{ … free GUI … }
};

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 125

 Server Side Equivalent IDL
for ObserverHome Observer Home

Observer
local interface
CCM_ObserverHomeExplicit :
::Components::HomeExecutorBase {};

local interface CCM_ObserverHomeImplicit {

::Components::EnterpriseComponent
create() raises(::Components::CreateFailure);
};

local interface CCM_ObserverHome :

CCM_ObserverHomeExplicit,
CCM_ObserverHomeImplicit {};

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 126

 ObserverHome Executor Observer Home

class ObserverHome_impl :
Observer
virtual public CCM_ObserverHome
{
// from the implicit interface

Components::EnterpriseComponent_ptr create ()
{
return new Observer_impl;
}
};
extern “C” {
Components::HomeExecutorBase_ptr
create_ObserverHome ()
{ return new ObserverHome_impl; }
}

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 127

 Implementing Philosopher
in C++ Philosopher

name
component Philosopher {
attribute string name;
uses Fork left;
uses Fork right;
publishes StatusInfo info;
};
home PhilosopherHome manages Philosopher {
factory new (in string name);
};
local interface MyPhilosopher :
CCM_Philosopher,
Components::SessionComponent
{};

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 128

 Server Side equivalent IDL
for Philosopher Philosopher

name

// Main component executor interface.

local interface CCM_Philosopher_Executor :
::Components::EnterpriseComponent {
attribute string name;
};

// Monolithic executor interface.

local interface CCM_Philosopher :
CCM_Philosopher_Executor {
};

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 129

 Server Side equivalent IDL
for Philosopher Philosopher

name

local interface CCM_Philosopher_Context :

::Components::CCMContext
{
// To obtain the connected left fork
Fork get_connection_left();
// To obtain the connected right fork
Fork get_connection_right();
// To push an info event to all subscribers
void push_info(in StatusInfo ev);
};

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 130

 Philosopher Executor
Monolithic Philosopher

name
class Philosopher_impl :
virtual public MyPhilosopher
{
CCM_Philosopher_Context_var _ctx;
CORBA::String_var _name;

public:
// Philosopher interface
Philosopher_impl (const char * nn) {
_name = nn;
}
void name (const char * nn) { _name = nn; }
char * name () { return CORBA::string_dup (_name); }

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 131

 Philosopher Executor
Monolithic (2) Philosopher

name
// from SessionComponent interface

void set_session_context
(Components::SessionContext_ptr ctx)
{ _ctx = CCM_Philosopher_Context::_narrow (ctx); }

void ccm_activate ()
{ … start philosopher, start timer … }

void ccm_passivate ()
{ … deep-freeze philosopher, stop timer … }

void ccm_remove ()
{ … kill philosopher … }

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 132

 Philosopher Executor
Monolithic (3) Philosopher

name
// timer callback
void timer ()
{
// not the real code
Fork_var left = _ctx->get_connection_left ();
Fork_var right = _ctx->get_connection_right ();
left->get (); // acquire left fork
right->get (); // acquire right fork
StatusInfo_var info = new StatusInfo_impl;
// set event contents
_ctx->push_info (info);
right->release (); // release right fork
left->release (); // release left fork
}
};

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 133

 Server Side equivalent IDL
for PhilosopherHome PhilosopherHome

Philosopher
local interface
CCM_PhilosopherHomeExplicit : name
::Components::HomeExecutorBase {
::Components::EnterpriseComponent
new (in string name);
};
local interface CCM_PhilosopherHomeImplicit {
::Components::EnterpriseComponent
create () raises(Components::CreateFailure);
};
local interface CCM_PhilosopherHome :
CCM_PhilosopherHomeExplicit,
CCM_PhilosopherHomeImplicit {};

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 134

 PhilosopherHome Executor PhilosopherHome

class PhilosopherHome_impl : Philosopher

virtual public CCM_PhilosopherHome
{ name
Components::EnterpriseComponent_ptr
create ()
{ return new Philosopher_impl (“unnamed”); }

Components::EnterpriseComponent_ptr
_cxx_new (const char * name)
{ return new Philosopher_impl (name); }
};
extern “C” {
Components::HomeExecutorBase_ptr
create_PhilosopherHome ()
{ return new PhilosopherHome_impl; }
}

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 135

 Implementing CORBA Components
with CIDL

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 136

 Component Implementation Definition
Language (CIDL)
 Describes component composition
 Aggregate entity which describes all the artifacts
required to implement a component and its home

 Manages component persistence state

 With OMG Persistent State Definition Language (PSDL)
 Links storage types to segmented executors

 Generates executor skeletons providing

 Segmentation of component executors
 Default implementations of callback operations
 Component’s state persistency

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 137

 Basic CIDL Composition Features

 Component lifecycle category

 Service, session, process, entity

 Name of home executor skeleton to generate

 Component home type implemented

 Implicitly the component type implemented

 Name of main executor skeleton to generate

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 138

 CIDL Composition for
Observer Component
#include <philo.idl>
// or import DiningPhilosophers;

composition service ObserverComposition

{
home executor ObserverHomeServiceImpl
{
implements DiningPhilosophers::ObserverHome;
manages ObserverServiceImpl;
};
};

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 139

 OMG CIDL Compilation Process

Component Composition Component

Designer Designer Implementer

Component
OMG IDL OMG CIDL
includes Executor
3.0
imports

Local OMG CIDL

OMG IDL inherited by
3.0 Server-side Compiler
and completed
Compiler OMG IDL

delegates to
partially User written
implemented Component
Component Compiler
Skeleton Executor
Generated files
Skeleton
Wednesday, April 24th, 2002 CORBA Component Model Tutorial 140
 Advanced CIDL Composition Features
 Associated abstract storage home type for
component persistency
 Multiple executor segments
 Implement a subset of the component’s facets
 Could have an associated abstract storage home

 Component features stored automatically

 Attribute values, references connected to receptacles
and event sources are delegated to storage

 Proxy homes

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 141

 CIDL Composition
for ForkManager Component
#include <philo.idl>
// or import DiningPhilosophers;
composition session ForkManagerComposition
{
home executor ForkHomeSessionImpl
{
implements DiningPhilosophers::ForkHome;
manages ForkManagerSessionImpl {
segment Seg {
provides facet the_fork; }
};
};
};
Wednesday, April 24th, 2002 CORBA Component Model Tutorial 142
 OMG PSDL for Dining Philosophers
#include <philo.idl>
abstract storagetype Person {
state string name;
state DiningPhilosophers::PhilosopherState
philosopher_state;
. . .
};
abstract storagehome PersonHome of Person {
factory create();
};
storagetype PersonBase implements Person {};
storagehome PersonHomeBase of PersonBase
implements PersonHome {};

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 143

 CIDL Composition for Dining Philosophers
#include <philo.psdl>

composition process PhilosopherComposition

{
home executor PhilosopherHomeProcessImpl
{
implements
DiningPhilosophers::PhilosopherHome;
bindsTo PersonHome;
manages PhilosopherProcessImpl;
};
};

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 144

 OMG CIDL & PSDL Compilation Process
OMG IDL
Database 3.0 Composition Component
Designer Designer Implementer

Component
OMG PSDL OMG CIDL
includes Executor

OMG PSDL OMG CIDL

Compiler Compiler
inherited by
and completed

Storage
Stub uses Component
User written
Executor
Skeleton Compiler
Database Generated files

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 145

 Relationship Between Artifacts
component C {}; abstract storagetype ST{};
home executor HE { abstract storagehome SH
home H manages C implements H;
{}; manages ST {};
bindsTo SH;
manages E;
};

implements Home binds to Storage

Home
Executor Home

manages manages manages

implements stored as Storage

Component Executor
Object
IDL
Explicitly defined
CIDL
PSDL Implicitly defined
Wednesday, April 24th, 2002 CORBA Component Model Tutorial 146
 Putting CORBA Containers to Work

 The Container Model

 Container Managed Policies

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 147

 The Container Model

 A framework for component application servers

 Mostly built on the Portable Object Adaptor
 Automatic activation / deactivation
 Resource usage optimization

 Provides simplified interfaces for CORBA Services

 Security, transactions, persistence, and events

 Uses callbacks for instance management

 Empty container for user-defined frameworks also
Wednesday, April 24th, 2002 CORBA Component Model Tutorial 148
 The Container Architecture

C Home
l Extended
i OMG IDL
external
e API Callback
CORBA
n API
Component
t

POA
Internal
API Container

ORB

Transaction Security Persistency Notification

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 149

 Container View
 A container encapsulates one or several POAs
 A container manages one kind of component
 entity: persistent, primary key, and explicit destruction
 process: persistent, no key, and explicit destruction
 session: exists during a session with the client
 service: exists during an invocation
 EJBsession, EJBentity: for EJBs
 Empty: user-defined policy
 References are exported through Component
HomeFinder, Naming, or Trader services

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 150

 Component Categories
COMPONENT CONTAINER CONTAINER EXTERNAL EJB BEAN
CATEGORY IMPL TYPE TYPE TYPE EQUIVALENT

Service Stateless Session Keyless Session

(stateless)
Session Conv Session Keyless Session
(stateful)
Process Durable Entity Keyless -----

Entity Durable Entity Keyfull Entity

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 151

 Container Managed Policies
 Specified by the deployer using an XML vocabulary
 Implemented by the container, not the component
 Policy declarations defined for:
 Servant Lifetime
 Transaction
 Security
 Events
 Persistence

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 152

 Servant Lifetime Policies
 method – valid for all categories
 activated before each invocation
 passivated after each invocation
 transaction – valid for all except service
 activated on the first invocation of a new transaction
 passivated after the last invocation of the transaction
 component – valid for all except service
 activated before first invocation
 passivated explicitly
 container – valid for all except service
 activated on the first invocation
 passivated when the container needs to reclaim memory

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 153

 Transactions

 Container-managed at the operation level

 NOT_SUPPORTED
 REQUIRED
 SUPPORTS
 REQUIRES_NEW
 MANDATORY
 NEVER
 Self-managed using the Components::
Transaction::UserTransaction API which
is mapped to CORBA transactions
Wednesday, April 24th, 2002 CORBA Component Model Tutorial 154
 Security
 Most security is declarative using the component
descriptors (security element)
 Container supports access to and testing of
credentials at run time
 Security Permissions defined at the operation level
 CLIENT_IDENTITY
 SYSTEM_IDENTITY
 SPECIFIED_IDENTITY (=userid)
 Based on CORBA Security V2

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 155

 Events
 Subset of the CORBA Notification service
 Events represented as valuetypes to components
 Push Model
 Container maps valuetypes to Structured Events
 Container manages channel creation
 Quality of service properties left to configuration
 Event Policies declared in component descriptors
 non-transactional
 default
 transactional

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 156

 Persistence

 Supported for Entity container types only

 Container persistence policies:
 Self managed
 Container managed

 Both modes can use PSS or their own persistence

mechanism

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 157

 The Container Server Architecture

Container Manager
Entity Session EJB Other
Container Container Container Container

POA1 POA2 POA3 POA4

ORB

Transactions Security Persistence Events

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 158

 Packaging CORBA Components

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 159

 A Day in the Life of a Component

 A component is specified
 OMG IDL 3.0, PSDL, and CIDL
 A component is implemented
 Component Implementation Framework
 A component must be packaged
 A component may be assembled with other
components
 Components and assemblies are be deployed

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 160

 Packaging and Deployment

 “Classic” CORBA: No standard means of ...

 Configuration
 Distribution
 Deployment
 Packaging and Deployment of Components
 Components are packaged into a self-descriptive
package
 Packages can be assembled
 Assemblies can be deployed
 Helped by XML descriptors

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 161

 CCM Applications Deployment
 It is necessary for an application to
 List component instances
 Define logical location and partitioning
 Specify connections between components
 It is necessary for a component to
 Specify its elements
 interfaces, implementations
 Describe system requirements
 OS, ORB, JVM, library releases, …
 Specify its initial configuration
 It is necessary for a connection to
 Associate related component ports

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 162

 The Packaging and Deployment Model

 Describes distributed CORBA component-based

applications for automatic deployment
 Packaging technology
 Self descriptive “ZIP” archives with XML descriptors
 For heterogeneous components

 Allows interoperability between deployment tools

and containers
 Off-line by data exchange formats
 On-line by OMG IDL interfaces

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 163

 Component Package

 Archive (ZIP file) containing

 One component, consisting of
 One or more implementations
 E.g. for different OSs, ORBs, processors, QoS, ...
 OMG IDL file of the component, home and port types
 CORBA Component Descriptor (.ccd) for required container

policies
 Property File Descriptor (.cpf) defining default attribute values
 Software Package Descriptor (.csd) describing package contents

 Self-contained and self-descriptive, reusable unit

 Usually done by the component implementer
Wednesday, April 24th, 2002 CORBA Component Model Tutorial 164
 Component Packaging Artifacts

I D L / C ID L F ile U s e r 's C o d e P r o g r a m m in g
Language
T o o ls

ID L /C ID L D e f a u lt P r o p e r t ie s H o m e P r o p e r t ie s C o m p o n e n t P r o p e r t ie s
C o m p ile r

C O R BA
S tu b s , S k e le t o n s I m p le m e n ta t io n C om ponent
P ackage

C O R B A C om ponent
P a c k a g in g A s s e m b ly
C om ponent A s s e m b ly
Tool Tool
P ackage P ackage

C om ponent
D e s c rip to r
s o ftp k g A s s e m b ly
D e s c r ip t o r D e s c r ip to r

C O R BA
D e p lo y m e n t
C om ponent
Tool
P ackage

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 165

 Component Assembly Package

 A component assembly is a template for a

deployed set of interconnected components

 Described by a assembly descriptor in terms of

component files, partitioning, and connections

 May be deployed as it as well as imported into a

design tool to be reused or extended

 A “ZIP” archive containing descriptor, component

archive files, and property files
Wednesday, April 24th, 2002 CORBA Component Model Tutorial 166
 Component Assembly Package
 Archive (ZIP file) containing
 One or more component packages, either
 Including a package’s contents
 Including the original package
 Referencing the package by URL
 Property File Descriptors defining initial attribute values
 Component Assembly Descriptor (.cad)
 Defines home instances to be created
 Defines component instances to be created
 Defines connections between ports to be made
 Self-contained and self-descriptive unit
 For automatic and easy “one step” deployment
 No programming language experience necessary
Wednesday, April 24th, 2002 CORBA Component Model Tutorial 167
 Component Assembly Artifacts

I D L / C I D L F ile U s e r 's C o d e P r o g r a m m in g
Language
T o o ls

ID L /C ID L D e f a u lt P r o p e r t ie s H o m e P r o p e r t ie s C o m p o n e n t P r o p e r t ie s
C o m p ile r

C O R BA
S tu b s , S k e le to n s I m p le m e n t a t io n C om ponent
P ackage

C O R BA C om ponent
P a c k a g in g A s s e m b ly
C om ponent A s s e m b ly
Tool Tool
P ackage P ackage

C om ponent
D e s c r ip to r
s o ftp k g A s s e m b ly
D e s c r ip t o r D e s c r ip to r

C O R BA
D e p lo y m e n t
C om ponent
Tool
P ackage

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 168

 XML Descriptors Overview
 Software Package Descriptor (.csd)
 Describes contents of a component software package
 Lists one or more implementation(s)
 CORBA Component Descriptor (.ccd)
 Technical information mainly generated from CIDL
 Some container managed policies filled by user
 Component Assembly Descriptor (.cad)
 Describes initial virtual configuration
 homes, component instances, and connections
 Component Property File Descriptor (.cpf)
 name/value pairs to configure attributes
Wednesday, April 24th, 2002 CORBA Component Model Tutorial 169
 Relationship Between
CCM XML Descriptors

Component Software CORBA

* *
Assembly Package Component
Descriptor Descriptor Descriptor

Component
* Property
File
Descriptor

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 170

 Software Package Descriptor (.csd)
 Descriptive general elements
 title, description, author, company, webpage, license
 Link to OMG IDL file
 Link to default property file
 Implementation(s)
 Information about Implementation
 Operating System, processor, language, compiler, ORB
 Dependencies on other libraries and deployment requirements
 Customized property and CORBA component descriptor
 Link to implementation file
 Shared library, Java class, executable
 Entry point
Wednesday, April 24th, 2002 CORBA Component Model Tutorial 171
 Software Package Descriptor Example
<?xml version='1.0'?>
<!DOCTYPE softpkg>
<softpkg name="PhilosopherHome">
<idl id="IDL:DiningPhilosophers/PhilosopherHome:1.0">
<fileinarchive name="philo.idl"/>
</idl>
<implementation id="*">
<code type="DLL">
<fileinarchive name="philo.dll"/>
<entrypoint>create_DiningPhilosophers_PhilosopherHome</entrypoint>
</code>
</implementation>
</softpkg>

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 172

 Software Package Descriptor
for Observer Component
<?xml version="1.0"?>
<!DOCTYPE softpkg SYSTEM "softpkg.dtd">

<softpkg name="Observer" version="1,0,0,0">

<pkgtype>CORBA Component</pkgtype>
<title>Observer</title>
<author>
<name>Philippe Merle</name>
<company>INRIA</company>
<webpage href="http://www.inria.fr"/>
</author>
<description>The CCM dining philosophers example</description>

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 173

 Software Package Descriptor
for Observer Component
<license href= "http://www.objectweb.org/license.html"/>
<idl id='IDL:DiningPhilosophers/Observer:1.0'>
<link href=" http://www.objectweb.org/philo.idl"/>
</idl>
<descriptor type="CORBA Component">
<fileinarchive name="observer.ccd"/>
</descriptor>
<propertyfile>
<fileinarchive name="observer.cpf"/>
</propertyfile>
<implementation> . . . </implementation>
</softpkg>

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 174

 Software Package Descriptor
for Observer Component
<implementation id="Observer_impl">
<os name="WinNT" version="4,0,0,0"/>
<os name="Linux" version="2,2,17,0"/>
<processor name="x86"/>
<compiler name="JDK"/>
<programminglanguage name="Java"/>
<code type="Java class">
<fileinarchive name="ObserverHomeImpl.class"/>
<entrypoint>ObserverHomeImpl.create_home</entrypoint>
</code>
<runtime name="Java VM" version="1,2,2,0"/>
<runtime name="Java VM" version="1,3,0,0"/>
<dependency>...</dependency>
</implementation>

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 175

 Software Package Descriptor
for Observer Component
<dependency type="ORB" action="assert">
<name>OpenORB</name>
</dependency>

<dependency type="Java Class" action="install">

<valuetypefactory
repid="IDL:DiningPhilosophers/StatusInfo:1.0"

valueentrypoint="DiningPhilosophers.StatusInfoDefaultFactory.create"
factoryentrypoint="DiningPhilosophers.StatusInfoDefaultFactory">
<fileinarchive
name="DiningPhilosophers/StatusInfoDefaultFactory.class"/>
</valuetypefactory>
</dependency>

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 176

 Software Package Descriptor
for Observer Component
<implementation id="observer_0x1">
<os name="Win2000" />
<processor name="x86" />
<compiler name="VC++" />
<programminglanguage name="C++" />
<dependency type="DLL"><localfile name="jtc.dll"/></dependency>
<dependency type="DLL"><localfile name="ob.dll"/></dependency>
<descriptor type="CORBA Component">
<fileinarchive name="observer.ccd" />
</descriptor>
<code type="DLL">
<fileinarchive name="PhilosophersExecutors.dll"/>
<entrypoint>create_ObserverHome</entrypoint>
</code>
</implementation>

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 177

 CORBA Component Descriptor (.ccd)
 Structural information generated by CIDL
 Component / home types and features
 Ports and supported interfaces
 Component category and segments
 Container policies filled by the packager
 Threading
 Servant lifetime
 Transactions
 Security
 Events
 Persistence
 Extended POA policies
 Link to component and home property files
Wednesday, April 24th, 2002 CORBA Component Model Tutorial 178
 CORBA Component Descriptor Example
<corbacomponent>
<corbaversion>3.0</corbaversion>
<componentrepid>IDL:DiningPhilosophers/Philosopher:1.0</componentrepid>
<homerepid>IDL:DiningPhilosophers/PhilosopherHome:1.0</homerepid>
<componentkind><session><servant lifetime=“component”/></session></componentkind>
<threading policy=“multithread”/>
<configurationcomplete set=“true”/>
<homefeatures name=“PhilosopherHome” repid=“IDL:...PhilosopherHome:1.0”/>
<componentfeatures name=“Philosopher” repid=“IDL:...Philosopher:1.0”>
<ports>
<publishes publishesname=“info” eventtype=“IDL:DiningPhilosophers/StatusInfo:1.0”>
<eventpolicy/>
</publishes>
<uses usesname=“left” repid=“IDL:DiningPhilosophers/Fork:1.0”/>
<uses usesname=“right” repid=“IDL:DiningPhilosophers/Fork:1.0”/>
</ports>
</componentfeatures>
</corbacomponent>

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 179

 CORBA Component Descriptor
for Philosopher Component
<?xml version="1.0"?>
<!DOCTYPE corbacomponent SYSTEM "corbacomponent.dtd">

<corbacomponent>
<corbaversion>3.0</corbaversion>
<componentrepid repid=
"IDL:DiningPhilosophers/Philosopher:1.0"/>
<homerepid repid=
"IDL:DiningPhilosophers/PhilosopherHome:1.0"/>
<componentkind>
<process><servant lifetime="container" /></process>
</componentkind>
<security rightsfamily="CORBA“
rightscombinator="secanyrights" />
<threading policy="multithread" />
<configurationcomplete set="true" />

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 180

 CORBA Component Descriptor
for Philosopher Component
<homefeatures name="PhilosopherHome"
repid="IDL:DiningPhilosophers/PhilosopherHome:1.0"/>
<componentfeatures name="Philosopher"
repid="IDL:DiningPhilosophers/Philosopher:1.0">
<ports>
<uses usesname="right"
repid="IDL:DiningPhilosophers/Fork:1.0" />
<uses usesname="left"
repid="IDL:DiningPhilosophers/Fork:1.0" />
<publishes emitsname="info"
eventtype="StatusInfo">
<eventpolicy policy="normal" />
</publishes>
</ports>
</componentfeatures>
<interface name="Fork" repid="IDL:DiningPhilosophers/Fork:1.0"/>

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 181

 CORBA Component Descriptor
for Philosopher Component
<segment name="philosopherseg" segmenttag="1">
<segmentmember facettag="1" />
<containermanagedpersistence>
<storagehome id="PSDL:PersonHome:1.0"/>
<pssimplementation id="OpenORB-PSS" />
<accessmode mode="READ_WRITE" />
<psstransaction policy="TRANSACTIONAL" >
<psstransactionisolationlevel level="SERIALIZABLE" />
</psstransaction>
<params>
<param name="x" value="1" />
</params>
</containermanagedpersistence>
</segment>
</corbacomponent>

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 182

 Property File Descriptor (.cpf)

 Used to set home and component properties

 However, it could be used for anything
 Contains zero or more name/value pairs to
configure attributes
 Referenced by...
 Software Package Descriptors to define default values
for component attributes
 CORBA Component Descriptors to define default values
for component or home attributes
 Assembly Descriptors to configure initial values for
home or component instances
Wednesday, April 24th, 2002 CORBA Component Model Tutorial 183
 Property Files

I D L / C I D L F ile U s e r 's C o d e P r o g ra m m in g
Language
T o o ls

ID L /C ID L D e f a u lt P r o p e r t ie s H o m e P r o p e rtie s C o m p o n e n t P r o p e r t ie s
C o m p ile r

C O R BA
S tu b s , S k e le to n s I m p le m e n t a t io n C om ponent
P ackage

C O R BA C om ponent
P a c k a g in g A s s e m b ly
C om ponent A s s e m b ly
Tool Tool
P ackage P ackage

C om ponent
D e s c r ip t o r
s o ftp k g A s s e m b ly
D e s c rip to r D e s c r ip t o r

C O R BA
D e p lo y m e n t
C om ponent
Tool
P ackage

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 184

 Property File For Philosopher Kant
<?xml version="1.0"?>
<!DOCTYPE properties SYSTEM "properties.dtd">

<properties>
<simple name="name" type="string">
<description>Philosopher name</description>
<value>Kant</value>
<defaultvalue>Unknown</defaultvalue>
</simple>
</properties>

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 185

 Component Assembly Descriptor (.cad)
 References one or more Component Software
Descriptors
 Defines home instances and their collocation and
cardinality constraints
 Defines components to be instantiated
 Defines that homes, components or ports are to be
registered in the ComponentHomeFinder, Naming or
Trading Service
 Defines connections to be made between
component ports, e.g. receptacles to facets and
event sinks to event sources
Wednesday, April 24th, 2002 CORBA Component Model Tutorial 186
 Dining Philosophers as Component
CORBA Components Base ref.
Facet
Receptacle
Event Sink
Philosopher
Fork Event Source
name = Kant

Fork

Philosopher
Fork
name = Descartes

Philosopher
name = Aristotle
Observer

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 187

 Component Assembly Descriptor
for Dining Philosophers
<?xml version="1.0"?>
<!DOCTYPE componentassembly SYSTEM "componentassembly.dtd">

<componentassembly id="demophilo">
<description>Dinner assembly descriptor</description>
<componentfiles>
<componentfile id="PhilosopherComponent">
<fileinarchive name="philosopher.csd"/>
</componentfile>
<componentfile id="ObserverComponent">
<fileinarchive name="observer.csd"/>
</componentfile>
<componentfile id="ForkManagerComponent">
<fileinarchive name="forkmanager.csd"/>
</componentfile>
</componentfiles>

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 188

 Assembly Descriptor Example (2)
<partitioning>
<homeplacement id="ObserverHome">
<componentfileref idref="ObserverHome"/>
<registerwithnaming name="ObserverHome"/>
</homeplacement>
<homeplacement id="PhilosopherHome">
<componentfileref idref="PhilosopherHome"/>
<registerwithnaming name="PhilosopherHome"/>
</homeplacement>
<homeplacement id="ForkHome">
<componentfileref idref="ForkHome"/>
<registerwithnaming name="ForkHome"/>
</homeplacement>
</partitioning><connections/></componentassembly>

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 189

 Component Assembly Descriptor
Partitioning for Dining Philosophers
<partitioning>
<homeplacement id="ObserverHome">
<componentfileref idref="ObserverComponent"/>
<componentinstantiation id="Freud"/>
<registerwithnaming name="corbaname: . . ."/>
</homeplacement>

<homeplacement id="ForkHome">
<componentfileref idref="ForkManagerComponent"/>
<componentinstantiation id="ForkManager1"/>
<componentinstantiation id="ForkManager2"/>
<componentinstantiation id="ForkManager3"/>
<registerwithhomefinder name="ForkHome"/>
</homeplacement>

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 190

 Component Assembly Descriptor
Partitioning for Dining Philosophers
<homeplacement id="PhilosopherHome">
<componentfileref idref="PhilosopherComponent"/>
<componentinstantiation id="Kant">
<componentproperties><fileinarchive name="Kant.cpf"/>
</componentproperties></componentinstantiation>
<componentinstantiation id="Descartes">
<componentproperties><fileinarchive name="Descartes.cpf"/>
</componentproperties></componentinstantiation>
<componentinstantiation id="Aristotle">
<componentproperties><fileinarchive name="Aristotle.cpf"/>
</componentproperties></componentinstantiation>
</homeplacement>
</partitioning>

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 191

 Component Assembly Descriptor
Connections for Dining Philosophers
<connections> Fork
Philosopher
<connectinterface> name = Kant

<usesport>
<usesidentifier>left</usesidentifier>
<componentinstantiationref idref="Kant"/>
</usesport>

<providesport>
<providesidentifier>the_fork</providesidentifier>
<componentinstantiationref idref="ForkManager1"/>
</providesport>

</connectinterface>

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 192

 Component Assembly Descriptor
Connections for Dining Philosophers

Philosopher
<connectevent> name = Kant Observer
<publishesport>
<publishesidentifier>info</publishesidentifier>
<componentinstantiationref idref="Kant"/>
</publishesport>
<consumesport>
<consumesidentifier>info</consumesidentifier>
<componentinstantiationref idref="Freud"/>
</consumesport>
</connectevent>

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 193

 Component Packaging

User
IDL Compiler
Code

Generated
Code Shared
IDL/CIDL Library or
Compiler Executable
Component
Descriptor
Component
Packaging
Package
Tool
.zip
Default
Properties

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 194

 Component Assembly

Instance Port
Creation Connections
Component
Package

Component Assembly
Assembly
Package Archive
Tool
.aar (ZIP)

Component
Package
DeploymentT
Properties
ool
...

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 195

 Deploying CORBA
Component Applications

 Component Deployment Objects

 Component Deployment Process
 Deployment Scenario

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 196

 Deployment

 An Assembly Archive is deployed by a deployment

tool

 The deployment tool might interact with the user

to assign homes and components to hosts and
processes

 The deployment application interacts with

installation objects on each host

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 197

 Deployment Objects
 ComponentInstallation
 Singleton, installs component implementations
 AssemblyFactory
 Singleton, creates Assembly objects
 Assembly
 Represents an assembly instantiation
 Coordinates the creation and destruction of component assemblies
and components
 ServerActivator
 Singleton by host, creates ComponentServer objects
 ComponentServer
 Creates Container objects
 Container
 Installs CCMHome objects

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 198

 The Component Deployment Process
I n st a ll
O b je c t

I n s t a ll

P ro c e s s o r O b je ct

P ro c e s s o r

ZIP D e p lo y m e n t A p p

A s se m b ly F i le

OMG IDL I n s ta ll
O b je c t

P ro ce ss o r
S t a g in g A r e a

I n st a ll
O b je c t

P ro c e s s o r

P ro c e s s o r

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 199

 The Component Deployment Process
«instantiates»
AssemblyFactory Assembly

ServerActivator
«instantiates»

Deployment Tool ComponentServer

«instantiates»

Container
«instantiates»

CCMHome
«instantiates»
ComponentInstallation
CCMObject
Wednesday, April 24th, 2002 CORBA Component Model Tutorial 200
 Deployment API: Assembly
module Components {
enum AssemblyState {
INACTIVE, INSERVICE
};
exception CreateFailure {};
exception RemoveFailure {};

interface Assembly {
void build () raises (CreateFailure);
void tear_down () raises (RemoveFailure);
AssemblyState get_state ();
};
};

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 201

 Deploying the Philosophers Example

 Run Deployment Application

 Use ComponentInstallation to upload component
implementations
 Use AssemblyFactory to create an Assembly
 Call build() operation on Assembly Interface
 starts ComponentServers for each home
 creates Containers and installs homes
 creates component instances
 interconnects component ports
 calls configuration_complete
 One-step installation!

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 202

 Deployment Scenario

Component
Deployment Tool Assembly
Descriptor

Component
Assembly
Deployer Descriptor +

with installation information

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 203

 Deployment Scenario:
Implementation UpLoading

Deployment Tool

ComponentInstallation ComponentInstallation
Component
Code for Assembly Code for
Component A Descriptor + Component B

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 204

 Deployment Scenario:
Assembly Creation

Deployment Tool

AssemblyFactory

Code for Code for

Component A Assembly Component B

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 205

 Deployment Scenario:
Component Server Instantiation
Component
Assembly
Descriptor +

ComponentServer ComponentServer

ServerActivator Assembly ServerActivator

Code for Code for

Component A Component B

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 206

 Deployment Scenario:
Container Instantiation
Component
Assembly
Descriptor +

ComponentServer ComponentServer

Container Assembly Container

Code for Code for
Component A Component B

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 207

 Deployment Scenario:
Home Installation
Component
Assembly
Descriptor +

Home for A Home for B

Container Assembly Container

Code for Code for
Component A Component B

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 208

 Deployment Scenario:
Component Instantiation
Component
Assembly
Descriptor +

Home for A Home for B

Assembly

A instance B instance

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 209

 Deployment Scenario:
Component Configuration
Component
Assembly
Descriptor +

Home for A Home for B

Assembly

A instance B instance

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 210

 Summary

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 211

 Conclusion
 1st open standard for Distributed Component
Computing
 Component-based software engineering process
 Advanced component model
 Server-side container framework
 Packaging and distributed deployment
 EJB interworking
 Component meta models

 Heart of CORBA 3.0

 Final CCM specification approved begin 2002
 ~ 500 pages added
Wednesday, April 24th, 2002 CORBA Component Model Tutorial 212
 Next CCM Steps at OMG
 Deployment and Configuration RFP
 OMG TC Doc orbos/2002-01-19
 CORBA Component Model Revision Task Force
 Will be chartered this Friday, April 26th 2002
 UML Profile for CCM RFP
 Should be prepared
 Revision of the UML Profile for CORBA for
including IDL 3.0 extension, PSDL, and CIDL
 EDOC to CCM Mapping RFP
 Should be prepared

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 213

 Open Source CCM Implementations
 OpenCCM from LIFL & ObjectWeb
 Java on ORBacus 4.1 & OpenORB 1.2.1
 http://www.objectweb.org/OpenCCM/

 MicoCCM from FPX & Alcatel

 C++ on MICO
 http://www.fpx.de/MicoCCM/

 FreeCCM from Humboldt University

 C++ on ORBacus 4.1
 http://sourceforge.net/projects/cif
Wednesday, April 24th, 2002 CORBA Component Model Tutorial 214
 Commercial CCM Implementations
 EnagoCCM from IKV++/Fraunhofer FOKUS
 C++ on MICO & ORBacus 4.1
 ritter@fokus.gmd.de

 EJCCM from CPI Inc.

 Java on OpenORB 1.3.x
 http://www.ejccm.org

 K2 from ICMP
 C++ on various ORBs
 http://www.icmgworld.com

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 215

 More Information

 CORBA 3.0: New Components Chapters

 OMG TC Document ptc/2001-11-03

 CORBA 3 Fundamentals and Programming

 Dr. John Siegel, published at John Wiley and Sons

 “The CCM Page”, Diego Sevilla Ruiz

 http://www.ditec.um.es/~dsevilla/ccm/

Wednesday, April 24th, 2002 CORBA Component Model Tutorial 216