Copland Manual

Chapters

1. Introduction
   1. What is Copland?
   2. What Can Copland Do For Me?
   3. Copland sans Buzzwords
   4. Copland avec Buzzwords
   5. The Buzzwords Themselves
   6. Features
   7. Getting Copland
   8. License Information
   9. Support
2. Justification
   1. IoC in One Paragraph
   2. Why IoC?
   3. A Case Study
3. Getting Started
   1. Terminology
   2. Quickstart
4. Copland's Design
   1. HiveMind
   2. Registry Initialization
   3. Service Instantiation
   4. Interceptor Chains
5. Packages
   1. Descriptor Syntax
   2. Tips
6. Service Points
   1. Descriptor Syntax
7. Service Models
   1. Standard Models
   2. Deferred Instantiation
   3. Custom Service Models
8. Configuration Points
   1. Descriptor Syntax
   2. FactoryDefaults
   3. ApplicationDefaults
9. Contributions
10. Logging
    1. Log Factory
    2. Configuration
11. Service Factories
    1. Schemas
    2. How do they work?
    3. BuilderFactory
12. Schemas
    1. Basic Format
    2. Subschemas
    3. Arrays
    4. Named vs. Anonymous Schemas
    5. Extending Schemas
    6. Limitations
13. Listeners and Event Producers
    1. Event Producers
    2. Listeners
    3. The Registry as an Event Producer

API Reference

• Copland API
• Package Reference

Tutorials

1. Creating Services
   

   The basics of creating new services in Copland.

2. Service Factories
   

   Introduces the concept of a “service factory”, and shows how to use them to create complex services.

3. Service Models
   

   Introduces the concept of the “service model”, and shows the difference between “singleton” and “prototype”.

4. Logging Interceptor
   

   Shows how to use the logging interceptor to add logging for method invocations on any service.

5. Configuration Points
   

   Demonstrates the use of configuration points for decentralizing service configuration.

More To Come...

Product Manual

Copland Website: http://copland.rubyforge.org
Copland Project Website: http://rubyforge.org/projects/copland

Recent Updates to This Manual

documented the new "visibility" attribute of service points added chapter about Logging configuration fixed misinformation about symbol sources added discussion about FactoryDefaults vs. ApplicationDefaults added (HiveMind-inspired) section in Introduction describing concrete benefits of Copland

Copyright © 2004 Jamis Buck (jgb3@email.byu.edu)