DOMBuilder(BuilderFactory) Category Reference

List of all members.

Detailed Description

Defines methods for creating builders The most common way of getting a builder is by calling DOMBuilder::defaultBuilder.

New builders can be plugged in into the DOM framework by placing a bundle with the extension "builder" in the PlugIns-directory in the framework bundle. To aquire an instance of a plug in builder, use the DOMBuilder#builderForName-method (the name is the name of the bundle minus the ".builder" extension).

You can get a list of installed builders from the method DOMBuilder::installedBuilders.


Static Public Member Functions

(DOMBuilder *)  defaultBuilder
(DOMBuilder *)  builderForName:
(NSArray *)  installedBuilders

Member Function Documentation

+ (DOMBuilder *) builderForName: (NSString *)  name  
 

Creates a builder by name If there is an installed builder (a bundle with the extension ".builder") in the frameworks plugin-directory (DOM.framework/PlugIns), named as specified, that builder's bundle will be loaded and an instance of it's principal class will be created. Do not include ".builder" in the name, it will be added automatically.

Example:

 // get an instance of the builder in "MyBuilder.builder"
 DOMBuilder *builder = [DOMBuilder builderForName:@"MyBuilder];

The principal class of the bundle is assumed to be a subclass of DOMBuilder.

Parameters:
name The name of the builder to be loaded, without the ".builder" extension
Returns:
An autoreleased instance of the named builder

+ (DOMBuilder *) defaultBuilder  
 

Returns an instance of the default builder class The default builder is currently an Cocoa-wrapped version of the Expat builder.

+ (NSArray *) installedBuilders  
 

Returns an array of the names of all installed builders Builders are installed in the framework's default plugin directory (DOM.framework/PlugIns).